ConstRig whose arm chain is read; only rest offsets are used.
Which arm to test.
OptionaljointAxes: Partial<Record<AutoMovieHumanoidBone, IAutoMovieJointAxes>>
Per-bone clinical axes; defaults to HUMANOID_JOINT_AXES,
the table every arm computation applies, under any axes the lower arm
declares itself.
Why the analytic arm IK cannot articulate one arm chain of
skeleton, ornullwhen it can.HUMANOID_JOINT_AXESputs 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 inreason.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.nullalso 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.