AutoMovie API
    Preparing search index...

    Borrowed shot snapshot and caller-owned violation sink for numerical camera-envelope checks.

    The hero take and every coverage take whose staged camera declares clearance are inspected; the others are skipped, and a shot with none returns undefined without reading runtime. Each such take is sampled at cameraClearanceSampleTimes, and every staged node is an obstacle: a node nothing animates is its rest box through its placement (nodeSubjectBox), and an animated one is a box around its current root holding cameraClearanceDeformationRadius scaled by its largest absolute scale component, which stays valid under any rotation or pose. evaluateCameraClearance then sweeps each interval.

    Every refusal is pushed to out with an author-facing path, and the result is then undefined: a hero or coverage camera the scene does not stage, a missing runtime, a sample rate that is not finite and positive, a stale geometry revision (one item per take, before any geometry is read), a morph-weight track, a node whose model is absent, fails validateModel, draws nothing or whose bound overflows, a motion the clock cannot bound, and every contact the evaluator finds. Items already in out belong to the caller and do not count as refusals here. The check covers portable geometry bounds and admitted interpolation, not rendered pixels, external asset bytes or renderer-only deformation.

    type IProps = {
        coverage: readonly IAutoMovieShotCoverage[];
        duration: number;
        hero: { camera: IAutoMovieCamera; motion: IAutoMovieShot["cameraMotion"] };
        models: readonly IAutoMovieModel[];
        motions: Readonly<Record<string, IAutoMovieMotion>>;
        objectMotions: readonly IAutoMovieClip[];
        out: IAutoMovieViolationCollector;
        runtime: IAutoMovieCameraClearanceRuntime | undefined;
        scene: IAutoMovieScene;
    }
    Index
    coverage: readonly IAutoMovieShotCoverage[]

    The shot's coverage takes, each naming a staged camera.

    duration: number

    Finite nonnegative shot length in seconds; zero is a single-instant check. performShot supplies a positive duration, while the evaluator admits zero.

    hero: { camera: IAutoMovieCamera; motion: IAutoMovieShot["cameraMotion"] }

    Hero take; the record itself is always present.

    Type Declaration

    • camera: IAutoMovieCamera

      Camera whose id must occur in scene.cameras; this supplied object's envelope and world transform are used.

    • motion: IAutoMovieShot["cameraMotion"]

      Camera-node tracks on the shot-local seconds clock, or null to retain the staged transform.

    models: readonly IAutoMovieModel[]

    Portable models indexed by model id; every staged node needs a valid measurable model when clearance runs.

    motions: Readonly<Record<string, IAutoMovieMotion>>

    Final actor motion by staged node id, sampled in shot-local seconds and folded through each staged root.

    objectMotions: readonly IAutoMovieClip[]

    Final object clips on the shot clock in channel-authority order; node weight tracks are refused because no morph expansion bound is available.

    Collector that receives every refusal, after any items it already holds.

    Builder-owned revision and clock, required once any take has an envelope.

    The staged scene whose cameras and nodes are read.