Video Tutorials
Interface
Essentials
Advanced
How To
UnigineEditor
Interface Overview
Assets Workflow
Settings and Preferences
Working With Projects
Adjusting Node Parameters
Setting Up Materials
Setting Up Properties
Lighting
Landscape Tool
Using Editor Tools for Specific Tasks
Extending Editor Functionality
Built-in Node Types
Nodes
Objects
Effects
Decals
Light Sources
Geodetics
World Objects
Sound Objects
Pathfinding Objects
Players
Programming
Fundamentals
Setting Up Development Environment
Usage Examples
UnigineScript
C++
C#
UUSL (Unified UNIGINE Shader Language)
File Formats
Rebuilding the Engine Tools
GUI
Double Precision Coordinates
API
Containers
Common Functionality
Controls-Related Classes
Engine-Related Classes
Filesystem Functionality
GUI-Related Classes
Math Functionality
Node-Related Classes
Objects-Related Classes
Networking Functionality
Pathfinding-Related Classes
Physics-Related Classes
Plugins-Related Classes
IG Plugin
CIGIConnector Plugin
Rendering-Related Classes
Content Creation
Content Optimization
Materials
Art Samples
Tutorials

Starting with Sandworm

Warning
The functionality described in this article is not available in the Community SDK edition.
You should upgrade to Engineering / Sim SDK edition to use it.

This chapter gives an overview of the Sandworm tool interface.

Overview of the Landscape Generation Process#

In general, the process of generating the landscape in Sandworm is as follows:

  1. Prepare assets: source data for landscape (geodata-based maps or links to online geodata sources), vector data to create roads and objects, OSM data to generate buildings, masks to generate vegetation, nodes that will be used as roads, trees, and anything else generated according to your data.
  2. Open Sandworm and add the landscape data: heights and imagery.
  3. Optional: generate a landscape to see how vast it is and check if the settings need to be adjusted.
  4. Add roads, objects, vegetation, and buildings.
  5. Set masks.
  6. Define the output settings such as terrain type, quality of generated data, and the world that is going to store the generated result.
  7. Generate (or re-generate) the output.
  8. Open the world with the output in UnigineEditor.

Opening the Sandworm Tool#

To open Sandworm, in the main menu select Tools -> Sandworm.

The following window will open:

If you have already worked with Sandworm and created projects, you'll also see a list of links to your recent projects for quick access:

By clicking the Create New button, the Project Configuration window opens:

The coordinate system you choose here is set for the convenience of preview display. While for data export you should specify only a projected coordinate system, because the generated landscape is exported to Object Landscape Terrain, which is actually a flat (i.e. not geospherical) area.

Sandworm Interface#

The Sandworm tool interface has 5 panels: Sources, Output, Generation, Preview, and Parameters.

  • In the Sources panel, you specify the Elevation (height) and Imagery (albedo) sources for the terrain generation, as well as Vector and Mask data sources for generation of details, vegetation, buildings, etc. if necessary.
  • In the Output panel, you set the play area of the landscape generation, select the display projection, export format, required output projection, quality, define if the surface will be curved, and specify the world where this landscape is going to be located.
  • In the Generation panel, .
  • In the Preview panel, you can navigate and preview the added inputs.
  • The Parameters panel contains parameters of the selected settings or information of the selected data source.

The location of panels is not fixed, and they can be rearranged as necessary.

Sources Panel#

The Sources panel contains all the added layers. To work with multiple layers simultaneously, multiselection is provided.

Right-clicking on a layer opens the context menu:

Focus Focuses the view in the Preview panel on the selected layer.
Remove Removes the selected layer or layers.
Move to Foreground Moves the selected layer (or layers of one type) to the foreground in the Preview panel.
Move to Background Moves the selected layer (or layers of one type) to the background in the Preview panel.
Properties Displays the properties of the source file for the selected layer such as file name, the coordinate system the source file uses, the source file density in meters per pixel, and geographic bounds of the source file.

Renaming of layers is done by double click + focus click on the layer name.

For the Vector and Mask sources, overall information on the tags and objects in use is summarized for convenience.

Output Panel#

Link to output settings.

Generation Panel#

Link to Generate settings.

Preview Panel#

The Preview panel visualizes the available information. The following controls are available:

Panning mode. Allows only panning in the Preview panel, without selecting any layer.
Selection mode. Allows panning and selecting the foreground layers in the Preview panel.
Zoom-in button. The preview can also be zoomed in by scrolling the mouse wheel up.
Zoom-out button. The preview can also be zoomed out by scrolling the mouse wheel down.
Coordinates Current coordinates of the mouse cursor.
Show in WGS 84 Display coordinates as WGS 84 latitude and longitude. If coordinates are already displayed as latitude and longitude (not in meters), then this button is inactive.
Coordinate System The coordinate system selected for preview. Can be changed by clicking on it.
Last update: 2021-03-05