MapTiler Engine settings

In MapTiler Engine, you can review and adjust the global settings that store various default configurations. In addition to that, you have the possibility to modify certain settings only for a specific tiling task in advanced task settings, which overrides the global defaults.

Global settings

To access global settings, go to File > Settings. These settings are saved permanently and applied to any processing task by default, unless modified in advanced task settings.

Note that any change in the global settings will only apply to tasks created after you save the change. It won’t affect any tasks that are already in the processing queue.

global_settings.png

Image tab

Resampling and overviews resampling

Can be overriden with advanced task settings

First of all, you can see the combo boxes controlling the resampling methods that are being used. You will probably be interested in these either when over-zooming your data or when experimenting with the options to find out which setting will result in the best output for you. For detailed information go to Resampling tiles. These options are available from MapTiler Engine Start.

The default value for resampling is bilinear and for overviews resampling average.

Tiling scheme

Can be overriden with advanced task settings

Different map providers work with different tiling schemes, so make sure you are using the correct scheme depending on further usage of your output. The schemes differ in the way your output tiles are named. For detailed information on the available options, go to Tiling scheme.

The Default value is XYZ.

Sparse output

Can be overriden with advanced task settings

This option controls how the empty tiles in your output are treated. In some cases, e.g. when your input data are very geographically distant, you’ll get a huge amount of empty tiles between them, which can lead to high disk space usage. If you leave the default setting, the blank tiles will be produced for MBTiles and GeoPackage outputs otherwise will be skipped. By setting this option to sparse (skip empty tiles) or no-sparse (don’t skip), you have full control over this.

The default value is “default” (depending on the used store option).

ECW memory usage

This option allows you to set the maximum amount of memory to be used for in-memory caching by the ECW driver of the GDAL library. This setting should be used with care and in reasonable cases, since using a high value may slow your system down or make it temporarily irresponsive.

The default and suggested value for ECW Memory usage is 80%.

Allow large JPEG

Enabling large JPEG allows you to process very large images. It also should be used only in reasonable cases since it can have the same negative impact on your system as a large ECW memory usage.

By default, large JPEG support is disabled.

General tab

Proxy settings

If you use a computer without direct access to the internet, enable the system proxy to load the proxy settings from your system configuration.

Saved georeferences

By leaving this option enabled, you will be offered to use the geolocation previously saved by Assign visually when you add a new input file.

By default, saving georeferences is enabled.

MBTiles compatibility

Can be overriden with advanced task settings

Enabling this option make the generated GeoPackage conform to the MBTiles specification for the tiles table. The tilegrid is in the selected output coordinate system, which is not defined for MBTiles.

By default, MBTiles compatibility is disabled.

Save EPSG code

Can be overriden with advanced task settings

wkt-save-epsg.png

Changes the format of coordinate system representation to be used. Disabling this option causes saving the full WKT string (left) instead of the short EPSG code (right) within the project file or report message. EPSG.io is a nice tool to switch between different formats. For the lower versions of the application, this option is hidden and set to true. Changing this option is enabled in MapTiler Engine Pro.

By default, saving EPSG code instead of WKT string is enabled.

Google Maps API key

Use this field to save your Google Maps API key, which is used to secure Google Maps Platform products from unauthorized use. You can get this key by following steps described in the Google guides. For more details, go to Google maps API key.

Directories tab

In this tab, you can set custom paths for different kinds of files used over the application. If you do so, the file dialogs will open in these custom directories. Before you save any custom path, system paths for temporary files, pictures (add a file, view a file), and Engine (rendering output, projects) are used. Using custom paths is available from MapTiler Engine Plus. By default, each option in the Directories tab is disabled.

Save the last selected directory for user directories

With this option enabled, when you select a different path (in the application), it will get saved to settings in the background. This option is available from MapTiler Engine Plus.

Let’s say you have set the Engine/ location for adding a file, but you add a file from Engine/files-to-process/ folder, this folder gets saved in settings for you and replaces the Engine/ folder just as you would have done it in settings. The next time you add a file, the file dialog will navigate in Engine/files-to-process/.

This works only for paths, that have been set custom!

Remember the last selected directory in the application’s lifetime

With this option enabled, when you select a different path (in the application), it will be remembered (but not saved) until you restart the application. This option is available from MapTiler Engine Plus.

Let’s say you did not touch the “add a file” path (set to Pictures/), but you add a file from Engine/files-to-process/ folder, you’ll be offered this path every time you attempt to add a file until you quit the application or change it in settings. After the application restarts, the file dialog will navigate in the default location (Pictures/) again.

Watermark tab

MapTiler Engine allows you to set the custom watermark to be used in your outptut. You can choose either image (which will need to meet some criteria for this purpose), or quickly create a text watermark using the simple in-build editor. Either way, you’ll see the result in the preview below. Read the Custom watermark article for more detailed description. This option is available in MapTiler Engine Pro and by default, the “No watermark” option is set.

Saved watermark settings (both image and text) last through the application lifetime and get loaded on the next startup.

Advanced task settings

To access advanced task settings, start configuring a tiling task. When you get to the output settings, use the Advanced settings button. Any changes in these settings will only apply to this specific task, and won’t be propagated to the global settings. If you save your task, the advanced settings specific for the task will be saved too.

advanced_task_settings_open.png

Advanced task settings contain the same options as the Image and General tabs in global settings. If you update these options in the advanced task settings, they’ll override the global settings.

Additionally, you can configure the HiDPI / Retina scaling in the advanced task settings dialog. To learn more about this option, go to Custom retina scale.