This page has been translated automatically.
Click here to view the original English version instead.
Getting Started
What's Inside?
Downloading and Installing UNIGINE SDK
Project Workflow
Programming Quick Start
Programming Quick References
1. Setting Up the Project
2. Creating the Controllable Character
3. Implementing Shooting
4. Generating Physical Objects
5. Implementing Color Zone
6. Playing Background Music
7. Managing Game Rules
8. Creating the End UI
9. Building the Project
Getting Started with VR
Classes and Components Overview
System Requirements
Migrating to UNIGINE
Migrating to UNIGINE From Unreal Engine
Content Creation
Programming
Physics
Migrating to UNIGINE From Unity
Content Creation
Programming
Physics
Video Tutorials
Interface
SDK Browser Interface
Editor Interface
Scene Viewport
Essentials
Importing 3D Models
Instancing Nodes
Materials
Lighting
Tracker Tool
Global Illumination
Georeferenced Terrain Generation
Arbitrary Terrain Generation
Content Optimization
Decals
Performance Inspection with Microprofile
Textures
Procedural Texturing
Bit Masking
Audio Sources and Sound Effects
Cached Shadows
Water
Physics
C# Component System
Landscape Terrain
Volumetric Clouds
Advanced
Microprofile for Artists
How To
Principles of Operation
Virtual World Structure
World Management
Properties
Hierarchy and Inheritance
Component System
C++ Component System
C# Component System
Rendering
Rendering Sequence
Parallel-Split Shadow Mapping
Interleaved Lights Rendering
Alpha Blending
Physics
Shapes
Collision Detection
Joints
Simulation of Physics
Bit Masking
Import System
File System
Asynchronous Data Streaming
SDK Browser
Projects
Licenses
Managing Company Accounts and Licenses
Add-Ons
Airport Assets
Eastern European Countryside
Industrial Assets
Road Tool Constructor
Vegetation
VFX
Weather
Arbitrary Terrain Generation
Georeferenced Terrain Generation
Demos
CIGI
C# Third Person Platformer
CPP Samples
Earthworks
Fox Hole
LiDAR
Oil Platform
Oil Refinery
Orbits
Procedural City Generation
Soldier
Superposition
Syncker
Viewer
VR Sample
Winch
UnigineEditor
Interface Overview
Layout Customization
Context Menus
Assets Workflow
Asset Types
Assets and Runtime Files
Organizing Assets
Copying Assets From Other Projects
Project Files
Version Control
Settings and Preferences
Editor Settings and Hotkeys
World Settings
Global Physics Settings
Global Sound Settings
Controls Settings
Working With Projects
Packing a Final Build for Publishing
Managing Worlds
Scene Navigation
Creating Nodes
Selecting and Positioning Nodes
Organizing Nodes
Exporting Nodes
Instancing Nodes
Adjusting Node Parameters
Transformation and Common Parameters
Visual Representation
Properties
Physics and Sound
Setting Up Materials
Organizing Materials
Forced Shader Compilation
Setting Up Properties
Organizing Properties
Lighting
Environment
Light Meter
Reflections
Setting Up Cameras
Using Visual Helpers
System Menu
Landscape Tool
Creating a Terrain
Creating a Geo-Referenced Terrain
Generating Detail Masks
Generating Vegetation
Generating Spline Objects
Generating Vector Objects
Generating Point Objects
Generating Buildings
Procedural Refinement
Distributed Computing
Sandworm
Starting with Sandworm
Generating the Landscape and Objects
Using Editor Tools for Specific Tasks
Capturing Screenshots and Frame Sequences
Adding Variations for a More Realistic Environment
Generating Impostors with Impostors Creator
Editing Global Terrain
Editing Landscape Terrain
Mask Editor for Grass and Clutters
Extending Editor Functionality
Setting Up Environment
Creating Your First Editor Plugin
Editing Curves
Tools
Plugins for 3D Editors
Plugins for 3ds Max
Plugins for Maya
Performance Profiling Tools
Performance Profiler
Microprofile
USC Interpreter
Archiver
Resource
Upgrade Script
Runtimes Generator
Built-in Node Types
Nodes
Node
Node Reference
Dummy Node
Layer
Trigger
Objects
Dummy Object
Static Mesh
Skinned Mesh
Dynamic Mesh
Mesh Cluster
Mesh Clutter
Text Object
Sky
Cloud Layer
Effects
Particle System
Decals
Projected Decal
Orthographic Decal
Mesh Decal
Light Sources
Light Sources Parameters
Omni Light
Projected Light
World Light
Environment Probe
Voxel Probe
Planar Reflection Probe
Geodetics
Geodetic Pivot
World Objects
World Trigger
World Clutter
Switcher
World Expression
World Spline Graph
Sound Objects
Sound Source
Sound Reverb
Pathfinding Objects
Players
Player Actor
Player Dummy
Player Persecutor
Player Spectator
Programming
Fundamentals
Programming Overview
Engine Architecture
Working with Smart Pointers
Accessing Nodes and Files via Properties
Thread Safety
Matrix Transformations
Camera Matrices
Event Handling Callbacks
Setting Up Development Environment
Windows Development Environment
Linux Development Environment
Usage Examples
Working with Landscape Terrain via Code
High-Level Car Physics System (C++)
Custom Import Plugin
Importing Models Directly to Memory
C++ Component System
Customizing Mouse Cursor and Behavior
Basic Object Movements
Creating and Attaching a Cloth
Creating a Car with Wheel Joints
Creating Mirrors Using Viewports (Rendering to Texture) or Materials
A Simple Mechanism Using Joints
Creating Routes
Creating Pylons and Wires Using Ropes
Dynamic Meshes
Enabling Selective Surface-Based Collision
Playing Sounds on Collisions
Intersections
Mesh Class
Working with Console
Sharing Data
Splitting Logic Between Several WorldLogic Classes
Using Manipulators to Transform Objects
UnigineScript
Creating UnigineScript Application
Adding Scripts to the Project
Script Debugging
Handling Ownership When Using Scripts
Cache Files
C++
Creating C++ Application
Creating C++ Plugin
C#
Creating C# Application
Debugging C# Components
Garbage Collector
C# API Reference
UUSL (Unified UNIGINE Shader Language)
UUSL Keywords
UUSL Common Intrinsic Functions
UUSL GBuffer Structure
UUSL Data Structure
UUSL Parameters
UUSL Textures
UUSL Semantics
UUSL Tessellation
UUSL Compute Shaders
Creating a Custom Shader for Deferred Rendering Pass
Creating a Custom Shader for Forward Rendering Pass
Creating a Custom Shader for Post-Processing
File Formats
Unigine Language Object Notation
Mesh File Formats
Property File Format
Spline File Format
Startup Command-Line Options
Console
Configuration Files
Rebuilding the Engine Tools
Rebuild in Windows via Visual Studio
Semi-automatic Compilation with Build Script
Protecting Your Data with a Password
GUI
Loading and Splash Screens
RC Files
Skin Layout
Usage Example
Double Precision Coordinates
Usage
Performance Analyzer
API
Containers
Container Functions
ArrayVector Class
Map Class
Set Class
Common Functionality
Async Class
ScopedLock Class
ScopedReaderLock Class
ScopedReentrantLock Class
ScopedWriterLock Class
Atomic Class
BackoffSpinner Class
Mutex Class
ReentrantMutex Class
RWMutex Class
Blob Class
Checksum Class
Compress Class
ConsoleVariableFloat Class
ConsoleVariableInt Class
ConsoleVariableString Class
Curve2d Class
Expression Class
ExternClass Class
FunctionBase Class
Hash Class
Hasher Class
Image Class
ImageConverter Class
Interpreter Class
Json Class
Log Class
OS Functions
Palette Class
Path Class
Plugin Class
Property Class
PropertyParameter Class
Ptr Class
Reflection Class
RegExp Class
Resource Class
Stream Class
String Class
StringArray Class
StringPtr Class
StringStack Class
Thread Class
Timer Class
TypeInfo Class
UlonArg Class
UlonValue Class
UlonNode Class
Unigine Namespace Items
Utils Class
Xml Class
Variable Class
Controls-Related Classes
Controls Class
ControlsApp Class
ControlsDummy Class
ControlsJoystick Class
ControlsSixAxis
ControlsXPad360 Class
Input Class
InputGamePad Class
Engine-Related Classes
App Class
BootConfig Class
CustomApp Class
Config Class
Console Class
Editor Class
Engine Class
EnginePtr Class
engine.system Functions
EnginePlugins Class
Game Class
GameIntersection Class
LoadingScreen Class
Memory Class
Profiler Class
Properties Class
Sound Class
Sounds Class
SystemDialog Class
SystemInfo Class
UserConfig Class
Visualizer Class
World Class
Filesystem Functionality
Dir Class
File Class
FileSystem Class
FileSystemAssets Class
FileSystemMount Class
AsyncQueue Class
File System Functions
Package Class
PackageUng Class
UGUID Class
GUI-Related Classes
Gui Class
UserInterface Class
Widget Class
WidgetButton Class
WidgetCanvas Class
WidgetCheckBox Class
WidgetComboBox Class
WidgetDialog Class
WidgetDialogColor Class
WidgetDialogFile Class
WidgetDialogImage Class
WidgetDialogMessage Class
WidgetEditLine Class
WidgetEditText Class
WidgetExternBase Class
WidgetExtern Class
WidgetGridBox Class
WidgetGroupBox Class
WidgetHBox Class
WidgetHPaned Class
WidgetIcon Class
WidgetLabel Class
WidgetListBox Class
WidgetManipulator Class
WidgetManipulatorRotator Class
WidgetManipulatorScaler Class
WidgetManipulatorTranslator Class
WidgetMenuBar Class
WidgetMenuBox Class
WidgetScroll Class
WidgetScrollBox Class
WidgetSlider Class
WidgetSpacer Class
WidgetSpinBox Class
WidgetSpinBoxDouble Class
WidgetSprite Class
WidgetSpriteNode Class
WidgetSpriteShader Class
WidgetSpriteVideo Class
WidgetSpriteViewport Class
WidgetTabBox Class
WidgetTreeBox Class
WidgetVBox Class
WidgetVPaned Class
WidgetWindow Class
Math Functionality
Predefined Constants
Geometry Class
Math Common Functions
Math 2D Functions
Math Exponential Functions
Math Matrix Functions
Math Random Functions
Math Trigonometrical Functions
bvec4 Class
dmat4 Class
dvec2 Class
dvec3 Class
dvec4 Class
half Class
hvec2 Class
hvec3 Class
hvec4 Class
ivec2 Class
ivec3 Class
ivec4 Class
mat2 Class
mat3 Class
mat4 Class
quat Class
svec4 Class
vec2 Class
vec3 Class
vec4 Class
Node-Related Classes
Node Class
NodeDummy Class
NodeExtern Class
NodeExternBase Class
NodeLayer Class
NodeReference Class
NodeTrigger Class
Objects-Related Classes
Object Class
ObjectBillboards Class
ObjectCloudLayer Class
ObjectDummy Class
ObjectDynamic Class
ObjectExtern Class
ObjectExternBase Class
ObjectGrass Class
ObjectGui Class
ObjectGuiMesh Class
ObjectIntersection Class
ObjectIntersectionNormal Class
ObjectIntersectionTexCoord Class
ObjectMeshStatic Class
ObjectMeshCluster Class
ObjectMeshClutter Class
ObjectMeshDynamic Class
ObjectMeshSkinned Class
ObjectMeshSplineCluster Class
ObjectSky Class
ObjectTerrainGlobal Class
TerrainGlobalDetail Class
TerrainGlobalLod Class
TerrainGlobalLodHeight Class
TerrainGlobalLods Class
TileSet Class
TileSetFile Class
ObjectText Class
ObjectVolumeBox Class
ObjectVolumeOmni Class
ObjectVolumeProj Class
ObjectVolumeSphere Class
ObjectWaterMesh Class
ObjectWaterGlobal Class
Networking Functionality
Socket Class
Pathfinding-Related Classes
Navigation Class
NavigationMesh Class
NavigationSector Class
Obstacle Class
ObstacleBox Class
ObstacleCapsule Class
ObstacleSphere Class
PathRoute Class
PathRouteIntersection Class
Physics-Related Classes
Contact Class
ShapeContact Class
Physics Class
PhysicsIntersection Class
PhysicsIntersectionNormal Class
Plugins-Related Classes
AppEasyBlend Class
OpenFlightImport Class
Kinect Class
AppOculus Class
AppProjection Class
engine.surround Functions
AppVarjo Class
AppVive Class
AppWall Class
ARTTracker Class
IG Plugin
CIGIConnector Plugin
CIGI::Connector Class
CigiAerosolResponse Class
CigiAnimationNotify Class
CigiArticulatedControl Class
CigiArticulatedShortControl Class
CigiAtmosphereControl Class
CigiCelestialControl Class
CigiComponentControl Class
CigiComponentShortControl Class
CigiEarthModelDef Class
CigiEntityClampedControl Class
CigiEntityControl Class
CigiEnvironmentControl Class
CigiEnvironmentRequest Class
CigiEventNotify Class
CigiHatHotExtResponse Class
CigiHatHotRequest Class
CigiHatHotResponse Class
CigiHostPacket Class
CigiHostUserDefined Class
CigiIGControl Class
CigiIGMessage Class
CigiIGPacket Class
CigiIGUserDefined Class
CigiLosExtResponse Class
CigiLosResponse Class
CigiLosSegmentRequest Class
CigiLosVectorRequest Class
CigiMaritimeControl Class
CigiMaritimeResponse Class
CigiPositionRequest Class
CigiPositionResponse Class
CigiRateControl Class
CigiSegmentDef Class
CigiSegmentNotify Class
CigiSensorControl Class
CigiSensorExtResponse Class
CigiSensorResponse Class
CigiStartOfFrame Class
CigiSymbolCircleDef Class
CigiSymbolClone Class
CigiSymbolControl Class
CigiSymbolLineDef Class
CigiSymbolShortControl Class
CigiSymbolSurfaceDef Class
CigiSymbolTextDef Class
CigiTerrestrialControl Class
CigiTerrestrialResponse Class
CigiTrackerControl Class
CigiTrajectoryDef Class
CigiViewControl Class
CigiViewDef Class
CigiVolumeDef Class
CigiVolumeNotify Class
CigiWaveControl Class
CigiWeatherControl Class
CigiWeatherResponse Class
ComponentBaseInterface
IG Manager Class
ArticulatedPart Class
CollisionSegment Class
CollisionVolume Class
Component Class
Converter Class
IGConfig Class
Entity Class
ViewBase Class
ViewGroup Class
View Class
SkyMap Class
Meteo Class
Region Class
LightController Class
SymbolsController Class
SymbolsPlane Class
Symbol Class
SymbolPolyline Class
SymbolCircle Class
SymbolText Class
Water Class
IGIntersection Structure
Rendering-Related Classes
Camera Class
EngineExpression Class
Ffp Class
Material Class
Materials Class
Mesh Class
MeshDynamic Class
MeshStatic Class
Primitives Class
Render Class
RenderEnvironmentPreset Class
Renderer Class
RenderContext Class
RenderState Class
RenderTarget Class
Shader Class
CPUShader Class
StructuredBuffer Class
Texture Class
TextureCurve Class
Viewport Class
Content Creation
3D Models Requirements
Art Assets Conversion
Content Optimization
Lights Optimization
Dynamic Reflections Optimization
Water Optimization
Terrain Optimization
Physics Optimization
VR Best Practices
Materials
Hierarchy and Inheritance
Custom Materials
Scriptable Materials
Art Samples
Animated Character
Billboards
Camera Effects
Clouds
Cluster
Clutter
Cross Section
Decals
Environment
Global Illumination
Impostors
Interior
Landscape
Lens Flares
Lights
LOD System
Materials
Occluders
Particles
Post Sensors
Reflections
Simlights
SSBevel
SSDirt
Vegetation
Volumetrics
Water
Wildfire
World Spline Graph
Tutorials
Adding Morph Targets
Vegetation: Authoring Tips
Upgrading to UNIGINE 2.14.1
API Migration
Content Migration
IG Template
IG Configuration
Environment Settings
Light Settings
Entity-Related Properties
Creating Custom Components
Processing User-Defined Packets
Debugging IG Application
IG Host
Troubleshooting
SDK Browser Issues
UnigineEditor Issues
.NET Issues
Third-Party Notices
Table of Contents
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.

