AutoMovie API
    Preparing search index...

    Interface IAutoMovieMotionHumanActionLaw<P>

    One human action as a deterministic law: given its context (the body, the parameters, the skill, the state it is entered from and its targets) it plans its timing, events and contacts once, and its plan gives the posture at any second as a pure function.

    interrupts is the action's closed cancel table, keyed by the action it may cut into: only a cut that falls inside a listed window is legal, and an undeclared cut is refused when the performance is built, with the legal windows in the message, the way fighting-game cancel tables and Unity's interruption sources fire only declared transitions.

    interface IAutoMovieMotionHumanActionLaw<P = object> {
        accepts?: Partial<
            Record<
                AutoMovieMotionHumanActionKey
                | "any",
                readonly IAutoMovieMotionHumanInterruptRow[],
            >,
        >;
        balance?: IAutoMovieMotionHumanBalance;
        family?: AutoMovieMotionHumanActionKey;
        interrupts: Partial<
            Record<
                AutoMovieMotionHumanActionKey
                | "any",
                readonly IAutoMovieMotionHumanInterruptRow[],
            >,
        >;
        name: AutoMovieMotionHumanActionKey;
        overlay?: boolean;
        physical?: boolean;
        yields?: readonly AutoMovieMotionHumanChannelClaim[];
        demands?(ahead: IAhead<P>): readonly IDemand[];
        plan(
            context: IAutoMovieMotionHumanActionContext<P>,
        ): IAutoMovieMotionHumanActionPlan;
        resolve?(given: object): object;
    }

    Type Parameters

    • P = object
    Index
    accepts?: Partial<
        Record<
            AutoMovieMotionHumanActionKey
            | "any",
            readonly IAutoMovieMotionHumanInterruptRow[],
        >,
    >

    The table of what may be cut into this action, where the action itself decides it: source action to the windows of that source a cut may use, any for every source. A reaction to a blow or a threat interrupts whatever the body was doing, so it declares that here instead of every other action listing it. A source's own row for this action comes first; these rows are read when it has none.

    The law's recommended balancing shift (IAutoMovieMotionHumanBalance). An explicit parameter takes precedence. The cited study identifies the affected part and when it contributes. The recommendation applies only when the caller requests balance, and the correction moves that part by the minimum amount its support needs, scaled by the requested weight.

    The action this one is a row of: the same law under another name with some of its parameters fixed, as a salute is a touch. Wherever an action is told apart by what it is (a cancel table's key, a follow-up that continues its own kind, an answer to a kind of attack), a row counts as its family. Absent for an action that is its own.

    interrupts: Partial<
        Record<
            AutoMovieMotionHumanActionKey
            | "any",
            readonly IAutoMovieMotionHumanInterruptRow[],
        >,
    >

    The cancel table: target action to the windows a cut may use. The key any gives the windows a cut into every action may use, for an action a person can leave for anything, as quiet standing is.

    The action's name: a vocabulary name, or the name a production registers the law under.

    overlay?: boolean

    Whether the action can be performed over a carrier (HumanChain.over): it plans on the carrier's posture and claims only the channels its plan names. An action that moves the whole body cannot.

    physical?: boolean

    Whether the action's content is a staged physical outcome (a stagger, a fall, a shove's or a force's response, a throw and a release, a flight): it computes its physics on its own interval and bodies whatever its params' balance says (IAutoMovieMotionHumanBalance), and the audit judges its balance. Absent, the action is kinematic unless its params turn the option on.

    The channels this action lets an overlay take while it carries the body: a walk yields its arms, its hands and its head, so a wave or a phone can be performed during it. A digit yields that digit alone, so an overlay may take a thumb while the other four keep holding. None when absent.

    • The poses this action will hold a prop in, asked before it is planned of the grips an earlier action is still choosing among (pickUp): the action's goal postures, computed from its own parameters by the functions its plan reads, so a grip the earlier action takes for them is one this action holds (goal postures planned first, Rosenbaum, Meulenbroek, Vaughan and Jansen 2001; a task's goal pose as a grasp's constraint). Nothing is planned: the action reads only what is known before it is, with the grip weighed (IAutoMovieMotionHumanActionLaw.IAhead). Empty when the action asks nothing of the grip, or would refuse whatever the grip; absent when it never asks.

      Parameters

      • ahead: IAhead<P>

        What is known of this action before it is planned, and the grip weighed.

      Returns readonly IDemand[]

      The poses the action demands of the grip.

    • The parameters the plan reads, from those the composition gave: a row adds its fixed ones. The performance records and passes on the result, so whatever reads a placed action's parameters reads the whole set.

      Parameters

      • given: object

        The parameters the composition gave.

      Returns object

      The parameters planned from.