AutoMovie API
    Preparing search index...

    Construction input for one deterministic performance: seed, performers, props, composition and optional environmental constraints.

    interface IInput {
        blasts?: readonly IBlast[];
        composition: IAutoMovieComposition;
        cues?: Readonly<Record<string, readonly IAutoMovieScheduleCue[]>>;
        flight?: "physical" | "staged";
        forces?: readonly IAutoMovieMotionHumanForce[];
        laws?: readonly IAutoMovieMotionHumanActionLaw<never>[];
        layers?: Readonly<
            Record<
                string,
                readonly (
                    IAutoMovieMotionHumanLayer
                    | IAutoMovieMotionHumanLayer.IScheduled
                )[],
            >,
        >;
        obstacles?: readonly IAutoMovieMotionHumanObstacle[];
        performers: IAutoMovieMotionHumanPerformer[];
        props?: IAutoMovieMotionHumanProp[];
        rules?: readonly IAutoMovieCheckLegality.IRule[];
        seed: string;
    }
    Index
    blasts?: readonly IBlast[]

    Blasts in the scene: each gives a hit to every person within its radius at its instant (HumanBlast, hits). None when absent.

    What everyone does.

    cues?: Readonly<Record<string, readonly IAutoMovieScheduleCue[]>>

    Tracks of named instants that belong to no action, by track name: a dialogue's line starts and accents, a score's beats (HumanCue builds both). An action is synced to one (HumanChain.sync) and cut on one (until) as on another action's events; a track's name is used like an anchor, so no action may be anchored under it.

    flight?: "physical" | "staged"

    Authored airborne turns use deterministic staged rotation by default, preserving the law's centre path and fitted articulation without claiming angular-momentum conservation. The existing landing pose requires complete revolutions on each axis; nonclosing fractional turns need a compatible landing outcome and are refused. Physical solves turns from the composed body's inertia and take-off limit but does not repair that legacy landing limitation. A flight with explicitly supplied momentum always remains physical.

    forces?: readonly IAutoMovieMotionHumanForce[]

    Forces on the performers (#3429): impulses at an instant and forces sustained over a span, read by the reactions the composition places (IAutoMovieMotionHumanActionContext.forces). A force starts no action. None when absent.

    laws?: readonly IAutoMovieMotionHumanActionLaw<never>[]

    Laws of the production's own, performed like the vocabulary's under the names they carry: an act the vocabulary lacks, written on the same kernel (a clock, a base and part primitives), or a row of an existing law with some of its parameters fixed. A name the vocabulary already has, or one given twice, refuses the performance. A registered law draws from streams keyed by its own name, so registering it changes no other action's draws. HumanChain.extend gives its typed method.

    layers?: Readonly<
        Record<
            string,
            readonly (
                IAutoMovieMotionHumanLayer
                | IAutoMovieMotionHumanLayer.IScheduled
            )[],
        >,
    >

    Additive layers per subject, applied in order over the person's actions: each for the whole film, or scheduled in a window between two instants (IAutoMovieMotionHumanLayer.IScheduled).

    obstacles?: readonly IAutoMovieMotionHumanObstacle[]

    What stands in the performers' way: the scene's walls and solid objects with their openings (HumanObstacle). A law that moves a body across the floor reads them through its context and refuses a path through a solid; none when absent, and then every path is free.

    The people.

    The props actions aim at.

    rules?: readonly IAutoMovieCheckLegality.IRule[]

    The production's legality rules, such as KickboxingRules.rules, checked against the placed schedule with the engine's checkAutoMovieLegality; any violation refuses the performance with every broken rule in the message. None when absent.

    seed: string

    The chain seed every draw starts from.