Segments whose joint toward the old root may move: the support chain, the trunk and the reaching chain.
The endpoint goal.
Optionalapproach?: {Optional arrival direction: the segment's local direction should point along it.
Unit world direction.
Unit direction in the segment's frame.
Metres of residual per unit of direction difference; positive.
Segment carrying the endpoint.
Endpoint in that segment's frame, metres.
World goal point, metres.
Positive update budget, at most 64.
Admitted fixed-pivot tree.
The held support and its bounded turn about the contact normal.
Held segment.
Upper turn, radians.
Lower turn, radians.
Unit world contact normal the support may turn about.
World contact point, metres.
Current world pose of every segment.
Positive residual early-out, metres.
Fit a whole articulated body to one endpoint goal while a support segment stays held, turning only about its contact.
The tree is held from the support (rerootPhysicalProfile), and a virtual base hinges onto it at the contact point about the contact normal within the declared turn, so the old root (a pelvis) rotates, tilts and translates through the support chain's own joints while the reaching chain reaches. Every coordinate stays inside its own declared ROM, the contact point never moves, and the bounded articulation solver (solvePhysicalArticulationTargets) accepts only residual decreases. The residual is the goal point's world error in metres and, when an approach is declared, the weighted difference between the endpoint's local direction carried to world and the approach direction.