AutoMovie API
    Preparing search index...

    Finalized shot data borrowed by compilePerformShotCameras to produce hero movement, lens intent, alternate takes and clearance reports.

    The live camera's frame moves, already sorted by start, compile through compileCameraMove into the clip cam:<scope>; with no move the camera is locked off and the clip is null. Each move's intent carries its framing, move, focal length and focus, the focus resolved to the world point the input gate accepted; the solve never reads the intent, a render host does. Each coverage job plays its one framing across the whole beat from its own staged camera, as the clip cam:<scope>:<camera>, so a host can cut to the angle at any instant, with no focus or focal length invented for it. Every subject is measured by one createPerformShotSubjectFramer, so hero and coverage frame the same subject. compileCameraClearanceReports then reports any take whose physical envelope is obstructed into the context's collector.

    type IProps = {
        aspect: number | undefined;
        coverageJobs: readonly IAutoMoviePerformShotCoverageJob[];
        formationMotions: readonly IAutoMovieFormationMotion[];
        frames: readonly IAutoMoviePerformShotFrameJob[];
        liveCamera: string;
        models: readonly IAutoMovieModel[] | undefined;
        motions: Record<string, IAutoMovieMotion>;
        objectMotions: readonly IAutoMovieClip[];
        rotations: ReadonlyMap<string, IAutoMovieQuaternion>;
        runtime: IAutoMovieCameraClearanceRuntime | undefined;
        scope: string;
    }
    Index
    aspect: number | undefined

    Delivered width/height ratio; undefined uses the camera compiler's square fit, as do non-positive/non-finite values at that lower layer.

    coverageJobs: readonly IAutoMoviePerformShotCoverageJob[]

    Admitted alternate camera jobs in authored order, each covering the entire shot. Empty requests no alternate takes.

    formationMotions: readonly IAutoMovieFormationMotion[]

    Compact formation cues on the shot clock, used when measuring and following group subjects; empty keeps groups at their opening placement.

    Admitted hero moves sorted by action.start in shot-local seconds; empty leaves the camera locked off and intent empty.

    liveCamera: string

    Id of the staged camera elected by gatePerformShotCamera; this compiler assumes the lookup succeeds.

    models: readonly IAutoMovieModel[] | undefined

    Portable staged model catalogue. Undefined behaves as an empty catalogue: framing may use rig/default bounds, while envelope clearance refuses unmeasurable staged obstacles.

    motions: Record<string, IAutoMovieMotion>

    Final actor motions by node id, read without mutation after coupling; absent entries contribute no actor motion.

    objectMotions: readonly IAutoMovieClip[]

    Final object clips in producer/channel-authority order, sampled on the shot clock for framing and clearance.

    rotations: ReadonlyMap<string, IAutoMovieQuaternion>

    Staged node world-facing quaternions, used to place actor root movement; a missing facing prevents the actor-motion following branch.

    Builder-owned geometry revision and clearance clock; required only when a selected camera declares an envelope.

    scope: string

    Clip-id suffix, normally the shot id or otherwise beat id; used verbatim in cam: and coverage ids.