Struct palette::Lab

#[repr(C)]
pub struct Lab<Wp = D65, T = f32> where
    T: Component + Float,
    Wp: WhitePoint,  {
    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.

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.

Methods

impl<T> Lab<D65, T> where
    T: Component + Float, 

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

CIE L*a*b* with white point D65.

impl<Wp, T> Lab<Wp, T> where
    T: Component + Float,
    Wp: WhitePoint, 

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

CIE L*a*b*.

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.

Trait Implementations

impl<Wp, T> FromColor<Wp, T> for Lab<Wp, T> where
    T: Component + Float,
    Wp: WhitePoint,
    T: Component + Float,
    Wp: WhitePoint, 

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

Convert from XYZ color space

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

Convert from Lab* color space

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

Convert from LCh° color space

fn from_yxy(inp: Yxy<Wp, T>) -> Self

Convert from Yxy color space

fn from_rgb<S: RgbSpace<WhitePoint = Wp>>(inp: Rgb<Linear<S>, T>) -> Self

Convert from RGB color space

fn from_hsl<S: RgbSpace<WhitePoint = Wp>>(inp: Hsl<S, T>) -> Self

Convert from HSL color space

fn from_hsv<S: RgbSpace<WhitePoint = Wp>>(inp: Hsv<S, T>) -> Self

Convert from HSV color space

fn from_hwb<S: RgbSpace<WhitePoint = Wp>>(inp: Hwb<S, T>) -> Self

Convert from HWB color space

fn from_luma(inp: Luma<Linear<Wp>, T>) -> Self

Convert from Luma

impl<Wp, T> IntoColor<Wp, T> for Lab<Wp, T> where
    T: Component + Float,
    Wp: WhitePoint, 

fn into_xyz(self) -> Xyz<Wp, T>

Convert into XYZ space

fn into_yxy(self) -> Yxy<Wp, T>

Convert into Yxy color space

fn into_lab(self) -> Lab<Wp, T>

Convert into Lab* color space

fn into_lch(self) -> Lch<Wp, T>

Convert into LCh° color space

fn into_rgb<S: RgbSpace<WhitePoint = Wp>>(self) -> Rgb<Linear<S>, T>

Convert into RGB color space.

fn into_hsl<S: RgbSpace<WhitePoint = Wp>>(self) -> Hsl<S, T>

Convert into HSL color space

fn into_hsv<S: RgbSpace<WhitePoint = Wp>>(self) -> Hsv<S, T>

Convert into HSV color space

fn into_luma(self) -> Luma<Linear<Wp>, T>

Convert into Luma

fn into_hwb<S: RgbSpace<WhitePoint = Wp>>(self) -> Hwb<S, T>

Convert into HWB color space

impl<Wp, T> Pixel<T> for Lab<Wp, T> where
    T: Component + Float,
    Wp: WhitePoint, 

const CHANNELS: usize

The number of color channels.

fn as_raw<P: RawPixel<T> + ?Sized>(&self) -> &P

Cast as a reference to raw color components.

fn as_raw_mut<P: RawPixel<T> + ?Sized>(&mut self) -> &mut P

Cast as a mutable reference to raw color components.

fn into_raw<P: RawPixelSized<T>>(self) -> P

Convert from raw color components.

fn from_raw<P: RawPixel<T> + ?Sized>(pixel: &P) -> &Self

Cast from a reference to raw color components.

fn from_raw_mut<P: RawPixel<T> + ?Sized>(pixel: &mut P) -> &mut Self

Cast from a mutable reference to raw color components.

fn from_raw_slice(slice: &[T]) -> &[Self]

Cast a slice of raw color components to a slice of colors.

fn from_raw_slice_mut(slice: &mut [T]) -> &mut [Self]

Cast a mutable slice of raw color components to a mutable slice of colors.

fn into_raw_slice(slice: &[Self]) -> &[T]

Cast a slice of colors to a slice of raw color components.

fn into_raw_slice_mut(slice: &mut [Self]) -> &mut [T]

Cast a mutable slice of colors to a mutable slice of raw color components.

impl<Wp, T> Limited for Lab<Wp, T> where
    T: Component + Float,
    Wp: WhitePoint, 

fn is_valid(&self) -> bool

Check if the color's components are within the expected ranges.

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

Return a new color where the components has been clamped to the nearest valid values.

fn clamp_self(&mut self)

Clamp the color's components to the nearest valid values.

impl<Wp, T> Mix for Lab<Wp, T> where
    T: Component + Float,
    Wp: WhitePoint, 

type Scalar = T

The type of the mixing factor.

fn mix(&self, other: &Lab<Wp, T>, factor: T) -> Lab<Wp, T>

Mix the color with an other color, by factor.

impl<Wp, T> Shade for Lab<Wp, T> where
    T: Component + Float,
    Wp: WhitePoint, 

type Scalar = T

The type of the lighten/darken amount.

fn lighten(&self, amount: T) -> Lab<Wp, T>

Lighten the color by amount.

fn darken(&self, amount: Self::Scalar) -> Self

Darken the color by amount.

impl<Wp, T> GetHue for Lab<Wp, T> where
    T: Component + Float,
    Wp: WhitePoint, 

type Hue = LabHue<T>

The kind of hue unit this color space uses.

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

Calculate a hue if possible.

impl<Wp, T> ComponentWise for Lab<Wp, T> where
    T: Component + Float,
    Wp: WhitePoint, 

type Scalar = T

The scalar type for color components.

fn component_wise<F: FnMut(T, T) -> T>(
    &self,
    other: &Lab<Wp, T>,
    f: F
) -> Lab<Wp, T>

Perform a binary operation on this and an other color.

fn component_wise_self<F: FnMut(T) -> T>(&self, f: F) -> Lab<Wp, T>

Perform a unary operation on this color.

impl<Wp, T> Copy for Lab<Wp, T> where
    T: Component + Float,
    Wp: WhitePoint, 

impl<Wp, T, P: ?Sized> AsRef<P> for Lab<Wp, T> where
    T: Component + Float,
    Wp: WhitePoint,
    P: RawPixel<T>, 

fn as_ref(&self) -> &P

Performs the conversion.

impl<Wp, T> Default for Lab<Wp, T> where
    T: Component + Float,
    Wp: WhitePoint, 

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

Returns the "default value" for a type.

impl<Wp, T> Clone for Lab<Wp, T> where
    T: Component + Float,
    Wp: WhitePoint, 

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: PartialEq, T: PartialEq> PartialEq<Lab<Wp, T>> for Lab<Wp, T> where
    T: Component + Float,
    Wp: WhitePoint, 

fn eq(&self, other: &Lab<Wp, T>) -> bool

This method tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Lab<Wp, T>) -> bool

