AutoMovie API
    Preparing search index...

    Interface IAutoMovieHumanLimbGoal

    An arm or leg effector goal with its bend direction, optional contact constraints and reference configuration. Coordinates are world metres unless on names the posed bone frame; resolveHumanPosture admits attachment order and fits the goal.

    interface IAutoMovieHumanLimbGoal {
        bend: IAutoMovieVector3;
        clear?: readonly IAutoMovieMotionHumanColliders.IPlaced[];
        clearanceOn?: IClearance;
        contact?: IAutoMovieVector3;
        elbow?: Elbow;
        limits?: readonly IAutoMovieHumanEffectorPointLimit[];
        on?: AutoMovieHumanoidBone;
        planted?: boolean;
        point: IAutoMovieVector3;
        reference?: IAutoMovieHumanLimbReference;
        rests?: readonly IAutoMovieMotionHumanColliders.IPlaced[];
        rotation?: IAutoMovieQuaternion;
    }
    Index

    A world point the middle joint (elbow or knee) bends toward.

    Another body's colliders, placed in the world, an arm keeps clear of on its way and at its goal (a partner whose head, cheek or back the hand is sent to): its forearm keeps the clearance it keeps from its own trunk, except that the wrist's own depth in them excuses nothing, since no goal put the wrist inside another person (HumanArmClearance). Ignored on a leg.

    clearanceOn?: IClearance

    Collider frames of a rigidly carried partner in this goal's on frame.

    The contact the hand or foot turns about, in its rest frame relative to its joint (a heel, a ball, a palm): when rotation cannot be met exactly within the limb's range, the end joint is re-aimed so this point stays where the goal puts it, and the rotation gives way, as a foot pivots on its ball.

    elbow?: Elbow

    Where an arm's elbow goes when the law leaves it to the body: "strain" takes, among the places that leave the hand's rotation error least, the one where the arm strains least, read from the fit's own sweep (AutoMovieMotionHumanBend.strainOf), with bend serving only where no place is legal. "placed" says bend is itself the elbow's place, which the law's own elbow search chose (AutoMovieMotionHumanBend.solve): the fit takes the swivel that puts the elbow there, refined locally, and sweeps only where that is not legal, so the place is searched once. Absent, bend decides; a leg ignores it.

    Points in the end joint's own frame whose world positions must remain within their bounds of the asked frame. Requires rotation. These hard task limits accompany the contact when a path is planned; a held tool names both ends of its working line.

    The bone the goal is attached to, when it moves with the body rather than staying in the world: point and bend are then in the bone's posed frame (relative to its posed world position and rotation) and rotation composes after the bone's. The resolver carries them into the world from the pose being fitted, after the trunk, the head, any layer and any transition offset have placed the bone, so a palm on the chin or in a pocket stays there when breathing or a glance moves the body. A limb attached to another limb's bone is fitted after it; a bone of the limb's own chain, or two limbs attached to each other, is refused (resolveHumanPosture.order, resolveHumanPosture.world).

    planted?: boolean

    Whether the limb bears on a fixed contact the transition must not move.

    Where the end joint (wrist or ankle) goes, world metres.

    The limb's own solution at one instant of the action the law names (the grasp, the clasp, the placement): the clinical angles of its upper and lower bones there, as resolveHumanPosture.reference reads them. Where the goal can be met by more than one arm or leg configuration, the fit keeps the one nearest this reference, so the limb stays on one side of the choice for the whole stroke. It is a constant of the plan, never a previous frame, so the pose stays a function of time alone. A degree of joint turn from the reference counts like a degree of hand or foot rotation error, so a law gives it in full from the named instant on (the hold after a grasp) and, over the reach toward that instant, raises its weight from 0 to 1 with the reach's own progress: the reference is that instant's solution, so the reach arrives at it exactly, and on the way the growing weight keeps the limb on the reference's side where two configurations nearly tie instead of letting it switch between them.

    Another body's colliders, placed in the world, the goal lays the hand on (the partner's segment a palm rests on): the forearm keeps clear of them as of clear, except that near the wrist it asks no more room than the goal gives, since the goal puts the hand on their surface (HumanArmClearance). Ignored on a leg.

    The hand's or foot's world rotation from its rest, when the law sets it.