Skip to content

Scenes #

Scenes serve as containers for scene objects such as geometry groups and materials. They describe the content of a three-dimensional space and are essential for all ray-tracing based instructions.

Static Scene#

A static scene is set up once and maintains its contents over time. Scene objects can be added to it either using the dedicated Add Objects instruction or during ray-tracing based instructions. These objects remain in the scene until they are replaced or removed.

Multiple static scenes can coexist, each distinguished by a unique name. This name is important for identifying different static scenes in external viewports.

Temporary Scene#

If an instruction that needs scene objects is run without a static scene, a temporary scene is created. This scene temporarily holds objects for that specific instruction and is deleted once the instruction completes. Temporary scenes are separate from static ones and don't need names.

Info

For better performance and reduced data transfer, it's advisable to use static scenes when repeatedly running commands on the same scene objects.