tempa 0.1.9

A no_std temporal system for animation and simulation, providing time, duration, time ranges, frame rates, and deterministic frame-index stepping.
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
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121

use core::ops::{Div, Mul};

use rinia::{
    Scalard, Scalarf,
    numeric::{Floor, IsFinite, LossyCast, SaturatingCast, Zero},
};

use crate::{Error, FrameIndex, FrameRate, Time, common};

impl<T> Time<T> {
    /// Creates [Time] from seconds without validation.
    ///
    /// This function allows invalid values to be used, which may lead to invalid results in
    /// subsequent calculations.
    ///
    /// Prefer [Self::from_seconds] for validated construction.
    #[inline]
    pub const fn new(seconds: T) -> Self {
        Self(seconds)
    }

    /// Creates [Time] from seconds with validation.
    ///
    /// Returns an error if seconds is NaN or infinite.
    #[inline]
    pub fn try_from_seconds(seconds: T) -> Result<Self, Error>
    where
        T: Copy + IsFinite,
    {
        if seconds.is_finite() {
            Ok(Self(seconds))
        } else {
            Err(Error::InvalidValue("Time cannot be created from NaN or infinite values"))
        }
    }

    /// Creates [Time] from seconds with validation.
    ///
    /// # Panics
    /// Panics if seconds is NaN or infinite.
    #[inline]
    pub fn from_seconds(seconds: T) -> Self
    where
        T: Copy + IsFinite,
    {
        Self::try_from_seconds(seconds).unwrap_or_else(|err| panic!("{err}"))
    }

    /// Returns this [Time] value in seconds.
    #[inline]
    pub const fn seconds(&self) -> T
    where
        T: Copy,
    {
        self.0
    }

    /// Consumes this [Time] value and returns the inner seconds value.
    #[inline]
    pub fn into_seconds(self) -> T {
        self.0
    }

    /// Converts this time value to [FrameIndex] using the given [FrameRate].
    #[inline]
    pub fn to_frame<I>(self, rate: FrameRate<T>) -> FrameIndex<I>
    where
        T: Copy + Mul<Output = T> + Floor + SaturatingCast<I>,
    {
        common::frame_from_time(self, rate)
    }

    /// Creates [Time] from [FrameIndex] at the specified [FrameRate].
    #[inline]
    pub fn from_frame<I>(frame: FrameIndex<I>, rate: FrameRate<T>) -> Self
    where
        T: Copy + Div<Output = T>,
        I: Copy + LossyCast<T>,
    {
        common::time_from_frame(frame, rate)
    }
}

// Impl Default for Time<T>
impl<T> Default for Time<T>
where
    Self: Zero,
{
    fn default() -> Self {
        Self::ZERO
    }
}

// Conversion
impl<T> From<T> for Time<T> {
    fn from(seconds: T) -> Self {
        Self(seconds)
    }
}

impl From<Time<Scalarf>> for Scalarf {
    fn from(time: Time<Scalarf>) -> Self {
        time.0
    }
}

impl From<Time<Scalard>> for Scalard {
    fn from(time: Time<Scalard>) -> Self {
        time.0
    }
}

// Impl approx equality traits for Time<T>
common::impl_approx_forwarding!(Time<T>, 0);

// Impl bytemuck for Time<T>
common::impl_bytemuck_basic!(
    [T],
    Time<T>,
    item: T,
);