AutoMovie API
    Preparing search index...

    Interface IAutoMovieHingedArticulation

    The articulation hingedArmArticulation chose for an arm reach, with its range-of-motion cost.

    Every candidate the solver scores lands the hand on the reachable shell toward the target, so the choice among them is legality first and then the least clinical deviation from the anatomical neutral. reachPose lowers upper and lower into clinical angles for the shoulder and elbow. Its branch and swivel are the seed a fit of a nearby target continues from (IAutoMovieSwivelNear).

    interface IAutoMovieHingedArticulation {
        branch: number;
        deviation: number;
        lower: IAutoMovieQuaternion;
        overshoot: number;
        second?: number;
        shortfall: number;
        swivel: number;
        upper: IAutoMovieQuaternion;
    }

    Hierarchy (View Summary)

    Index
    branch: number

    The bend branch: its index in hingedArmSwivel.branches.

    deviation: number

    The chosen candidate's exact deviation, the scorer's tie-break after the overshoot.

    Bone-local articulation delta for the mid joint (the elbow): a pure rotation about that joint's own flexion axis, so its abduction and twist decompose to exactly zero.

    overshoot: number

    Total ROM overshoot of the chosen candidate in degrees, 0 when the pose satisfies both joints. Reported rather than hidden: a rig whose declared ranges genuinely cannot hold any pose that reaches the target must still say so, instead of the solver quietly returning its least-bad attempt as if it were clean.

    Infinity when the scorer found a violation with no measurable overshoot, which jointRomOvershoot reserves for a non-finite angle: unusable rather than free, so a malformed candidate can never win the selection.

    second?: number

    The chosen candidate's second key (the scorer's tiebreak), when the sweep has a tie.

    shortfall: number

    Metres the effector rests short of (or past) the target along the line from the chain root, because the target distance lies outside the chain's span or the mid joint stopped at a limit of its own range; 0 when a legal hinge angle reaches the distance.

    swivel: number

    The swivel about the chain's root-to-effector line, degrees (hingedArmSwivel.pose).

    Bone-local articulation delta for the chain-root joint (the shoulder).