Struct Lab

pub struct Lab<T: Float + Send + Sync> { /* private fields */ }

LAB colour representation.

Implementations

impl<T: Float + Send + Sync> Lab<T>

pub fn new(lightness: T, a_star: T, b_star: T) -> Self

Create a new Lab instance.

Panics

This function will not panic.

pub const fn lightness(&self) -> T

Get the lightness component (L*).

pub const fn a_star(&self) -> T

Get the a_star component (a*).

pub const fn b_star(&self) -> T

Get the b_star component (b*).

pub fn set_lightness(&mut self, lightness: T)

Set the lightness component (L).

Panics

This function will not panic.

pub fn set_a_star(&mut self, a_star: T)

Set the a_star component.

Panics

This function will not panic.

pub fn set_b_star(&mut self, b_star: T)

Set the b_star component.

Panics

This function will not panic.

pub fn delta_e(&self, other: &Self) -> T

Calculate perceptual colour difference in Lab space (CIE76 Delta E). The Delta E value indicates how different two colours appear, with values:

• < 1.0: Not perceptible by human eyes
• 1-2: Perceptible through close observation
• 2-10: Perceptible at a glance

• 10: Colours are more similar than opposite

pub fn delta_e94(&self, other: &Self) -> T

Calculate perceptual colour difference using the improved CIE94 Delta E formula. This is more accurate than the basic delta_e method, especially for saturated colours.

Panics

This function will not panic.

Trait Implementations

impl<T: Clone + Float + Send + Sync> Clone for Lab<T>

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: Float + Send + Sync> Colour<T, 3> for Lab<T>

fn lerp(lhs: &Self, rhs: &Self, t: T) -> Self

Linear interpolate between two Lab colours.

Lab is designed to be perceptually uniform, so linear interpolation in this space produces perceptually uniform gradients.

fn from_hex(hex: &str) -> Result<Self, ParseColourError<ParseIntError>>

Create a new colour from a hex string.

fn to_hex(&self) -> String

Convert the colour to a hex string.

fn from_bytes(bytes: [u8; 3]) -> Self

Create a new colour from a byte array.

fn to_bytes(self) -> [u8; 3]

Convert the colour to a byte array.

const NUM_COMPONENTS: usize = N

Number of components in the colour.

fn mix(colours: &[Self], weights: &[T]) -> Self

where Self: Clone, T: AddAssign,

Mix N by folding lerp (assumes weights sum to 1).

impl<T: Float + Send + Sync> Convert<T> for Lab<T>

fn to_grey(&self) -> Grey<T>

fn to_grey_alpha(&self) -> GreyAlpha<T>

fn to_hsl(&self) -> Hsl<T>

fn to_hsl_alpha(&self) -> HslAlpha<T>

fn to_hsv(&self) -> Hsv<T>

fn to_hsv_alpha(&self) -> HsvAlpha<T>

fn to_lab(&self) -> Self

fn to_lab_alpha(&self) -> LabAlpha<T>

fn to_rgb(&self) -> Rgb<T>

fn to_rgb_alpha(&self) -> RgbAlpha<T>

fn to_srgb(&self) -> Srgb<T>

fn to_srgb_alpha(&self) -> SrgbAlpha<T>

fn to_xyz(&self) -> Xyz<T>

fn to_xyz_alpha(&self) -> XyzAlpha<T>

impl<T: Debug + Float + Send + Sync> Debug for Lab<T>

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

Formats the value using the given formatter.

impl<T: Float + Send + Sync> Display for Lab<T>

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

Formats the value using the given formatter.

impl<T: Copy + Float + Send + Sync> Copy for Lab<T>