Expand description
Caller-buffered VibeScript motor rig sampling, attachments and skinning.
Caller-buffered skeletal animation using the rigid motor algebra (etalon_render::skeletal).
Joint transforms are rigid; authoring scale is baked into mesh/bind positions.
Sampling, hierarchy composition and skinning allocate no heap memory.
Re-exports§
pub use fauna_rig::FaunaBiomechanicalArchetype;pub use fauna_rig::FaunaSkeletalRig10d;pub use fauna_rig::FAUNA_MAX_JOINTS;pub use fauna_rig::FAUNA_PARENT_INDICES;
Modules§
- absm
- Zero-Heap Multi-Layer Animation Blending State Machine (re-exported from
etalon-render). - activity
- Bounded visual activity timeline (re-exported from
etalon-render). - authoring
- Bounded skin influence authoring and seam remapping (re-exported from
etalon-render). - blend_
space - Zero-Heap 1D & 2D Delaunay Animation Blend Spaces (re-exported from
etalon-render). - fauna_
rig - Hardware GPU PGA Motor Dual-Quaternion Skinning, Multi-Layer ABSM, 2D Delaunay Blend Space & Constrained Motor IK for Australian Fauna.
- gpu_
morph - GPU Morph Target &
.10dMAGIC_EONTOntogenetic Deformation Bridge (re-exported frometalon-render). - gpu_
skin - GPU Dual-Quaternion Skinning Palette & Reference Kernel (re-exported from
etalon-render). - ik_
motor - Analytical Two-Bone, Constrained FABRIK, Coupled Swing-Twist Reach Cones,
Scapulo-Humeral Rhythm & Biarticular Tendon Coupling (re-exported from
etalon-render). - player
- Cold resident allocation and allocation-free visual playback lifecycle (
etalon_render::skeletal::player).
Structs§
- Absm
Layer - Single animation layer within an
AbsmMachine. - Absm
Machine - Multi-layer zero-heap Animation Blending State Machine (
AbsmMachine). - Absm
State Node - A state node inside an
super::absm_machine::AbsmLayer. - Absm
Transition - Directed transition edge between two states in an
super::absm_machine::AbsmLayer. - Animation
Clip - Fixed-capacity skeletal animation clip (
HotZeroHeap). - Animation
Event - Discrete event marker embedded in an
AnimationCliptimeline. - Animation
Signal - Timeline event emitted when an animation playhead crosses a normalized trigger timestamp.
- Animation
State Machine - Zero-heap animation state machine controller.
- Blend
Point1D - A single sample point inside a
BlendSpace1D. - Blend
Point2D - A 2D parameter sample point inside a
BlendSpace2D. - Blend
Sample2D - Result of sampling a
BlendSpace2Dat a 2D parameter coordinate. - Blend
Space1D - Fixed-capacity 1D animation blend space (
MAX_POINTSdefault8). - Blend
Space2D - Fixed-capacity 2D Delaunay animation blend space (
MAX_POINTS = 16,MAX_TRIS = 32). - Blend
Triangle - A Delaunay triangle indexing 3 points in
BlendSpace2D::points. - Body
FitSpec - Neutral body-fit specification applied in bind/CCF space before orbit-frame normalisation.
- Bone
Layer Mask - 128-bit bone mask (1 bit per joint up to
MAX_JOINTS = 128). - Bone
Track - Fixed-capacity keyframe track for a single bone (
HotZeroHeap). - Clip
- Eont
Posture Config - Ontogenetic and metabolic posture/cadence modulator (
EONT1compatible). - GpuInstance
Morph Weights - 48-byte per-instance morph weight uniform/storage record uploaded to the GPU.
- GpuJoint
Motor Pair - 64-byte GPU storage record per joint storing both current-frame and previous-frame
skinning PGA
Motors ($M_{\text{skin}, j} = M_{\text{world}, j} \circ M_{\text{inv_bind}, j}$). - GpuMorph
Delta - 32-byte GPU storage record holding a single morph target’s per-vertex position and normal delta.
- GpuSkinned
Vertex - 24-byte static vertex skinning attribute (
JOINTS_0+WEIGHTS_0) uploaded once per mesh. - Joint
- Key
- Keyframe3D
- Single keyframe sample for a
BoneTrack. - Motor
- A 3D PGA Motor (even multivector / unit dual quaternion) in
f64precision. Real part $R = (r_w, r_x, r_y, r_z)$, Dual part $D = (d_w, d_x, d_y, d_z)$. - Motor
Bivector - Lie algebra $\mathfrak{se}(3)$ screw bivector (rotation axis/angle + translation along screw axis).
- Ontogenetic
State Header - Domain-neutral 40-byte ontogenetic and metabolic state header (
EONT1layout). - Playback
Receipt - Root
Motion Delta - Frame-to-frame root motion displacement extracted from the skeleton’s root joint.
- Root
Motion Extractor - Extracts continuous root motion from the root bone (eliminating loop-wrap teleport spikes)
and locks horizontal
(x, z)drift on the visual skeleton. - Signal
Queue - Fixed-capacity FIFO ring buffer for
AnimationSignalevents (HotZeroHeap). - Signal
Trigger - Authored signal trigger attached to an animation state.
- Skeletal
Counts - Validated element counts and encoded payload size for skeletal admission budgeting.
- Skeletal
Player - Buffers are allocated once on validated scene admission, never on advance. Geometry stays in the authored bind frame; output can receive a uniform orbit transform without altering the rig or losing attachment alignment.
- Skeletal
RigDescriptor - Direct borrowed rig descriptor implementing
SkeletalSectionSource. - Skin
Weight - Track
- Transform3D
- 3D affine transform representation (
rotationstored as[x, y, z, w]). - TwoBone
IkResult - Output receipt for
solve_two_bone_motor_ik_zero_heap. - Zero
Heap Skeleton - Fixed-capacity skeletal rig (
MAX_BONES = 64).
Enums§
- Absm
Parameter - Typed parameter value driving ABSM transitions and blend spaces.
- Absm
State Source - Motion generator source for a state inside an
super::absm_machine::AbsmLayer. - Joint
Constraint - Angular constraint applied to a joint during
solve_constrained_fabrik_motor_ik_zero_heap. - Layer
Blend Mode - How an ABSM layer combines its output pose with lower layers.
- Leaf
Condition - Atomic predicate for transition evaluation (stack-resident,
Copy). - Player
Error - Pose
Time Policy - Skeletal
Error - Transition
Condition - Zero-heap transition firing condition supporting single predicates and
And/Orcombinators. - Transition
Mode - Animation state machine transition blend mode.
Constants§
- MAX_
BONES - Maximum bones supported per skeleton instance (fits in GPU uniform blocks).
- MAX_
GPU_ MORPH_ TARGETS - Maximum morph targets evaluated simultaneously per instance on the GPU.
- MAX_
GPU_ RIG_ JOINTS - Maximum joints supported per GPU skeletal rig palette (
128joints =8 KiBper instance). - MAX_
GPU_ SKELETON_ INSTANCES - Maximum concurrent skeletal instances resident in a single GPU storage buffer.
- MAX_
IK_ CHAIN - Maximum joints in a single constrained FABRIK chain (
HotZeroHeapstack bound). - MAX_
JOINTS - MAX_
KEYS - MAX_
VERTICES
Traits§
- Body
FitSource - Conversion trait allowing host body-fit descriptors (e.g.
AnatomyBodyFit) to configureSkeletalPlayer::set_body_fitwithout reverse crate dependencies. - Skeletal
Section Source - Zero-copy section source abstraction so
SkeletalPlayercan be constructed from.10dSkeletalSectionpayloads or direct in-memory slice descriptors without introducing reverse crate dependencies.
Functions§
- compose_
palette_ into - Iterative parent-before-child composition and inverse bind application.
globalsdoubles as reusable attachment transforms for tools and clothing. - compute_
ontogenetic_ morph_ weights_ from_ header_ zero_ heap - Convenience wrapper extracting
stage,damage_permill, andhydration_permilldirectly from anOntogeneticStateHeader(EntityOntologyMiniHeader). - compute_
ontogenetic_ morph_ weights_ zero_ heap - Computes
GpuInstanceMorphWeightswith zero heap allocations (HotZeroHeap), combining explicit pose/facial blend-shape weights with ontogenetic/metabolic state (damage_permill,hydration_permill, andstageontogenetic factor). - evaluate_
morph_ deltas_ zero_ heap - Evaluates linear blend-shape morph deltas into caller-supplied vertex position and normal
buffers with zero heap allocations (
HotZeroHeap). - evaluate_
skinning_ motor_ palette_ zero_ heap - Evaluates the GPU skinning
Motorpalette in a single zero-heap pass (HotZeroHeap). - gpu_
shader_ skin_ vertex_ reference - Deterministic software reference implementation of the WGSL vertex shader PGA
Motordual-quaternion skinning kernel (HotZeroHeap). - hemisphere_
align_ motor - Aligns
candidateto the same $S^3$ double-cover hemisphere asreference. - ontogenetic_
stage_ growth_ factor - Maps a
DevelopmentalStagediscriminant (0..=4) to a normalized ontogenetic growth factor in[0.0, 1.0]. - sample_
blend_ space_ 1d_ zero_ heap - Evaluates a
BlendSpace1Datparamand blends the corresponding clipMotorposes intoout_poseusingMotor::sclerp(HotZeroHeap). - sample_
blend_ space_ 2d_ zero_ heap - Samples a
BlendSpace2Datqueryand blends the 3 enclosing triangle clip poses per joint using barycentricMotor::sclerpwith zero heap allocation (HotZeroHeap). - sample_
pose_ into - Samples a local pose, optionally transitioning from a caller-owned pose.
blendis target influence[0, 1]. Missing tracks retain the rig rest pose. Validation finishes before modifying any output. Time is visual, not a game day. - skin_
vertices_ gpu_ reference_ into - Batch helper that skins a slice of vertices via
gpu_shader_skin_vertex_referenceinto caller-supplied output slices (HotZeroHeap). - skin_
vertices_ into - Four-influence linear blend skinning of immutable bind geometry. Positions and normals share the same palette. UVs, tangents and material topology are unchanged; tangent reconstruction remains the renderer’s job. No partial writes on malformed influences or inadequate output buffers.
- solve_
constrained_ fabrik_ motor_ ik_ zero_ heap - Solves multi-joint Constrained Forward-And-Backward Reaching Inverse Kinematics (FABRIK)
directly on a chain of up to
MAX_IK_CHAIN = 16PGAMotors with zero heap allocations (HotZeroHeap). - solve_
two_ bone_ motor_ ik_ zero_ heap - Analytically solves two-bone inverse kinematics (e.g., hip–knee–ankle or shoulder–elbow–wrist)
directly on PGA
Motors using the Law of Cosines and a pole-vector bend plane (HotZeroHeap). - valid_
motor - Returns
truewhenmis a finite, unit-norm, Plücker-orthogonal PGAMotor. - validate_
joints - Validates topological parent ordering and motor invariants for
joints.