This page has been translated automatically.
Click here to view the original English version instead.
Getting Started
What's Inside?
Project Workflow
Migrating to Unigine
Migrating to Unigine From Unreal Engine
Migrating to Unigine From Unity
Programming Quick Start
1. Basic Scene Objects and Coordinate System
2. Logging and Printing Messages to Console
3. Saving and Loading a World
4. Closing the Application
5. Working with Smart Pointers
6. Creating and Deleting Nodes at Runtime
7. Creating and Setting Up a Camera
8. Creating and Setting up Light Sources
9. Creating, Applying and Deleting Materials at Runtime
10. Managing Existing Scene Objects
11. Performing Basic Transformations (Move, Rotate, Scale)
12. Making It in Time
13. Managing Intersections
14. Getting and Managing User Inputs
15. Implementing Game Logic and Using Properties
16. Creating User Interface
Getting Started with VR
Classes and Components Overview
System Requirements
Video Tutorials
Interface
Interface Overview
The 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
Advanced
Microprofile for Artists
Principles of Operation
Virtual World Structure
World Management
Properties
Hierarchy and Inheritance
Component System
Custom C++ Component System
C# Component System
Rendering
Rendering Sequence
Scattering
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
Add-Ons
Eastern European Countryside
Road Tool Constructor
Vegetation
VFX
Weather
Arbitrary Terrain Generation
Georeferenced Terrain Generation
Demos
CIGI
C# Third Person Platformer
Fox Hole
Oil Platform
Oil Refinery
Orbits
Procedural City Generation
Soldier
Superposition
Syncker
Viewer
VR Sample
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
Working With Projects
Building a Project
Managing Worlds
Scene Navigation
Creating and Importing 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
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
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
Creating Your First Editor Plugin
Bake Lighting
FAQ
Switching From the Previous Version of the Editor
Tools
Plugins for 3D Editors
Plugins for 3ds Max
Plugins for Maya
Performance Profiling Tools
Performance Profiler
Microprofile
USC Interpreter
Archiver
Resource
Upgrade Script
Built-in Node Types
Nodes
Node
Node Reference
Dummy Node
Layer
Pivot
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
Geodetics
Geodetic Pivot
World Objects
World Layer
Sector
Portal
World Trigger
World Cluster
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
Typical Architecture of a Unigine-Based Application
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
High-Level Car Physics System (C++)
Custom Import Plugin
Importing Models Directly to Memory
Custom 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
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
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 File
Rebuilding the Engine and Tools
Rebuild in Windows via Visual Studio
Semi-automatic Compilation with Build Script
Preprocessor Macros for Rebuilding the Engine
Protecting Your Data with a Password
GUI
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
Expression Class
ExternClass Class
FunctionBase Class
Hash Class
Hasher Class
Image Class
Interpreter Class
Json Class
Log Class
OS Functions
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
CustomApp Class
Config Class
Console Class
Editor Class
Engine Class
EnginePtr Class
engine.system Functions
EnginePlugins Class
Game Class
GameIntersection Class
Memory Class
Profiler Class
Properties Class
Sound Class
Sounds Class
Splash 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
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
vec2 Class
vec3 Class
vec4 Class
Node-Related Classes
Node Class
NodeDummy Class
NodeExtern Class
NodeExternBase Class
NodeLayer Class
NodePivot 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
ObjectParticles 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
Rendering-Related Classes
Camera Class
Ffp Class
Material Class
Materials Class
Mesh Class
MeshDynamic Class
Primitives Class
Render Class
RenderEnvironmentPreset Class
Renderer Class
RenderContext Class
RenderState Class
RenderTarget Class
Shader Class
StructuredBuffer Class
Texture 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
Art Samples
Billboards
Camera Effects
Clouds
Cluster
Clutter
Cross Section
Decals
Environment
Global Illumination
Impostors
Landscape
Lens Flares
Lights
LOD System
Materials
Particles
Post Sensors
Reflections
Simlights
SSBevel
SSDirt
Vegetation
Volumetrics
Water
World Spline Graph
Tutorials
Adding Morph Targets
Migrating to UNIGINE 2.10
API Migration
Console Migration
Content Migration
IG Template
Setting Up Properties
IG Configuration
Environment Settings
Light Settings
Creating Custom Components
Processing User-Defined Packets
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.

Working with Projects

In This Article:

A project is an independent entity that contains all the data on your application content organized in a set of directories. The .project file containing metadata is associated with the project.

Notice
One project can consist of several worlds. So, there is no need to create a separate project for each world.

Creating New Project#

