AutoMovie API
    Preparing search index...

    Function poseJointCodec

    • The two maps between a joint's clinical angles and its bone-local rotation on one rig, for work that must treat a pose's joints as rotations.

      A joint's [flexion, abduction, twist] is an Euler chart of a rotation: at the chart's gimbal (a hanging arm on a T-pose rig, where the shoulder's abduction is 90 degrees from rest) two of the angles turn about one axis, so nearly equal rotations have far apart triples, and a difference or blend taken per angle swings the bone through poses neither side holds. Differences and blends are therefore taken on the rotation, and the result is lowered to angles once.

      rotation is jointToQuaternion with the rig's axes (a bone's own declaration before the host table, skeletonJointAxes) and rest frame. angles is decomposeJointRotation with the same two and the bone's effective range of motion (getConstraint), so of the equivalent triples it returns the one the range admits best, as the limb fits do. Without a rig both use the default basis with rest-relative angles and the principal chart.

      That holds for a joint free about all three axes. A hinge or a two-axis joint spans a lower-dimensional set of rotations, which a composed rotation leaves, and its angles have no gimbal inside their range; ball tells the two apart so a caller keeps such a joint on its own angles.

      Parameters

      • Optionalrig: IAutoMoviePoseRig

        The rig the angles are read through; the default basis when omitted.

      Returns ICodec

      The forward and inverse maps.