This method tests for !=.

impl<S, T> From<Lab<<S as RgbSpace>::WhitePoint, T>> for Hsl<S, T> where
    T: Component + Float,
    S: RgbSpace,
    T: Component + Float, 

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

Performs the conversion.

impl<S, T> From<Lab<<S as RgbSpace>::WhitePoint, T>> for Alpha<Hsl<S, T>, T> where
    T: Component + Float,
    S: RgbSpace,
    T: Component + Float, 

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

Performs the conversion.

impl<S, T> From<Lab<<S as RgbSpace>::WhitePoint, T>> for Hsv<S, T> where
    T: Component + Float,
    S: RgbSpace,
    T: Component + Float, 

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

Performs the conversion.

impl<S, T> From<Lab<<S as RgbSpace>::WhitePoint, T>> for Alpha<Hsv<S, T>, T> where
    T: Component + Float,
    S: RgbSpace,
    T: Component + Float, 

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

Performs the conversion.

impl<S, T> From<Lab<<S as RgbSpace>::WhitePoint, T>> for Hwb<S, T> where
    T: Component + Float,
    S: RgbSpace,
    T: Component + Float, 

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

Performs the conversion.

impl<S, T> From<Lab<<S as RgbSpace>::WhitePoint, T>> for Alpha<Hwb<S, T>, T> where
    T: Component + Float,
    S: RgbSpace,
    T: Component + Float, 

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