Before starting to create new projects you should have an SDK installed. Once you have the required version of the SDK, you can create a new project as follows:

  1. Open the Projects tab in the SDK browser.

  2. Click Create New. The new project creation window will be opened.
  3. Define the name of the project, choose a path to store project files, specify the SDK and UNIGINE Engine build to be used.
    Notice
    You can choose the Development or Release build of UNIGINE Engine:
    • The Development build includes additional features that can be useful for project's development (Microprofile, etc.)
    • The Release build allows checking the final performance of the application.

    The project will be created in the <project path>/<unigine_project> folder.
  4. Specify the required application and general settings.
  5. Specify the add-ons to be added (optional).
  6. Click Create New Project. The project will appear in the projects list.

Notice
You can change the project settings any time by clicking Other Actions -> Configure Project.

Application Settings#

The project can be created with the following application settings:

Template A template that is used as a basis for the project:
  • Empty — no template is used for the project.
  • VR — a template is used to facilitate creation of a custom application for VR.
  • IG — a template is used to facilitate creation of a custom Image Generator application.
API+IDE Programming language to be used for project creation. The following APIs are available:
  • UnigineScript only — UnigineScript will be used to implement the project.
  • C++ — C++ API will be used to implement the project. For a project using a template, one of the following variants should be used depending on the OS:
    • On Windows:
      • C++ (Visual Studio 2015)
      • C++ (Qt-based) — Qt Creator, QMake, or CMake is required for building the project.
      • C++ SDL2
        Notice
        App* plugins (AppProjection, AppSurround, AppWall, AppPanorama, and others) cannot be used in Qt-based and SDL-based applications.
    • On Linux:
      • C++ GNU Make
  • C# (.Net Framework) — C# API will be used to implement the project. The Visual Studio will be used to compile a project.
  • C# (.NET Core) — C# API and Component System will be used to implement the project. .NET Core is required for building the project.
Precision The coordinates precision to be used:

General Settings#

The project can be created with the following general settings:

Component System Create a project with the Component System.
GUI-based settings configurator Create a project with the launcher.

Click Plugins to specify the following:

Oculus support (AppOculus plugin) Create project with the Oculus Rift virtual display support.
HTC Vive support (AppVive plugin) Create project with the HTC Vive output support.
Dual output stereo 3D (AppSeparate plugin) Output 2 separate images for each eye.
Notice
The AppSeparate supports DirectX 11 only.

3-monitor output (AppSurround plugin) Render the application across 3 monitors simultaneously.
Monitor wall (AppWall plugin) Render the application into the configurable number of monitors.

Multi-projector setups (AppProjection plugin) Create a project with the AppProjection plugin. All necessary files are copied and the launcher with the corresponding settings is generated.
EasyBlend support (AppEasyBlend plugin) Create a project with the AppEasyBlend plugin.

Syncker plugin Create a project with the Syncker plugin for multi-channel rendering synchronization.
SSLSocket plugin Create a project with the SSLSocket plugin.
Steam plugin Create a project with the plugin for Steam integration.
VRPN Client plugin Create a project with the VRPN Client plugin.
ARTTracker plugin Create a project with the ARTTracker plugin.

Kinect2 Plugin Create a project with the Kinect2 plugin.
GPU Monitor plugin Enable GPU frequencies and temperature monitoring for your project.
Leap Motion plugin Tracking hands and fingers with Leap Motion
Interface plugin Create a project with the Interface plugin.

Add-Ons#

The project can be created including any add-on available in the Add-Ons tab. All required add-ons can be added both on and after project's creation.

Specifying Add-Ons on Project's Creation#

To create the project with an add-on:

  1. Download the required add-on in the Add-Ons tab by clicking Install.

    Notice
    Any amount of add-ons could be added to a project afterwards.
  2. On the project creation, specify the add-ons to be included by clicking the Add-ons (0) button.

  3. Drop the required add-ons from the Available field to In Use. You can add any amount of add-ons to the project. After all add-ons are dropped, click Ok.

    Notice
    If you haven't downloaded the add-on, click Manage installed add-ons. You will be redirected to the page with available add-ons.
  4. Click Create New Project. To enable added add-ons in the project, you should follow instructions on each add-on.

Specifying Add-Ons for Existing Project#

To extend an existing project with add-ons:

  1. Download the required add-on in the Add-Ons tab by clicking Install.

    Notice
    Any amount of add-ons could be added to a project afterwards.
  2. Click Other Actions -> Configure Project.

  3. Click the Add-ons (0) button and drag and drop the required add-ons from the Available field to In Use.

    Notice
    If you haven't downloaded the add-on, click Manage installed add-ons. You will be redirected to the page with available add-ons.
  4. Click Ok and then click Update Configuration.

Adding Existing Project#

