EIKJointConstraint
Description of an N-bone chain solved iteratively by FABRIK (Forward And Backward Reaching Inverse Kinematics).
- Module
- Animation
- Header
#include "Animation/IK/FABRIK.h"- Namespace
Mowo
bones lists bone indices from root → end, contiguous along the parent chain. The solver does NOT verify they form an actual parent chain — it just treats them as a kinematic chain with the segment lengths inferred from the current bind/animated pose. Author-side responsibility to keep the list ordered and connected.
Typical use cases (chains longer than 3 bones, where the analytical two-bone solver doesn't apply): - spine bending (pelvis → chest → neck) - tail / tentacle / cable - multi-finger phalanx - prehensile limb (creature animation)
polePosition is an optional swing hint applied AFTER the FABRIK pass: the chain is rotated around the root→end axis so the middle joint(s) face toward the pole. This is the only joint-orientation control we expose — FABRIK itself only constrains positions.
maxIterations / tolerance cap the solver work; in practice 5-10 iterations converge to within 1mm for human-scale chains. What a joint is allowed to do to the segment leaving it.
None — unconstrained, the classic positions-only FABRIK behaviour. Hinge — one degree of freedom: the outgoing segment is forced into the plane perpendicular to hingeAxis and its swing about that axis is clamped to [minAngleDegrees, maxAngleDegrees]. This is the knee/elbow case, and the reason it matters is that unconstrained FABRIK will happily fold a knee forwards. Cone — the outgoing segment stays within coneAngleDegrees of the incoming one. Shoulders, hips, tail segments.
Values
| Name | Value | Description |
|---|---|---|
None | 0 | |
Hinge | 1 | |
Cone | 2 |