Landscape Gizmos

Landscape Gizmos are editor-only Actors that are similar to volumes in that they define a specified area. Their purpose is to hold height and layer data for an area of a Landscape so that it can be copied to another location on the Landscape or exported for use in a different Landscape or heightmap generator (World Machine, Terresculptor,...).

Accessing the Gizmo Tool

To access the Gizmo tool:

  1. In Sculpt mode, click the currently selected tool icon to open the Sculpting Tools drop-down menu.

    Sculpt Menu

  2. Choose Copy/Paste from the menu. The Gizmo brush appears on your selected Landscape as a red-outlined box.

    Gizmo Outline

Selecting the Gizmo brush creates a temporary Gizmo Actor. You can use the transformation tools to manipulate this Actor as you would any other, to define the area of the Landscape you want to copy.

For more information about the transformation tools, see Transforming Actors .

You can also modify the Gizmo Actor's properties in the Details panel.

Gizmo Properties

Property Description
Width The base width for Gizmo Actor in Unreal Units; X axis shown as red line.
Height The base height for the Gizmo Actor in Unreal Units; Y axis shown as green line.
LengthZ The base Z length for the Gizmo Actor in Unreal Units.
MarginZ The Z value for space when you fit the Gizmo to the selection, with Max height and Min height. When you fit Gizmo to selected region, LengthZ = (Max height - Min height) + 2 * MarginZ.
MinRelativeZ The minimum height value of data in the Gizmo. Height values in the Gizmo are normalized from 0.f to 1.f and displayed as (Value - MinRelativeZ) * RelativeScaleZ.
RelativeScaleZ The height scale of the data in the Gizmo.
TargetLandscape The currently selected Landscape, which the Gizmo tool will be used on.

Copying to the Gizmo

In order to copy a portion of a Landscape, the data for that area must be copied to a Gizmo. Then, that data can later be pasted to another location.

To copy a selected region:

  1. In Sculpt mode, select the Region Selection sculpting tool.

    Region Select

  2. Use the brush strokes to select a region of the Landscape, similar to the normal painting process.

    Gizmo Copy

  3. Select the Copy/Paste sculpting tool.

    Copy/Paste

    The Gizmo will become visible in the viewport.

    Gizmo Tool

  4. In the Gizmo's Tool Settings section, enable Use Region as Mask so the selection will be used as a mask when copying the data.

    Use Region As Mask Setting

  5. Click the Fit Gizmo to Selected Regions button to position and size the Gizmo so that it encompasses all selected regions.

    Copy Gizmo Data

  6. Click the Copy Data to Gizmo button to transfer the data for the selected region of the Landscape within the Gizmo's bounds. Pressing Ctrl + C performs the same function.

    Copied Gizmo Data

To copy an area within a Gizmo:

  1. Select the Region Copy/Paste sculpting tool. The Gizmo will become visible in the viewport.

  2. Select the Gizmo by clicking on it. The transform widget should appear.

    Transform Gizmo

  3. Move, rotate, and scale the Gizmo so that it encompasses the portion of the Landscape you wish to copy.

    Transformed Gizmo

  4. Press the Copy Data to Gizmo button to transfer the data for the portion of the Landscape within the Gizmo's bounds. Pressing Ctrl + C performs the same function.

    Copied Data to Gizmo

Pasting from the Gizmo

Pasting data from a Gizmo makes it possible to transfer parts of a Landscape from one location to another. The data can either be pasted completely to create an identical feature, or it can be painted to the new location using brush strokes and strength settings to partially transfer the feature.

Before data can be pasted from a Gizmo, it must first be copied to a Gizmo.

To paste Gizmo data:

  1. Move, rotate, and scale a Gizmo that contains data so that it covers the area you wish to paste the data to.

    Gizmo Paste

    Gizmo Paste

  2. Paste the data using one of the available brushes (Circle, Pattern, Alpha, Gizmo) to "paint" the data from the Gizmo.

    • The Gizmo brush is used to fully paste the data from the Gizmo. Pressing Ctrl + V also fully pastes the data from the Gizmo.

    • Other brushes can be used to paint the data from the Gizmo using the current brush size and strength.

    Gizmo Paste

    Gizmo Paste

    If there is a region selected using the Region Selection tool and Use Region as Mask is enabled, pasted data is applied according to the masked region.

Gizmo Data Import/Export

Heightmap data can be imported from and exported to the Gizmo through the Gizmo Import/Export section in the Landscape Editor.

gizmo_importexport.png

To import data to the Gizmo:

  1. Click the browse for file button ( import_filebrowse.png) and select the heightmap file (16-bit raw file) you want to import to the Gizmo. The file and dimensions of the heightmap will be filled in.
    gizmo_import_file.png

    Since the import process uses the .raw file format, there is no way to correctly determine which dimension is which. A best guess will be made, but you may need to manually reverse the dimensions in order to import the heightmap correctly.

    gizmo_import_file_dimensions.png

  2. If you want to import layer weight information as well, press the Add Layer button ( import_layeradd.png) to add as many layers as desired.
    gizmo_import_layerfields.png

  3. Select the layer weightmap file (8-bit raw file) to import for each layer. The file and layer name will be filled in. The layer name uses the name of the file by default. Change the layer name if needed. Enabling the No Import checkbox will prevent any individual layer information from being imported.

    The Layer Name must match the name of a layer that exists on the Landscape or the import will fail.

    gizmo_import_layerfile.png

  4. Once the heightmap and any layers are selected, press the Import to Gizmo button to import the data to the Gizmo.
    If the dimensions are not correct, you may see something similar to this:

    Import Wrong Dimensions

    Reverse the dimensions and re-import to get the correct result. If the dimensions were correct, the Gizmo should show the correct data.

To Export Gizmo Data:

  1. With the Gizmo populated with data (see Copying to the Gizmo ), press the Export Gizmo Data button to export the Gizmo data to a file. Enabling the Gizmo copy/paste all layers checkbox at the top of the Gizmo options will export the heightmap and all layers' weight data to files.

  2. Choose a location and name for the heightmap file.
    export_file.jpg

  3. If exporting layers, choose locations and filenames for each exported layer.
    export_layerfile.jpg