This page has been translated automatically.
Video Tutorials
Interface
Essentials
Advanced
How To
Professional (SIM)
UnigineEditor
Interface Overview
Assets Workflow
Settings and Preferences
Working With Projects
Adjusting Node Parameters
Setting Up Materials
Setting Up Properties
Lighting
Sandworm
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.

Layer

A   layer is a zero-sized node that has no visual representation and enables to save all its child nodes into a separate .node file. Layer nodes should be used as containers for editing the other nodes in the world: you can split the world into several logical parts and save each of them in a .node file. It will enable to facilitate collaborative work on one project by eliminating conflicts arising from simultaneous editing of this world by several people.

Warning
DO NOT use multiple layer nodes referring to the same .node file! This leads to conflicts when saving changes. If you want to have several instances of .node file contents, please use Node References.

World Nodes Grouped into Several Layers
Notice
All changes made in child nodes of a layer node will not affect the source .world file.

The contents of a layer depend on the hierarchy structure: to become part of a layer, a node should be assigned to it as a child. In the World Nodes Hierarchy window, a layer node is displayed as a usual node that can be transformed, cloned and so on.

Layer nodes are especially convenient when using the VCS, because by merging the project modifications there will be no need to match the conflicted files.

Notice
Using layer nodes won't prevent conflicts if the same layer is simultaneously edited by several people.

Unlike a Node Reference, a layer node can contain more than 1 node of the same level in the hierarchy.

See also#

Adding a Layer Node#

To add a new layer via UnigineEditor do the following:

  1. Run UnigineEditor.
  2. On the Menu bar, click Create -> Node -> Layer.

  3. In the Save Node file dialog window that opens, specify a name for the .node file into which child nodes of the layer will be saved.
  4. Place the layer node in the world.

  5. Add child nodes to the layer node: select the required nodes and drag the nodes inside the layer node:

Editing a Layer Node#

Changes made in the child nodes of the layer node are saved on the disk when:

  • Clicking Save in the Node tab of the Parameters window.
  • Saving the world via File -> Save World or by pressing Ctrl+S.

In both cases only the .node file will be updated.

Node Tab

The .node file contains all child nodes of the layer node. All changes made in child nodes of the layer node do not affect the source .world file.

Notice
The layer node itself is not stored in the .node file.
Last update: 2022-12-14
Build: ()