Struct MotionController 

pub struct MotionController {
    pub graph: MotionGraph,
    pub current_state: String,
    pub state_time: f32,
    pub blend_state: Option<String>,
    pub blend_time: f32,
    pub blend_duration: f32,
    pub parameters: HashMap<String, f32>,
    pub total_time: f32,
}

Runtime controller that drives a MotionGraph.

Fields

graph: MotionGraph

The graph being controlled.

current_state: String

Name of the currently active state.

state_time: f32

Seconds spent in the current state (resets on transition).

blend_state: Option<String>

Name of the state being blended into (if any).

blend_time: f32

Seconds spent in the current blend.

blend_duration: f32

Total duration of the current blend.

parameters: HashMap<String, f32>

Named runtime float parameters used by transition conditions.

total_time: f32

Total time since the controller was created / reset.

Implementations

impl MotionController

pub fn new(graph: MotionGraph) -> Self

Create a controller and start in the graph’s entry state (or "idle" as a fallback).

pub fn set_parameter(&mut self, name: &str, value: f32)

Set (or overwrite) a named runtime parameter.

pub fn get_parameter(&self, name: &str) -> f32

Read a named runtime parameter (0.0 if not set).

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

Advance the controller by dt seconds.

1. Advances state_time and total_time.
2. Checks all transitions out of the current state in priority order.
3. If a condition fires, starts a blend to the target state.
4. Advances an in-progress blend; finalises it when complete.

pub fn transition_to(&mut self, state: &str, blend_duration: f32)

Force-start a transition to state with the given cross-fade duration. If blend_duration is 0.0, the transition is instantaneous.

pub fn blend_weight(&self) -> f32

Current blend weight in [0, 1].

• 0.0 → 100 % current state.
• 1.0 → 100 % destination state.

Returns 0.0 when not blending.

pub fn evaluate_morphs(&self) -> HashMap<String, f32>

Evaluate blended morph weights at the current instant.

When not blending, returns the current state’s morph weights unchanged. When blending, returns a linear interpolation between the current and destination state morph weights.

pub fn check_condition(&self, cond: &TransitionCondition) -> bool

Check whether a single TransitionCondition is currently satisfied.

pub fn is_blending(&self) -> bool

Returns true while a cross-fade blend is in progress.

pub fn current_state_name(&self) -> &str

The name of the currently active state.