Method references¶
These public sources describe dependencies and numerical techniques used in RigExec. They are references for implementation and review, not claims of affiliation, endorsement, or ownership of the underlying techniques.
| Area | Public source | RigExec code |
|---|---|---|
| OpenExec computation registration and reference requests | OpenExec introduction and system design | libs/rigExec/computations.cpp, libs/rigExec/moverKernels.cpp, libs/rigExec/types.cpp, libs/rigExec/tapSet.cpp; used only by the reference check and tests. Production evaluation uses the shared operation graph in libs/rigExecGraph. |
| Scene-index publication | Hydra getting started | libs/rigExecImaging |
| Dual-quaternion skinning | Kavan et al., Geometric Skinning with Approximate Dual Quaternion Blending (2008), author project page | libs/rigExecMath/dualQuat.cpp |
| Delta Mush | Mancewicz, Derksen, and Wilson, Delta Mush: Smoothing Deformations While Preserving Detail (2014), publisher entry | libs/rigExecMath/deltaMushKernel.h |
| Position projection concepts | Müller, Heidelberger, Hennix, and Ratcliff, Position Based Dynamics (2007), author-hosted paper, DOI | libs/rigExecMath/wrinkleKernel.h |
| Harmonic secondary motion | tbttfox, BlurHarmonics ("a simplified mass/spring solver that lets you tweak parameters after you run the solve"): each frame's acceleration rings as a damped sine over a fixed window. The repository states no license, so RigExec reimplements the method from its description and contains none of its code | libs/rigExecMath/harmonicsKernel.h (RigExecHarmonicsConstraint); secondary motion and cloth |
| Compliant position-based dynamics | Macklin, Müller, and Chentanez, XPBD: Position-Based Simulation of Compliant Constrained Dynamics, Motion in Games (2016), author-hosted paper, DOI | libs/rigExecMath/clothKernel.h (RigExecClothMover constraints); libs/rigExecMath/clothModel.h (RigExecClothStrength: force-dependent strength from the constraint force estimate) |
| Many substeps, one iteration each | Macklin, Storey, Lu, Terdiman, Chentanez, Jeschke, and Müller, Small Steps in Physics Simulation, Symposium on Computer Animation (2019), author-hosted paper, DOI | libs/rigExecMath/clothKernel.h (rigExec:substeps) |
| Coloured Gauss-Seidel constraint projection | Fratarcangeli, Tibaldo, and Pellacini, Vivace: a Practical Gauss-Seidel Method for Stable Soft Body Dynamics, ACM Transactions on Graphics 35(6) (2016), DOI | libs/rigExecMath/clothKernel.h (RigExecBuildClothMesh colouring), libs/rigExecGpu/clothShader.cpp |
| Long-range tethers to pins | Kim, Chentanez, and Müller, Long Range Attachments - A Method to Simulate Inextensible Clothing in Computer Games, Symposium on Computer Animation (2012), author-hosted paper | libs/rigExecMath/clothKernel.h (rigExec:tethers) |
| Collider spatial hashing | Teschner, Heidelberger, Müller, Pomeranets, and Gross, Optimized Spatial Hashing for Collision Detection of Deformable Objects, Vision, Modeling, and Visualization (2003), author-hosted paper | libs/rigExecMath/clothKernel.h (RigExecBuildClothGrid) |
| Collision thickness and friction | Bridson, Fedkiw, and Anderson, Robust Treatment of Collisions, Contact and Friction for Cloth Animation, ACM Transactions on Graphics 21(3) (2002), DOI | libs/rigExecMath/clothKernel.h (RigExecClothFindContact, RigExecClothParticlePass; RigExecClothSelfContacts, two-sided vertex/triangle and edge/edge self-contact) |
| Barycentric coordinates | Ericson, Real-Time Collision Detection, Morgan Kaufmann (2005), section 3.4 | libs/rigExec/movers/clothInputs.h (Samples, UV and barycentric cloth bindings), libs/rigExecMath/clothModel.h (RigExecClothSampleMap) |
| Warp and weft axes from UV coordinates | Baraff and Witkin, Large Steps in Cloth Simulation, SIGGRAPH (1998), DOI | libs/rigExecMath/clothKernel.h (RigExecClothMaterialFrame) |
| Closest point on a triangle | Ericson, Real-Time Collision Detection, Morgan Kaufmann (2005), section 5.1.5 | libs/rigExecMath/clothKernel.h (ClosestBarycentric), libs/rigExecGpu/clothShader.cpp |
| Closest point on a segment | Ericson, Real-Time Collision Detection, Morgan Kaufmann (2005), section 5.1.2 | libs/rigExecMath/weightFields.cpp (RigExecSegmentDistance: RigExecCurveWeight fields), libs/rigExecRuntime/weights.cpp (_RrSegmentDistance) |
| Closest points between segments | Ericson, Real-Time Collision Detection, Morgan Kaufmann (2005), section 5.1.9 | libs/rigExecMath/clothKernel.h (ClosestSegments, edge/edge self-contact) |
| Segment crossing a triangle | Ericson, Real-Time Collision Detection, Morgan Kaufmann (2005), section 5.3.6 | libs/rigExecMath/clothKernel.h (RigExecClothClearOfColliders, where a cloth window starts) |
| Wrinkle reference lengths and bounded offsets | Müller and Chentanez, Wrinkle Meshes (2010), author-hosted paper, DOI | libs/rigExecMath/wrinkleKernel.h; method and limitations |
| Lattice (free-form) deformation | Sederberg and Parry, Free-Form Deformation of Solid Geometric Models, ACM SIGGRAPH Computer Graphics 20(4):151–160 (1986), DOI | libs/rigExecMath/latticeKernel.h |
| Ray-triangle intersection | Möller and Trumbore, Fast, Minimum Storage Ray-Triangle Intersection, Journal of Graphics Tools 2(1):21–28 (1997), publication entry | libs/rigExecMath/surfaceProjectorKernel.h (surface projector, RigExecRaycastSurface) |
| Path curve bases | UsdGeomBasisCurves (linear; cubic bezier, bspline, catmullRom; nonperiodic and pinned wrap); Catmull and Rom, A Class of Local Interpolating Splines, in Barnhill and Riesenfeld (eds.), Computer Aided Geometric Design (1974), DOI | libs/rigExecMath/pathCurveKernel.h (float math path operation) |
| Arc length by Gauss–Legendre quadrature | NIST Digital Library of Mathematical Functions, §3.5(v) Gauss quadrature | libs/rigExecMath/pathCurveKernel.h |
| NURBS patch evaluation | Piegl and Tiller, The NURBS Book (1997), DOI | libs/rigExecMath/geometryKernels.h (RigExecNurbsPatch), libs/rigExecMath/geometryKernels.cpp (RigExecNurbsPatch::EvaluateNormalized, RigExecApplyPatchMover); Patch Mover |
| RigLogic radial-basis solvers, machine-learned behavior and animated maps | Epic Games, OpenRigLogic (MIT), RigLogic 13.5.0 at commit 9ca65ac: src/riglogic/rbf/cpu, src/riglogic/ml/cpu, src/riglogic/conditionaltable and src/riglogic/animatedmaps; RigLogic whitepaper. What was ported and what was added is listed in RigLogic behaviours |
libs/rigExecMath/rbfMethodKernel.h (RigExecPoseInterpolator rigExec:solver additive and interpolative), libs/rigExecMath/mlpKernel.h (RigExecMlMover), libs/rigExecMath/conditionalTableKernel.h (RigExecAnimatedMaps); reference values from RigLogic itself in tests/fixtures/rigLogicReference.inc |
| Swing-twist decomposition | Dobrowolski, Swing-twist decomposition in Clifford algebra (2015), arXiv:1506.05481 | libs/rigExec/solverKernels.cpp (space switch rotation filters), libs/rigExecMath/solvers.cpp (_SwingTwist), libs/rigExecMath/rbf.cpp |
| Forward and backward reaching IK | Aristidou and Lasenby, FABRIK: A fast, iterative solver for the Inverse Kinematics problem, Graphical Models 73(5):243–260 (2011), DOI | libs/rigExecMath/singleChainIk.cpp (RigExecSingleChainIkConstraint) |
| Linear blend skinning | Magnenat-Thalmann, Laperrière, and Thalmann, Joint-Dependent Local Deformations for Hand Animation and Object Grasping, Graphics Interface (1988), DOI; Lewis, Cordner, and Fong, Pose Space Deformation: A Unified Approach to Shape Interpolation and Skeleton-Driven Deformation, SIGGRAPH (2000), DOI | libs/rigExec/moverGraph.cpp (RigExecApplySkinKernel, RigExecSkinMover classicLinear) |
| Cyclic coordinate descent | Wang and Chen, A Combined Optimization Method for Solving the Inverse Kinematics Problems of Mechanical Manipulators, IEEE Transactions on Robotics and Automation 7(4):489–499 (1991), DOI. The rules beyond the per-joint descent have no public source; see 2D skeleton rules without a public source | libs/rigExecMath/skeleton2dKernel.h (RigExecSkeleton2d lock and target solves) |
2D skeleton rules without a public source¶
The rules and constants of skeleton2dKernel.h that the sources above do
not cover have no public source; they come from an unpublished internal
specification. They include the 2D lock and IK solve rules: the lock and
target rules of the coordinate descent (chain stops, pins left out of a
parent's children, the 32-bone chain cap, the retry from the other bend,
out-of-reach stretch, limit handling), delta-form control bones and the
alternative-chain joint groups of jointGroupKernel.h, which RigExecFkChain
shares.
2D skeletons, binding and smart-bone step tables
describes the behavior. A smart bone's frame rules (which side it serves,
the full-turn wrap, ties, offset and value channels) are written into
animated-map step tables by the authoring tool; RigExec evaluates them as
RigLogic's conditional tables, with rigExec:clampOutput as its one
addition.
Implementation details and limitations are documented with each operator.
The cloth mover combines the sources above in one solver of its own: a
window re-simulated from the incoming points at every evaluation, starting
before any contact that cuts through them, collision
against swept collider triangles within a fixed reach, and a GPU twin of the
same passes; secondary motion and cloth
describes it. Its directional strength weights the warp, weft and normal
scales by the squared cosines between a constraint's direction and those
axes (RigExecClothStrength); that blend is RigExec's own and is not taken
from the cited sources. Citing them does not claim any author's
implementation.
In particular, referencing Delta Mush does not claim implementation of the
distinct Direct Delta Mush method. Third-party source and asset provenance
is tracked separately in third-party notices.
The wrinkle mover independently adapts position projection, reference lengths,
and bounded offsets using a deterministic fold guide and affine edge targets.
Its guide and target equations are documented in the
method guide. It does not reproduce the
papers' nonlinear distance projection, the separate refined mesh, or the
persistent offset state of Wrinkle Meshes. Its public behavior references
do not imply use of proprietary implementation code.
Persistent surface bindings¶
RigExecSurfaceBindingMover evaluates generalized barycentric positions and
offsets in an orthonormal tangent/bitangent/normal frame. Polygon normals use
Newell's area vector; optional smooth normals interpolate normalized,
area-weighted vertex normals. The Blender
Surface Deform evaluator
is the reference for weighted polygon bindings and normal-offset import.
Limit position and tangent derivatives are supplied as factored control-point
stencils, as described by the
OpenSubdiv limit stencil factory.
The runtime consumes these immutable attributes without tessellation or rebinding.
Extended deformation settings¶
The independent Blender behavior fixtures cover Corrective Smooth, nearest-surface shrinkwrap, and lattice deformation. The shared, stage-free kernels implement the selected mathematical behavior; Blender-generated fixture coordinates test the results independently.
Newly authored surface, Delta Mush, or lattice settings require updated runtime
consumers. Binary exports carry these settings on the existing SurfaceProject,
DeltaMush and Lattice revisions from format 21
(RigExecFormatExtendedSettingsVersion in libs/rigExecBinary/format.h); a
format-20 file holds none of them and plays the legacy deformer.
USD assets must likewise be opened with the updated schema and runtime.
Affine frame computation contracts¶
The stage-free libs/rigExecMath/affineFrameKernels.cpp implements joint
inheritance, affine frame copying/mapping, weighted rest-to-pose parenting,
constraint space conversion, tracking, stretch and location remapping.
Production evaluation runs these kernels as provider-program operations
(libs/rigExecScene/providerProgram.cpp). The OpenExec expressions in
libs/rigExec/affineFrameComputations.cpp read declared inputs and call the
same kernels, but nothing requests them. Source behavior references
include Blender's constraint evaluator,
joint inheritance,
and rotation channel extraction.
The shared schemas define the runtime contracts independently of the file
format that authored them. Independent source fixtures cover local-space
location remapping, inherited nonuniform transforms and sequential skinning.