Introduction

Mapollage is a photo kml generator with a number of options listed below.

Profiles

Settings are stored in profiles that you can run from the gui or from the command line. Profiles can be added, removed, renamed and cloned.

Source

The source tab lets you select the image directory to process, a (glob) pattern to match each file and exclude strings separated by :: (double colon). When an exclude element is found in the image path, that file will be excluded.

You can choose if you want to process subdirectories, follow links and include photos without a coordinate.

This tab also includes the output log.

Folders

The folders tab defines the folder structure to be created in the kml file. First of all you will have to set the root folder name and description. Sub folder creation is done by either

1. The image directory name
2. A date pattern of the image timestamp
3. The first file path match of the specified regular expression
4. Or not at all

Path

The path tab lets you select wether or not to create a connecting path between the images. You can set the path width and control how to split the paths.

Placemark

The placemark tab controls how the placemark is presented. Its name can come from the filename, a date pattern of the image timestamp or be nothing at all. The symbol can be the photo or a pushpin.

The scale value controls the size of the placemark in its normal state and the zoom value the size when hovered.

Be sure to set a good enough value for the thumbnail size under the global program options to match scale and zoom.

Finally, it is possible to set the timestamp of the placemark and by doing so, Google Earth can filter the images by a time slider.

Description

The description tab controls what the placemark description will look like. The description will be displayed after clicking on a placemark.

A description can be defined either by a customized template or by selecting from the static elements. Hovering a static element displays a tag that can be used in the custom form.

The photo tab is enabled only if the photo is part of the description.

Photo

The photo tab controls the images displayed in the description. The image size can be limited and the image reference can be one of

1. A relative link to the thumbnail from the kml file
2. A relative link to the original image from the kml file
3. An absolute link to the original image
4. An absolute link to a base name plus the image name

When selecting a relative reference, remember that the interrelation between the image and the kml document must not change.

There has been some reports that in some circumstances, windows have problem with the extension case and because of that, there is an option to force lower case extension. Use with caution.

Information

The information tab displays a textual summary of the profile. The same information can be displayed from the command line with:

mapollage --view-profile <profile>

Options

Besides the look and feel settings there are a couple of global options controlling the kml generation:

• Calendar language
• Thumbnail and border size
• Default coordinate