Struct Timeline 

pub struct Timeline { /* private fields */ }

A timeline that schedules multiple animations at specific offsets.

Implements Animation where value() returns overall progress (0.0–1.0).

Implementations

impl Timeline

pub fn new() -> Self

Create an empty timeline.

pub fn add(self, offset: Duration, animation: impl Animation + 'static) -> Self

Add an animation event at an absolute offset (builder pattern).

pub fn add_labeled( self, label: &str, offset: Duration, animation: impl Animation + 'static, ) -> Self

Add a labeled animation event at an absolute offset (builder pattern).

pub fn then(self, animation: impl Animation + 'static) -> Self

Add an event relative to the last event’s offset (builder pattern).

If no events exist, the offset is 0.

pub fn set_duration(self, d: Duration) -> Self

Set the total duration explicitly (builder pattern).

If not called, duration is inferred as max(event.offset). A zero duration is clamped to 1ns.

pub fn set_loop_count(self, count: LoopCount) -> Self

Set the loop count (builder pattern).

impl Timeline

pub fn play(&mut self)

Start or restart playback from the beginning.

pub fn pause(&mut self)

Pause playback. No-op if not playing.

pub fn resume(&mut self)

Resume from pause. No-op if not paused.

pub fn stop(&mut self)

Stop playback and reset to idle.

pub fn seek(&mut self, time: Duration)

Seek to an absolute time position.

Clamps to [0, total_duration]. Resets all animations and re-ticks them up to the seek point so their state is consistent.

pub fn seek_label(&mut self, label: &str) -> bool

Seek to a labeled event’s offset.

Returns true if the label was found, false otherwise (no-op).

pub fn progress(&self) -> f32

Current progress as a value in [0.0, 1.0].

pub fn state(&self) -> PlaybackState

Current playback state.

pub fn current_time(&self) -> Duration

Current time position.

pub fn duration(&self) -> Duration

Total duration.

pub fn event_count(&self) -> usize

Number of events in the timeline.

pub fn event_value(&self, label: &str) -> Option<f32>

Get the animation value for a specific labeled event.

Returns None if the label doesn’t exist.

pub fn event_value_at(&self, index: usize) -> Option<f32>

Get the animation value for an event by index.

Returns None if index is out of bounds.

Trait Implementations

impl Animation for Timeline

fn tick(&mut self, dt: Duration)

Advance the animation by dt.

fn is_complete(&self) -> bool

Whether the animation has reached its end.

fn value(&self) -> f32

Current output value, clamped to [0.0, 1.0].

fn reset(&mut self)

Reset the animation to its initial state.

fn overshoot(&self) -> Duration

Time elapsed past completion. Used by composition types to forward remaining time (e.g., Sequence forwards overshoot from first to second). Returns Duration::ZERO for animations that never complete.

impl Debug for Timeline

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

Formats the value using the given formatter.

impl Default for Timeline

fn default() -> Self

Returns the “default value” for a type.