ConstClinical angles in degrees; null axes are at rest.
Optionalaxes: IAutoMovieJointAxes
Clinical axis basis; defaults to DEFAULT_JOINT_AXES.
Optionalframe: IAutoMovieRestFrame
Rest frame mapping clinical angles to rest-relative ones; omitted, the angles are already rest-relative.
Convert a joint's clinical flexion, abduction and twist, in degrees, into one bone-local rotation quaternion.
Flexion turns about
axes.flexion(default local X, sagittal), abduction aboutaxes.abduction(default Z, frontal) and twist aboutaxes.twist(default Y, the bone's long axis). The composition followsaxes.twistPlacement. A proximal twist, the default, turns the swing axes with it, as the head turns below its nodding joint:A distal twist turns the moved segment about its own long axis before the swing, as the forearm pronates beyond the elbow, so a pose without twist is the same rotation in either placement:
A declared flexion-abduction-twist order takes precedence over twist placement and uses the rig's clinical vectors in the ISB hip sequence (https://www.isbweb.org/standards/hip.pdf, Hip Order of Rotation):
axeslets a rig whose bone frames are not aligned to the clinical planes keep flexion sagittal, such as a T-pose arm that needs flexion about Y. Anullangle contributes no rotation. With aframe, each angle is read as clinical and mapped to the rig's rest-relative angle,r = (clinical − neutral) / sign, so one clinical convention serves both sides of a mirrored rig. decomposeJointRotation is the inverse for the sameaxesandframe.Throws on a non-finite angle, an invalid axis basis (see normalizeJointAxes), or an invalid frame sign or neutral.