Scene

Regardless of its location in your script, the Scene node is the highest-level node in the scene hierarchy because it references all the elements in a 3D workspace - all the geometric objects, cameras, and lights.

Every Scene node in a script should be connected to a ScanlineRender, RayRender, or PrmanRender node, which render the results of the scene.

Inputs and Controls

Connection Type

Connection Name

Function

Input

[numbered inputs]

3D objects, Lights, Cameras, and materials. You can connect any number of nodes to a Scene node.

Control (UI)

Knob (Scripting)

Default Value

Function

Scene Tab

display

display

unchanged

Adjust the display characteristics of the 3D objects attached to the node. These settings don’t affect the render output of the scene; these are for display purposes only in the 3D Viewer.

off - hides the 3D geometry object.

wireframe - displays only the outlines of the object geometry.

solid - displays all geometry with a solid color.

solid +wireframe - displays the geometry as solid color with the object geometry outlines.

textured - displays only the surface textures.

textured +wireframe - displays the wireframes plus the surface textures.

unchanged - doesn't change object display modes.

selectable

selectable

enabled

When enabled, you can make selections as normal in the Viewer. When disabled, points cannot be selected or changed.

render

render_mode

unchanged

Sets how objects connected to the scene will render. This control is independent from the display selection, but has the same settings.

shadow

shadow_override

unchanged

Determines whether geometry nodes in the scene remain unchanged, or are adjusted to override inputs. If the latter option is chosen, you can set shadow options for all the geometry in the scene.

cast shadow

cast_shadow

disabled

If the shadow operation is set to override inputs, cast shadow enables the geometry to cast shadows on other objects.

receive shadow

receive_shadow

disabled

If the shadows operation is set to override inputs, receive shadow enables the geometry to have shadows cast on it by other objects, provided a materials shader has been attached to the object.

Step-by-Step Guides

The Scene Node

Video Tutorials