Performs the conversion.

impl<Wp, T, _S> From<Rgb<_S, T>> for Lab<Wp, T> where
    T: Component + Float,
    Wp: WhitePoint,
    T: Component + Float,
    _S: RgbStandard,
    _S::Space: RgbSpace<WhitePoint = Wp>, 

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

Performs the conversion.

impl<Wp, T, _S> From<Alpha<Rgb<_S, T>, T>> for Lab<Wp, T> where
    T: Component + Float,
    Wp: WhitePoint,
    T: Component + Float,
    _S: RgbStandard,
    _S::Space: RgbSpace<WhitePoint = Wp>, 

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

Performs the conversion.

impl<Wp, T, _S> From<Luma<_S, T>> for Lab<Wp, T> where
    T: Component + Float,
    Wp: WhitePoint,
    T: Component + Float,
    _S: LumaStandard<WhitePoint = Wp>, 

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

Performs the conversion.

impl<Wp, T, _S> From<Alpha<Luma<_S, T>, T>> for Lab<Wp, T> where
    T: Component + Float,
    Wp: WhitePoint,
    T: Component + Float,
    _S: LumaStandard<WhitePoint = Wp>, 

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

Performs the conversion.

impl<Wp, T, _S> From<Hsl<_S, T>> for Lab<Wp, T> where
    T: Component + Float,
    Wp: WhitePoint,
    T: Component + Float,
    _S: RgbSpace<WhitePoint = Wp>, 

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

Performs the conversion.

impl<Wp, T, _S> From<Alpha<Hsl<_S, T>, T>> for Lab<Wp, T> where
    T: Component + Float,
    Wp: WhitePoint,
    T: Component + Float,
    _S: RgbSpace<WhitePoint = Wp>, 

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

Performs the conversion.

impl<Wp, T, _S> From<Hsv<_S, T>> for Lab<Wp, T> where
    T: Component + Float,
    Wp: WhitePoint,
    T: Component + Float,
    _S: RgbSpace<WhitePoint = Wp>, 

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

Performs the conversion.

impl<Wp, T, _S> From<Alpha<Hsv<_S, T>, T>> for Lab<Wp, T> where
    T: Component + Float,
    Wp: WhitePoint,
    T: Component + Float,
    _S: RgbSpace<WhitePoint = Wp>, 

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

Performs the conversion.

impl<Wp, T, _S> From<Hwb<_S, T>> for Lab<Wp, T> where
    T: Component + Float,
    Wp: WhitePoint,
    T: Component + Float,
    _S: RgbSpace<WhitePoint = Wp>, 

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

Performs the conversion.

impl<Wp, T, _S> From<Alpha<Hwb<_S, T>, T>> for Lab<Wp, T> where
    T: Component + Float,
    Wp: WhitePoint,
    T: Component + Float,
    _S: RgbSpace<WhitePoint = Wp>, 

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

Performs the conversion.

impl<Wp, T> From<Alpha<Lab<Wp, T>, T>> for Lab<Wp, T> where
    T: Component + Float,
    Wp: WhitePoint,
    T: Component + Float, 

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

Performs the conversion.

impl<Wp, T> From<Alpha<Lch<Wp, T>, T>> for Lab<Wp, T> where
    T: Component + Float,
    Wp: WhitePoint,
    T: Component + Float, 

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

Performs the conversion.

impl<Wp, T> From<Alpha<Xyz<Wp, T>, T>> for Lab<Wp, T> where
    T: Component + Float,
    Wp: WhitePoint,
    T: Component + Float, 

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

Performs the conversion.

impl<Wp, T> From<Yxy<Wp, T>> for Lab<Wp, T> where
    T: Component + Float,
    Wp: WhitePoint,
    T: Component + Float, 

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

