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.
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 asjointToQuaternion 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.