AutoMovie API
    Preparing search index...

    Interface IAutoMovieScene

    A scene: placed characters, cameras, and lights, the top-level container the viewer plays and the renderer bakes frames from.

    The scene is the composition layer above individual rigs: it says where characters stand, what they are doing (which motion/pose), and how the frame is lit and framed. A structured building owns rooms and lowers the world transforms of its visible elements here, while actors and props remain ordinary scene nodes in that same frame.

    interface IAutoMovieScene {
        cameras: IAutoMovieCamera[];
        environment?: IAutoMovieSceneEnvironment | null;
        fog?: IAutoMovieFog | null;
        id: string;
        lights: IAutoMovieLight[];
        name: string | null;
        nodes: IAutoMovieSceneNode[];
        space?: IAutoMovieSpace | null;
    }
    Index
    cameras: IAutoMovieCamera[]

    Cameras; the first is the default render viewpoint when unspecified.

    environment?: IAutoMovieSceneEnvironment | null

    Optional physical render environment; omitted preserves legacy output.

    fog?: IAutoMovieFog | null

    The scene's atmosphere: exponential distance fog (IAutoMovieFog), the depth cue an exterior needs and the only one that costs no particles.

    Absent or null means no atmosphere, and a scene that says nothing about fog renders exactly as it did before the field existed: the viewer leaves scene.fog unset and every offline consumer derives a transmittance of one. Optional (?) rather than required for the same evolving-schema reason space is, so no committed scene has to be rewritten.

    applySceneFog constructs FogExp2 from this declaration; sceneFogTransmittance predicts the same squared camera-depth law in binary64. Shader precision, rasterization and appearance processing can differ, so the shared formula does not certify identical rendered pixels or numbers. Structural guide passes suspend fog to preserve their geometry channels.

    id: string

    Stable id.

    lights: IAutoMovieLight[]

    Scene lights.

    name: string | null

    Human / LLM readable name. Null if unnamed.

    Placed characters and what each is doing.

    space?: IAutoMovieSpace | null

    The scene's space: standable surfaces and walkability (#605). Absent or null means no declared space: the engine falls back to the scalar ground plane it assumed before the space layer existed. Optional (?) rather than required so every pre-space scene stays valid, the evolving-schema pattern IAutoMovieShot.events uses.

    Staging authors it (IAutoMovieStage.space); the low-level viewer builder tessellates each nondegenerate patch for structural passes. Its ordinary material writes no beauty colour or depth, because semantic support does not establish that an authored physical floor exists. Heightfield interiors are planar triangle approximations of the bilinear height law.