Performs the conversion.

impl<Wp, T> From<Alpha<Yxy<Wp, T>, T>> for Lab<Wp, T> where
    T: Component + Float,
    Wp: WhitePoint,
    T: Component + Float, 

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

Performs the conversion.

impl<Wp, T, _S> From<Color<_S, T>> for Lab<Wp, T> where
    T: Component + Float,
    Wp: WhitePoint,
    T: Component + Float,
    _S: RgbSpace<WhitePoint = Wp>, 

fn from(color: Color<_S, T>) -> Self

Performs the conversion.

impl<Wp, T, _S> From<Alpha<Color<_S, T>, T>> for Lab<Wp, T> where
    T: Component + Float,
    Wp: WhitePoint,
    T: Component + Float,
    _S: RgbSpace<WhitePoint = Wp>, 

fn from(color: Alpha<Color<_S, T>, T>) -> Self

Performs the conversion.

impl<Wp, T> From<Xyz<Wp, T>> for Lab<Wp, T> where
    T: Component + Float,
    Wp: WhitePoint, 

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

Performs the conversion.

impl<Wp, T> From<Lch<Wp, T>> for Lab<Wp, T> where
    T: Component + Float,
    Wp: WhitePoint, 

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

Performs the conversion.

impl<Wp: WhitePoint, T: Component + Float> From<(T, T, T)> for Lab<Wp, T>

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

Performs the conversion.

impl<Wp, T> From<Lab<Wp, T>> for Alpha<Lch<Wp, T>, T> where
    T: Component + Float,
    Wp: WhitePoint,
    T: Component + Float, 

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

Performs the conversion.

impl<Wp, T> From<Lab<Wp, T>> for Lch<Wp, T> where
    T: Component + Float,
    Wp: WhitePoint, 

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

Performs the conversion.

impl<S, T> From<Lab<<S as LumaStandard>::WhitePoint, T>> for Luma<S, T> where
    T: Component,
    S: LumaStandard,
    T: Component + Float, 

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

Performs the conversion.

impl<S, T> From<Lab<<S as LumaStandard>::WhitePoint, T>> for Alpha<Luma<S, T>, T> where
    T: Component,
    S: LumaStandard,
    T: Component + Float, 

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

Performs the conversion.

impl<S: RgbStandard, T: Component> From<Lab<<<S as RgbStandard>::Space as RgbSpace>::WhitePoint, T>> for Rgb<S, T> where
    T: Component + Float, 

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

Performs the conversion.

impl<S: RgbStandard, T: Component> From<Lab<<<S as RgbStandard>::Space as RgbSpace>::WhitePoint, T>> for Alpha<Rgb<S, T>, T> where
    T: Component + Float, 

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

Performs the conversion.

impl<Wp, T> From<Lab<Wp, T>> for Alpha<Xyz<Wp, T>, T> where
    T: Component + Float,
    Wp: WhitePoint,
    T: Component + Float, 

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

Performs the conversion.

impl<Wp, T> From<Lab<Wp, T>> for Xyz<Wp, T> where
    T: Component + Float,
    Wp: WhitePoint, 

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

Performs the conversion.

impl<Wp, T> From<Lab<Wp, T>> for Yxy<Wp, T> where
    T: Component + Float,
    Wp: WhitePoint,
    T: Component + Float, 

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

Performs the conversion.

impl<Wp, T> From<Lab<Wp, T>> for Alpha<Yxy<Wp, T>, T> where
    T: Component + Float,
    Wp: WhitePoint,
    T: Component + Float, 

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

Performs the conversion.

impl<S, T> From<Lab<<S as RgbSpace>::WhitePoint, T>> for Color<S, T> where
    T: Float + Component,
    S: RgbSpace, 

fn from(color: Lab<S::WhitePoint, T>) -> Color<S, T>

Performs the conversion.

impl<Wp: WhitePoint, T: Component + Float> Into<(T, T, T)> for Lab<Wp, T>

