Skip to main content

Module skeletal

Module skeletal 

Expand description

Zero-Heap Skeletal Animation, ABSM, Blend Spaces, Motor IK & Dual-Quaternion Skinning (skeletal).

Unifies:

  • pga_f64: f64 PGA $\mathcal{G}_{3,0,1}$ Motor and MotorBivector (log, exp, sclerp) with bidirectional conversion to crate::spatial_math::pga::Motor (f32).
  • pose, skin, gpu_skin, gpu_morph, ik_motor: caller-buffered pose sampling, 4-influence CPU/GPU dual-quaternion skinning, ontogenetic morph targets, and analytical/FABRIK IK.
  • blend_space_1d, blend_space_2d (re-exported under blend_space): 1D & 2D Bowyer–Watson Delaunay blend spaces.
  • absm_types, absm_machine, root_motion (re-exported under absm): multi-layer bone-masked Animation Blending State Machine with timeline signals and ontogenetic posture modulation.
  • transform_hierarchy, clip_state_machine (also accessible under inertial_skeleton): Transform3D, ZeroHeapSkeleton, AnimationStateMachine, and direct dual-quaternion GPU palette export.

Modules§

absm
Submodule namespace preserving skeletal::absm::* import paths.
absm_machine
Zero-Heap Multi-Layer Animation Blending State Machine Evaluator (absm_machine.rs).
absm_types
Zero-Heap Animation Blending State Machine Types (absm_types.rs).
activity
Bounded visual activity timeline, independent of campaign time and rendering.
authoring
Bounded skin influence authoring and seam remapping into caller buffers.
blend_space
Submodule namespace preserving skeletal::blend_space::* import paths.
blend_space_1d
Zero-Heap 1D Animation Blend Space (blend_space_1d.rs).
blend_space_2d
Zero-Heap 2D Delaunay Animation Blend Space (blend_space_2d.rs).
clip_state_machine
Zero-Heap Clip State Machine, Layer Blending & Sim Blend Space (clip_state_machine.rs).
cosserat_rod
Regime II & V: Geometrically Exact Discrete Cosserat Rod Solver (cosserat_rod.rs).
dca_multibody
Regime I: Articulated Multibody Endoskeleton Solver (dca_multibody.rs).
exoskeletal_cuticle
Regime III: Inverted Cuticular Exoskeleton Solver (exoskeletal_cuticle.rs).
gpu_morph
GPU Morph Target (Blend Shape) & Ontogenetic Deformation Bridge (gpu_morph.rs).
gpu_skin
Hardware GPU PGA Motor Dual-Quaternion Skinning Palette & Vertex Shader Bridge.
ik_motor
Zero-Heap Analytical Two-Bone Motor IK & Constrained Motor FABRIK (ik_motor.rs).
inertial_skeleton
Submodule namespace grouping transform_hierarchy and clip_state_machine.
mobility_risk_eval
BIO-WP-10: Coupled Mobility, Effort Reserve, Gait Stability & Bone Fracture Risk Evaluator.
pga_f64
3D Projective Geometric Algebra (PGA $\mathcal{G}_{3,0,1}$) / Dual Quaternion Motor Algebra (f64).
player
Cold resident allocation and allocation-free visual playback lifecycle.
pose
root_motion
Loop-Safe Root Motion Extraction & Ontogenetic Posture Modulation (root_motion.rs).
skin
time_policy
Per-invocation sampling policy; the authored clip’s loop declaration and legacy natural-advance behavior are never mutated by an inspection seek.
transform_hierarchy
Zero-Heap Skeletal Transform Hierarchy & Dual-Quaternion Bridge (transform_hierarchy.rs).
vbd_soft_tissue
Regime IV: Volumetric Soft Tissue, Fascia & Hydrostatic Skeleton Solver (vbd_soft_tissue.rs).

Structs§

