AutoMovie API
    Preparing search index...

    Function normalizeJointAxes

    • Validate a joint-axis basis and return it with unit-length axes, ready for quaternion composition and decomposition.

      The axes must pass validateJointAxesBasis: finite, non-zero and mutually orthogonal, with a supported rotation order and compatible twist placement. Otherwise the first issue is thrown as <path> <expected>, such as jointToQuaternion axes.twist must have non-zero length. The result has unit axes and any declared placement and rotation order. It is frozen and may be shared between calls on the same axes record.

      A rig's axes are a handful of constant records read for every bone of every pose, so the admitted basis is remembered per record. A remembered basis is returned only while the record still holds the nine components and the placement and order it was admitted with, compared exactly, so a record edited since is validated again; a basis that fails is never remembered, and the path, which only words a failure, plays no part in the result.

      Parameters

      • axes: IAutoMovieJointAxes

        Basis to check; read, never modified.

      • path: string

        Diagnostic path prefix naming the caller's input.

      Returns IAutoMovieJointAxes