fn into(self) -> (T, T, T)

Performs the conversion.

impl<Wp, T, P: ?Sized> AsMut<P> for Lab<Wp, T> where
    T: Component + Float,
    Wp: WhitePoint,
    P: RawPixel<T>, 

fn as_mut(&mut self) -> &mut P

Performs the conversion.

impl<Wp: Debug, T: Debug> Debug for Lab<Wp, T> where
    T: Component + Float,
    Wp: WhitePoint, 

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

Formats the value using the given formatter.

impl<Wp, T> Add<Lab<Wp, T>> for Lab<Wp, T> where
    T: Component + Float,
    Wp: WhitePoint, 

type Output = Lab<Wp, T>

The resulting type after applying the + operator.

fn add(self, other: Lab<Wp, T>) -> Lab<Wp, T>

Performs the + operation.

impl<Wp, T> Add<T> for Lab<Wp, T> where
    T: Component + Float,
    Wp: WhitePoint, 

type Output = Lab<Wp, T>

The resulting type after applying the + operator.

fn add(self, c: T) -> Lab<Wp, T>

Performs the + operation.

impl<Wp, T> Sub<Lab<Wp, T>> for Lab<Wp, T> where
    T: Component + Float,
    Wp: WhitePoint, 

type Output = Lab<Wp, T>

The resulting type after applying the - operator.

fn sub(self, other: Lab<Wp, T>) -> Lab<Wp, T>

Performs the - operation.

impl<Wp, T> Sub<T> for Lab<Wp, T> where
    T: Component + Float,
    Wp: WhitePoint, 

type Output = Lab<Wp, T>

The resulting type after applying the - operator.

fn sub(self, c: T) -> Lab<Wp, T>

Performs the - operation.

impl<Wp, T> Mul<Lab<Wp, T>> for Lab<Wp, T> where
    T: Component + Float,
    Wp: WhitePoint, 

type Output = Lab<Wp, T>

The resulting type after applying the * operator.

fn mul(self, other: Lab<Wp, T>) -> Lab<Wp, T>

Performs the * operation.

impl<Wp, T> Mul<T> for Lab<Wp, T> where
    T: Component + Float,
    Wp: WhitePoint, 

type Output = Lab<Wp, T>

The resulting type after applying the * operator.

fn mul(self, c: T) -> Lab<Wp, T>

Performs the * operation.

impl<Wp, T> Div<Lab<Wp, T>> for Lab<Wp, T> where
    T: Component + Float,
    Wp: WhitePoint, 

type Output = Lab<Wp, T>

The resulting type after applying the / operator.

fn div(self, other: Lab<Wp, T>) -> Lab<Wp, T>

Performs the / operation.

impl<Wp, T> Div<T> for Lab<Wp, T> where
    T: Component + Float,
    Wp: WhitePoint, 

type Output = Lab<Wp, T>

The resulting type after applying the / operator.

fn div(self, c: T) -> Lab<Wp, T>

Performs the / operation.

impl<Wp, T> ApproxEq for Lab<Wp, T> where
    T: Component + Float + ApproxEq,
    T::Epsilon: Copy + Float,
    Wp: WhitePoint, 

type Epsilon = <T as ApproxEq>::Epsilon

Used for specifying relative comparisons.

fn default_epsilon() -> Self::Epsilon

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

fn default_max_relative() -> Self::Epsilon

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

fn default_max_ulps() -> u32

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

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

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

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

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

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

The inverse of ApproxEq::relative_eq.

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

The inverse of ApproxEq::ulps_eq.

impl<Wp, T> Serialize for Lab<Wp, T> where
    T: Component + Float,
    Wp: WhitePoint,
    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<'de, Wp, T> Deserialize<'de> for Lab<Wp, T> where
    T: Component + Float,
    Wp: WhitePoint,
    T: Deserialize<'de>, 

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error> where
    __D: Deserializer<'de>, 

Deserialize this value from the given Serde deserializer.