Skip to content

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.