AutoMovie API
    Preparing search index...

    Variable armChainFaultConst

    armChainFault: (
        skeleton: IAutoMovieSkeleton,
        side: "left" | "right",
        jointAxes?: Partial<Record<AutoMovieHumanoidBone, IAutoMovieJointAxes>>,
    ) => IAutoMovieArmChainFault | null = ...

    Why the analytic arm IK cannot articulate one arm chain of skeleton, or null when it can.

    HUMANOID_JOINT_AXES puts the arm's flexion on local +Y because the canonical humanoid rests in the VRM T-pose with its arms along local ±X. On a rig whose forearm rests along that flexion axis, such as arms hanging along −Y, elbow flexion only rolls the forearm about its own length: the hand never moves, the chain has one reachable radius instead of a shell, and no reach can be solved. This function reports that rig, naming the lower arm and both directions in reason.

    The test reads the rig, not a pose name, because a retargeted quadruped's front legs ride the arm chains and may legitimately rest along −Y. Callers therefore ask it only where an arm verb is performed: the perform-shot gate refuses the verb with this reason, and reachPose returns null.

    null also answers every case that is not this fault: a missing hand, a hand not parented to the lower arm (its rest offset is then not in the elbow's frame), a zero-length forearm, and an axis table with no or a zero-length elbow flexion axis. reachPose reports the structural cases itself as a chain it cannot measure.

    Type Declaration