Struct picto::color::Lab

pub struct Lab<T = f32> where
    T: Float,  {
    pub l: T,
    pub a: T,
    pub b: T,
}

The CIE Lab* (CIELAB) color space.

CIE Lab* 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 Lab* are quite different, compared to many other color spaces, so manipulating them manually can be unintuitive.

Fields

l: T

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

a: T

a* goes from red at -1.0 to green at 1.0.

b: T

b* goes from yellow at -1.0 to blue at 1.0.

Implementations

impl<T> Lab<T> where
    T: Float, 

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

CIE Lab*.

Trait Implementations

impl<T> Add<Lab<T>> for Lab<T> where
    T: Float, 

type Output = Lab<T>

The resulting type after applying the + operator.

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

Performs the + operation.

impl<T> Add<T> for Lab<T> where
    T: Float, 

type Output = Lab<T>

The resulting type after applying the + operator.

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

Performs the + operation.

impl<T> ApproxEq for Lab<T> where
    T: Float + ApproxEq,
    <T as ApproxEq>::Epsilon: Copy,
    <T as ApproxEq>::Epsilon: Float, 

type Epsilon = <T as ApproxEq>::Epsilon

Used for specifying relative comparisons.

pub fn default_epsilon() -> <Lab<T> as ApproxEq>::Epsilon

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

pub fn default_max_relative() -> <Lab<T> as ApproxEq>::Epsilon

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

pub fn default_max_ulps() -> u32

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

pub fn relative_eq(
    &self,
    other: &Lab<T>,
    epsilon: <Lab<T> as ApproxEq>::Epsilon,
    max_relative: <Lab<T> as ApproxEq>::Epsilon
) -> bool

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

pub fn ulps_eq(
    &self,
    other: &Lab<T>,
    epsilon: <Lab<T> as ApproxEq>::Epsilon,
    max_ulps: u32
) -> bool

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

pub fn relative_ne(
    &self,
    other: &Lab<T>,
    epsilon: <Lab<T> as ApproxEq>::Epsilon,
    max_relative: <Lab<T> as ApproxEq>::Epsilon
) -> bool

The inverse of ApproxEq::relative_eq.

pub fn ulps_ne(
    &self,
    other: &Lab<T>,
    epsilon: <Lab<T> as ApproxEq>::Epsilon,
    max_ulps: u32
) -> bool

The inverse of ApproxEq::ulps_eq.

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

pub fn clone(&self) -> Lab<T>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<T> ComponentWise for Lab<T> where
    T: Float, 

type Scalar = T

The scalar type for color components.

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

Perform a binary operation on this and an other color.

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

Perform a unary operation on this color.

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

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

Formats the value using the given formatter.

impl<T> Default for Lab<T> where
    T: Float, 

pub fn default() -> Lab<T>

Returns the “default value” for a type.

impl<T> Div<Lab<T>> for Lab<T> where
    T: Float, 

type Output = Lab<T>

The resulting type after applying the / operator.

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

Performs the / operation.

impl<T> Div<T> for Lab<T> where
    T: Float, 

type Output = Lab<T>

The resulting type after applying the / operator.

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

Performs the / operation.

impl<T> From<Alpha<Hsl<T>, T>> for Lab<T> where
    T: Float, 

pub fn from(other: Alpha<Hsl<T>, T>) -> Lab<T>

Performs the conversion.

impl<T> From<Alpha<Hsv<T>, T>> for Lab<T> where
    T: Float, 

pub fn from(other: Alpha<Hsv<T>, T>) -> Lab<T>

Performs the conversion.

impl<T> From<Alpha<Hwb<T>, T>> for Lab<T> where
    T: Float, 

pub fn from(other: Alpha<Hwb<T>, T>) -> Lab<T>

Performs the conversion.

impl<T> From<Alpha<Lab<T>, T>> for Lab<T> where
    T: Float, 

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

Performs the conversion.

impl<T> From<Alpha<Lch<T>, T>> for Lab<T> where
    T: Float, 

pub fn from(other: Alpha<Lch<T>, T>) -> Lab<T>

Performs the conversion.

impl<T> From<Alpha<Luma<T>, T>> for Lab<T> where
    T: Float, 

pub fn from(other: Alpha<Luma<T>, T>) -> Lab<T>

Performs the conversion.

impl<T> From<Alpha<Rgb<T>, T>> for Lab<T> where
    T: Float, 

pub fn from(other: Alpha<Rgb<T>, T>) -> Lab<T>

Performs the conversion.

impl<T> From<Alpha<Xyz<T>, T>> for Lab<T> where
    T: Float, 

pub fn from(other: Alpha<Xyz<T>, T>) -> Lab<T>

Performs the conversion.

impl<T> From<Alpha<Yxy<T>, T>> for Lab<T> where
    T: Float, 

pub fn from(other: Alpha<Yxy<T>, T>) -> Lab<T>

Performs the conversion.

impl<T> From<Color<T>> for Lab<T> where
    T: Float, 

pub fn from(color: Color<T>) -> Lab<T>

Performs the conversion.

impl<T> From<Hsl<T>> for Lab<T> where
    T: Float, 

pub fn from(other: Hsl<T>) -> Lab<T>

Performs the conversion.

impl<T> From<Hsv<T>> for Lab<T> where
    T: Float, 

pub fn from(other: Hsv<T>) -> Lab<T>

Performs the conversion.

impl<T> From<Hwb<T>> for Lab<T> where
    T: Float, 

pub fn from(other: Hwb<T>) -> Lab<T>

Performs the conversion.

impl<T> From<Lab<T>> for Alpha<Hwb<T>, T> where
    T: Float, 

pub fn from(color: Lab<T>) -> Alpha<Hwb<T>, T>

Performs the conversion.

impl<T> From<Lab<T>> for Alpha<Hsl<T>, T> where
    T: Float, 

pub fn from(color: Lab<T>) -> Alpha<Hsl<T>, T>

Performs the conversion.

impl<T> From<Lab<T>> for Color<T> where
    T: Float, 

pub fn from(color: Lab<T>) -> Color<T>

Performs the conversion.

impl<T> From<Lab<T>> for Yxy<T> where
    T: Float, 

pub fn from(other: Lab<T>) -> Yxy<T>

Performs the conversion.

impl<T> From<Lab<T>> for Hsl<T> where
    T: Float, 

pub fn from(other: Lab<T>) -> Hsl<T>

Performs the conversion.

impl<T> From<Lab<T>> for Xyz<T> where
    T: Float, 

pub fn from(other: Lab<T>) -> Xyz<T>

Performs the conversion.

impl<T> From<Lab<T>> for Rgb<T> where
    T: Float, 

pub fn from(other: Lab<T>) -> Rgb<T>

Performs the conversion.

impl<T> From<Lab<T>> for Alpha<Luma<T>, T> where
    T: Float, 

pub fn from(color: Lab<T>) -> Alpha<Luma<T>, T>

Performs the conversion.

impl<T> From<Lab<T>> for Hsv<T> where
    T: Float, 

pub fn from(other: Lab<T>) -> Hsv<T>

Performs the conversion.

impl<T> From<Lab<T>> for Alpha<Rgb<T>, T> where
    T: Float, 

pub fn from(color: Lab<T>) -> Alpha<Rgb<T>, T>

Performs the conversion.

impl<T> From<Lab<T>> for Alpha<Hsv<T>, T> where
    T: Float, 

pub fn from(color: Lab<T>) -> Alpha<Hsv<T>, T>

Performs the conversion.

impl<T> From<Lab<T>> for Alpha<Yxy<T>, T> where
    T: Float, 

pub fn from(color: Lab<T>) -> Alpha<Yxy<T>, T>

Performs the conversion.

impl<T> From<Lab<T>> for Hwb<T> where
    T: Float, 

pub fn from(other: Lab<T>) -> Hwb<T>

Performs the conversion.

impl<T> From<Lab<T>> for Luma<T> where
    T: Float, 

pub fn from(other: Lab<T>) -> Luma<T>

Performs the conversion.

impl<T> From<Lab<T>> for Lch<T> where
    T: Float, 

pub fn from(other: Lab<T>) -> Lch<T>

Performs the conversion.

impl<T> From<Lab<T>> for Alpha<Lch<T>, T> where
    T: Float, 

pub fn from(color: Lab<T>) -> Alpha<Lch<T>, T>

Performs the conversion.

impl<T> From<Lab<T>> for Alpha<Xyz<T>, T> where
    T: Float, 

pub fn from(color: Lab<T>) -> Alpha<Xyz<T>, T>

Performs the conversion.

impl<T> From<Lch<T>> for Lab<T> where
    T: Float, 

pub fn from(other: Lch<T>) -> Lab<T>

Performs the conversion.

impl<T> From<Luma<T>> for Lab<T> where
    T: Float, 

pub fn from(other: Luma<T>) -> Lab<T>

Performs the conversion.

impl<T> From<Rgb<T>> for Lab<T> where
    T: Float, 

pub fn from(other: Rgb<T>) -> Lab<T>

Performs the conversion.

impl<T> From<Xyz<T>> for Lab<T> where
    T: Float, 

pub fn from(other: Xyz<T>) -> Lab<T>

Performs the conversion.

impl<T> From<Yxy<T>> for Lab<T> where
    T: Float, 

pub fn from(other: Yxy<T>) -> Lab<T>

Performs the conversion.

impl<T> FromColor<T> for Lab<T> where
    T: Float, 

pub fn from_xyz(xyz: Xyz<T>) -> Lab<T>

Convert from XYZ color space

pub fn from_lab(lab: Lab<T>) -> Lab<T>

Convert from Lab* color space

pub fn from_lch(lch: Lch<T>) -> Lab<T>

Convert from LCh° color space

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

Convert from Yxy color space

fn from_rgb(inp: Rgb<T>) -> Self

Convert from RGB color space

fn from_hsl(inp: Hsl<T>) -> Self

Convert from HSL color space

fn from_hsv(inp: Hsv<T>) -> Self

Convert from HSV color space

fn from_hwb(inp: Hwb<T>) -> Self

Convert from HWB color space

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

Convert from Luma

impl<T> GetHue for Lab<T> where
    T: Float, 

type Hue = LabHue<T>

The kind of hue unit this color space uses.

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

Calculate a hue if possible.

impl<T> IntoColor<T> for Lab<T> where
    T: Float, 

pub fn into_xyz(self) -> Xyz<T>

Convert into XYZ space

pub fn into_yxy(self) -> Yxy<T>

Convert into Yxy color space

pub fn into_lab(self) -> Lab<T>

Convert into Lab* color space

pub fn into_lch(self) -> Lch<T>

Convert into LCh° color space

pub fn into_rgb(self) -> Rgb<T>

Convert into RGB color space.

pub fn into_hsl(self) -> Hsl<T>

Convert into HSL color space

pub fn into_hsv(self) -> Hsv<T>

Convert into HSV color space

pub fn into_luma(self) -> Luma<T>

Convert into Luma

fn into_hwb(self) -> Hwb<T>

Convert into HWB color space

impl<T> Limited for Lab<T> where
    T: Float, 

pub fn is_valid(&self) -> bool

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

pub fn clamp(&self) -> Lab<T>

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

pub fn clamp_self(&mut self)

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

impl<T> Mix for Lab<T> where
    T: Float, 

type Scalar = T

The type of the mixing factor.

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

Mix the color with an other color, by factor.

impl<T> Mul<Lab<T>> for Lab<T> where
    T: Float, 

type Output = Lab<T>

The resulting type after applying the * operator.

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

Performs the * operation.

impl<T> Mul<T> for Lab<T> where
    T: Float, 

type Output = Lab<T>

The resulting type after applying the * operator.

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

Performs the * operation.

impl<T> PartialEq<Lab<T>> for Lab<T> where
    T: PartialEq<T> + Float, 

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

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

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

This method tests for !=.

impl<C: Channel, T: Float + 'static> Pixel<C> for Lab<T>

fn channels() -> usize

The number of channels in the Pixel.

impl<T: Float + 'static> Read<f32> for Lab<T>

fn read(data: &[f32]) -> Self

Read a Pixel from the slice.

impl<T: Float + 'static> Read<f64> for Lab<T>

fn read(data: &[f64]) -> Self

Read a Pixel from the slice.

impl<T: Float + 'static> Read<u16> for Lab<T>

fn read(data: &[u16]) -> Self

Read a Pixel from the slice.

impl<T: Float + 'static> Read<u32> for Lab<T>

fn read(data: &[u32]) -> Self

Read a Pixel from the slice.

impl<T: Float + 'static> Read<u8> for Lab<T>

fn read(data: &[u8]) -> Self

Read a Pixel from the slice.

impl<T> Shade for Lab<T> where
    T: Float, 

type Scalar = T

The type of the lighten/darken amount.

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

Lighten the color by amount.

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

Darken the color by amount.

impl<T> Sub<Lab<T>> for Lab<T> where
    T: Float, 

type Output = Lab<T>

The resulting type after applying the - operator.

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

Performs the - operation.

impl<T> Sub<T> for Lab<T> where
    T: Float, 

type Output = Lab<T>

The resulting type after applying the - operator.

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

Performs the - operation.

impl<C: Channel, T: Float + 'static> Write<C> for Lab<T>

fn write(&self, data: &mut [C])

Write the Pixel to the slice.

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

impl<T> StructuralPartialEq for Lab<T> where
    T: Float,