Hierarchy Container | This node encapsulates the functionality of any number of Hierarchy (and bound Content) nodes to a single Hierarchy node. | |
Output | This node provides the possibility to link objects to Hierarchy Containers. Must be placed inside the Hierarchy Container. | |
Content Container | This node encapsulates the functionality of any number of Content nodes to a single Content node. | |
Container Info | This node provides information about the name and link index of a Hierarchy Container node. |
Containers are most likely the single most important node when it comes to building large scenes in Ventuz. They can be used to encapsulate a set of nodes, thus hiding complexity and creating new types of customized meta-nodes. For more information on working with Containers and Outputs, see Containers and Interfaces.
The Container Info node is a content node that provides information about the container that it is located in. This can be useful to change the containers behavior depending on what context it is used in.
The Name property of course contains the name of the Hierarchy or Content Container it is located in. If the Container Info node is used outside any container and the scene is used inside a Scene Port, the name property will be set to the name of the scene port. If the name ends in a number, the NameText property will contain everything up to the digits and the NameIndex the number composed by those digits (i.e. "Test2" becomes "Test" and "2").
If inside a Hierarchy Container, LinkIndex will contain the position the Container is used in with respect to its parent (so 5 if it is the 5th child node). TopLevel is true if the Container Info node is neither in a Hierarchy nor a Content Container - which means Scene Level. The Blocked property indicates that the Info node resides in a Hierarchy Container which is blocked. Note that a Hierarchy Container is in blocked state if a superior node or hosting container is blocked!
NestedScene and NestingLevel relate to the use of Scene Ports. If the Container Info node is in a scene that is used inside a Scene Port, NestedScene will be true. The NestingLevel will indicate how many cascaded Scene Ports are used to load the scene the Container Info Node is in. Since a scene is always part of a Layout Scene, this will start at 1. If the Container Info node resides in a Layout Scene the NestingLevel is 0. This property returns -1 if the Container Info belongs to scene which is not connected to the rendered main Scene tree.