colorgrad 0.8.0

Color scales library for data visualization, charts, games, generative art and others.
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

use crate::{BlendMode, Color};

pub(crate) fn convert_colors(
    colors: &[Color],
    mode: BlendMode,
) -> impl Iterator<Item = [f32; 4]> + use<'_> {
    colors.iter().map(move |c| match mode {
        BlendMode::Rgb => c.to_array(),
        BlendMode::LinearRgb => c.to_linear_rgba(),
        BlendMode::Oklab => c.to_oklaba(),
        #[cfg(feature = "lab")]
        BlendMode::Lab => c.to_laba(),
    })
}

#[inline]
pub(crate) fn interpolate_linear(a: &[f32; 4], b: &[f32; 4], t: f32) -> [f32; 4] {
    [
        a[0] + t * (b[0] - a[0]),
        a[1] + t * (b[1] - a[1]),
        a[2] + t * (b[2] - a[2]),
        a[3] + t * (b[3] - a[3]),
    ]
}

pub(crate) fn linspace(min: f32, max: f32, n: usize) -> impl Iterator<Item = f32> {
    let d = max - min;
    let l = n as f32 - 1.0;

    (0..n).map(move |i| {
        if n == 1 {
            min
        } else {
            min + (i as f32 * d) / l
        }
    })
}

#[inline]
pub(crate) fn modulo(x: f32, y: f32) -> f32 {
    (x % y + y) % y
}

// Map t from range [a, b] to range [0, 1]
#[inline]
pub(crate) fn norm(t: f32, a: f32, b: f32) -> f32 {
    (t - a) * (1.0 / (b - a))
}

#[cfg(test)]
mod tests {
    use super::*;
    use alloc::vec::Vec;

    #[test]
    fn utils() {
        assert_eq!(linspace(0.0, 1.0, 0).next(), None);
        assert_eq!(linspace(0.0, 1.0, 1).collect::<Vec<_>>(), [0.0]);
        assert_eq!(linspace(0.0, 1.0, 2).collect::<Vec<_>>(), [0.0, 1.0]);
        assert_eq!(linspace(0.0, 1.0, 3).collect::<Vec<_>>(), [0.0, 0.5, 1.0]);
        assert_eq!(
            linspace(-1.0, 1.0, 5).collect::<Vec<_>>(),
            [-1.0, -0.5, 0.0, 0.5, 1.0]
        );
        assert_eq!(
            linspace(0.0, 100.0, 5).collect::<Vec<_>>(),
            [0.0, 25.0, 50.0, 75.0, 100.0]
        );

        assert_eq!(modulo(7.0, 10.0), 7.0);
        assert_eq!(modulo(17.0, 10.0), 7.0);

        assert_eq!(norm(0.79, 0.0, 1.0), 0.79);
        assert_eq!(norm(16.0, 0.0, 100.0), 0.16);
        assert_eq!(norm(20.0, 15.0, 25.0), 0.5);
    }
}