Joint angles in the constraint's degree frame; null is rest.
Finite ordered axis intervals and an optional swing cone.
Called once per fault with the faulted part, the measured
value in degrees and its overshoot in degrees, undefined for a
non-finite value.
Optionalrig: IAutoMovieJointRotationFrame
The bone's frame as the caller's rig resolves it (swingTwistRange.of(bone, skeleton)); the humanoid tables' when absent.
Measure one joint against its range of motion and report each fault to the caller, building no message: the single owner of what counts as a ROM fault and how far past the limit it lies, read by the pose gate (validateJointRom), which words each fault, and by the solvers' candidate ranking (
jointRomOvershoot), which only sums them.Faults are reported in axis order (flexion, abduction, twist), then the combined swing. A
nullangle is rest and reports nothing on its own axis;0reports nothing on an immobile (null) axis, whose rest it is, but is measured against a range that excludes it. A non-finite angle is reported with anundefinedovershoot, since it has no distance to a limit. An angle on an immobile axis overshoots by its whole magnitude, and one outside its interval by its distance to the nearer bound. The swing is the coupling of flexion and abduction, anullaxis contributing its actual rotation,0, and overshoots by what it exceedsswingDeg.A ball joint whose constraint declares
swingTwistis measured by its rotation instead (swingTwistRange), in the frame of its bone the caller's rig resolves (rig), or the humanoid tables' (swingTwistRange.of): aswingfault by the degrees its direction lies past the reach of its flexion and abduction ranges, then atwistfault by the degrees its turn about its own axis lies pastswingTwist.twist. A non-finite angle is reported as above and nothing else is measured. A bone with no axes in that frame keeps the three-angle scan.