Navigation Mesh

In This Article:

The Navigation Mesh is a navigation area which is arranged above the surface of an arbitrary mesh. In fact, the Navigation Mesh is an area of the specified height above the mesh polygons, which is available for pathfinding.

In contrast to navigation sectors, the Navigation Mesh enables the following:

  • Only 2D routes can be calculated within the Navigation Mesh.

  • Pathfinding can be performed within 1 Navigation Mesh only. Pathfinding within the following areas is not supported:

    • Within several intersecting Navigation Meshes
    • Within the intersecting Navigation Mesh and sector

See also#

  • The NavigationMesh class to manage navigation meshes via API
  • The article on Creating Routes to learn how to create routes inside the navigation mesh
  • A set of samples located in the <UnigineSDK>/data/samples/paths folder:
    • mesh_00
    • route_03
    • route_04

Creating Navigation Mesh#

Before adding a Navigation Mesh, you should prepare a mesh, on which this Navigation Mesh will be based. Such mesh is created separately and should meet the following requirements:

  • Any polygon of the mesh must not share its edge with more than 2 other polygons; otherwise, an error will occur.
  • Mesh polygons should be as wide as possible (ideally, they should be equilateral). Too narrow and high polygons may reduce accuracy of path calculation.
  • The mesh should be optimized: it should not contain a large number of polygons.

