Struct Keyframes 

pub struct Keyframes<Value> { /* private fields */ }

A nonempty track starting at zero, with absolute destinations and relative holds.

Exact timestamps return stored values. Intervals use the arriving point’s easing, while holds clone their value without invoking interpolation. Sampling is stateless and uses integer ticks for interval selection before f64 progress.

This is the canonical crate::Keyframes type.

use motion_core::prelude::*;
use motion_core::{
    DisplayList, RasterLimits, ResourcePool, ValidatedDisplayList, MAX_PATH_VERBS,
    MAX_STROKE_VERBS, MAX_SVG_PATH_BYTES, sample_offsets,
};
let track = Keyframes::new(0.0_f64)
    .to(1.seconds(), 10.0, Easing::QuadraticIn)
    .hold(500.milliseconds())
    .to(2.5.seconds(), 20.0, Easing::Linear);
assert_eq!(track.sample(500.milliseconds()), 2.5);
assert_eq!(track.sample(1250.milliseconds()), 10.0);
assert_eq!(track.sample(2.seconds()), 15.0);
assert_eq!(track.duration(), Some(2.5.seconds()));

Implementations

impl<Value> Keyframes<Value>

pub fn new(value: Value) -> Self

Starts with a value at zero. Without further points the finite duration is zero and every sample returns this value.

pub fn to(self, at: Time, value: Value, easing: Easing) -> Self

Appends a destination at an absolute local time, not an added duration. The easing controls the segment arriving at this value.

Panics

Panics unless at is strictly later than the previous point, including any appended hold, or for invalid easing parameters. Equal, negative and descending times are not sorted or converted into instantaneous jumps.

impl<Value: Clone> Keyframes<Value>

pub fn hold(self, duration: Duration) -> Self

Holds the last value for an additional duration, without interpolation. Zero is a no-op, leaving the last timestamp unchanged.

Panics

Panics for a negative duration or signed tick overflow.

Trait Implementations

impl<Value: Interpolate + Send + Sync> Animation<Value> for Keyframes<Value>

fn sample(&self, time: Time) -> Value

Samples without advancing a clock or changing playback state.

fn duration(&self) -> Option<Duration>

Returns the finite duration, or None for an unbounded signal.

fn map<Output, Function>(self, function: Function) -> Map<Self, Function, Value>

where Self: Sized, Function: Fn(Value) -> Output + Send + Sync,

Transforms values without changing timing.

fn zip<OtherValue, Other>(self, other: Other) -> Zip<Self, Other>

where Self: Sized, Other: Animation<OtherValue>,

Samples in parallel; the duration is infinite if either input is infinite.

fn delay(self, offset: Duration) -> Delay<Self>

where Self: Sized,

Delays a finite animation, holding its initial value before the offset. Infinite signals shift their signed time instead. Negative offsets and finite duration overflow panic at construction.

fn speed(self, factor: f64) -> Speed<Self>

where Self: Sized,

Changes playback speed by a finite, strictly positive factor. Durations round to the nearest tick; a collapsed finite animation becomes instantaneous. Invalid factors and unrepresentable durations panic.

fn then<Next: Animation<Value>>(self, next: Next) -> Then<Self, Next>

where Self: Sized,

Runs two finite animations in sequence. The second owns their shared boundary. Infinite sources or duration overflow panic at construction.

fn reverse(self) -> Reverse<Self>

where Self: Sized,

Reverses a finite animation. Infinite sources panic at construction.

fn repeat(self, count: u32) -> Repeat<Self>

where Self: Sized,

Plays a finite animation count times. Intermediate boundaries restart; the final boundary holds the target. Zero repeats hold the initial value. Infinite sources or duration overflow panic at construction.

fn ping_pong(self) -> PingPong<Self>

where Self: Sized,

Plays a finite animation forward then backward, ending at its initial value. Infinite sources or duration overflow panic at construction.

fn boxed(self) -> Arc<dyn Animation<Value>>

where Self: Sized + 'static,

Shares a type-erased animation, retaining sampling and combinators.

impl<Value: Clone> Clone for Keyframes<Value>

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<Value: Debug> Debug for Keyframes<Value>

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

Formats the value using the given formatter.