Struct MotionPlayer 

pub struct MotionPlayer { /* private fields */ }

Plays a parsed motion3.json animation against a ModelRuntime.

A player owns playback time and blend weight. It does not update meshes by itself; call ModelRuntime::update_meshes after applying one or more players.

Implementations

impl MotionPlayer

pub fn new(motion: Motion3) -> Self

Creates a player at time 0.0 with full weight.

The player follows the motion’s own Loop metadata.

pub fn new_once(motion: Motion3) -> Self

Creates a player that stops at the end, ignoring the motion’s Loop metadata.

pub fn with_looping(motion: Motion3, looping: bool) -> Self

Creates a player with an explicit loop mode.

pub fn motion(&self) -> &Motion3

Returns the motion data owned by this player.

pub fn time(&self) -> f32

Returns the current playback time in seconds.

pub fn weight(&self) -> f32

Returns the player’s global blend weight.

pub fn is_looping(&self) -> bool

Returns whether this player wraps at the motion duration.

pub fn set_weight(&mut self, weight: f32)

Sets the player’s global blend weight, clamped to 0.0..=1.0.

pub fn is_finished(&self) -> bool

Returns whether a one-shot motion has reached its end.

pub fn restart(&mut self)

Restarts playback from the beginning.

pub fn tick(&mut self, delta_seconds: f32)

Advances playback time by delta_seconds.

Negative deltas are treated as zero. Looping motions wrap at their declared duration; non-looping motions stop at the end.

pub fn apply(&self, runtime: &mut ModelRuntime)

Applies the current motion sample to a model runtime.

Curves targeting unknown parameters or parts are ignored. Call ModelRuntime::update_meshes after all motion and expression players have been applied for the frame.

Trait Implementations

impl Clone for MotionPlayer

fn clone(&self) -> MotionPlayer

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for MotionPlayer

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

Formats the value using the given formatter.