Struct lab::Lab

pub struct Lab {
    pub l: f32,
    pub a: f32,
    pub b: f32,
}

Struct representing a color in CIALab, a.k.a. L*a*b*, color space

Fields

l: f32

a: f32

b: f32

Implementations

impl Lab

pub fn from_rgb(rgb: &[u8; 3]) -> Self

Constructs a new Lab from a three-element array of u8s

Examples

let lab = lab::Lab::from_rgb(&[240, 33, 95]);
assert_eq!(lab::Lab { l: 52.334686, a: 75.55157, b: 19.995684 }, lab);

pub fn from_rgba(rgba: &[u8; 4]) -> Self

Constructs a new Lab from a four-element array of u8s

The Lab struct does not store alpha channel information, so the last u8 representing alpha is discarded. This convenience method exists in order to easily measure colors already stored in an RGBA array.

Examples

let lab = lab::Lab::from_rgba(&[240, 33, 95, 255]);
assert_eq!(lab::Lab { l: 52.334686, a: 75.55157, b: 19.995684 }, lab);

pub fn to_rgb(&self) -> [u8; 3]

Returns the Lab’s color in RGB, in a 3-element array.

Examples

let lab = lab::Lab { l: 52.330193, a: 75.56704, b: 19.989174 };
let rgb = lab.to_rgb();
assert_eq!([240, 33, 95], rgb);

pub fn squared_distance(&self, other: &Lab) -> f32

Measures the perceptual distance between the colors of one Lab and an other.

Examples

let pink = Lab { l: 66.6348, a: 52.260696, b: 14.850557 };
let websafe_pink = Lab { l: 64.2116, a: 62.519463, b: 2.8871894 };
assert_eq!(254.23636, pink.squared_distance(&websafe_pink));

Trait Implementations

impl Clone for Lab

fn clone(&self) -> Lab

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Lab

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

Formats the value using the given formatter.

impl Default for Lab

fn default() -> Lab

Returns the “default value” for a type.

impl PartialEq<Lab> for Lab

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

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

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

This method tests for !=.

impl Copy for Lab

impl StructuralPartialEq for Lab