AutoMovie API
    Preparing search index...

    Interface IAutoMovieActorContext

    Borrowed per-actor inputs to the reference action synthesizer: skeleton id, named gaits, staged metre position, ground speed, +Y facing, eye height and rest articulation. Optional rig and clinical rest frames enable constrained gaze and arm/reaction solves.

    interface IAutoMovieActorContext {
        eyeHeight: number;
        facingDeg: number;
        gaitPhase?: number | null;
        gaits: IAutoMovieGait[];
        position: IAutoMovieVector3;
        restFrames?: Partial<Record<AutoMovieHumanoidBone, IAutoMovieRestFrame>>;
        restPose: IAutoMoviePose;
        rig?: IAutoMovieSkeleton;
        skeleton: string;
        speed: number;
    }
    Index
    eyeHeight: number

    Finite vertical eye offset in metres for gaze origin and staged actor aim targets; animated eye FK is not represented.

    facingDeg: number

    Finite degrees about +Y, zero facing +Z; staged synthesis supports this rigid heading rather than arbitrary affine placement.

    gaitPhase?: number | null

    Seconds into the looping gait cycle at the opening beat; omitted or null starts at the cycle beginning.

    Borrowed available cycles; reference synthesis rejects duplicate names and looks up exact action gait names.

    Staged actor ground origin in world metres; a verified prior beat can replace it with its carried translation.

    restFrames?: Partial<Record<AutoMovieHumanoidBone, IAutoMovieRestFrame>>

    Optional clinical sign/neutral frames for arm IK, paired with the same convention in playback; omitted entries use reachPose's canonical humanoid rest frames rather than raw rest-relative angles.

    restPose: IAutoMoviePose

    Borrowed clinical articulation used by hold and seeded into gait bones that the cycle does not drive.

    Optional matching skeleton geometry and clinical constraints; arms/reactions require it, gaze distributes over its neck/head ranges when present and otherwise uses its existing single-head fallback.

    skeleton: string

    Id shared by the actor's poses, gaits and optional rig.

    speed: number

    Positive finite ground speed in metres/second used for locomotion sizing, not vertical travel speed.