To add an existing project to the browser:

  1. Click Add Existing in the Projects tab.

  2. In the file dialog window that opens, specify the path to the project folder and click Import Project. The project will appear in the projects list.

Notice
If the added project was created in the SDK of a previous version, it will be marked with the Upgrade available label.

Upgrading Existing Project#

Projects that require upgrade are marked with the Upgrade available label:

To upgrade your project to the newest installed version of UNIGINE SDK:

  1. Click this label or Other Actions -> Configure Project. The following form will open:

  2. Choose the newest installed version of the SDK and click Update Configuration.
  3. Specify a path to the backup folder into which the original project will be copied. Leave Migrate Content checked and click Upgrade Project.

The project will be upgraded automatically. You can also manually upgrade the project by running the upgrade script. In both cases, the same script will be used.
Notice
The source code should be upgraded manually by using the Migration Guide.

Running Project with Default Settings#

There are several options of running a project with default settings:

  • Run the project without the loaded editor by clicking Run.

  • Run the project with the loaded editor by clicking Edit Content.

Notice
Clicking Edit Content will only launch the Editor, you will have to load the world manually: via the console, via the File -> Open World in the Menu Bar of the UnigineEditor, or by double-clicking the *.world file in the Asset Browser.

You can also use launchers created by default in the project folder:

  • launch_debug — the launcher of the project's debug version.
  • launch_editor — the launcher of the project's with the loaded editor.
  • launch_release — the launcher of the project's release version.
  • launcher — the startup file for the launcher that provides a GUI to configure application options and run the application. This launcher can be customized and used in the release version of your project. To create a project with the launcher, check the GUI-based settings configurator box in the project's creation window.

Running Project with Custom Settings#

There are also several options of running project with custom settings:

  • Run the project without the loaded editor by clicking an ellipsis under the Run button:

    In the Customize Run Options form that opens, set the required values and click Run.
  • Run the project with the loaded editor by clicking an ellipsis under the Edit Content button:

    In the Customize UnigineEditor Options form that opens, set the required values and click Edit.
Notice
Clicking Edit Content will only launch the Editor, you will have to load the world manually via the console or via the File -> Open World in the main menu of the UnigineEditor.

Customize Run Options#

Via this form, the project without the loaded editor can be run with the custom settings.

Depending on the value of the Application option, different sets of options are available:

  • Default — the default main application (<project_name>_x*.exe) will be run:

    The default main application should be used when only UnigineScript is used to implement the project. In this case, the following options can be customized:
    Debug Indicates whether debug or release version of the application should be run.
    Arguments Start-up command-line options.
    Remember Indicates whether to remember the specified custom settings for future run or not.
  • Custom — a custom main application will be run:

    This option should be chosen if the C++ or C# API is used to implement the project (besides UnigineScript). In this case, the following options can be customized:
    Binary Name of the custom main application. Here the name of the compiled binary executable located in the bin folder of the project should be specified. If the binary executable is located outside this folder, a path to it relative to the bin folder should be specified.
    Arguments Start-up command-line options.
    Remember Indicates whether to remember the specified custom settings for future run or not.

Customize UnigineEditor Options#

Additional arguments Start-up command-line options.
Debug The editor version (debug or release) that will be used for project's editing.
Remember Indicates whether to remember the specified custom settings for a future run or not.

Editing Project#

To open the project for editing:

  • On Windows, click Edit Code:

    The project will be opened for editing in an associated tool. To change a tool, click an ellipsis under Edit Code. By default, the following form will open:

    Choose Custom in the drop-down list and specify a path to a custom tool (e.g. IDE or editor) with required arguments:

  • On Linux, click Open folder and then edit code in an associated tool:

See the articles in the Programming Overview section to learn how to edit the opened project.

Other Actions#

When clicking the Other Actions button, the following form opens:

Configure Project Change project settings.
Open Folder Open the project folder.
Delete Delete the project.

Updating Project Configuration#

When clicking Other Actions -> Configure Project, the following form opens:

Via this form, you can change settings of an existing project: the UNIGINE Engine build used for the project, the version of the release application, the coordinates precision, and the general settings. This option should also be used when you need to upgrade the existing project to the newest SDK version.

Moreover, you can restore the project's files that were corrupted, missed, or mistakenly modified. For this, you should leave settings in the form unchanged and press the Update Configuration button. In this case, the following files of the project will be restored (they will be copied from the SDK):

  • Binaries
  • core.ung, editor.ung and scripts.ung
  • Launchers
Notice
If some of the files listed above are changed, the .modified postfix is added to names of such files. At that, the files from the SDK will also be copied.
Last update: 2019-12-25
Build: ()