When a mesh is prepared, you can add the Navigation Mesh to the scene via UnigineEditor:

  1. Run UnigineEditor.

  2. On the Menu bar, click Create -> Navigation -> Navigation Mesh.

  3. In the file dialog window that opens, choose the required mesh to be used as a base for the new navigation area and click OK.

  4. Click somewhere in the world to place the Navigation Mesh. A new Navigation Mesh is added to UnigineEditor and you can edit it via the Parameters window.
Notice
The created Navigation Mesh only provides an area within which 2D routes are calculated. The routes themselves should be created using the script.

Example#

If you have a scene with different objects and need to calculate a 2D route among them, add the Navigation Mesh to this scene as follows:

  1. Create a flat mesh with holes in places where the objects are positioned.

    The scene
    The mesh created for the Navigation Mesh

  2. Specify this mesh as a base for a Navigation Mesh within which the route is calculated, and add the Navigation Mesh to the world. It will be highlighted in green:

    A Navigation Mesh based on the flat mesh

  3. Place the Navigation Mesh above the scene.

    The Navigation Mesh positioned above the scene
Notice
In this case, you can also use a navigation sector with obstacles positioned inside it instead of the Navigation Mesh. However, the Navigation Mesh is preferred for more complex cases.

Editing Navigation Mesh#

