AutoMovie API
    Preparing search index...

    Interface IAutoMovieMotionHumanActionContext<P>

    Everything one action instance plans from: whose body, with which parameters and skill, entered from which state, at which film second, and how to find its targets and its seeded draws.

    start is the film second of the action's own time zero; an action entered at a later share of itself (a redirect continuing its family's clock) starts before its entry. aim resolves a target to a world point and outward normal at a film second: a person's region on that person's displayed body, a prop's named point, a free point, or the virtual opponent of none. random returns the stream of one channel of this instance, keyed by the chain seed, the subject, the action's id and its instance.

    interface IAutoMovieMotionHumanActionContext<P = object> {
        attributes?: Readonly<
            Partial<Record<IAutoMovieMotionHumanAttribute.Name, number>>,
        >;
        body: IAutoMovieMotionHumanBody;
        carrier?: IAutoMovieMotionHumanActionContext.ICarrier;
        entry: IAutoMovieMotionHumanEntryState;
        handover?: IHandover;
        instant?: IAutoMovieMotionHumanActionContext.Instant;
        params: P;
        skill: IAutoMovieMotionHumanSkill;
        start: number;
        subject: string;
        tempo?: number;
        action(anchor: string): IAutoMovieMotionHumanPlacedAction;
        aim(
            target: IAutoMovieMotionTarget,
            seconds: number,
        ): { normal: IAutoMovieVector3; point: IAutoMovieVector3 };
        cue(track: string): readonly IAutoMovieScheduleCue[];
        demands?(grip: IAutoMovieMotionHumanActionLaw.IGrip): readonly IDemand[];
        forces?(from: number, to: number): readonly IAutoMovieMotionHumanForce[];
        meeting(
            kind: IAutoMovieMotionMeetingKind,
            role: string,
            partner?: IPartner | readonly IPartner[],
            window?: IAutoMovieMotionMeeting.IWindow,
        ): IAutoMovieMotionMeeting;
        obstacles(): readonly IAutoMovieMotionHumanObstacle[];
        performer(subject: string): IAutoMovieMotionHumanPerformerReader;
        prop(subject: string): IAutoMovieMotionHumanPropReader;
        random(channel: string): IAutoMovieRandom;
        series(channel: string): IAutoMovieMotionHumanActionContext.ISeries;
    }

    Type Parameters

    • P = object
    Index
    attributes?: Readonly<
        Partial<Record<IAutoMovieMotionHumanAttribute.Name, number>>,
    >

    The performer's group attributes (IAutoMovieMotionHumanPerformer.attributes), each in [0, 1]; an attribute absent, or the whole record absent, reads as its neutral value.

    The performer's body.

    The action this one is performed over, when it is an overlay: a wave during a walk. The carrier keeps the root and the legs and whatever else it does not yield; this action writes only the channels it claims, on the carrier's posture of the same instant. Absent for an action that carries the body itself.

    entry

    The state the action is entered from.

    handover?: IHandover

    The arm solutions handed between the plans of this one action: the solutions the last plan of the same action in the same performance reached (an alignment trial's, a replan's over another span), by the arms solved together, and the map this plan's solutions are written into for the next. A plan's arm groups read and write it (AutoMovieMotionHumanArmPlanned.together); a solution handed on is only the start of the next solve, which admits its own result. Absent, every solve starts from its course.

    The film second of an earlier anchor or cue, when planning in a performance.

    params: P

    The action's parameters.

    The performer's resolved skill.

    start: number

    Film second of the action's time zero.

    subject: string

    The performer's subject id.

    tempo?: number

    A factor on every span of the action that physics does not fix, over its manner's own tempo (AutoMovieMotionManner.of): 1 when absent, and more where the action is replanned to take the time its planned motion needs within the speed bound (Hollerbach 1984's time scaling, applied where the action is placed).

    • One of the film's cue tracks (IAutoMovieMotionHumanPerformance.IInput.cues): its named instants in film seconds, in the track's order, so a law can place its own beats on a score's or its stresses on a line's (a dance's steps on the beats, a nod on an accent). It may be read at plan time. A law that only needs to start at a cue is synced by its composition instead.

      Parameters

      • track: string

        The track's name.

      Returns readonly IAutoMovieScheduleCue[]

      The track's instants, each with its event name and film second.

      A participant refusal when the performance has no such track.

    • The forces on this performer in a span of this action (IAutoMovieMotionHumanPerformance.IInput.forces, #3429): impulses and sustained forces, known before the action plans because they are inputs. A reaction reads them to size its response; none acts by itself. Absent on a context built outside a performance.

      Parameters

      • from: number

        Seconds since the action's start.

      • to: number

        Seconds since the action's start, at least from.

      Returns readonly IAutoMovieMotionHumanForce[]

      The forces, in the order the performance was given them.