Exactly one placement for every script cast member and none for any other node.
Cameras available to the shot and its coverage takes. Staging accepts an empty list, but performShot refuses a shot whose staged scene has no camera to frame it.
OptionalenvironmentImage lighting, exposure, tone mapping and shadow policy, checked against these lights by validateSceneEnvironment and lowered verbatim. Omitted leaves those decisions to the host renderer.
OptionalfogThe set's fog specified by density, range-checked and lowered verbatim. Author this field or fogVisibility. Omit both for a scene without fog.
OptionalfogCalibrate the set's fog by the fraction of the subject color retained at a reference camera-axis depth. Staging solves the FogExp2 law for a finite scene density. Use either this field or fog.
Positive finite reference camera-axis depth in metres.
Linear fog color approached as transmittance decreases.
Finite fraction of subject color retained at that depth, in (0, 1]. One produces zero fog density.
Physical light declarations lowered into the deterministic scene.
Human-readable geometric rationale retained beside the authored values; stageScene does not read it.
Stable scene identity, with a non-blank id, cited by every registered shot that uses this set.
OptionalsetOptional unrigged set geometry, lowered to motionless scene nodes.
OptionalspaceWalkable surfaces whose geometry drives grounding and locomotion checks, checked by validateSpace and lowered verbatim. Omitted lowers to space: null, the scalar ground plane.
The coding-agent-owned set before a shot is performed.
This is an engine input. Positions and couplings stay declarative so
stageScenecan validate identities and lower the set into deterministic scene data. Node ids must be non-blank and unique across actors, set pieces, cameras and lights.