palette 0.7.6

Convert and manage colors with a focus on correctness, flexibility and ease of use.
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

use crate::angle::{AngleEq, HalfRotation, RealAngle, SignedAngle};
use crate::num::{One, Zero};
use crate::visual::{VisualColor, VisuallyEqual};
use crate::{HasBoolMask, Okhsl, OklabHue};
use approx::AbsDiffEq;
use std::borrow::Borrow;
use std::ops::{Mul, Neg, Sub};

impl<T> VisualColor<T> for Okhsl<T>
where
    T: PartialOrd
        + HasBoolMask<Mask = bool>
        + AbsDiffEq<Epsilon = T>
        + One
        + Zero
        + Neg<Output = T>,
    T::Epsilon: Clone,
    OklabHue<T>: AbsDiffEq<Epsilon = T::Epsilon>,
{
    /// Returns true, if `saturation == 0`
    fn is_grey(&self, epsilon: T::Epsilon) -> bool {
        debug_assert!(self.saturation >= -epsilon.clone());
        self.saturation.abs_diff_eq(&T::zero(), epsilon)
    }

    /// Returns true, if `Self::is_grey` && `lightness >= 1`,
    /// i.e. the color's hue is irrelevant **and** it is at or beyond the
    /// `sRGB` maximum luminance. A color at or beyond maximum brightness isn't
    /// necessarily white. It may also be a bright shining hue.
    fn is_white(&self, epsilon: T::Epsilon) -> bool {
        self.is_grey(epsilon.clone()) && self.lightness > T::one()
            || self.lightness.abs_diff_eq(&T::one(), epsilon)
    }

    /// Returns true if `lightness == 0`
    fn is_black(&self, epsilon: T::Epsilon) -> bool {
        debug_assert!(self.lightness >= -epsilon.clone());
        self.lightness <= epsilon
    }
}

impl<S, O, T> VisuallyEqual<O, S, T> for Okhsl<T>
where
    T: PartialOrd
        + HasBoolMask<Mask = bool>
        + RealAngle
        + SignedAngle
        + Zero
        + One
        + AngleEq<Mask = bool>
        + Sub<Output = T>
        + AbsDiffEq<Epsilon = T>
        + Neg<Output = T>
        + Clone,
    T::Epsilon: Clone + HalfRotation + Mul<Output = T::Epsilon>,
    S: Borrow<Self> + Copy,
    O: Borrow<Self> + Copy,
{
    fn visually_eq(s: S, o: O, epsilon: T::Epsilon) -> bool {
        VisuallyEqual::both_black_or_both_white(s, o, epsilon.clone())
            || VisuallyEqual::both_greyscale(s, o, epsilon.clone())
                && s.borrow()
                    .lightness
                    .abs_diff_eq(&o.borrow().lightness, epsilon.clone())
            || s.borrow().hue.abs_diff_eq(&o.borrow().hue, epsilon.clone())
                && s.borrow()
                    .saturation
                    .abs_diff_eq(&o.borrow().saturation, epsilon.clone())
                && s.borrow()
                    .lightness
                    .abs_diff_eq(&o.borrow().lightness, epsilon)
    }
}