AutoMovie API
    Preparing search index...

    Interface IAutoMovieMotionHumanPerformance

    A performance of people and props: their chained actions placed on the film clock, every cut checked against the actions' interrupt tables, and each person's displayed pose a pure function of film seconds.

    Construction resolves the composition with the engine's schedule resolver. Each intent's timing comes from its law's plan, made from the state the performer is in when the intent starts: the previous action's displayed pose and velocity at its cut or end, its posture and its planted feet. A cut (an intent's until) is legal only inside a window of the cut action's interrupt table for the next action; otherwise construction throws with the legal windows. A proximity cut is found by scanning the 24 Hz grid for the first frame within the distance and bisecting 20 times, about 1e-7 s, deterministic on a fixed grid whose last sample is the action's end; a distance never met leaves the action uncut. Given rules, the placed schedule is checked with the engine's legality check and a violation refuses the performance. An input equal to one the process resolved recently reads that resolution again (HumanPerformanceState.of): the resolution is a pure function of its input.

    Sampling a person at a second takes the active action's posture, resolves it to a pose, adds the decaying inertialization offset of the transition that entered it, re-solves every planted or gripping limb onto its goal so no contact slides, and clamps to the range of motion (HumanSegment). A person before their first action stands at their starting place. Additive layers (gaze, breathing) apply over every action without cutting it. While the schedule is resolved, a person's poses may read people whose actions are not placed yet, so nothing is cached until every action is placed; then caches and transition offsets start afresh.

    interface IAutoMovieMotionHumanPerformance {
        duration: number;
        performers: readonly IAutoMovieMotionHumanPerformer[];
        schedule: IAutoMovieSchedule;
        aim(
            target: IAutoMovieMotionTarget,
            seconds: number,
            frame: IAutoMovieMotionHumanPerformanceAim.IFrame,
        ): { normal: IAutoMovieVector3; point: IAutoMovieVector3 };
        bones(
            subject: string,
            seconds: number,
        ): Map<AutoMovieHumanoidBone, IAutoMovieResolvedBone>;
        flights(
            subject: string,
        ): readonly IAutoMovieMotionHumanPropFlight.IFlight[];
        fracture<Piece extends IAutoMovieMotionHumanObject.IModel>(
            request: IAutoMovieMotionHumanPropFracture.IRequest<Piece>,
        ): IAutoMovieMotionHumanPropFracture.IPlan<Piece> | null;
        hits(subject?: string): readonly IAutoMovieInteractionEvent[];
        instant(at: AutoMovieMotionHumanScheduledInstant): number;
        overlays(subject: string): readonly IOverlay[];
        pose(subject: string, seconds: number): IAutoMoviePose;
        posture(subject: string, seconds: number): IAutoMovieMotionHumanPosture;
        prop(subject: string, seconds: number): IAutoMovieRigidTransform;
        segments(subject: string): readonly IAutoMovieMotionHumanSegment[];
        soft(subject: string, seconds: number): number[];
        softLoad(
            subject: string,
            person: string,
            side: "left" | "right",
            seconds: number,
        ): IAutoMovieVector3;
        state(subject: string, seconds: number): Record<string, number>;
    }
    Index
    duration: number

    Seconds from 0 to the last action's end.

    performers: readonly IAutoMovieMotionHumanPerformer[]

    The people, as the performance was given them.

    The resolved schedule.

    • A prop's world frame at a film second: its rest frame until a hand grips it, then carried by the gripping hand with the offset it had when the grip closed, and left where the last grip released it.

      A grip is any action's contact window of kind grip on a hand whose support is this prop. The hand's grip socket rides the hand bone, so the prop is a child of the hand while held: the rigid coupling of the engine's IAutoMovieAttachment, a bone plus an offset, with the offset captured at the grip's start instead of authored. When grips overlap (a handover), the one that closed last carries the prop. A hold an action leaves (IAutoMovieMotionHumanActionPlan.holds) is a grip lasting until a later action takes that hand over. A released prop stays where the last grip to end released it, unless an action launched it: then it flies from the launch and rests where it struck (HumanPropFlight) until a later grip takes it.

      Parameters

      • subject: string

        The prop.

      • seconds: number

        Film seconds.

      Returns IAutoMovieRigidTransform

      Its frame.

    • A soft prop's particle positions at a film second: its lattice solved once over the performance from the displayed poses at its domain's fixed step, and read between the two steps around the second, so a seek costs no solve and every frame rate reads the same state (HumanPerformanceSoft).

      Parameters

      • subject: string

        The soft prop.

      • seconds: number

        Film seconds.

      Returns number[]

      World metres, row-major [x, y, z, ...].

      When the prop is not soft or the performance outlasts its domain's step budget.

    • The force a soft prop pulls a gripping hand with at a film second (HumanPerformanceSoft.load): the compliant solver's force on the particle the hand holds, held over its step.

      Parameters

      • subject: string

        The soft prop.

      • person: string

        The gripping person.

      • side: "left" | "right"

        The hand.

      • seconds: number

        Film seconds.

      Returns IAutoMovieVector3

      Newtons on the hand, world frame; zero when the hand does not hold the prop or its domain declares no compliance.

    • One input per coupled degree of freedom a prop's acts or tracks have moved by a film second (HumanPerformanceObject.state), in the latest begun writer's coordinate. A later writer of another coordinate of the same degree replaces the old one; after its end its last travel holds. A degree absent from the record starts at its leader's zero.

      Parameters

      • subject: string

        The prop.

      • seconds: number

        Film seconds.

      Returns Record<string, number>

      Travel by articulation id, in each articulation's own unit.