Version

The scene object contains your world and its content.

A scene is populated with Node. Scene and Node properties are determined by the Component attached to them.

Node components

By default, a node with no component attached is a dummy node and serves no purpose. It exists in the scene list of node but holds no properties beside its name and a unique identifier.

To provide a node with useful characteristics Component must be attached to it using the AddComponent method.

The most common node component types are:

  • Transform: Provides the node with a transformation so that it can be positioned in space.
  • Camera: Implement the required properties for the node to act as a camera.
  • Light: Implement the required properties for the node to act as a light.
  • Object: Associate a node and a RenderGeometry in order to display a 3D model at the node position.

There is no restriction on how you can mix and match components over a single node. A component instance can however only belong to a single node at any given time.

There are many other built-in components available for navigation, sound and various visual effects. See the Component inherited by list for the complete list of available components.

For more specific needs the Script component provides a way to customize a Node behavior using the Lua scripting language. The Script component page describes this component in greater details.

Scene components

The most common scene component types are: