[go: up one dir, main page]

vek 0.1.0

(placeholder) Colorful vector+matrix+quaternion+basic shapes library for graphics, with focus on intent and the small bits that make you happier as a user.
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

extern crate num_traits;

use self::num_traits::{Zero};
use core::ops::{Range, Sub};

use clamp::Clamp01;
use lerp::Lerp;

/// A convenience structure for storing a linear progression from a value to another.
#[derive(Debug, Default, Clone, Copy, Hash)]
pub struct Tween<T, Progress=f32> {
    /// The value when progress gets close to 0.
    pub start: T,
    /// The value when progress gets close to 1.
    pub end: T,
    /// Expected to be between 0 and 1.
    pub progress: Progress
}
impl<T, Progress> From<Range<T>> for Tween<T, Progress> where Progress: Zero {
    fn from(r: Range<T>) -> Self {
        Tween { start: r.start, end: r.end, progress: Zero::zero() }
    }
}
impl<T, Progress> Tween<T, Progress> where T: Lerp<Progress>, Progress: Clone + Clamp01 + Sub<Output=Progress> {
    /// Gets the transition's current state, clamping progress to [0;1].
    pub fn current(self) -> T {
        T::lerp(self.start, self.end, self.progress)
    }
    /// Gets the transition's current state using the `progress` value as-is.
    pub fn current_unclamped(self) -> T {
        T::lerp_unclamped(self.start, self.end, self.progress)
    }
    pub fn into_range(self) -> Range<T> {
        let Tween { start, end, .. } = self;
        Range { start, end }
    }
    pub fn to_range(&self) -> Range<T> where T: Clone {
        let &Tween { ref start, ref end, .. } = self;
        Range { start: start.clone(), end: end.clone() }
    }
}