AbsmLayer
Single animation layer within an AbsmMachine.
AbsmMachine
Multi-layer zero-heap Animation Blending State Machine (AbsmMachine).
AbsmStateNode
A state node inside an super::absm_machine::AbsmLayer.
AbsmTransition
Directed transition edge between two states in an super::absm_machine::AbsmLayer.
AnimationClip
Fixed-capacity skeletal animation clip (HotZeroHeap).
AnimationEvent
Discrete event marker embedded in an AnimationClip timeline.
AnimationSignal
Timeline event emitted when an animation playhead crosses a normalized trigger timestamp.
AnimationStateMachine
Zero-heap animation state machine controller.
ApodemeActuator
Internal apodeme muscle fiber bundle attached inside the cuticular shell.
BicondylarHinge
Dual-pin dicondylic arthrodial hinge between parent and child sclerite shells.
BlendPoint1D
A single sample point inside a BlendSpace1D.
BlendPoint2D
A 2D parameter sample point inside a BlendSpace2D.
BlendSample2D
Result of sampling a BlendSpace2D at a 2D parameter coordinate.
BlendSpace1D
Fixed-capacity 1D animation blend space (MAX_POINTS default 8).
BlendSpace2D
Fixed-capacity 2D Delaunay animation blend space (MAX_POINTS = 16, MAX_TRIS = 32).
BlendTriangle
A Delaunay triangle indexing 3 points in BlendSpace2D::points.
BodyDensitometryInertia
Tissue densitometry and geometry parameters used to derive BMD-scaled 6x6 spatial inertia.
BodyFitSpec
Neutral body-fit specification applied in bind/CCF space before orbit-frame normalisation.
BoneFractureLoadEvaluation
Computed bone yield capacity and Structural Factor of Risk $\Phi_b$.
BoneFractureLoadInput
Input parameters for structural bone fracture load evaluation.
BoneLayerMask
128-bit bone mask (1 bit per joint up to MAX_JOINTS = 128).
BoneMask64
64-bit bone mask (1 bit per bone in ZeroHeapSkeleton).
BoneTrack
Fixed-capacity keyframe track for a single bone (HotZeroHeap).
Clip
ClipRecord
Metadata record describing an animation clip span in caller-owned track/key tables.
CosseratElement
Material-frame segment state connecting node i to node i + 1.
CosseratElementGpu
GPU-aligned 64-byte Cosserat element buffer matching COSSERAT_ROD_WGSL.
CosseratEnvironment
Environmental forcing parameters for Cosserat rods (gravity, fluid/wind, light direction).
CosseratNode
Centerline node state for a discrete Cosserat rod.
CoupledMobilityFractureSummary
Coupled whole-body summary combining mobility reserve, dynamic balance, and fracture risk.
CuticleSclerite
Exterior load-bearing cuticular sclerite shell.
DcaAssemblyNodeGpu
GPU-aligned 128-byte binary-tree DCA assembly node matching DCA_MULTIBODY_WGSL.
DcaBodyGpu
GPU-aligned 64-byte per-body state record matching DCA_MULTIBODY_WGSL.
DcaBodyNode
Rigid-body articulated node for Regime I ABA/DCA dynamics.
EontPostureConfig
Ontogenetic and metabolic posture/cadence modulator (EONT1 compatible).
ExoHingeGpu
GPU-aligned 64-byte dicondylic hinge + hemolymph state matching EXOSKELETAL_CUTICLE_WGSL.
GaitStabilityEvaluation
Computed Hof $\text{XCoM}$ and Margin of Stability evaluation.
GaitStabilityInput
Input parameters for Hof’s dynamic gait / posture Margin of Stability evaluation.
GpuInstanceMorphWeights
48-byte per-instance morph weight uniform/storage record uploaded to the GPU.
GpuJointMotorPair
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}$).
GpuMorphDelta
32-byte GPU storage record holding a single morph target’s per-vertex position and normal delta.
GpuSkinnedVertex
24-byte static vertex skinning attribute (JOINTS_0 + WEIGHTS_0) uploaded once per mesh.
HemolymphHydraulics
Internal hemolymph / coelomic hydraulic chamber driving joint extension.
Joint
JointMobilityEvaluation
Computed joint effort reserve and capacity evaluation.
JointMobilityInput
Input parameters for a single joint actuator mobility/effort evaluation.
Key
Keyframe3D
Single keyframe sample for a BoneTrack.
LoopClosureConstraint
Closed kinematic loop constraint (ribcage, radius-ulna, pelvic ring).
Motor
A 3D PGA Motor (even multivector / unit dual quaternion) in f64 precision. Real part $R = (r_w, r_x, r_y, r_z)$, Dual part $D = (d_w, d_x, d_y, d_z)$.
MotorBivector
Lie algebra $\mathfrak{se}(3)$ screw bivector (rotation axis/angle + translation along screw axis).
OntogeneticStateHeader
Domain-neutral 40-byte ontogenetic and metabolic state header (EONT1 layout).
PlaybackReceipt
RootMotionDelta
Frame-to-frame root motion displacement extracted from the skeleton’s root joint.
RootMotionExtractor
Extracts continuous root motion from the root bone (eliminating loop-wrap teleport spikes) and locks horizontal (x, z) drift on the visual skeleton.
SignalQueue
Fixed-capacity FIFO ring buffer for AnimationSignal events (HotZeroHeap).
SignalTrigger
Authored signal trigger attached to an animation state.
SimAnimationSignal
Fixed-capacity animation signal event and ring buffer.
SimBlendPoint2D
2D blend space sample point for Transform3D poses.
SimBlendSpace2D
Zero-heap 2D triangle blend space for Transform3D skeletal poses.
SimRootMotionDelta
Root motion displacement extracted from bone 0.
SimRootMotionExtractor
Loop-safe root motion extractor for Transform3D skeletons.
SimSignalQueue
SkeletalCounts
Validated element counts and encoded payload size for skeletal admission budgeting.
SkeletalPlayer
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.
SkeletalRigDescriptor
Direct borrowed rig descriptor implementing SkeletalSectionSource.
SkinWeight
Track
Transform3D
3D affine transform representation (rotation stored as [x, y, z, w]).
TwoBoneIkResult
Output receipt for solve_two_bone_motor_ik_zero_heap.
VbdTetElement
Constitutive hyperelastic + active Hill muscle + dermal strain-hardening parameters per tet.
VbdVertex
Vertex state for graph-colored Vertex Block Descent soft-tissue simulation.
VbdVertexGpu
GPU-aligned 32-byte VBD vertex record matching VBD_SOFT_TISSUE_WGSL.
ZeroHeapSkeleton
Fixed-capacity skeletal rig (MAX_BONES = 64).

