This page has been translated automatically.
Video Tutorials
Interface
Essentials
Advanced
Полезные советы
UnigineEditor
Interface Overview
Assets Workflow
Settings and Preferences
Working With Projects
Adjusting Node Parameters
Setting Up Materials
Setting Up Properties
Landscape Tool
Using Editor Tools for Specific Tasks
Extending Editor Functionality
Программирование
Fundamentals
Setting Up Development Environment
Usage Examples
UnigineScript
C++
C#
UUSL (Unified UNIGINE Shader Language)
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
Внимание! Эта версия документация УСТАРЕЛА, поскольку относится к более ранней версии SDK! Пожалуйста, переключитесь на самую актуальную документацию для последней версии SDK.
Внимание! Эта версия документации описывает устаревшую версию SDK, которая больше не поддерживается! Пожалуйста, обновитесь до последней версии SDK.

Node Reference

A Node Reference is a node that refers to an external .node file on the disk, which is obtained by exporting a node from the world.

Notice
The world can contain several instances of node references referring to the same .node file.
The .node file usually contains a pre-fabricated node (or a hierarchy of nodes) with links to all materials and properties required for its rendering. All changes made for the Node Reference via UnigineEditor are saved into this file.

The node references should be used if there are a lot of identical objects that are repeated in the world. Using node references enables to avoid manual editing each identical object if you need to make the same changes in all of them. You can simply add several node references that point to one .node file and then edit only one Node Reference in order to update all of them. Such approach enables to hold to integrity of instanced objects, especially if they are complex and sophisticated.

For example, the Node Reference can be used to add identical cars, boats, or buildings that should be updated at once, if necessary.

Boats added as node references

See Also#

  • The Instancing Nodes article to learn more about using node references to create identical objects.
  • The NodeReference class to edit node references via API
  • The Randomizer plugin to work with multiple node references

Creating a Node Reference#

There are two ways to create a Node Reference via UnigineEditor:

  • Add a new Node Reference that refers to an external .node file. In this case, you should export a node into a .node file first.

    On the Menu bar, click Create -> Node -> Reference.

  • Convert a node with all its child nodes present in the nodes hierarchy list into a Node Reference. In this case, the source node will change its type to a Node Reference.

By Importing a New Node Asset#

  1. Click the Import button in the Asset Browser window and choose the desired node in the file dialog window that opens.
  2. Place the Node Reference in the world.

You can repeat Step 2 in order to add the required number of node references. Or you can simply clone the added node: select the Node Reference and press Ctrl+D.

Several node references with the red material applied

By Converting an Existing Node#

  1. Select a node in the World Hierarchy window (or directly in the scene).
  2. On the Menu bar, click Edit -> Convert to NodeReference (or press Ctrl+Shift+G).

As a result, the source node is converted into the Node Reference:

Source node to be converted
Converted node

You can also clone the converted node in order to get the required number of node references.

Notice
If you select several nodes and convert them into a Node Reference, they are saved into a .node file as child nodes of a dummy node.
Source nodes to be converted
Nodes grouped under a dummy node to which Node Reference refers

Editing a Node Reference#

In the Reference section of the Node tab, you can change the asset of the source node or open the ReferenceNode Editor used to edit the source node:

A node asset

To edit the source node, to which the Node Reference points:

  1. Select the Node Reference in the World Hierarchy window.
  2. Click Edit in the Node tab of the Parameters window.

    The source node becomes available in the World Hierarchy window as a child of the Node Reference and can be edited via the Parameters window.

    World Hierarchy window: source node in the edit mode
  3. Edit the source node. For example, you can change the material applied to it:
    Node references with the red material applied
    Node references with the changed material
  4. After all changes are made, select the parent node in the World Hierarchy window and click Apply to save changes to the source node or Cancel changes to keep nodes unchanged.

    Reference section in the Node tab of the parent Node Reference

Deleting a Node Reference#

You can delete the Node Reference the same way as any other node.

Last update: 31.07.2020
Build: ()