Struct MotionRuntime 

pub struct MotionRuntime { /* private fields */ }

Stores animations, advances active values, and queues lifecycle events.

Examples

use aura_anim_core::{runtime::MotionRuntime, timing::Timing};
use std::time::Duration;

let mut runtime = MotionRuntime::new();
let opacity = runtime.motion_with(0.0_f32, Timing::new(100.0));

opacity.transition_to(1.0, &mut runtime).unwrap();
runtime.tick(Duration::from_millis(50));

assert_eq!(opacity.value(&runtime).unwrap(), 0.5);
assert!(opacity.is_active(&runtime).unwrap());
assert!(runtime.events().is_empty());

Implementations

impl MotionRuntime

pub fn new() -> Self

Creates an empty motion runtime.

pub fn motion<T: Animatable>(&mut self, initial: T) -> Motion<T>

Inserts an idle motion with the default transition timing.

pub fn motion_with<T: Animatable>( &mut self, initial: T, timing: Timing, ) -> Motion<T>

Inserts an idle motion with the provided transition timing.

pub fn insert<T: Animatable>( &mut self, animation: impl Animation<T>, transition: Timing, ) -> Motion<T>

Inserts an animation that remains stored after it settles.

pub fn play_once<T: Animatable>( &mut self, animation: impl Animation<T>, ) -> Motion<T>

Inserts an animation that is removed after it settles.

pub fn insert_with_policy<T: Animatable>( &mut self, animation: impl Animation<T>, transition: Timing, retain_policy: RetainPolicy, ) -> Motion<T>

Inserts an animation with transition timing and a retention policy.

pub fn tick(&mut self, delta: impl Into<Duration>)

Advances every active animation by delta.

pub fn tick_at(&mut self, now: Instant)

Advances active animations using elapsed wall-clock time.

The first call establishes the clock origin and advances by zero.

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

Returns queued lifecycle events without consuming them.

pub fn take_events(&mut self) -> Vec<MotionEvent>

Takes all queued lifecycle events.

Events remain queued until they are taken or explicitly cleared.

pub fn clear_events(&mut self)

Removes all queued lifecycle events.

pub fn pending_event_count(&self) -> usize

Returns the number of queued lifecycle events.

pub fn active_count(&self) -> usize

Returns the number of animations currently marked active.

pub fn has_active(&self) -> bool

Returns whether at least one animation is active.

pub fn motion_count(&self) -> usize

Returns the number of stored animations.

pub fn slot_capacity(&self) -> usize

Returns the allocated capacity of the runtime slot storage.

pub fn shrink_to_fit(&mut self)

Releases unused slot and queue capacity.

pub fn value<T: Animatable>(&self, motion: Motion<T>) -> Result<&T, MotionError>

Returns the current value for motion.

pub fn state<T: Animatable>( &self, motion: Motion<T>, ) -> Result<AnimationState, MotionError>

Returns the lifecycle state for motion.

pub fn playback<T: Animatable>( &self, motion: Motion<T>, ) -> Result<PlaybackId, MotionError>

Returns the ID of the motion’s current playback.

pub fn is_active<T: Animatable>( &self, motion: Motion<T>, ) -> Result<bool, MotionError>

Returns whether motion is active.

pub fn transition_to<T: Animatable>( &mut self, motion: Motion<T>, target: T, ) -> Result<(), MotionError>

Transitions motion toward target.

pub fn transition_to_tracked<T: Animatable>( &mut self, motion: Motion<T>, target: T, ) -> Result<PlaybackId, MotionError>

Transitions motion toward target and returns its new playback ID.

pub fn play<T, P, Kind>( &mut self, motion: Motion<T>, playback: P, ) -> Result<(), MotionError>

where T: Animatable, P: IntoMotionAnimation<T, Kind>,

Replaces the animation associated with motion.

pub fn play_tracked<T, P, Kind>( &mut self, motion: Motion<T>, playback: P, ) -> Result<PlaybackId, MotionError>

where T: Animatable, P: IntoMotionAnimation<T, Kind>,

Replaces the animation associated with motion and returns its playback ID.

pub fn command<T: Animatable>( &mut self, motion: Motion<T>, command: AnimationCommand, ) -> Result<(), MotionError>

Applies a command to motion.

pub fn command_all(&mut self, command: AnimationCommand)

Applies command to every stored motion.

This includes idle, running, paused, and settled motions. Commands keep their normal per-animation semantics, including terminal events and RetainPolicy::DropWhenSettled removal.

pub fn remove<T: Animatable>( &mut self, motion: Motion<T>, ) -> Result<(), MotionError>

Removes the animation referenced by motion.

Trait Implementations

impl Default for MotionRuntime

fn default() -> MotionRuntime

Returns the “default value” for a type.