Struct palette::lab::Lab

#[repr(C)]
pub struct Lab<Wp = D65, T = f32> {
    pub l: T,
    pub a: T,
    pub b: T,
    pub white_point: PhantomData<Wp>,
}

The CIE L*a*b* (CIELAB) color space.

CIE L*a*b* is a device independent color space which includes all perceivable colors. It’s sometimes used to convert between other color spaces, because of its ability to represent all of their colors, and sometimes in color manipulation, because of its perceptual uniformity. This means that the perceptual difference between two colors is equal to their numerical difference. It was, however, never designed for the perceptual qualities required for gamut mapping. For perceptually uniform color manipulation the newer color spaces based on Oklab are preferable: Oklch, Okhsv, Okhsl, Okhwb (Note that the latter three are tied to the sRGB gamut and reference white).

The parameters of L*a*b* are quite different, compared to many other color spaces, so manipulating them manually may be unintuitive.

Fields

l: T

L* is the lightness of the color. 0.0 gives absolute black and 100 give the brightest white.

a: T

a* goes from red at -128 to green at 127.

b: T

b* goes from yellow at -128 to blue at 127.

white_point: PhantomData<Wp>

The white point associated with the color’s illuminant and observer. D65 for 2 degree observer is used by default.

Implementations

impl<Wp, T> Lab<Wp, T>

pub const fn new(l: T, a: T, b: T) -> Lab<Wp, T>

Create a CIE L*a*b* color.

pub fn into_components(self) -> (T, T, T)

Convert to a (L\*, a\*, b\*) tuple.

pub fn from_components((l, a, b): (T, T, T)) -> Self

Convert from a (L\*, a\*, b\*) tuple.

impl<Wp, T> Lab<Wp, T>

where T: Zero + Real,

pub fn min_l() -> T

Return the l value minimum.

pub fn max_l() -> T

Return the l value maximum.

pub fn min_a() -> T

Return the a value minimum.

pub fn max_a() -> T

Return the a value maximum.

pub fn min_b() -> T

Return the b value minimum.

pub fn max_b() -> T

Return the b value maximum.

impl<Wp, T> Lab<Wp, &T>

pub fn copied(&self) -> Lab<Wp, T>

where T: Copy,

Get an owned, copied version of this color.

pub fn cloned(&self) -> Lab<Wp, T>

where T: Clone,

Get an owned, cloned version of this color.

impl<Wp, T> Lab<Wp, &mut T>

pub fn set(&mut self, value: Lab<Wp, T>)

Update this color with new values.

pub fn as_refs(&self) -> Lab<Wp, &T>

Borrow this color’s components as shared references.

pub fn copied(&self) -> Lab<Wp, T>

where T: Copy,

Get an owned, copied version of this color.

pub fn cloned(&self) -> Lab<Wp, T>

where T: Clone,

Get an owned, cloned version of this color.

impl<Wp, C> Lab<Wp, C>

pub fn iter<'a>(&'a self) -> <&'a Self as IntoIterator>::IntoIter

where &'a Self: IntoIterator,

Return an iterator over the colors in the wrapped collections.

pub fn iter_mut<'a>(&'a mut self) -> <&'a mut Self as IntoIterator>::IntoIter

where &'a mut Self: IntoIterator,

Return an iterator that allows modifying the colors in the wrapped collections.

pub fn get<'a, I, T>( &'a self, index: I, ) -> Option<Lab<Wp, &<I as SliceIndex<[T]>>::Output>>

where T: 'a, C: AsRef<[T]>, I: SliceIndex<[T]> + Clone,

Get a color, or slice of colors, with references to the components at index. See slice::get for details.

pub fn get_mut<'a, I, T>( &'a mut self, index: I, ) -> Option<Lab<Wp, &mut <I as SliceIndex<[T]>>::Output>>

where T: 'a, C: AsMut<[T]>, I: SliceIndex<[T]> + Clone,

Get a color, or slice of colors, that allows modifying the components at index. See slice::get_mut for details.

impl<Wp, T> Lab<Wp, Vec<T>>

pub fn with_capacity(capacity: usize) -> Self

Create a struct of vectors with a minimum capacity. See Vec::with_capacity for details.

pub fn push(&mut self, value: Lab<Wp, T>)

Push an additional color’s components onto the component vectors. See Vec::push for details.

pub fn pop(&mut self) -> Option<Lab<Wp, T>>

Pop a color’s components from the component vectors. See Vec::pop for details.

pub fn clear(&mut self)

Clear the component vectors. See Vec::clear for details.

pub fn drain<R>(&mut self, range: R) -> Iter<Drain<'_, T>, Wp>

where R: RangeBounds<usize> + Clone,

Return an iterator that moves colors out of the specified range.

Trait Implementations

impl<Wp, T> AbsDiffEq for Lab<Wp, T>

where T: AbsDiffEq, T::Epsilon: Clone,

type Epsilon = <T as AbsDiffEq>::Epsilon

Used for specifying relative comparisons.

fn default_epsilon() -> Self::Epsilon

The default tolerance to use when testing values that are close together.

fn abs_diff_eq(&self, other: &Self, epsilon: T::Epsilon) -> bool

A test for equality that uses the absolute difference to compute the approximate equality of two numbers.

fn abs_diff_ne(&self, other: &Self, epsilon: T::Epsilon) -> bool

The inverse of AbsDiffEq::abs_diff_eq.

impl<Wp, T> Add<T> for Lab<Wp, T>

where T: Add<Output = T> + Clone,

type Output = Lab<Wp, T>

The resulting type after applying the + operator.

fn add(self, c: T) -> Self::Output

Performs the + operation.

impl<Wp, T> Add for Lab<Wp, T>

where T: Add<Output = T>,

type Output = Lab<Wp, T>

