Importing and Reimporting Layers

How processed project assets become editor layers, and what happens when you reimport terrain, vector, or raster data.

Assets become layers

The Editor does not edit raw provider output directly. It creates project layers from processed assets. A DTM asset can become a terrain layer, an OSM/vector asset can become vector layers, and an imagery/raster asset can become a static raster layer.

The Editor tracks which asset IDs already have persisted layers. If it detects unimported terrain, vector, or raster assets, it can prompt you to import them. The project info popover also shows whether layer imports are pending.

Terrain import

A terrain import creates a terrain layer from a DTM asset. If no usable DTM exists, the Editor can create an empty terrain layer from the project selection. Empty terrain is stored as a generated project asset and layer, not just a viewport placeholder.

The active terrain layer drives the terrain mesh and is the target for the Sculpt tool. Working resolution comes from Editor Settings.

Vector import

Vector import reads processed OSM-style vector assets and builds saved vector layers using the selected vector mapping collection. The import preview groups features by mapping layer so you can see which layers will be created before importing.

Before the layer is created, the Editor applies saved tags from the selected mapping collection to matched features. This is how mapping rules can preserve source tags such as names, surfaces, or other attributes for later editing and export.

Raster import

Raster import creates static raster layers from persisted raster assets, usually imagery. Imported imagery layers are created with metadata that marks them as static, sets opacity to 0.65, and fits them to terrain by default.

Static raster layers are visual references. To paint, create a manual raster layer from the Layers panel instead of trying to paint into imported imagery.

Reimporting

Reimport is intentionally destructive. Reimport vectors removes saved vector layers, clears vector modifiers for those layers, clears generated tree/building/electricity placement metadata, then rebuilds vector layers from the persisted local OSM assets using the selected mapping collection.

Reimport raster removes saved raster layers and rebuilds them from persisted raster assets. Reimport DTM clears sculpted terrain overrides and terrain-shaping modifiers for saved terrain layers, restoring terrain to the original DTM source state.

Use reimport when the source asset or mapping choice should become the new layer baseline. Do not use it as ordinary undo; use History and Saving for recent viewport edits.