Setting Up Development Environment
Usage Examples
UUSL (Unified UNIGINE Shader Language)
File Formats
Rebuilding the Engine and Tools
Double Precision Coordinates
Common Functionality
Controls-Related Classes
Engine-Related Classes
Filesystem Functionality
GUI-Related Classes
Math Functionality
Node-Related Classes
Networking Functionality
Pathfinding-Related Classes
Physics-Related Classes
Plugins-Related Classes
CIGI Client Plugin
Rendering-Related Classes

Generating Spline Objects

Spline object (WorldSplineGraph) represents a basic static mesh, tiled or extruded along the segments of a Bezier spline graph, built on the basis of vector data available. As an example of spline object generation let us consider generation of a road network. The basic workflow is as follows:

1. Preparing a Basic Mesh

First, we create a MeshStatic object, that will be used as a building block for generation of roads.

The MeshStatic object must be located and have a pivot at the origin (0, 0, 0).
  1. Create a mesh (we use a plane for the road), for this purpose on the Menu bar, click Create -> Primitive -> Plane.

  2. Specify mesh parameters, for our road we set the following.

    It is recommended to use more than a single segment to make road curves smoother.
  3. Move the mesh to the origin.

  4. Inherit a material from the mesh_base, set all necessary textures and parameters and assign it to the mesh.

  5. As it was mentioned spline objects are generated by means of extrusion or tiling of the basic mesh along one of the axes X, Y or Z (forward axis). Make sure that you mesh is oriented properly - in this case the forward axis is X (red arrow).

  6. Geometry is very resource consuming. Thus, to maintain acceptable performance you should set up LODs for the basic mesh. For each surface of the mesh specify visibility and fade distances. These settings will be used for managing LODs of generated spline objects.

    For more information on LOD settings see Setting Up Object LODs.

  7. Export your mesh to a mesh file by clicking the following button in the Nodes window. And delete the node.

  8. Create a MeshStatic object using the mesh and material you prepared. Move the mesh to the origin and export your mesh to a node file (e.g. road.node) by clicking the following button in the Nodes window.

  9. Now our basic mesh for roads (road.node) is ready to use and you can delete it from the scene.

2. Adding a Vector Data Source and Specifying Tags

Now, we add a vector data source to be used for generation.

  1. Open the Landscape Tool window, for this purpose on the Menu bar, click Windows -> Landscape.

  2. In the Data Sources panel, specify necessary vector data sources (see Specifying Data Sources section).

    Currently only *.shp files are supported.
  3. Select each vector data source from the ones you added in the Data Sources panel and specify parameters in the Parameters panel.

  4. Add tags for each type of spline objects you are going to generate by clicking Add and specifying a tag name.

  5. For each tag you can specify a set of filters (AND) to select certain data from the vector source. You can add as many filters as necessary. This can be done by selecting attributes from the list and specifying necessary values for each attribute. You can specify as many filters as you need.


    Use "+" (plus) button to add a filter, or "-" (minus) to remove one.

    If no filters are specified, all the data from the vector source will be used for generation.

  6. Now all necessary tags and filters are added and you can proceed to the next step.

3. Specifying Parameters of Spline Objects

Now, we must specify basic objects created at the first step and bind them to the tags.

  1. In the Cultural Layer panel, select Spline (Roads, Communications, etc.) and the following settings will be displayed in the Parameters panel.

  2. Add a basic mesh object for generation by clicking Add button at the top of the Parameters panel and specify object's name. You can add as many objects as nesessary.

  3. For each basic object specify the following parameters:

    Tag The tag to be used for the selected basic object from the list of the tags specified at the second step.
    Node The path to the basic mesh object's *.node file.
    Type Type of objects to be generated. One of the following:
    • Geometry - a static mesh will be generated. Static meshes may require additional alignment with terrain surface, they are costly in terms of performance, but they offer collision detection. This option can be used for example to generate a railway track for the train simulator.
    • Decal - a mesh decal will be generated. Decals do not have problems associated with alignment with the terrain surface, as they are projected onto it. They are also performance friendly, but collision detection for decals is not available. This option can be used for example to generate roads for a flight simulator.
    • Both - both a static mesh and a mesh decal will be generated. This option can be used to generate static meshes that will be visible within a close distance range (according to LOD settings of the basic mesh) and decals for a long-distance range.
    Collider Flag indicating whether collisions for the generated object are to be detected or not.
    Available only for geometry type.
    Drop to ground Flag indicating whether the generated object will be aligned with the terrain surface or not.
    Height offset Distance from the terrain surface along the Z-axis, in units.
    If you see the generated object partially, You can try to increase this value to lift it above the terrain surface.
    Decal texture height Resolution of baked texture for decals.
    Available only for decal type.
    Split segments Flag indicating whether the segment splitting mode is enabled. In this mode all spline segments will be divided into subsegments of the specified length (if this length does not exceed the length of the segment itself).
    This parameter can be used to provide better alignment of spline objects with the terrain.
    Split segment length Length of the segment for splitting mode, in units.
    The lower the value the more segments will be generated. Setting too low values may significantly reduce performance.
    Split splines Flag indicating whether spline splitting mode is enabled. By default a single WorldSplineGraph object shall be generated for the specified tag and shall include all relevant geometry and/or decals. When spline splitting mode is enabled the spline will be divided into parts of the specified length (if this length does not exceed the length of the spline itself). Each part will be represented by a separate WorldSplineGraph object.
    This parameter can be used to optimize performance. Generation of several WorldSplineGraph objects instead of a single one makes it possible to use the advantages of managing visibility distances (according to LOD settings of the basic mesh).
    Split splines length (km) Length of the spline for splitting mode, in kilometers.
    The lower the value the more splines will be generated. Setting too low values may significantly reduce performance.
    Adjust terrain heights and masks Flag indicating whether terrain heights and masks will be adjusted for generated roads. When this option is enabled the following data of the global terrain will be modified in the areas along the splines having the width specified by the Area width parameter:
    • height data will be adjusted (flattened) to provide better alignment of generated roads with the terrain surface.

    • masks data will be cut out (e.g. preventing grass from growing on roads).
      All masks will be affected.

    • Enabling this option significantly increases generation time.

    • Adjustment will affect all height and mask LOD's of the global terrain having the density satisfying the following condition:

      Density < Area width x 6.

    Area width Width of the area along the spline to be affected by heights and masks adjustment.
    Available only when heights and masks adjustment is enabled.
    Forward axis Axis along which the basic mesh is to be extruded or tiled.
    Mode One of the following:
    • stretch - in this case the basic mesh will be extruded along spline segments.
    • tiling - in this case the basic mesh will be tiled along spline segments.
    If the stretch mode is selected the number of meshes in the generated object is significantly lower which makes it more performance friendly.
  4. Now all necessary basic objects are specified and bound to tags.


    If the terrain is already generated and you want to add only spline objects - proceed to Step 4.

    Otherwise - return back to setting other parameters of terrain generation.

4. Generating Spline Objects

Now you can generate spline objects by clicking Generate button and selecting Vector objects option in the Generation Steps window, in this case only vector objects will be generated.

Here is a terrain fragment with roads generated on the basis of vector data using the basic mesh object we created.

Last update: 2018-02-13