The resulting type after applying the + operator.

fn add(self, other: Self) -> Self::Output

Performs the + operation.

impl<Wp, T> AddAssign<T> for Lab<Wp, T>

where T: AddAssign + Clone,

fn add_assign(&mut self, c: T)

Performs the += operation.

impl<Wp, T> AddAssign for Lab<Wp, T>

where T: AddAssign,

fn add_assign(&mut self, other: Self)

Performs the += operation.

impl<Wp, T> ArrayCast for Lab<Wp, T>

type Array = [T; 3]

The output type of a cast to an array.

impl<Wp, T> AsMut<[T]> for Lab<Wp, T>

fn as_mut(&mut self) -> &mut [T]

Converts this type into a mutable reference of the (usually inferred) input type.

impl<Wp, T> AsMut<[T; 3]> for Lab<Wp, T>

fn as_mut(&mut self) -> &mut [T; 3]

Converts this type into a mutable reference of the (usually inferred) input type.

impl<Wp, T> AsMut<Lab<Wp, T>> for [T; 3]

fn as_mut(&mut self) -> &mut Lab<Wp, T>

Converts this type into a mutable reference of the (usually inferred) input type.

impl<Wp, T> AsRef<[T]> for Lab<Wp, T>

fn as_ref(&self) -> &[T]

Converts this type into a shared reference of the (usually inferred) input type.

impl<Wp, T> AsRef<[T; 3]> for Lab<Wp, T>

fn as_ref(&self) -> &[T; 3]

Converts this type into a shared reference of the (usually inferred) input type.

impl<Wp, T> AsRef<Lab<Wp, T>> for [T; 3]

fn as_ref(&self) -> &Lab<Wp, T>

Converts this type into a shared reference of the (usually inferred) input type.

impl<Wp, T> Ciede2000 for Lab<Wp, T>

where T: Real + RealAngle + One + Zero + Powi + Exp + Trigonometry + Abs + Sqrt + Arithmetics + PartialCmp + Hypot + Clone, T::Mask: LazySelect<T> + BitAnd<Output = T::Mask> + BitOr<Output = T::Mask>,

type Scalar = T

The type for the ΔE* (Delta E).

fn difference(self, other: Self) -> Self::Scalar

Calculate the CIEDE2000 ΔE* (Delta E) color difference between self and other.

impl<Wp, T> Clamp for Lab<Wp, T>

where T: Clamp + Real + Zero,

fn clamp(self) -> Self

Return a new color where out-of-bounds components have been changed to the nearest valid values.

impl<Wp, T> ClampAssign for Lab<Wp, T>

where T: ClampAssign + Real + Zero,

fn clamp_assign(&mut self)

Changes out-of-bounds components to the nearest valid values.

impl<Wp, T> Clone for Lab<Wp, T>

where T: Clone,

fn clone(&self) -> Lab<Wp, T>

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl<Wp, T> ColorDifference for Lab<Wp, T>

where T: Real + RealAngle + One + Zero + Powi + Exp + Trigonometry + Abs + Sqrt + Arithmetics + PartialCmp + Clone, T::Mask: LazySelect<T> + BitAnd<Output = T::Mask> + BitOr<Output = T::Mask>, Self: Into<LabColorDiff<T>>,

type Scalar = T

👎Deprecated since 0.7.2: replaced by palette::color_difference::Ciede2000

The type of the calculated color difference.

fn get_color_difference(self, other: Lab<Wp, T>) -> Self::Scalar

👎Deprecated since 0.7.2: replaced by palette::color_difference::Ciede2000

Return the difference or distance between two colors.

impl<Wp, T> Complementary for Lab<Wp, T>

where T: Neg<Output = T>,

fn complementary(self) -> Self

Return the complementary color of self.

impl<Wp: Debug, T: Debug> Debug for Lab<Wp, T>

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<Wp, T> Default for Lab<Wp, T>

where T: Zero,

fn default() -> Lab<Wp, T>

Returns the “default value” for a type.

impl<Wp, T> DeltaE for Lab<Wp, T>

where Self: EuclideanDistance<Scalar = T>, T: Sqrt,

type Scalar = T

The type for the distance value.

fn delta_e(self, other: Self) -> Self::Scalar

Calculate the ΔE color difference metric for self and other, according to the color space’s specification.

impl<'de, Wp, T> Deserialize<'de> for Lab<Wp, T>

where T: Deserialize<'de>,

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl<Wp, T> Div<T> for Lab<Wp, T>

where T: Div<Output = T> + Clone,

type Output = Lab<Wp, T>

The resulting type after applying the / operator.

fn div(self, c: T) -> Self::Output

Performs the / operation.

impl<Wp, T> Div for Lab<Wp, T>

where T: Div<Output = T>,

type Output = Lab<Wp, T>

The resulting type after applying the / operator.

fn div(self, other: Self) -> Self::Output

Performs the / operation.

impl<Wp, T> DivAssign<T> for Lab<Wp, T>

where T: DivAssign + Clone,

fn div_assign(&mut self, c: T)

Performs the /= operation.

impl<Wp, T> DivAssign for Lab<Wp, T>

where T: DivAssign,

fn div_assign(&mut self, other: Self)

Performs the /= operation.

impl<Wp, T> EuclideanDistance for Lab<Wp, T>

where T: Real + Sub<T, Output = T> + Add<T, Output = T> + Mul<T, Output = T> + Clone,

type Scalar = T

The type for the distance value.

fn distance_squared(self, other: Self) -> Self::Scalar

Calculate the squared Euclidean distance from self to other.

impl<Wp, T, C> Extend<Lab<Wp, T>> for Lab<Wp, C>

where C: Extend<T>,

fn extend<I: IntoIterator<Item = Lab<Wp, T>>>(&mut self, iter: I)

