Terrain Water Mask Task

The Terrain Water Mask task uses GeoJSON polygons to create an animated water image on the terrain. The task must be applied to an already created terrain. No new terrain is calculated; instead, a water mask is generated on existing terrain, which is why this task is listed separately. An example of the result can be seen in this Cesium Sandcastle Demo, although VC Map has slightly different rendering settings, so the appearance may differ somewhat.

Different GeoJSON files can be used for different zoom levels of the terrain. For example, if a terrain only has higher levels in a small area (e.g., levels 18 and above with a terrain resolution of <1.2m), a more detailed GeoJSON file can be used for these levels. The displayed transparency of the terrain water mask changes depending on the distance to the edge of the water. This value can be set with the coast smoothing distance. A higher value results in a larger transparency zone at the edge of the water.

For better visibility of the terrain water mask, it is recommended to use an orthophoto as the terrain texture.

Step 1

Option Description

Task Name

Name of the task.

Create or overwrite Datasource

Select whether to create a new datasource or overwrite an existing one

Datasource Name

If an existing data source is to be overwritten, select the source here.

Step 2

Required Settings

Setting Description

Terrain datasource

Select a terrain data source available in the current project to which the water mask should be applied.

Water mask geojson

Select the GeoJSON file that defines the water mask. The geometry in the file should contain polygons that define the areas where water should be displayed on the terrain. The coordinate system of the GeoJSON file must be WGS84 (EPSG:4326).

Smooth coast distance

Distance in meters over which the transparency of the water mask transitions at the edge of the water.

Break Levels

Setting Description

Add Break Level

Clicking the button opens a new settings field for another break level.

Window for Break Level:

Setting Description

Level

Enter a numeric value for the terrain zoom level for which this break level should apply. [0-24]

Water mask geojson

Select the GeoJSON file that defines the water mask for this zoom level. The geometry in the file should contain polygons that define the areas where water should be displayed on the terrain. The coordinate system of the GeoJSON file must be WGS84 (EPSG:4326).

Smooth coast distance

Distance in meters over which the transparency of the water mask transitions at the edge of the water.

Add Break Level

Clicking the button adds the specified break level to the list of break levels.

Cancel

Closes the window without saving the settings.

Delete Break Level

Deletes an already created break level from the list of break levels.

Advanced Settings

Setting Description

Number of Threads (Default: 4, optional)

Number of threads to use for processing.

Debug Log Level (optional)

Select the DEBUG log level for this task. This setting should only be enabled if problems occur during task execution and detailed logs are needed.

Step 3

Option Description

Start Job as soon as possible

Start the job immediately.

Start Job once at given time

Schedule job for a future time.

Repeat Job

Automatic periodic execution of the job.

Publish Job after Completion

Once conversion is successful, the datasource is published automatically.