Struct KeyframeTrack 

pub struct KeyframeTrack<T>
where
    T: Animatable,
{
    pub looping: Loop,
    /* private fields */
}

A sorted collection of keyframes that evaluates a value over time.

Empty tracks are valid. They evaluate to None instead of requiring T: Default or panicking.

Example

use animato_core::{Easing, Update};
use animato_tween::KeyframeTrack;

let mut track = KeyframeTrack::new()
    .push_eased(0.0, 0.0_f32, Easing::EaseOutCubic)
    .push(1.0, 100.0);

track.update(0.5);
assert!(track.value().unwrap() > 50.0);

Fields

looping: Loop

Looping behavior for this track.

Implementations

impl<T> KeyframeTrack<T>

where T: Animatable,

pub fn new() -> KeyframeTrack<T>

Create an empty keyframe track.

pub fn push(self, time: f32, value: T) -> KeyframeTrack<T>

Insert a linear keyframe and keep the track sorted by time.

If another frame already exists at the same time, it is replaced.

pub fn push_eased(self, time: f32, value: T, easing: Easing) -> KeyframeTrack<T>

Insert a keyframe with an explicit segment easing.

If another frame already exists at the same time, it is replaced.

pub fn looping(self, mode: Loop) -> KeyframeTrack<T>

Set the looping behavior.

pub fn frames(&self) -> &[Keyframe<T>]

All frames in sorted order.

pub fn elapsed(&self) -> f32

Current elapsed time in seconds.

pub fn duration(&self) -> f32

Base duration in seconds, equal to the last keyframe time.

pub fn progress(&self) -> f32

Normalized progress through the current finite playback span.

pub fn value_at(&self, secs: f32) -> Option<T>

Evaluate the track at an absolute time in seconds.

pub fn value(&self) -> Option<T>

Current value based on the track’s elapsed time.

pub fn is_complete(&self) -> bool

true when the track has finished all finite playback.

pub fn reset(&mut self)

Reset to the beginning of the track.

Trait Implementations

impl<T> Clone for KeyframeTrack<T>

where T: Clone + Animatable,

fn clone(&self) -> KeyframeTrack<T>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<T> Debug for KeyframeTrack<T>

where T: Debug + Animatable,

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

Formats the value using the given formatter.

impl<T> Default for KeyframeTrack<T>

where T: Animatable,

fn default() -> KeyframeTrack<T>

Returns the “default value” for a type.

impl<T> Playable for KeyframeTrack<T>

where T: Animatable,

fn duration(&self) -> f32

Total finite duration in seconds.

fn reset(&mut self)

Reset the animation to its initial state.

fn seek_to(&mut self, progress: f32)

Seek to normalized progress through the animation.

fn is_complete(&self) -> bool

true when the animation has reached its terminal state.

fn as_any(&self) -> &(dyn Any + 'static)

Return a type-erased shared reference for downcasting.

fn as_any_mut(&mut self) -> &mut (dyn Any + 'static)

Return a type-erased mutable reference for downcasting.

impl<T> Update for KeyframeTrack<T>

where T: Animatable,

fn update(&mut self, dt: f32) -> bool

Advance the animation by dt seconds.