Extends a collection with the contents of an iterator.

fn extend_one(&mut self, item: A)

🔬This is a nightly-only experimental API. (extend_one)

Extends a collection with exactly one element.

fn extend_reserve(&mut self, additional: usize)

🔬This is a nightly-only experimental API. (extend_one)

Reserves capacity in a collection for the given number of additional elements.

impl<'a, Wp, T> From<&'a [T; 3]> for &'a Lab<Wp, T>

fn from(array: &'a [T; 3]) -> Self

Converts to this type from the input type.

impl<'a, Wp, T> From<&'a Lab<Wp, T>> for &'a [T]

fn from(color: &'a Lab<Wp, T>) -> Self

Converts to this type from the input type.

impl<'a, Wp, T> From<&'a Lab<Wp, T>> for &'a [T; 3]

fn from(color: &'a Lab<Wp, T>) -> Self

Converts to this type from the input type.

impl<'a, Wp, T> From<&'a mut [T; 3]> for &'a mut Lab<Wp, T>

fn from(array: &'a mut [T; 3]) -> Self

Converts to this type from the input type.

impl<'a, Wp, T> From<&'a mut Lab<Wp, T>> for &'a mut [T]

fn from(color: &'a mut Lab<Wp, T>) -> Self

Converts to this type from the input type.

impl<'a, Wp, T> From<&'a mut Lab<Wp, T>> for &'a mut [T; 3]

fn from(color: &'a mut Lab<Wp, T>) -> Self

Converts to this type from the input type.

impl<Wp, T, V, const N: usize> From<[Lab<Wp, T>; N]> for Lab<Wp, V>

where [T; N]: Default, V: FromScalarArray<N, Scalar = T>,

fn from(colors: [Lab<Wp, T>; N]) -> Self

Converts to this type from the input type.

impl<Wp, T> From<[T; 3]> for Lab<Wp, T>

fn from(array: [T; 3]) -> Self

Converts to this type from the input type.

impl<Wp, T> From<(T, T, T)> for Lab<Wp, T>

fn from(components: (T, T, T)) -> Self

Converts to this type from the input type.

impl<Wp, T> From<Box<[T; 3]>> for Box<Lab<Wp, T>>

fn from(array: Box<[T; 3]>) -> Self

Converts to this type from the input type.

impl<Wp, T> From<Lab<Wp, T>> for [T; 3]

fn from(color: Lab<Wp, T>) -> Self

Converts to this type from the input type.

impl<Wp, T> From<Lab<Wp, T>> for (T, T, T)

fn from(color: Lab<Wp, T>) -> (T, T, T)

Converts to this type from the input type.

impl<Wp, T, V, const N: usize> From<Lab<Wp, V>> for [Lab<Wp, T>; N]

where Self: Default, V: IntoScalarArray<N, Scalar = T>,

fn from(color: Lab<Wp, V>) -> Self

Converts to this type from the input type.

impl<Wp, T> From<PreAlpha<Lab<Wp, T>>> for Lab<Wp, T>

where Self: Premultiply<Scalar = T>,

fn from(premultiplied: PreAlpha<Self>) -> Self

Converts to this type from the input type.

impl<Wp, T, _C, _A> FromColorUnclamped<Alpha<_C, _A>> for Lab<Wp, T>

where _C: IntoColorUnclamped<Self>,

fn from_color_unclamped(color: Alpha<_C, _A>) -> Self

Convert from T. The resulting color might be invalid in its color space.

impl<Wp, T, _S> FromColorUnclamped<Hsl<_S, T>> for Lab<Wp, T>

where _S: RgbStandard, _S::Space: RgbSpace<WhitePoint = Wp>, Wp: WhitePoint<T>, Xyz<Wp, T>: FromColorUnclamped<Hsl<_S, T>> + IntoColorUnclamped<Self>,

fn from_color_unclamped(color: Hsl<_S, T>) -> Self

Convert from T. The resulting color might be invalid in its color space.

impl<Wp, T> FromColorUnclamped<Hsluv<Wp, T>> for Lab<Wp, T>

where Wp: WhitePoint<T>, Xyz<Wp, T>: FromColorUnclamped<Hsluv<Wp, T>> + IntoColorUnclamped<Self>,

fn from_color_unclamped(color: Hsluv<Wp, T>) -> Self

Convert from T. The resulting color might be invalid in its color space.

impl<Wp, T, _S> FromColorUnclamped<Hsv<_S, T>> for Lab<Wp, T>

where _S: RgbStandard, _S::Space: RgbSpace<WhitePoint = Wp>, Wp: WhitePoint<T>, Xyz<Wp, T>: FromColorUnclamped<Hsv<_S, T>> + IntoColorUnclamped<Self>,

fn from_color_unclamped(color: Hsv<_S, T>) -> Self

Convert from T. The resulting color might be invalid in its color space.

impl<Wp, T, _S> FromColorUnclamped<Hwb<_S, T>> for Lab<Wp, T>

where _S: RgbStandard, _S::Space: RgbSpace<WhitePoint = Wp>, Wp: WhitePoint<T>, Xyz<Wp, T>: FromColorUnclamped<Hwb<_S, T>> + IntoColorUnclamped<Self>,

fn from_color_unclamped(color: Hwb<_S, T>) -> Self

Convert from T. The resulting color might be invalid in its color space.

impl<S, T> FromColorUnclamped<Lab<<<S as RgbStandard>::Space as RgbSpace>::WhitePoint, T>> for Hsl<S, T>

where S: RgbStandard, Rgb<S, T>: FromColorUnclamped<Lab<<<S as RgbStandard>::Space as RgbSpace>::WhitePoint, T>> + IntoColorUnclamped<Self>,

fn from_color_unclamped( color: Lab<<<S as RgbStandard>::Space as RgbSpace>::WhitePoint, T>, ) -> Self

Convert from T. The resulting color might be invalid in its color space.

impl<S, T> FromColorUnclamped<Lab<<<S as RgbStandard>::Space as RgbSpace>::WhitePoint, T>> for Hsv<S, T>

where S: RgbStandard, Rgb<S, T>: FromColorUnclamped<Lab<<<S as RgbStandard>::Space as RgbSpace>::WhitePoint, T>> + IntoColorUnclamped<Self>,

fn from_color_unclamped( color: Lab<<<S as RgbStandard>::Space as RgbSpace>::WhitePoint, T>, ) -> Self

Convert from T. The resulting color might be invalid in its color space.

impl<S, T> FromColorUnclamped<Lab<<<S as RgbStandard>::Space as RgbSpace>::WhitePoint, T>> for Hwb<S, T>

where S: RgbStandard, Hsv<S, T>: FromColorUnclamped<Lab<<<S as RgbStandard>::Space as RgbSpace>::WhitePoint, T>> + IntoColorUnclamped<Self>,

fn from_color_unclamped( color: Lab<<<S as RgbStandard>::Space as RgbSpace>::WhitePoint, T>, ) -> Self

Convert from T. The resulting color might be invalid in its color space.

impl<S, T> FromColorUnclamped<Lab<<<S as RgbStandard>::Space as RgbSpace>::WhitePoint, T>> for Rgb<S, T>

where S: RgbStandard, Xyz<<<S as RgbStandard>::Space as RgbSpace>::WhitePoint, T>: FromColorUnclamped<Lab<<<S as RgbStandard>::Space as RgbSpace>::WhitePoint, T>> + IntoColorUnclamped<Self>,

fn from_color_unclamped( color: Lab<<<S as RgbStandard>::Space as RgbSpace>::WhitePoint, T>, ) -> Self

Convert from T. The resulting color might be invalid in its color space.

impl<S, T> FromColorUnclamped<Lab<<S as LumaStandard>::WhitePoint, T>> for Luma<S, T>

where S: LumaStandard, Xyz<<S as LumaStandard>::WhitePoint, T>: FromColorUnclamped<Lab<<S as LumaStandard>::WhitePoint, T>> + IntoColorUnclamped<Self>,

fn from_color_unclamped(color: Lab<<S as LumaStandard>::WhitePoint, T>) -> Self

Convert from T. The resulting color might be invalid in its color space.

impl<T> FromColorUnclamped<Lab<D65, T>> for Okhsl<T>

where D65: WhitePoint<T>, Oklab<T>: FromColorUnclamped<Lab<D65, T>> + IntoColorUnclamped<Self>,

fn from_color_unclamped(color: Lab<D65, T>) -> Self

Convert from T. The resulting color might be invalid in its color space.

impl<T> FromColorUnclamped<Lab<D65, T>> for Okhsv<T>

where D65: WhitePoint<T>, Oklab<T>: FromColorUnclamped<Lab<D65, T>> + IntoColorUnclamped<Self>,

fn from_color_unclamped(color: Lab<D65, T>) -> Self

Convert from T. The resulting color might be invalid in its color space.

impl<T> FromColorUnclamped<Lab<D65, T>> for Okhwb<T>

where D65: WhitePoint<T>, Okhsv<T>: FromColorUnclamped<Lab<D65, T>> + IntoColorUnclamped<Self>,

fn from_color_unclamped(color: Lab<D65, T>) -> Self

Convert from T. The resulting color might be invalid in its color space.

impl<T> FromColorUnclamped<Lab<D65, T>> for Oklab<T>

where D65: WhitePoint<T>, Xyz<D65, T>: FromColorUnclamped<Lab<D65, T>> + IntoColorUnclamped<Self>,

fn from_color_unclamped(color: Lab<D65, T>) -> Self

Convert from T. The resulting color might be invalid in its color space.

impl<T> FromColorUnclamped<Lab<D65, T>> for Oklch<T>

where D65: WhitePoint<T>, Oklab<T>: FromColorUnclamped<Lab<D65, T>> + IntoColorUnclamped<Self>,

fn from_color_unclamped(color: Lab<D65, T>) -> Self

Convert from T. The resulting color might be invalid in its color space.

impl<Wp, T> FromColorUnclamped<Lab<Wp, T>> for Hsluv<Wp, T>

where Wp: WhitePoint<T>, Lchuv<Wp, T>: FromColorUnclamped<Lab<Wp, T>> + IntoColorUnclamped<Self>,

fn from_color_unclamped(color: Lab<Wp, T>) -> Self

Convert from T. The resulting color might be invalid in its color space.

impl<Wp, T> FromColorUnclamped<Lab<Wp, T>> for Lab<Wp, T>

fn from_color_unclamped(color: Lab<Wp, T>) -> Self

Convert from T. The resulting color might be invalid in its color space.

impl<Wp, T> FromColorUnclamped<Lab<Wp, T>> for Lch<Wp, T>

where T: Zero + Hypot, Lab<Wp, T>: GetHue<Hue = LabHue<T>>,

fn from_color_unclamped(color: Lab<Wp, T>) -> Self

Convert from T. The resulting color might be invalid in its color space.

impl<Wp, T> FromColorUnclamped<Lab<Wp, T>> for Lchuv<Wp, T>

where Wp: WhitePoint<T>, Luv<Wp, T>: FromColorUnclamped<Lab<Wp, T>> + IntoColorUnclamped<Self>,

fn from_color_unclamped(color: Lab<Wp, T>) -> Self

Convert from T. The resulting color might be invalid in its color space.

impl<Wp, T> FromColorUnclamped<Lab<Wp, T>> for Luv<Wp, T>

where Wp: WhitePoint<T>, Xyz<Wp, T>: FromColorUnclamped<Lab<Wp, T>> + IntoColorUnclamped<Self>,

fn from_color_unclamped(color: Lab<Wp, T>) -> Self

Convert from T. The resulting color might be invalid in its color space.

impl<Wp, T> FromColorUnclamped<Lab<Wp, T>> for Xyz<Wp, T>

where T: Real + Recip + Powi + Arithmetics + PartialCmp + Clone, T::Mask: LazySelect<T>, Wp: WhitePoint<T>,

fn from_color_unclamped(color: Lab<Wp, T>) -> Self

Convert from T. The resulting color might be invalid in its color space.

impl<Wp, T> FromColorUnclamped<Lab<Wp, T>> for Yxy<Wp, T>

where Wp: WhitePoint<T>, Xyz<Wp, T>: FromColorUnclamped<Lab<Wp, T>> + IntoColorUnclamped<Self>,

fn from_color_unclamped(color: Lab<Wp, T>) -> Self

Convert from T. The resulting color might be invalid in its color space.

impl<Wp, T> FromColorUnclamped<Lch<Wp, T>> for Lab<Wp, T>

where T: RealAngle + Zero + MinMax + Trigonometry + Mul<Output = T> + Clone,

fn from_color_unclamped(color: Lch<Wp, T>) -> Self

Convert from T. The resulting color might be invalid in its color space.

impl<Wp, T> FromColorUnclamped<Lchuv<Wp, T>> for Lab<Wp, T>

where Wp: WhitePoint<T>, Xyz<Wp, T>: FromColorUnclamped<Lchuv<Wp, T>> + IntoColorUnclamped<Self>,

fn from_color_unclamped(color: Lchuv<Wp, T>) -> Self

Convert from T. The resulting color might be invalid in its color space.

impl<Wp, T, _S> FromColorUnclamped<Luma<_S, T>> for Lab<Wp, T>

where _S: LumaStandard<WhitePoint = Wp>, Wp: WhitePoint<T>, Xyz<Wp, T>: FromColorUnclamped<Luma<_S, T>> + IntoColorUnclamped<Self>,

fn from_color_unclamped(color: Luma<_S, T>) -> Self

Convert from T. The resulting color might be invalid in its color space.

impl<Wp, T> FromColorUnclamped<Luv<Wp, T>> for Lab<Wp, T>

where Wp: WhitePoint<T>, Xyz<Wp, T>: FromColorUnclamped<Luv<Wp, T>> + IntoColorUnclamped<Self>,

fn from_color_unclamped(color: Luv<Wp, T>) -> Self

Convert from T. The resulting color might be invalid in its color space.

impl<Wp, T> FromColorUnclamped<Okhsl<T>> for Lab<Wp, T>

where Wp: WhitePoint<T>, Xyz<Wp, T>: FromColorUnclamped<Okhsl<T>> + IntoColorUnclamped<Self>,

fn from_color_unclamped(color: Okhsl<T>) -> Self

Convert from T. The resulting color might be invalid in its color space.

impl<Wp, T> FromColorUnclamped<Okhsv<T>> for Lab<Wp, T>

where Wp: WhitePoint<T>, Xyz<Wp, T>: FromColorUnclamped<Okhsv<T>> + IntoColorUnclamped<Self>,

fn from_color_unclamped(color: Okhsv<T>) -> Self

Convert from T. The resulting color might be invalid in its color space.

impl<Wp, T> FromColorUnclamped<Okhwb<T>> for Lab<Wp, T>

where Wp: WhitePoint<T>, Xyz<Wp, T>: FromColorUnclamped<Okhwb<T>> + IntoColorUnclamped<Self>,

fn from_color_unclamped(color: Okhwb<T>) -> Self

Convert from T. The resulting color might be invalid in its color space.

impl<Wp, T> FromColorUnclamped<Oklab<T>> for Lab<Wp, T>

where Wp: WhitePoint<T>, Xyz<Wp, T>: FromColorUnclamped<Oklab<T>> + IntoColorUnclamped<Self>,

fn from_color_unclamped(color: Oklab<T>) -> Self

Convert from T. The resulting color might be invalid in its color space.

impl<Wp, T> FromColorUnclamped<Oklch<T>> for Lab<Wp, T>

where Wp: WhitePoint<T>, Xyz<Wp, T>: FromColorUnclamped<Oklch<T>> + IntoColorUnclamped<Self>,

fn from_color_unclamped(color: Oklch<T>) -> Self

Convert from T. The resulting color might be invalid in its color space.

impl<Wp, T, _S> FromColorUnclamped<Rgb<_S, T>> for Lab<Wp, T>

where _S: RgbStandard, _S::Space: RgbSpace<WhitePoint = Wp>, Wp: WhitePoint<T>, Xyz<Wp, T>: FromColorUnclamped<Rgb<_S, T>> + IntoColorUnclamped<Self>,

fn from_color_unclamped(color: Rgb<_S, T>) -> Self

Convert from T. The resulting color might be invalid in its color space.

impl<Wp, T> FromColorUnclamped<Xyz<Wp, T>> for Lab<Wp, T>

where Wp: WhitePoint<T>, T: Real + Powi + Cbrt + Arithmetics + PartialCmp + Clone, T::Mask: LazySelect<T>,

fn from_color_unclamped(color: Xyz<Wp, T>) -> Self

Convert from T. The resulting color might be invalid in its color space.

impl<Wp, T> FromColorUnclamped<Yxy<Wp, T>> for Lab<Wp, T>

where Wp: WhitePoint<T>, Xyz<Wp, T>: FromColorUnclamped<Yxy<Wp, T>> + IntoColorUnclamped<Self>,

fn from_color_unclamped(color: Yxy<Wp, T>) -> Self

Convert from T. The resulting color might be invalid in its color space.

impl<Wp, T, C> FromIterator<Lab<Wp, T>> for Lab<Wp, C>

where Self: Extend<Lab<Wp, T>>, C: Default,

fn from_iter<I: IntoIterator<Item = Lab<Wp, T>>>(iter: I) -> Self

Creates a value from an iterator.

impl<Wp, T> GetHue for Lab<Wp, T>

where T: RealAngle + Trigonometry + Add<T, Output = T> + Neg<Output = T> + Clone,

type Hue = LabHue<T>

The kind of hue unit this color space uses.

fn get_hue(&self) -> LabHue<T>

Calculate a hue if possible.

impl<Wp, T> HasBoolMask for Lab<Wp, T>

where T: HasBoolMask,

type Mask = <T as HasBoolMask>::Mask

The mask type to use for selecting Self values.

impl<Wp, T> HyAb for Lab<Wp, T>

where T: Real + Abs + Sqrt + Sub<T, Output = T> + Add<T, Output = T> + Mul<T, Output = T> + Clone,

type Scalar = T

The type for the distance value.

fn hybrid_distance(self, other: Self) -> Self::Scalar

Calculate the hybrid distance between self and other.

impl<Wp, T> ImprovedDeltaE for Lab<Wp, T>

where Self: DeltaE<Scalar = T> + EuclideanDistance<Scalar = T>, T: Real + Mul<T, Output = T> + Powf,

fn improved_delta_e(self, other: Self) -> Self::Scalar

Calculate the ΔE’ (improved ΔE) color difference metric for self and other, according to the color space’s specification and later improvements by Huang et al.

impl<'a, 'b, Wp, T> IntoIterator for &'a Lab<Wp, &'b [T]>

type Item = Lab<Wp, &'a T>

The type of the elements being iterated over.

type IntoIter = Iter<Iter<'a, T>, Wp>

Which kind of iterator are we turning this into?

fn into_iter(self) -> Self::IntoIter

Creates an iterator from a value.

impl<'a, 'b, Wp, T> IntoIterator for &'a Lab<Wp, &'b mut [T]>

type Item = Lab<Wp, &'a T>

The type of the elements being iterated over.

type IntoIter = Iter<Iter<'a, T>, Wp>

Which kind of iterator are we turning this into?

fn into_iter(self) -> Self::IntoIter

Creates an iterator from a value.

impl<'a, Wp, T, const N: usize> IntoIterator for &'a Lab<Wp, [T; N]>

type Item = Lab<Wp, &'a T>

The type of the elements being iterated over.

type IntoIter = Iter<Iter<'a, T>, Wp>

Which kind of iterator are we turning this into?

fn into_iter(self) -> Self::IntoIter

Creates an iterator from a value.

impl<'a, Wp, T> IntoIterator for &'a Lab<Wp, Box<[T]>>

type Item = Lab<Wp, &'a T>

The type of the elements being iterated over.

type IntoIter = Iter<Iter<'a, T>, Wp>

Which kind of iterator are we turning this into?

fn into_iter(self) -> Self::IntoIter

Creates an iterator from a value.

impl<'a, Wp, T> IntoIterator for &'a Lab<Wp, Vec<T>>

type Item = Lab<Wp, &'a T>

The type of the elements being iterated over.

type IntoIter = Iter<Iter<'a, T>, Wp>

Which kind of iterator are we turning this into?

fn into_iter(self) -> Self::IntoIter

Creates an iterator from a value.

impl<'a, 'b, Wp, T> IntoIterator for &'a mut Lab<Wp, &'b mut [T]>

type Item = Lab<Wp, &'a mut T>

The type of the elements being iterated over.

type IntoIter = Iter<IterMut<'a, T>, Wp>

Which kind of iterator are we turning this into?

fn into_iter(self) -> Self::IntoIter

Creates an iterator from a value.

impl<'a, Wp, T, const N: usize> IntoIterator for &'a mut Lab<Wp, [T; N]>

type Item = Lab<Wp, &'a mut T>

The type of the elements being iterated over.

type IntoIter = Iter<IterMut<'a, T>, Wp>

Which kind of iterator are we turning this into?

fn into_iter(self) -> Self::IntoIter

Creates an iterator from a value.

impl<'a, Wp, T> IntoIterator for &'a mut Lab<Wp, Box<[T]>>

where T: 'a,

type Item = Lab<Wp, &'a mut T>

The type of the elements being iterated over.

type IntoIter = Iter<IterMut<'a, T>, Wp>

Which kind of iterator are we turning this into?

fn into_iter(self) -> Self::IntoIter

Creates an iterator from a value.

impl<'a, Wp, T> IntoIterator for &'a mut Lab<Wp, Vec<T>>

type Item = Lab<Wp, &'a mut T>

The type of the elements being iterated over.

type IntoIter = Iter<IterMut<'a, T>, Wp>

Which kind of iterator are we turning this into?

fn into_iter(self) -> Self::IntoIter

Creates an iterator from a value.

impl<'a, Wp, T> IntoIterator for Lab<Wp, &'a [T]>

type Item = Lab<Wp, &'a T>

The type of the elements being iterated over.

type IntoIter = Iter<Iter<'a, T>, Wp>

Which kind of iterator are we turning this into?

fn into_iter(self) -> Self::IntoIter

Creates an iterator from a value.

impl<'a, Wp, T> IntoIterator for Lab<Wp, &'a mut [T]>

type Item = Lab<Wp, &'a mut T>

The type of the elements being iterated over.

type IntoIter = Iter<IterMut<'a, T>, Wp>

Which kind of iterator are we turning this into?

fn into_iter(self) -> Self::IntoIter

Creates an iterator from a value.

impl<Wp, T, const N: usize> IntoIterator for Lab<Wp, [T; N]>

type Item = Lab<Wp, T>

The type of the elements being iterated over.

type IntoIter = Iter<IntoIter<T, N>, Wp>

Which kind of iterator are we turning this into?

fn into_iter(self) -> Self::IntoIter

Creates an iterator from a value.

impl<Wp, T> IntoIterator for Lab<Wp, Vec<T>>

type Item = Lab<Wp, T>

The type of the elements being iterated over.

type IntoIter = Iter<IntoIter<T>, Wp>

Which kind of iterator are we turning this into?

fn into_iter(self) -> Self::IntoIter

Creates an iterator from a value.

impl<Wp, T> IsWithinBounds for Lab<Wp, T>

where T: PartialCmp + Real + Zero, T::Mask: BitAnd<Output = T::Mask>,

fn is_within_bounds(&self) -> T::Mask

Check if the color’s components are within the expected range bounds.

impl<Wp, T> Lighten for Lab<Wp, T>

where T: Real + Zero + MinMax + Clamp + Arithmetics + PartialCmp + Clone, T::Mask: LazySelect<T>,

type Scalar = T

The type of the lighten modifier.

fn lighten(self, factor: T) -> Self

Scale the color towards the maximum lightness by factor, a value ranging from 0.0 to 1.0.

fn lighten_fixed(self, amount: T) -> Self

Lighten the color by amount, a value ranging from 0.0 to 1.0.

impl<Wp, T> LightenAssign for Lab<Wp, T>

where T: Real + Zero + MinMax + ClampAssign + AddAssign + Arithmetics + PartialCmp + Clone, T::Mask: LazySelect<T>,

type Scalar = T

The type of the lighten modifier.

fn lighten_assign(&mut self, factor: T)

Scale the color towards the maximum lightness by factor, a value ranging from 0.0 to 1.0.

fn lighten_fixed_assign(&mut self, amount: T)

Lighten the color by amount, a value ranging from 0.0 to 1.0.

impl<Wp, T> Mix for Lab<Wp, T>

where T: Real + Zero + One + Arithmetics + Clamp + Clone,

type Scalar = T

The type of the mixing factor.

fn mix(self, other: Self, factor: T) -> Self

Mix the color with an other color, by factor.

impl<Wp, T> MixAssign for Lab<Wp, T>

where T: Real + Zero + One + AddAssign + Arithmetics + Clamp + Clone,

type Scalar = T

The type of the mixing factor.

fn mix_assign(&mut self, other: Self, factor: T)

Mix the color with an other color, by factor.

impl<Wp, T> Mul<T> for Lab<Wp, T>

where T: Mul<Output = T> + Clone,

type Output = Lab<Wp, T>

The resulting type after applying the * operator.

fn mul(self, c: T) -> Self::Output

Performs the * operation.

impl<Wp, T> Mul for Lab<Wp, T>

where T: Mul<Output = T>,

type Output = Lab<Wp, T>

The resulting type after applying the * operator.

fn mul(self, other: Self) -> Self::Output

Performs the * operation.

impl<Wp, T> MulAssign<T> for Lab<Wp, T>

where T: MulAssign + Clone,

fn mul_assign(&mut self, c: T)

Performs the *= operation.

impl<Wp, T> MulAssign for Lab<Wp, T>

where T: MulAssign,

fn mul_assign(&mut self, other: Self)

Performs the *= operation.

impl<Wp, T> PartialEq for Lab<Wp, T>

where T: PartialEq,

fn eq(&self, other: &Self) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl<Wp, T> Premultiply for Lab<Wp, T>

where T: Real + Stimulus + Zero + IsValidDivisor + Mul<T, Output = T> + Div<T, Output = T> + Clone, T::Mask: LazySelect<T> + Clone,

type Scalar = T

The color’s component type.

fn premultiply(self, alpha: T) -> PreAlpha<Self>

Alpha mask the color.

fn unpremultiply(premultiplied: PreAlpha<Self>) -> (Self, T)

Alpha unmask the color, resulting in a color and transparency pair.

impl<Wp, T> RelativeContrast for Lab<Wp, T>

where T: Real + Arithmetics + PartialCmp, T::Mask: LazySelect<T>, Xyz<Wp, T>: FromColor<Self>,

type Scalar = T

👎Deprecated since 0.7.2: replaced by palette::color_difference::Wcag21RelativeContrast

The type of the contrast ratio.

fn get_contrast_ratio(self, other: Self) -> T

👎Deprecated since 0.7.2: replaced by palette::color_difference::Wcag21RelativeContrast

Calculate the contrast ratio between two colors.

fn has_min_contrast_text( self, other: Self, ) -> <Self::Scalar as HasBoolMask>::Mask

👎Deprecated since 0.7.2: replaced by palette::color_difference::Wcag21RelativeContrast

Verify the contrast between two colors satisfies SC 1.4.3. Contrast is at least 4.5:1 (Level AA).

fn has_min_contrast_large_text( self, other: Self, ) -> <Self::Scalar as HasBoolMask>::Mask

👎Deprecated since 0.7.2: replaced by palette::color_difference::Wcag21RelativeContrast

Verify the contrast between two colors satisfies SC 1.4.3 for large text. Contrast is at least 3:1 (Level AA).

fn has_enhanced_contrast_text( self, other: Self, ) -> <Self::Scalar as HasBoolMask>::Mask

👎Deprecated since 0.7.2: replaced by palette::color_difference::Wcag21RelativeContrast

Verify the contrast between two colors satisfies SC 1.4.6. Contrast is at least 7:1 (Level AAA).

fn has_enhanced_contrast_large_text( self, other: Self, ) -> <Self::Scalar as HasBoolMask>::Mask

👎Deprecated since 0.7.2: replaced by palette::color_difference::Wcag21RelativeContrast

Verify the contrast between two colors satisfies SC 1.4.6 for large text. Contrast is at least 4.5:1 (Level AAA).

fn has_min_contrast_graphics( self, other: Self, ) -> <Self::Scalar as HasBoolMask>::Mask

👎Deprecated since 0.7.2: replaced by palette::color_difference::Wcag21RelativeContrast

Verify the contrast between two colors satisfies SC 1.4.11 for graphical objects. Contrast is at least 3:1 (Level AA).

impl<Wp, T> RelativeEq for Lab<Wp, T>

where T: RelativeEq, T::Epsilon: Clone,

fn default_max_relative() -> T::Epsilon

The default relative tolerance for testing values that are far-apart.

fn relative_eq( &self, other: &Self, epsilon: T::Epsilon, max_relative: T::Epsilon, ) -> bool

A test for equality that uses a relative comparison if the values are far apart.

fn relative_ne( &self, other: &Self, epsilon: T::Epsilon, max_relative: T::Epsilon, ) -> bool

The inverse of RelativeEq::relative_eq.

impl<Wp, T> SaturatingAdd<T> for Lab<Wp, T>

where T: SaturatingAdd<Output = T> + Clone,

type Output = Lab<Wp, T>

The resulting type.

fn saturating_add(self, c: T) -> Self::Output

Returns the sum of self and other, but saturates instead of overflowing.

impl<Wp, T> SaturatingAdd for Lab<Wp, T>

where T: SaturatingAdd<Output = T>,

type Output = Lab<Wp, T>

The resulting type.

fn saturating_add(self, other: Self) -> Self::Output

Returns the sum of self and other, but saturates instead of overflowing.

impl<Wp, T> SaturatingSub<T> for Lab<Wp, T>

where T: SaturatingSub<Output = T> + Clone,

type Output = Lab<Wp, T>

The resulting type.

fn saturating_sub(self, c: T) -> Self::Output

Returns the difference of self and other, but saturates instead of overflowing.

impl<Wp, T> SaturatingSub for Lab<Wp, T>

where T: SaturatingSub<Output = T>,

type Output = Lab<Wp, T>

The resulting type.

fn saturating_sub(self, other: Self) -> Self::Output

Returns the difference of self and other, but saturates instead of overflowing.

impl<Wp, T> Serialize for Lab<Wp, T>

where T: Serialize,

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl<Wp, T> Sub<T> for Lab<Wp, T>

where T: Sub<Output = T> + Clone,

type Output = Lab<Wp, T>

The resulting type after applying the - operator.

fn sub(self, c: T) -> Self::Output

Performs the - operation.

impl<Wp, T> Sub for Lab<Wp, T>

where T: Sub<Output = T>,

type Output = Lab<Wp, T>

The resulting type after applying the - operator.

fn sub(self, other: Self) -> Self::Output

Performs the - operation.

impl<Wp, T> SubAssign<T> for Lab<Wp, T>

where T: SubAssign + Clone,

fn sub_assign(&mut self, c: T)

Performs the -= operation.

impl<Wp, T> SubAssign for Lab<Wp, T>

where T: SubAssign,

fn sub_assign(&mut self, other: Self)

Performs the -= operation.

impl<Wp, T> Tetradic for Lab<Wp, T>

where T: Neg<Output = T> + Clone,

fn tetradic(self) -> (Self, Self, Self)

Return the three additional colors of a tetradic color scheme.

impl<'a, Wp, T> TryFrom<&'a [T]> for &'a Lab<Wp, T>

type Error = <&'a [T; 3] as TryFrom<&'a [T]>>::Error

The type returned in the event of a conversion error.

fn try_from(slice: &'a [T]) -> Result<Self, Self::Error>

Performs the conversion.

impl<'a, Wp, T> TryFrom<&'a mut [T]> for &'a mut Lab<Wp, T>

type Error = <&'a mut [T; 3] as TryFrom<&'a mut [T]>>::Error

The type returned in the event of a conversion error.

fn try_from(slice: &'a mut [T]) -> Result<Self, Self::Error>

Performs the conversion.

impl<Wp, T> UlpsEq for Lab<Wp, T>

where T: UlpsEq, T::Epsilon: Clone,

fn default_max_ulps() -> u32

The default ULPs to tolerate when testing values that are far-apart.

fn ulps_eq(&self, other: &Self, epsilon: T::Epsilon, max_ulps: u32) -> bool

A test for equality that uses units in the last place (ULP) if the values are far apart.

fn ulps_ne(&self, other: &Self, epsilon: T::Epsilon, max_ulps: u32) -> bool

The inverse of UlpsEq::ulps_eq.

impl<Wp, T, _A> WithAlpha<_A> for Lab<Wp, T>

where _A: Stimulus,

type Color = Lab<Wp, T>

The opaque color type, without any transparency.

type WithAlpha = Alpha<Lab<Wp, T>, _A>

The color type with transparency applied.

fn with_alpha(self, alpha: _A) -> Self::WithAlpha

Transforms the color into a transparent color with the provided alpha value. If Self already has a transparency, it is overwritten.

fn without_alpha(self) -> Self::Color

Removes the transparency from the color. If Self::Color has an internal transparency field, that field will be set to A::max_intensity() to make it opaque.

fn split(self) -> (Self::Color, _A)

Splits the color into separate color and transparency values.

fn opaque(self) -> Self::WithAlpha

where A: Stimulus,

Transforms the color into a fully opaque color with a transparency field. If Self already has a transparency, it is overwritten.

fn transparent(self) -> Self::WithAlpha

where A: Zero,

Transforms the color into a fully transparent color. If Self already has a transparency, it is overwritten.

impl<Wp, T> Copy for Lab<Wp, T>

where T: Copy,

impl<Wp, T> Eq for Lab<Wp, T>

where T: Eq,