An Object in Incari is any entity which can be added to a Scene. "Object" is a broad term used to describe a number of different components, each with their own purpose, behaviors, and characteristics.
Objects in a Scene are managed in the Scene Outliner.
Prefabs are an important and useful type of Object. They are composed of a combination of Objects and allow the user to create several Instances of this combination, enact changes across all of them, or apply individual characteristics via overrides. For more information, see the Prefabs section.
Creating a Prefab.
In the Logic, it might be necessary to make references to specific Objects. For this, each Object in a Scene gets assigned an Object ID, which is a unique identifier. The Object ID of an Object can be obtained from said Object's Node, which is created by dragging an Object from the Scene Outliner to the Logic Editor.
Creating an Object Node.
The picture below shows an example. Here,
Object1is the parent of
Object2is the parent of
Object3has no children.
Every Scene has a Root Object, which is the parent of all Objects that are on the first hierarchy level. Thus, all Objects in a Scene are descendants of the Root Object. To obtain the Object ID of the Root Object, use the Get Root Node.
In the Scene Outliner, there are three ways to make an Object the child of another:
- Drag an existing Object and drop it on top of the Object that will be the parent.
- Select the Object that will be the parent and create a new Object by clicking the plusicon on the top left and selecting the Object to create as a child.
- Right-click the Object that will be the parent, click on
Createon the drop-down menu that appears and select the Object to create as a child.
Moreover, Objects in the Scene Outliner can be dragged and dropped anywhere in the Scene structure, as can be seen in the following example:
There are a few Nodes that allow the user to obtain and use information about the structure of Objects in a Scene. These are: