This page has been translated automatically.
Video Tutorials
Interface
Essentials
Advanced
How To
Professional (SIM)
UnigineEditor
Interface Overview
Assets Workflow
Version Control
Settings and Preferences
Working With Projects
Adjusting Node Parameters
Setting Up Materials
Setting Up Properties
Lighting
Using Editor Tools for Specific Tasks
Extending Editor Functionality
Built-in Node Types
Nodes
Objects
Effects
Decals
Light Sources
Geodetics
World Nodes
Sound Objects
Pathfinding Objects
Players
Programming
Fundamentals
Setting Up Development Environment
Usage Examples
C++
C#
UnigineScript
UUSL (Unified UNIGINE Shader Language)
Plugins
File Formats
Materials and Shaders
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
Material Nodes Library
Miscellaneous
Input
Math
Matrix
Textures
Art Samples
Tutorials
Warning! This version of documentation is OUTDATED, as it describes an older SDK version! Please switch to the documentation for the latest SDK version.
Warning! This version of documentation describes an old SDK version which is no longer supported! Please upgrade to the latest SDK version.

Adding Vegetation

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.

Trees and grass are placed on the terrain based on the Mask data.

See Also#

Check this video from the series of video tutorials on the terrain generation using Sandworm:

Preparing a Primary Object#

We need to create a primary object that will be used as a building block to generate vegetation (grass, trees, etc.). The following types of primary objects are supported:

Let's create a Mesh Clutter object with a tree.

Notice
You can omit the creation process and use a ready-made Node Reference sw_georeferenced/nodes/vegetation/pine/pine_clutter.node.
  1. In the scene, click Create -> Clutter -> Mesh. In the window that opens, select a mesh: sw_georeferenced/nodes/vegetation/pine/fbx/pine_01_2.FBX/pine_01_2.mesh and place it somewhere in the scene.
  2. Specify parameters of the primary object in the Parameters window: assign the materials from the sw_georeferenced/nodes/vegetation/pine/materials/ folder to the corresponding surfaces, increase the visibility distance of the Mesh Clutter, etc. For more details, see this article.

    Notice
    Intersections with the parent object must be enabled for all types of primary objects. The Intersection flag can be found on the Parameters tab of the object.

  3. Open the folder in the Asset Browser where you want the primary object be stored, right-click on the created ObjectMeshClutter and convert it to Node Reference.

The primary object is ready — we will use this Node Reference to generate vegetation.

Created primary object

You can remove it from the scene at all or disable if you'll require it later for further adjustments.

Impostors#

Considering that there'll be many trees generated, you may come across some performance issues. To optimize vegetation, create the Impostor object that will be rendered at a farther distance.

If you created the primary object from scratch, be sure that all settings of the Impostor object are the same as in the primary object, except Visibility Distance.

You may also use the Impostor asset sw_georeferenced/nodes/vegetation/pine/pine_clutter_impostor.node from the pack in pair with the sw_georeferenced/nodes/vegetation/pine/pine_clutter.node asset.

Adding the Vegetation Object#

  1. In the Objects panel, click + for Vegetation.

  2. Set the following parameters for the object:

    • The object name is set for convenience. This name will be displayed in the Objects list in Sandworm and in the World Nodes hierarchy after generation.
    • As you have only one mask, it is selected by default in the Parameters panel.
    • Set the prepared primary object as Node (or use an asset from the pack).
  3. Click the Create Vegetation Object button.

You can edit any parameters of the created vegetation object in Sandworm — changes are saved automatically.

If you plan to use an Impostor object, add it as one more Vegetation object.

List of Created Objects

Generated Vegetation#

The generated trees:

Generated trees

What Else#

  • Add grass the same way using the Grass node instead on Mesh Clutter. Use the same mask and grass will be spread under the trees.
  • Check the information on how to generate and use Impostors.
  • Read the tips on vegetation optimization.
  • Check the article on the Sandworm vegetation parameters for a more detailed description.
Last update: 2023-06-23
Build: ()