Struct AnimationMixer 

pub struct AnimationMixer {
    pub time: f32,
    pub time_scale: f32,
    pub enabled: bool,
    /* private fields */
}

Manages playback and blending of multiple animation actions.

The mixer drives time advancement for all active actions, accumulates sampled animation data into per-node blend buffers, and applies the final blended result to scene nodes once per frame.

Rest Pose & State Restoration

The mixer tracks which nodes were animated in the previous frame. When a node loses all animation influence (e.g. an action is stopped), it is automatically restored to its rest pose.

Blending

When multiple actions are active simultaneously, their contributions are combined using weight-based accumulation. If the total accumulated weight for a property is less than 1.0, the rest pose value fills the remainder.

Events

Animation events fired during the frame are collected and can be consumed via drain_events.

Fields

time: f32

Global mixer time in seconds.

time_scale: f32

Global time scale multiplier applied to all actions.

enabled: bool

Implementations

impl AnimationMixer

pub fn new() -> AnimationMixer

pub fn set_rig(&mut self, rig: Rig)

Sets the logical skeleton used for bone-index → node-handle lookup.

pub fn rig(&self) -> &Rig

Returns a read-only reference to the mixer’s rig.

pub fn list_animations(&self) -> Vec<String>

Returns a list of all registered animation clip names.

pub fn add_action(&mut self, action: AnimationAction) -> ActionHandle

Registers an action and returns its handle.

pub fn get_action(&self, name: &str) -> Option<&AnimationAction>

Read-only access to an action by clip name.

pub fn get_action_by_handle( &self, handle: ActionHandle, ) -> Option<&AnimationAction>

Read-only access to an action by handle.

pub fn action(&mut self, name: &str) -> Option<ActionControl<'_>>

Returns a chainable control wrapper for the named action.

pub fn any_action(&mut self) -> Option<ActionControl<'_>>

Returns a control wrapper for the first registered action.

pub fn get_control(&mut self, handle: ActionHandle) -> Option<ActionControl<'_>>

Returns a control wrapper for an existing handle.

pub fn get_control_by_name(&mut self, name: &str) -> Option<ActionControl<'_>>

pub fn play(&mut self, name: &str)

Plays the named animation, adding it to the active set.

pub fn stop(&mut self, name: &str)

Stops the named animation and removes it from the active set.

pub fn stop_all(&mut self)

Stops all active animations.

pub fn drain_events(&mut self) -> Vec<FiredEvent>

Drains all events fired during the most recent update.

pub fn events(&self) -> &[FiredEvent]

Returns a read-only slice of events fired during the most recent update.

pub fn update(&mut self, dt: f32, target: &mut dyn AnimationTarget)

Advances all active actions and applies blended results to the target.

This is the core per-frame entry point. The update proceeds in four phases:

1. Time advancement: Each active action’s time is advanced. Animation events that fall within the [t_prev, t_curr] window are collected.
2. Sampling & accumulation: Active actions sample their tracks and accumulate weighted results into the blend buffer. Track-to-node mapping uses crate::binding::ClipBinding + Rig for O(1) lookup.
3. Application: Blended values are mixed with the rest pose and written to scene nodes.
4. Restoration: Nodes that were animated last frame but received no contributions this frame are reset to their rest pose.

Trait Implementations

impl Default for AnimationMixer

fn default() -> AnimationMixer

Returns the “default value” for a type.