equidistributed-colors 0.1.0

Iterator over colors which are distributed evenly according to the equidistribution theorem.
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

use hsl::HSL;
pub use rgb::RGB8;

use oklab::*;

const PHI: f64 = 0.618033988749895;

#[derive(Copy, Clone)]
/// Iterator over colors which are distributed evenly according to the equidistribution theorem.
/// Attempts to make the next color look as different as possible from all of the previously generated colors. 
/// 
/// Call [`EquiColor::next()`] to produce the next color. 
pub struct EquiColor {
    state: f64,
    s: f32,
    l: f32,
}

impl EquiColor {
    /// Create a color generator with the provided saturation and lightness (in range `[0.0, 1.0)`)
    pub fn new(s: f32, l: f32) -> Self {
        EquiColor {
            state: 0.0,
            s, l,
        }
    }
}

impl Default for EquiColor {
    fn default() -> Self {
        Self::new(1.0, 0.6)
    }
}

impl Iterator for EquiColor {
    type Item = RGB8;

    fn next(&mut self) -> Option<Self::Item> {
        let (r, g, b) = HSL {
            h: 360.0*self.state,
            s: self.s as f64,
            l: self.l as f64,
        }.to_rgb();

        self.state = (self.state + PHI) % 1.0;

        let mut oklab = srgb_to_oklab(RGB8 { r, g, b});
        oklab.l = self.l;

        Some(oklab_to_srgb(oklab))
    }
}

#[test]
fn first_three_colors_correct() {
    let mut equicolor = EquiColor::default();
    assert_eq!(equicolor.next(), Some(Rgb { r: 237, g: 22, b: 33 }));
    assert_eq!(equicolor.next(), Some(Rgb { r: 54, g: 115, b: 255 }));
    assert_eq!(equicolor.next(), Some(Rgb { r: 74, g: 152, b: 0 }));
}