This page has been translated automatically.
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
Sandworm
Using Editor Tools for Specific Tasks
Extending Editor Functionality
Built-in Node Types
Nodes
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
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.

Mesh Cluster

A mesh cluster is an object that can contain a great number of identical meshes with the same material, which are managed as one object. Cluster meshes can be scattered either automatically, or each mesh can be positioned, rotated, and scaled manually.

The mesh cluster is usually used for objects of the same type, for example, houses in neighborhoods.

Meshes of the mesh cluster object that are visible in the viewing frustum are loaded, meshes outside the frustum are culled. Using the mesh cluster is very efficient performance-wise: it substantially speeds up rendering and allows handling a lot of objects without any performance drop.

Notice
The mesh cluster can contain only identical static meshes with the same material assigned to each of their surfaces.

There are two ways to create a mesh cluster in UnigineEditor:

  • Collect a mesh cluster by baking all identical meshes in node's hierarchy or in the world.
  • Create a mesh cluster manually by baking all its identical child meshes.
Notice
Mesh Cluster is always culled by the Occlusion Query and not rendered when outside the viewing frustum.

See also#

Collecting a Cluster#

A mesh cluster can be collected from all identical meshes that were added in the world or from all identical child meshes of a certain node.

Baking Identical Meshes of a Node Hierarchy#

To create a mesh cluster by baking all identical meshes in the hierarchy, right-click the parent node of the hierarchy in the World Hierarchy window and select Create Mesh Clusters From Hierarchy in the context menu.

Applying this operation creates a dummy node with the _clustered postfix added to the parent node name. This dummy node contains two child nodes:

  • Node that is a parent of all mesh clusters. This node is named by adding the _mesh_clusters postfix to the source parent node name. Mesh cluster names are formed using the mesh name and the _cluster postfix.
  • Node that is a parent of all other child nodes of the source parent node. This node is named by adding the _other_nodes postfix to the source parent node name.

The created clusters contain all identical meshes of the source node including meshes that are referenced by Node References. Other nodes are added as a linear list. The source node is disabled.

Creation of a clustered node: nodes that are not in clusters are added as a linear list
Notice
A mesh cluster is created only if a hierarchy contains at least 8 identical meshes.

Baking Identical Meshes in the World#

To create a cluster by baking all identical meshes in the world, do the following:

  1. On the Menu bar, click Create -> Cluster -> Mesh.

  2. In the dialog window that opens, choose the path to the .mesh file. This mesh would be used as the source one for the mesh cluster.
  3. Place the mesh cluster somewhere in the world. By default, is shall contain 4 instances of the selected mesh (you can remove them). Meshes to be baked should have the same .mesh file as the one selected for the mesh cluster.
  4. Specify the same material that is assigned to meshes going to be baked to the cluster in the Node tab of the Parameters window (the Surfaces section).
  5. Click Collect Similar in the Node tab, Mesh Cluster section. All meshes having the same mesh and material assigned will be baked to the cluster. Baked meshes are no longer seen in the nodes hierarchy.

    Parameters window, Node tab

    To change all child meshes at once, just select a required asset in the Mesh field of the Mesh Cluster section.

Creating Mesh Clusters from Mesh Clutters#

To create a Mesh Cluster from a Mesh Clutter, use the following context-menu option:

Using this option disables the Mesh Clutter and creates and enables a mesh cluster with the same name and postfix _Cluster added.

Creating a Cluster Manually#

To create a mesh cluster by baking its child meshes, do the following:

  1. On the Menu bar, click Create -> Cluster -> Mesh.

  2. In the dialog window that opens, choose a *.mesh asset to be used as the source mesh for the cluster.
  3. Place the cluster somewhere in the world. By default is shall contain 4 instances of the selected mesh (you can remove them).
  4. Manually position identical meshes in the world and make them children of the created cluster.
    Notice
    To make a node a child of another node, drag it under the parent node in the World Hierarchy window.
  5. To bake the child meshes to the cluster, click Apply in the Mesh Cluster section of the Node tab. The baked child meshes are no longer seen in the nodes hierarchy.

    Parameters window, Node tab
    Notice
    Only enabled meshes are baked to a cluster. Disabled meshes are left as child nodes.

    To add more meshes to the same cluster, simply click Edit make them its children and then click Apply to rebake the cluster.

    To change all child meshes at once just change the mesh asset in the Mesh field of the Mesh Cluster section.

Editing a Cluster#

To edit a mesh cluster (either created or collected), for example, to reposition or remove some meshes, click Edit in the Mesh Cluster section of the Node tab.

Notice
Meshes that were collected would become mesh cluster children.

Clearing a Cluster#

To delete all meshes baked to a mesh cluster, click Clear. Make sure that the meshes are created or collected, as the operation won't be performed if they are rebaked.

Mesh Cluster Parameters#

The following parameters are available for a cluster in the Mesh Cluster section of the Node tab:

Parameters window, Node tab, Mesh Cluster section
Mesh Change the source cluster mesh thus changing all children meshes.
Visibility Distance The distance up to which all cluster meshes are visible.
  • If set to infinity (inf), the Fade parameter will be ignored.
  • The real range of cluster visibility directly depends on the object (surface) maximum visibility distance and also on its fade out distance. In case meshes disappear at a closer distance, further increase of the visibility distance won't affect the performance in any way.
Notice
To avoid flickering of cluster meshes, the object maximum visibility distance should be greater than the sum of minimum visibility distance and minimum fade out distance:
Max Visibility > Min Visibility + Min Fade
Fade Distance The distance up to which the number of rendered cluster meshes gradually decreases, as they disappear randomly one by one. The fade distance follows the visibility distance. Without the fade distance set meshes disappear sharply, as a clearly seen line. Using fade distance allows the objects to disappear one by one until up to the fade distance only a few left. It makes the disappearing smooth and much less noticeable.

For the best result, it is also recommended to combine this effect with objects fade-out.

Last update: 2021-12-13
Build: ()