Enums§

AbsmParameter
Typed parameter value driving ABSM transitions and blend spaces.
AbsmStateSource
Motion generator source for a state inside an super::absm_machine::AbsmLayer.
AnatomicBoneSite
Anatomic site selecting Morgan, Bayraktar & Keaveny (2003) / Carter & Hayes (1977) power laws.
BiologicalSexBasis
Biological substrate sex basis for age-trajectory and neuromuscular reference scaling.
FractureCallusStage
Mechanobiological fracture healing stage (Claes & Heigele 1999).
JointConstraint
Angular constraint applied to a joint during solve_constrained_fabrik_motor_ik_zero_heap.
LayerBlendMode
How an ABSM layer combines its output pose with lower layers.
LayerBlendOp
Multi-layer skeletal blend mode.
LeafCondition
Atomic predicate for transition evaluation (stack-resident, Copy).
PlayerError
PoseTimePolicy
SkeletalError
TransitionCondition
Zero-heap transition firing condition supporting single predicates and And/Or combinators.
TransitionMode
Animation state machine transition blend mode.

Constants§

COSSERAT_ROD_WGSL
DCA_MULTIBODY_WGSL
EXOSKELETAL_CUTICLE_WGSL
MAX_ABSM_PARAMS
Maximum parameter slots in an super::absm_machine::AbsmMachine.
MAX_BONES
Maximum bones supported per skeleton instance (fits in GPU uniform blocks).
MAX_COSSERAT_NODES
MAX_DCA_BODIES
MAX_DCA_LOOPS
MAX_EXO_APODEMES
MAX_EXO_SCLERITES
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 (128 joints = 8 KiB per 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 (HotZeroHeap stack bound).
MAX_JOINTS
MAX_KEYS
MAX_SIGNALS_PER_STATE
Maximum signal triggers per animation state.
MAX_VBD_COLORS
MAX_VBD_TETS
MAX_VBD_VERTICES
MAX_VERTICES
VBD_SOFT_TISSUE_WGSL

Traits§

BodyFitSource
Conversion trait allowing host body-fit descriptors (e.g. AnatomyBodyFit) to configure SkeletalPlayer::set_body_fit without reverse crate dependencies.
SkeletalSectionSource
Zero-copy section source abstraction so SkeletalPlayer can be constructed from .10d SkeletalSection payloads or direct in-memory slice descriptors without introducing reverse crate dependencies.

Functions§

blend_skeleton_layer_zero_heap
Blends layer_pose into base_pose using mask, op, and weight in [0.0, 1.0] (HotZeroHeap).
clip_view
Build a runtime Clip view after loading the section into caller-owned arrays.
compose_palette_into
Iterative parent-before-child composition and inverse bind application. globals doubles as reusable attachment transforms for tools and clothing.
compute_darboux_vector
Computes material Darboux bending/twist vector $\boldsymbol{\Omega}$ between adjacent frames.
compute_ontogenetic_morph_weights_from_header_zero_heap
Convenience wrapper extracting stage, damage_permill, and hydration_permill directly from an OntogeneticStateHeader (EntityOntologyMiniHeader).
compute_ontogenetic_morph_weights_zero_heap
Computes GpuInstanceMorphWeights with zero heap allocations (HotZeroHeap), combining explicit pose/facial blend-shape weights with ontogenetic/metabolic state (damage_permill, hydration_permill, and stage ontogenetic factor).
evaluate_bone_fracture_load
Evaluates Structural Factor of Risk $\Phi_b = F_{\text{applied}} / F_{\text{yield}}$ from volumetric BMD, BV/TV, fabric tensor $\mathbf{M}{\text{fabric}}$, mineralization $\mu{\text{min}}$, and 4-stage fracture callus state.
evaluate_coupled_mobility_and_fracture_risk
Evaluates coupled joint mobility effort ($\text{RER}_j$), Hof dynamic stability ($\text{MoS}$), and bone Structural Factor of Risk ($\Phi_b$) into caller-supplied slices (HotZeroHeap).
evaluate_gait_stability
Evaluates Hof’s Extrapolated Center of Mass ($\text{XCoM}$) and signed Margin of Stability ($\text{MoS}$).
evaluate_joint_mobility
Evaluates $\text{RER}j = |\tau{j,\text{req}}| / \tau_{j,\max}$ for a single joint.
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 Motor palette in a single zero-heap pass (HotZeroHeap).
gpu_shader_skin_vertex_reference
Deterministic software reference implementation of the WGSL vertex shader PGA Motor dual-quaternion skinning kernel (HotZeroHeap).
hemisphere_align_motor
Aligns candidate to the same $S^3$ double-cover hemisphere as reference.
hydrostatic_cavity_axial_force
Computes internal hydrostatic cavity axial thrust $F_{\text{cav}} = P_{\text{cav}} \pi r^2$.
ontogenetic_stage_growth_factor
Maps a DevelopmentalStage discriminant (0..=4) to a normalized ontogenetic growth factor in [0.0, 1.0].
resolve_loop_closures_zero_heap
Resolves closed kinematic loop residuals (e.g. ribcage, radius-ulna) via compliant constraint projection over world body Motor poses (HotZeroHeap), returning max residual (m).
sample_blend_space_1d_zero_heap
Evaluates a BlendSpace1D at param and blends the corresponding clip Motor poses into out_pose using Motor::sclerp (HotZeroHeap).
sample_blend_space_2d_zero_heap
Samples a BlendSpace2D at query and blends the 3 enclosing triangle clip poses per joint using barycentric Motor::sclerp with zero heap allocation (HotZeroHeap).
sample_pose_2d_zero_heap
Samples a SimBlendSpace2D at query and blends the 3 enclosing clip Transform3D poses (HotZeroHeap).
sample_pose_into
Samples a local pose, optionally transitioning from a caller-owned pose. blend is target influence [0, 1]. Missing tracks retain the rig rest pose. Validation finishes before modifying any output. Time is visual, not a game day.
sideways_fall_trochanteric_impact_force_n
Estimates sideways-fall trochanteric impact force (N) attenuated by trochanteric soft-tissue padding $h_{\text{troch}}$ and protective stepping reflex attenuation (Robinovitch / Bouxsein).
skin_vertices_gpu_reference_into
Batch helper that skins a slice of vertices via gpu_shader_skin_vertex_reference into 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_aba_zero_heap
Solves forward dynamics in $O(N)$ using Featherstone’s Articulated-Body Algorithm (HotZeroHeap).
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 = 16 PGA Motors with zero heap allocations (HotZeroHeap).
solve_dca_parallel_chain_zero_heap
Solves forward dynamics for a serial chain in $O(\log N)$ balanced binary-tree passes via Featherstone’s Divide-and-Conquer Articulated-Body Algorithm (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).
step_cosserat_rod_zero_heap
Advances a discrete Cosserat rod by dt seconds with zero heap allocations (HotZeroHeap).
step_exoskeletal_cuticle_zero_heap
Advances Regime III cuticular sclerite hinges under apodeme torques, hydraulic hemolymph extension pressure, and coelomic volume conservation (HotZeroHeap).
step_vbd_soft_tissue_zero_heap
Advances Regime IV soft tissue using graph-colored Vertex Block Descent (HotZeroHeap), returning the mean volume determinant $\det(\mathbf{F})$ across elements.
valid_motor
Returns true when m is a finite, unit-norm, Plücker-orthogonal PGA Motor.
validate_joints
Validates topological parent ordering and motor invariants for joints.

Type Aliases§

EntityOntologyMiniHeader
Backwards-compatible alias for OntogeneticStateHeader.
SpatialMat6
6x6 spatial matrix in row-major [row][col] layout.
SpatialVec6
6D spatial motion or force vector [ang_0, ang_1, ang_2, lin_0, lin_1, lin_2].