In the Node tab of the Parameters window, you can adjust the following parameters of the Navigation Mesh:

Navigation Mask The Navigation mask of the Navigation Mesh must match the Navigation mask of the route that is calculated within it. Otherwise, the Navigation Mesh does not participate in pathfinding.
Quality Quality of optimization for route calculation. This value specifies the number of iterations that are used to find the shortcut. The higher the value, the longer the route calculation takes.
Velocity Scaling factor for velocity of the point that moves inside the Navigation Mesh.
Dangerous

Danger factor that indicates if a moving point should try to avoid the Navigation Mesh.

Notice
If the danger factor exceeds the maximum danger factor set for the route, the Navigation Mesh is excluded from pathfinding calculations.
Depth Depth value. This value affects the quality of the route that is currently calculated. The more the depth value, the better control over accuracy and speed of route calculation is provided. The depth can take integer value in range [0;4]. By default, the depth is set to 0 for a new Navigation Mesh. The 2, 3, 4 values are used for deeper heuristics.
Height Distance above the mesh polygons available for pathfinding. By default, the height is set to 1 for a new Navigation Mesh.

Loading a New Mesh#

To load a new mesh on which the navigation area is based:

  1. On the Navigation tab, press .
  2. In the file dialog window that opens, choose the required mesh and press OK.

Saving the Current Mesh#

To save the current mesh on which the navigation area is based:

  1. On the Navigation tab, press .
  2. In the file dialog window that opens, specify a name for the mesh and press OK.
Last update: 2021-04-29
Build: ()