Skip to main content

FaunaSkeletalRig10d

Struct FaunaSkeletalRig10d 

Source
pub struct FaunaSkeletalRig10d {
    pub archetype: FaunaBiomechanicalArchetype,
    pub joint_count: usize,
    pub joints: [Joint; 24],
    pub parent_indices: [i32; 24],
    pub rest_pose: [Motor; 24],
    pub clip_poses: [[Motor; 24]; 5],
    pub blend_space_2d: BlendSpace2D<16, 32>,
    pub absm: AbsmMachine<4, 16, 32>,
    pub prev_skin_motors: [Motor; 24],
    pub current_skin_motors: [Motor; 24],
    pub gpu_palette: [GpuJointMotorPair; 24],
    pub signal_queue: SignalQueue<16>,
}
Expand description

Complete 10D Articulated Fauna Skeletal Rig.

Encapsulates the PGA Motor joint hierarchy, 2D Bowyer–Watson Delaunay blend space, multi-layer ABSM, procedural motor oscillators, two-bone + FABRIK IK solvers, and GPU skinning palette / morph target evaluation buffers.

Fields§

§archetype: FaunaBiomechanicalArchetype

Biomechanical archetype.

§joint_count: usize

Active joint count (<= FAUNA_MAX_JOINTS).

§joints: [Joint; 24]

Up to 24 skeletal joints with authored rest transforms and inverse-bind motors.

§parent_indices: [i32; 24]

Parent index lookup table (parent < 0 for root).

§rest_pose: [Motor; 24]

Authored rest pose in local space.

§clip_poses: [[Motor; 24]; 5]

5 cardinal clips for 2D blend space locomotion and state machine generation.

§blend_space_2d: BlendSpace2D<16, 32>

2D Bowyer-Watson Delaunay blend space parameterized by (forward_speed, turn_rate).

§absm: AbsmMachine<4, 16, 32>

Multi-layer zero-heap Animation Blending State Machine.

§prev_skin_motors: [Motor; 24]

Previous-frame skinning motors for exact TAA velocity vector evaluation.

§current_skin_motors: [Motor; 24]

Current-frame skinning motors.

§gpu_palette: [GpuJointMotorPair; 24]

64-byte GPU storage records (GpuJointMotorPair) ready for direct SSBO upload.

§signal_queue: SignalQueue<16>

Event ring buffer for timeline animation signals.

Implementations§

Source§

impl FaunaSkeletalRig10d

Source

pub fn new(archetype: FaunaBiomechanicalArchetype) -> Self

Constructs a fully authored 10D fauna rig for the specified biomechanical archetype.

Source

pub fn set_parameter(&mut self, idx: usize, param: AbsmParameter)

Sets an ABSM control parameter (e.g. idx 0: Vec2 [speed, turn], idx 1: Float speed, idx 2: Bool is_vocalizing).

Source

pub fn sample_blend_space( &self, forward_speed_norm: f32, turn_rate_rad: f32, out_pose: &mut [Motor], ) -> Result<BlendSample2D, SkeletalError>

Samples the 2D Bowyer–Watson Delaunay blend space at (forward_speed_norm, turn_rate_rad) blending cardinal clip poses directly with Motor::sclerp (zero heap allocations).

Source

pub fn step_absm( &mut self, dt: f32, out_local_pose: &mut [Motor], ) -> Result<RootMotionDelta, SkeletalError>

Advances the multi-layer ABSM by dt seconds, evaluating layer blending, EONT1 posture modulation, and root motion extraction while pushing crossed timeline signals into self.signal_queue (HotZeroHeap).

Source

pub fn apply_proc1_respiration_oscillation( &self, pose: &mut [Motor], time_sec: f32, amplitude_rad: f32, )

Applies procedural respiration breathing pitch oscillation onto the Chest and Spine joints.

Source

pub fn apply_proc1_tail_undulation( &self, pose: &mut [Motor], time_sec: f32, frequency_hz: f32, amplitude_rad: f32, )

