colours 0.1.1

Color types for different color models with conversions between it.
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
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149

use super::{IsColorChannel, IsColor, HasAlpha, HasntAlpha, Rgba, Hsl, Hsv};

/// Generic RGB color
#[derive(Debug, Clone, Copy, PartialEq, Eq)]
pub struct Rgb<T> {
    pub red: T,
    pub green: T,
    pub blue: T,
}

impl<T: IsColorChannel> IsColor for Rgb<T> {
    type Channel = T;
}

impl<T: IsColorChannel> HasntAlpha for Rgb<T> {
    type Alphaful = Rgba<T>;

    fn with_alpha(self, alpha: Self::Channel) -> Self::Alphaful {
        let Rgb { red, green, blue } = self;
        Rgba { red, green, blue, alpha }
    }
}

impl<T> Rgb<T> {
    pub fn new(red: T, green: T, blue: T) -> Self {
        Self { red, green, blue }
    }
}

impl<T: IsColorChannel> Default for Rgb<T> {
    fn default() -> Self {
        Self::new(T::MIN, T::MIN, T::MIN)
    }
}

impl<T: IsColorChannel> From<Rgba<T>> for Rgb<T> {
    fn from(rgba: Rgba<T>) -> Self {
        rgba.without_alpha()
    }
}

impl From<Rgb<u8>> for Rgb<f32> {
    fn from(Rgb { red, green, blue }: Rgb<u8>) -> Self {
        Self::new(
            red as f32 / 255.0,
            green as f32 / 255.0,
            blue as f32 / 255.0,
        )
    }
}

impl From<Rgb<f32>> for Rgb<u8> {
    fn from(Rgb { red, green, blue }: Rgb<f32>) -> Self {
        Self::new(
            (red.clamp_channel() * 255.0).round() as u8,
            (green.clamp_channel() * 255.0).round() as u8,
            (blue.clamp_channel() * 255.0).round() as u8,
        )
    }
}

impl From<Hsl<f32>> for Rgb<f32> {
    fn from(Hsl { hue, saturation, lightness }: Hsl<f32>) -> Self {
        let hue = hue.unwind_channel();
        let saturation = saturation.clamp_channel();
        let lightness = lightness.clamp_channel();

        let c = (1.0 - (2.0 * lightness - 1.0).abs()) * saturation;
        let x = c * (1.0 - ((hue * 6.0) % 2.0 - 1.0).abs());
        let m = lightness - c / 2.0;

        hue_cxm_to_rgb(hue, c, x, m)
    }
}

impl From<Hsv<f32>> for Rgb<f32> {
    fn from(Hsv { hue, saturation, value }: Hsv<f32>) -> Self {
        let hue = hue.unwind_channel();
        let saturation = saturation.clamp_channel();
        let value = value.clamp_channel();

        let c = value * saturation;
        let x = c * (1.0 - ((hue * 6.0) % 2.0 - 1.0).abs());
        let m = value - c;

        hue_cxm_to_rgb(hue, c, x, m)
    }
}

fn hue_cxm_to_rgb(hue: f32, c: f32, x: f32, m: f32) -> Rgb<f32> {
    let mut red = 0.0;
    let mut green = 0.0;
    let mut blue = 0.0;

    if (hue >= 0.0 && hue < 1.0/6.0) || hue >= 1.0 {
        red = c;
        green = x;
    } else if hue >= 1.0/6.0 && hue < 1.0/3.0 {
        red = x;
        green = c;
    } else if hue >= 1.0/3.0 && hue < 0.5 {
        green = c;
        blue = x;
    } else if hue >= 0.5 && hue < 2.0/3.0 {
        green = x;
        blue = c;
    } else if hue >= 2.0/3.0 && hue < 5.0/6.0 {
        red = x;
        blue = c;
    } else if hue >= 5.0/6.0 && hue < 1.0 {
        red = c;
        blue = x;
    }

    red += m;
    green += m;
    blue += m;

    Rgb::new(red, green, blue)
}

#[cfg(test)]
mod test {
    use super::*;

    #[test]
    fn from_u8() {
        assert_eq!(Rgb::<f32>::from(Rgb::<u8>::new(84, 37, 181)),
                   Rgb::new(84.0/255.0, 37.0/255.0, 181.0/255.0));
    }

    #[test]
    fn from_f32() {
        assert_eq!(Rgb::<u8>::from(Rgb::<f32>::new(84.0/255.0, 37.0/255.0, 181.0/255.0)),
                   Rgb::new(84, 37, 181));
    }

    #[test]
    fn from_hsl() {
        assert_eq!(Rgb::<u8>::from(Rgb::from(Hsl::<f32>::from(Hsl::new(184u8, 168, 109)))),
                   Rgb::new(84u8, 37, 181));
    }

    #[test]
    fn from_hsv() {
        assert_eq!(Rgb::<u8>::from(Rgb::from(Hsv::<f32>::from(Hsv::new(12u8, 107, 66)))),
                   Rgb::new(66u8, 46, 38));
    }
}