Scene, Objects and Containers

The collection of all virtual objects rendered by the app at any time is called a Scene.

Scene Objects are visible parts of the scene. They are virtual 3D objects that a user can interact with. Scene objects usually have various kinds of properties that can be manipulated programmatically, changing their appearance in some way. Properties can affect object’s materials (e.g. upholstery of a sofa), geometry (e.g. width of a table), or even transitions between states (e.g. opening and closing of an awning). These properties are defined by models.

Containers are organisational units of the scene. There are two kinds of containers.

Grouped Containers encapsulate their children and make them behave as a single object with respect to interaction. This feature is used for creating complex objects using other scene objects as parts.

Ungrouped Containers do not encapsulate their children, allowing app users to interact with them separately. This is useful for logical grouping of scene objects. Scene itself is an ungrouped container. Ungrouped containers cannot be interacted with, but they can still be manipulated programmatically by changing their pose, visibility, etc..