aura-anim-iced 0.2.0

Iced-first animation primitives.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92

use super::{Hold, Parallel, Sequence, Track};
use crate::{property::PropertySnapshot, timing::Duration};

/// A timeline step that can contribute duration to a timeline.
#[derive(Debug, Clone, PartialEq)]
pub enum TimelineStep {
    /// A keyframe track.
    Track(Track),
    /// A sequential group of steps.
    Sequence(Sequence),
    /// A parallel group of steps.
    Parallel(Parallel),
    /// A silent hold segment.
    Hold(Hold),
}

impl TimelineStep {
    /// Returns the finite total duration of this step, or `None` for infinite tracks.
    #[must_use]
    pub fn total_duration(&self) -> Option<Duration> {
        match self {
            Self::Track(track) => track.total_duration(),
            Self::Sequence(sequence) => sequence.total_duration(),
            Self::Parallel(parallel) => parallel.total_duration(),
            Self::Hold(hold) => Some(hold.total_duration()),
        }
    }

    /// Samples this step at local timeline `offset`.
    #[must_use]
    pub fn sample_at(&self, offset: impl Into<Duration>) -> Option<PropertySnapshot> {
        match self {
            Self::Track(track) => track.sample_at(offset),
            Self::Sequence(sequence) => sequence.sample_at(offset),
            Self::Parallel(parallel) => parallel.sample_at(offset),
            Self::Hold(_) => None,
        }
    }

    /// Samples the final visual state for this step.
    #[must_use]
    pub fn completion_snapshot(&self) -> Option<PropertySnapshot> {
        match self {
            Self::Track(track) => track.completion_snapshot(),
            Self::Sequence(sequence) => sequence.completion_snapshot(),
            Self::Parallel(parallel) => parallel.completion_snapshot(),
            Self::Hold(_) => None,
        }
    }

    pub(crate) fn sample_entry_hint(&self) -> usize {
        match self {
            Self::Track(track) => track.keyframes().track_count(),
            Self::Sequence(sequence) => sequence.steps().iter().map(Self::sample_entry_hint).sum(),
            Self::Parallel(parallel) => parallel
                .steps()
                .iter()
                .map(Self::sample_entry_hint)
                .max()
                .unwrap_or(0),
            Self::Hold(_) => 0,
        }
    }

    pub(crate) fn is_hold(&self) -> bool {
        matches!(self, Self::Hold(_))
    }
}

impl From<Track> for TimelineStep {
    fn from(value: Track) -> Self {
        Self::Track(value)
    }
}

impl From<Sequence> for TimelineStep {
    fn from(value: Sequence) -> Self {
        Self::Sequence(value)
    }
}

impl From<Parallel> for TimelineStep {
    fn from(value: Parallel) -> Self {
        Self::Parallel(value)
    }
}

impl From<Hold> for TimelineStep {
    fn from(value: Hold) -> Self {
        Self::Hold(value)
    }
}