Applies continuous procedural caudal (tail) undulation along the Tail Base, Mid, Tip, and Distal Tip joints.

Source

pub fn solve_hindlimb_terrain_ik( &self, local_pose: &mut [Motor], left_foot_target: [f32; 3], right_foot_target: [f32; 3], ) -> Result<(TwoBoneIkResult, TwoBoneIkResult), SkeletalError>

Solves analytical Two-Bone Motor IK for both hindlimbs (Left and Right Hip-Knee-Ankle) to adapt foot placement to sloped East Coast terrain elevations (HotZeroHeap).

Source

pub fn solve_tail_fabrik_ik( &self, local_pose: &mut [Motor], target_tip: [f32; 3], ) -> Result<f32, SkeletalError>

Solves Constrained Motor FABRIK on the articulated tail chain (Tail Base, Mid, Tip) enforcing conical swing limits and hinge constraints (HotZeroHeap).

Source

pub fn evaluate_gpu_palette(&mut self, local_pose: &[Motor]) -> usize

Evaluates the GPU dual-quaternion skinning palette into self.gpu_palette (GpuJointMotorPair), computing $M_{\text{skin}} = M_{\text{world}} \circ M_{\text{inv_bind}}$ and updating previous-frame motors for exact TAA velocity vector evaluation (HotZeroHeap).

Source

pub fn compute_morph_weights( &self, explicit_weights: &[f32], stage: u8, damage_permill: u16, hydration_permill: u16, ) -> GpuInstanceMorphWeights

Computes 48-byte GpuInstanceMorphWeights combining explicit facial/vocal blend shape weights with .10d EONT1 metabolic damage, hydration, and lifecycle growth factors (HotZeroHeap).

Source

pub fn evaluate_morph_deltas( &self, base_positions: &[[f32; 3]], base_normals: &[[f32; 3]], morph_deltas: &[GpuMorphDelta], weights: &GpuInstanceMorphWeights, out_positions: &mut [[f32; 3]], out_normals: &mut [[f32; 3]], ) -> Result<usize, SkeletalError>

Displaces authored bind-pose vertex positions and normals by pre-skinning GPU morph deltas (HotZeroHeap).

Source

pub fn verify_vertex_skinning( &self, pos: [f32; 3], normal: [f32; 3], tangent: [f32; 4], skin_attr: &GpuSkinnedVertex, ) -> ([f32; 3], [f32; 3], [f32; 4], [f32; 3])

Software reference execution of the GPU WGSL dual-quaternion skinning vertex shader, returning (skinned_pos, skinned_normal, skinned_tangent, taa_motion_vector).

Source

pub const fn pelvic_girdle_class(&self) -> PelvicGirdleClass

Returns the pelvic / structural girdle classification for this rig’s archetype.

Source

pub fn joint_bio_metadata(&self) -> [JointBioMetadata; 24]

Derives per-joint biomechanical & epistemic metadata across all 24 canonical joints.

Source

pub fn to_skl2_payload(&self) -> SkeletalSectionPayload

Exports this rig’s active joints as a validated SKL2 v2 SkeletalSectionPayload.

Trait Implementations§

Source§

impl Clone for FaunaSkeletalRig10d

Source§

fn clone(&self) -> Self

Returns a duplicate of the value. Read more
1.0.0 (const: unstable) · Source§

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source. Read more
Source§

impl Copy for FaunaSkeletalRig10d

Source§

impl Debug for FaunaSkeletalRig10d

Source§

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter. Read more

Auto Trait Implementations§

Blanket Implementations§

§

impl<S, A> Aggregate<Result<S, Error>> for A
where A: Aggregate<S>,

§

fn from_shares<T>(iter: T) -> Result<A, Error>
where T: IntoIterator<Item = Result<S, Error>>,

Aggregate shares in an MPC protocol.
Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
§

impl<ST, DT> CastableFrom<ST, Initialized, Initialized> for DT
where ST: ?Sized, DT: ?Sized,

§

impl<ST, DT> CastableFrom<ST, Uninit, Uninit> for DT
where ST: ?Sized, DT: ?Sized,

Source§

impl<T> CloneToUninit for T
where T: Clone,

Source§

unsafe fn clone_to_uninit(&self, dest: *mut u8)

🔬This is a nightly-only experimental API. (clone_to_uninit)
Performs copy-assignment from self to dest. Read more
§

impl<T> Downcast<T> for T

§

fn downcast(&self) -> &T

Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

§

impl<T> FromRef<T> for T
where T: Clone,

§

fn from_ref(input: &T) -> T

Converts to this type from a reference to the input type.
§

impl<T> Instrument for T

§

fn instrument(self, span: Span) -> Instrumented<Self> ⓘ

Instruments this type with the provided [Span], returning an Instrumented wrapper. Read more
§

fn in_current_span(self) -> Instrumented<Self> ⓘ

Instruments this type with the current Span, returning an Instrumented wrapper. Read more
Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T> IntoEither for T

Source§

fn into_either(self, into_left: bool) -> Either<Self, Self> ⓘ

Converts self into a Left variant of Either<Self, Self> if into_left is true. Converts self into a Right variant of Either<Self, Self> otherwise. Read more
Source§

fn into_either_with<F>(self, into_left: F) -> Either<Self, Self> ⓘ
where F: FnOnce(&Self) -> bool,

Converts self into a Left variant of Either<Self, Self> if into_left(&self) returns true. Converts self into a Right variant of Either<Self, Self> otherwise. Read more
§

impl<T> Pointable for T

§

const ALIGN: usize

The alignment of pointer.
§

type Init = T

The type for initializers.
§

unsafe fn init(init: <T as Pointable>::Init) -> usize

Initializes a with the given initializer. Read more
§

unsafe fn deref<'a>(ptr: usize) -> &'a T

Dereferences the given pointer. Read more
§

unsafe fn deref_mut<'a>(ptr: usize) -> &'a mut T

Mutably dereferences the given pointer. Read more
§

unsafe fn drop(ptr: usize)

Drops the object pointed to by the given pointer. Read more
§

impl<T> PolicyExt for T
where T: ?Sized,

§

fn and<P, B, E>(self, other: P) -> And<T, P>
where T: Sized + Policy<B, E>, P: Policy<B, E>,

Create a new Policy that returns [Action::Follow] only if self and other return Action::Follow. Read more
§

fn or<P, B, E>(self, other: P) -> Or<T, P>
where T: Sized + Policy<B, E>, P: Policy<B, E>,

Create a new Policy that returns [Action::Follow] if either self or other returns Action::Follow. Read more
§

impl<T> Read<Exclusive, BecauseExclusive> for T
where T: ?Sized,

Source§

impl<T> Same for T

Source§

type Output = T

Should always be Self
Source§

impl<T> ToOwned for T
where T: Clone,

Source§

type Owned = T

The resulting type after obtaining ownership.
Source§

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more
Source§

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more
Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = !

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, !>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.
§

impl<T> Upcast<T> for T

§

fn upcast(&self) -> Option<&T>

§

impl<V, T> VZip<V> for T
where V: MultiLane<T>,

§

fn vzip(self) -> V

§

impl<T> WasmNotSend for T
where T: Send,

§

impl<T> WasmNotSendSync for T
where T: WasmNotSend + WasmNotSync,

§

impl<T> WasmNotSync for T
where T: Sync,

§

impl<T> WithSubscriber for T

§

fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self> ⓘ
where S: Into<Dispatch>,

Attaches the provided Subscriber to this type, returning a [WithDispatch] wrapper. Read more
§

fn with_current_subscriber(self) -> WithDispatch<Self> ⓘ

Attaches the current default Subscriber to this type, returning a [WithDispatch] wrapper. Read more