Struct Lms 

#[repr(C)]
pub struct Lms<M, T> {
    pub long: T,
    pub medium: T,
    pub short: T,
    pub meta: PhantomData<M>,
}

Generic LMS.

LMS represents the response of the eye’s cone cells. L, M and S are for “long”, “medium” and “short” wavelengths, roughly corresponding to red, green and blue. Many newer mentions of an LMS representation use the letters R, G and B instead (or sometimes ρ, γ, β), but this library sticks to LMS to differentiate it from Rgb.

The LMS color space is a model of the physiological response to color stimuli. It has some mathematical shortcomings that Xyz improves on, such as severe spectral sensitivity overlap between L, M and S. Despite this, LMS has a lot of uses, include chromatic adaptation and emulating different types of color vision deficiency, and it’s sometimes part of the conversion process between other color spaces.

Creating a Value

An LMS value is often derived from another color space, through a conversion matrix. Two such matrices are VonKries and Bradford, and Palette offers type aliases in the lms module to make using them a bit more convenient. It’s of course also possible to simply use Lms::new, but it may not be as intuitive.

use palette::{
    lms::{Lms, VonKriesLms, matrix::VonKries},
    white_point::D65,
    Srgb, FromColor
};

let von_kries_lms = Lms::<VonKries, f32>::new(0.1, 0.2, 0.3);
let von_kries_d65_lms = VonKriesLms::<D65, f32>::new(0.1, 0.2, 0.3);

// `new` is also `const`:
const VON_KRIES_LMS: Lms<VonKries, f32> = Lms::new(0.1, 0.2, 0.3);

// Von Kries LMS from sRGB:
let lms_from_srgb = VonKriesLms::<D65, f32>::from_color(Srgb::new(0.3f32, 0.8, 0.1));

// It's also possible to convert from (and to) arrays and tuples:
let lms_from_array = VonKriesLms::<D65, f32>::from([0.1, 0.2, 0.3]);
let lms_from_tuple = VonKriesLms::<D65, f32>::from((0.1, 0.2, 0.3));

Fields

long: T

Stimulus from long wavelengths, or red, or ρ. The typical range is between 0.0 and 1.0, but it doesn’t have an actual upper bound.

medium: T

Stimulus from medium wavelengths, or green, or γ. The typical range is between 0.0 and 1.0, but it doesn’t have an actual upper bound.

short: T

Stimulus from short wavelengths, or blue, or β. The typical range is between 0.0 and 1.0, but it doesn’t have an actual upper bound.

meta: PhantomData<M>

Type level meta information, such as reference white, or which matrix was used when converting from XYZ.

Implementations

impl<M, T> Lms<M, T>

pub const fn new(long: T, medium: T, short: T) -> Lms<M, T>

Create a new LMS color.

pub fn into_format<U>(self) -> Lms<M, U>

where U: FromStimulus<T>,

Convert the LMS components into another number type.

use palette::{
    lms::VonKriesLms,
    white_point::D65,
};

let lms_f64: VonKriesLms<D65, f64> = VonKriesLms::new(0.3f32, 0.7, 0.2).into_format();

pub fn from_format<U>(color: Lms<M, U>) -> Lms<M, T>

where T: FromStimulus<U>,

Convert the LMS components from another number type.

use palette::{
    lms::VonKriesLms,
    white_point::D65,
};

let lms_f64 = VonKriesLms::<D65, f64>::from_format(VonKriesLms::new(0.3f32, 0.7, 0.2));

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

Convert to a (long, medium, short) tuple.

pub fn from_components(_: (T, T, T)) -> Lms<M, T>

Convert from a (long, medium, short) tuple.

pub fn with_meta<NewM>(self) -> Lms<NewM, T>

Changes the meta type without changing the color value.

This function doesn’t change the numerical values, and thus the stimuli it represents in an absolute sense. However, the appearance of the color may not be the same. The effect may be similar to taking a photo with an incorrect white balance.

impl<M, T> Lms<M, T>

where T: Zero,

pub fn min_short() -> T

Return the short value minimum.

pub fn min_medium() -> T

Return the medium value minimum.

pub fn min_long() -> T

Return the long value minimum.

impl<M, T> Lms<M, T>

pub fn matrix_from_xyz() -> Matrix3<Xyz<<M as HasXyzMeta>::XyzMeta, T>, Lms<M, T>>

where M: HasXyzMeta + HasLmsMatrix, <M as HasLmsMatrix>::LmsMatrix: XyzToLms<T>,

Produce a conversion matrix from Xyz to Lms.

impl<M, T> Lms<M, &T>

pub fn copied(&self) -> Lms<M, T>

where T: Copy,

Get an owned, copied version of this color.

pub fn cloned(&self) -> Lms<M, T>

where T: Clone,

Get an owned, cloned version of this color.

impl<M, T> Lms<M, &mut T>

pub fn set(&mut self, value: Lms<M, T>)

Update this color with new values.

pub fn as_refs(&self) -> Lms<M, &T>

Borrow this color’s components as shared references.

pub fn copied(&self) -> Lms<M, T>

where T: Copy,

Get an owned, copied version of this color.

pub fn cloned(&self) -> Lms<M, T>

where T: Clone,

Get an owned, cloned version of this color.

impl<M, C> Lms<M, C>

pub fn iter<'a>(&'a self) -> <&'a Lms<M, C> as IntoIterator>::IntoIter

where &'a Lms<M, C>: IntoIterator,

Return an iterator over the colors in the wrapped collections.

pub fn iter_mut<'a>( &'a mut self, ) -> <&'a mut Lms<M, C> as IntoIterator>::IntoIter

where &'a mut Lms<M, C>: IntoIterator,

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

pub fn get<'a, I, T>( &'a self, index: I, ) -> Option<Lms<M, &'a <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<Lms<M, &'a 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<M, T> Lms<M, Vec<T>>

pub fn with_capacity(capacity: usize) -> Lms<M, Vec<T>>

Available on crate feature alloc only.

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

pub fn push(&mut self, value: Lms<M, T>)

Available on crate feature alloc only.

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

pub fn pop(&mut self) -> Option<Lms<M, T>>

Available on crate feature alloc only.

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

pub fn clear(&mut self)

Available on crate feature alloc only.

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

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

where R: RangeBounds<usize> + Clone,

Available on crate feature alloc only.

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

Trait Implementations

impl<M, T> AbsDiffEq for Lms<M, T>

where T: AbsDiffEq, <T as AbsDiffEq>::Epsilon: Clone,

Available on crate feature approx only.

type Epsilon = <T as AbsDiffEq>::Epsilon

Used for specifying relative comparisons.

fn default_epsilon() -> <Lms<M, T> as AbsDiffEq>::Epsilon

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

fn abs_diff_eq( &self, other: &Lms<M, T>, epsilon: <T as AbsDiffEq>::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: &Lms<M, T>, epsilon: <T as AbsDiffEq>::Epsilon, ) -> bool

The inverse of [AbsDiffEq::abs_diff_eq].

impl<M, T> Add<T> for Lms<M, T>

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

type Output = Lms<M, T>

The resulting type after applying the + operator.

fn add(self, c: T) -> <Lms<M, T> as Add<T>>::Output

Performs the + operation.

impl<M, T> Add for Lms<M, T>

where T: Add<Output = T>,

type Output = Lms<M, T>

The resulting type after applying the + operator.

fn add(self, other: Lms<M, T>) -> <Lms<M, T> as Add>::Output

Performs the + operation.

impl<M, T> AddAssign<T> for Lms<M, T>

where T: AddAssign + Clone,

fn add_assign(&mut self, c: T)

Performs the += operation.

impl<M, T> AddAssign for Lms<M, T>

where T: AddAssign,

fn add_assign(&mut self, other: Lms<M, T>)

Performs the += operation.

impl<M, T> ArrayCast for Lms<M, T>

type Array = [T; 3]

The output type of a cast to an array.

impl<M, T> AsMut<[T]> for Lms<M, T>

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

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

impl<M, T> AsMut<[T; 3]> for Lms<M, T>

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

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

impl<M, T> AsRef<[T]> for Lms<M, T>

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

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

impl<M, T> AsRef<[T; 3]> for Lms<M, T>

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

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

impl<M, T> Clamp for Lms<M, T>

where T: Clamp + Stimulus,

fn clamp(self) -> Lms<M, T>

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

impl<M, T> ClampAssign for Lms<M, T>

where T: ClampAssign + Stimulus,

fn clamp_assign(&mut self)

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

impl<M, T> Clone for Lms<M, T>

where T: Clone,

fn clone(&self) -> Lms<M, T>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<M, T> Debug for Lms<M, T>

where M: Debug, T: Debug,

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

Formats the value using the given formatter.

impl<M, T> Default for Lms<M, T>

where T: Default,

fn default() -> Lms<M, T>

Returns the “default value” for a type.

impl<'de, M, T> Deserialize<'de> for Lms<M, T>

where T: Deserialize<'de>,

fn deserialize<__D>( __deserializer: __D, ) -> Result<Lms<M, T>, <__D as Deserializer<'de>>::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl<M, T> Div<T> for Lms<M, T>

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

type Output = Lms<M, T>

The resulting type after applying the / operator.

fn div(self, c: T) -> <Lms<M, T> as Div<T>>::Output

Performs the / operation.

impl<M, T> Div for Lms<M, T>

where T: Div<Output = T>,

type Output = Lms<M, T>

The resulting type after applying the / operator.

fn div(self, other: Lms<M, T>) -> <Lms<M, T> as Div>::Output

Performs the / operation.

impl<M, T> DivAssign<T> for Lms<M, T>

where T: DivAssign + Clone,

fn div_assign(&mut self, c: T)

Performs the /= operation.

impl<M, T> DivAssign for Lms<M, T>

where T: DivAssign,

fn div_assign(&mut self, other: Lms<M, T>)

Performs the /= operation.

impl<M, T> EuclideanDistance for Lms<M, T>

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

type Scalar = T

The type for the distance value.

fn distance_squared( self, other: Lms<M, T>, ) -> <Lms<M, T> as EuclideanDistance>::Scalar

Calculate the squared Euclidean distance from self to other.

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

where Self::Scalar: Sqrt,

Calculate the Euclidean distance from self to other.

impl<M, T, C> Extend<Lms<M, T>> for Lms<M, C>

where C: Extend<T>,

fn extend<I>(&mut self, iter: I)

where I: IntoIterator<Item = Lms<M, T>>,

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, M, T> From<&'a [T; 3]> for &'a Lms<M, T>

fn from(array: &'a [T; 3]) -> &'a Lms<M, T>

Converts to this type from the input type.

impl<'a, M, T> From<&'a Lms<M, T>> for &'a [T]

fn from(color: &'a Lms<M, T>) -> &'a [T]

Converts to this type from the input type.

impl<'a, M, T> From<&'a mut [T; 3]> for &'a mut Lms<M, T>

fn from(array: &'a mut [T; 3]) -> &'a mut Lms<M, T>

Converts to this type from the input type.

impl<'a, M, T> From<&'a mut Lms<M, T>> for &'a mut [T]

fn from(color: &'a mut Lms<M, T>) -> &'a mut [T]

Converts to this type from the input type.

impl<M, T, V, const N: usize> From<[Lms<M, T>; N]> for Lms<M, V>

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

fn from(colors: [Lms<M, T>; N]) -> Lms<M, V>

Converts to this type from the input type.

impl<M, T> From<[T; 3]> for Lms<M, T>

fn from(array: [T; 3]) -> Lms<M, T>

Converts to this type from the input type.

impl<M, T> From<(T, T, T)> for Lms<M, T>

fn from(components: (T, T, T)) -> Lms<M, T>

Converts to this type from the input type.

impl<M, T> From<Box<[T; 3]>> for Box<Lms<M, T>>

Available on crate feature alloc only.

fn from(array: Box<[T; 3]>) -> Box<Lms<M, T>>

Converts to this type from the input type.

impl<M> From<Lms<M, f32>> for Lms<M, f64>

fn from(color: Lms<M, f32>) -> Lms<M, f64>

Converts to this type from the input type.

impl<M> From<Lms<M, f64>> for Lms<M, f32>

fn from(color: Lms<M, f64>) -> Lms<M, f32>

Converts to this type from the input type.

impl<M, T> From<PreAlpha<Lms<M, T>>> for Lms<M, T>

where Lms<M, T>: Premultiply<Scalar = T>,

fn from(premultiplied: PreAlpha<Lms<M, T>>) -> Lms<M, T>

Converts to this type from the input type.

impl<M, T, _C, _A> FromColorUnclamped<Alpha<_C, _A>> for Lms<M, T>

where _C: IntoColorUnclamped<Lms<M, T>>,

fn from_color_unclamped(color: Alpha<_C, _A>) -> Lms<M, T>

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

impl<M, T, _S, _Wp> FromColorUnclamped<Hsl<_S, T>> for Lms<M, T>

where _S: RgbStandard, <_S as RgbStandard>::Space: RgbSpace<WhitePoint = _Wp>, Xyz<_Wp, T>: FromColorUnclamped<Hsl<_S, T>> + IntoColorUnclamped<Lms<M, T>>,

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

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

impl<M, T, _Wp> FromColorUnclamped<Hsluv<_Wp, T>> for Lms<M, T>

where Xyz<_Wp, T>: FromColorUnclamped<Hsluv<_Wp, T>> + IntoColorUnclamped<Lms<M, T>>,

fn from_color_unclamped(color: Hsluv<_Wp, T>) -> Lms<M, T>

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

impl<M, T, _S, _Wp> FromColorUnclamped<Hsv<_S, T>> for Lms<M, T>

where _S: RgbStandard, <_S as RgbStandard>::Space: RgbSpace<WhitePoint = _Wp>, Xyz<_Wp, T>: FromColorUnclamped<Hsv<_S, T>> + IntoColorUnclamped<Lms<M, T>>,

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

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

impl<M, T, _S, _Wp> FromColorUnclamped<Hwb<_S, T>> for Lms<M, T>

where _S: RgbStandard, <_S as RgbStandard>::Space: RgbSpace<WhitePoint = _Wp>, Xyz<_Wp, T>: FromColorUnclamped<Hwb<_S, T>> + IntoColorUnclamped<Lms<M, T>>,

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

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

impl<M, T, _Wp> FromColorUnclamped<Lab<_Wp, T>> for Lms<M, T>

where Xyz<_Wp, T>: FromColorUnclamped<Lab<_Wp, T>> + IntoColorUnclamped<Lms<M, T>>,

fn from_color_unclamped(color: Lab<_Wp, T>) -> Lms<M, T>

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

impl<M, T, _Wp> FromColorUnclamped<Lch<_Wp, T>> for Lms<M, T>

where Xyz<_Wp, T>: FromColorUnclamped<Lch<_Wp, T>> + IntoColorUnclamped<Lms<M, T>>,

fn from_color_unclamped(color: Lch<_Wp, T>) -> Lms<M, T>

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

impl<M, T, _Wp> FromColorUnclamped<Lchuv<_Wp, T>> for Lms<M, T>

where Xyz<_Wp, T>: FromColorUnclamped<Lchuv<_Wp, T>> + IntoColorUnclamped<Lms<M, T>>,

fn from_color_unclamped(color: Lchuv<_Wp, T>) -> Lms<M, T>

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

impl<M, T> FromColorUnclamped<Lms<M, T>> for Lms<M, T>

fn from_color_unclamped(val: Lms<M, T>) -> Lms<M, T>

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

impl<M, T> FromColorUnclamped<Lms<M, T>> for Xyz<<M as HasXyzMeta>::XyzMeta, T>

where M: HasLmsMatrix + HasXyzMeta, <M as HasLmsMatrix>::LmsMatrix: LmsToXyz<T>, T: Arithmetics,

fn from_color_unclamped(val: Lms<M, T>) -> Xyz<<M as HasXyzMeta>::XyzMeta, T>

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

impl<S, T, _LmsM> FromColorUnclamped<Lms<_LmsM, T>> for Hsl<S, T>

where _LmsM: HasXyzMeta<XyzMeta = <<S as RgbStandard>::Space as RgbSpace>::WhitePoint>, S: RgbStandard, Rgb<S, T>: FromColorUnclamped<Lms<_LmsM, T>> + IntoColorUnclamped<Hsl<S, T>>,

fn from_color_unclamped(color: Lms<_LmsM, T>) -> Hsl<S, T>

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

impl<Wp, T, _LmsM> FromColorUnclamped<Lms<_LmsM, T>> for Hsluv<Wp, T>

where _LmsM: HasXyzMeta<XyzMeta = Wp>, Wp: WhitePoint<T>, Lchuv<Wp, T>: FromColorUnclamped<Lms<_LmsM, T>> + IntoColorUnclamped<Hsluv<Wp, T>>,

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

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

impl<S, T, _LmsM> FromColorUnclamped<Lms<_LmsM, T>> for Hsv<S, T>

where _LmsM: HasXyzMeta<XyzMeta = <<S as RgbStandard>::Space as RgbSpace>::WhitePoint>, S: RgbStandard, Rgb<S, T>: FromColorUnclamped<Lms<_LmsM, T>> + IntoColorUnclamped<Hsv<S, T>>,

fn from_color_unclamped(color: Lms<_LmsM, T>) -> Hsv<S, T>

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

impl<S, T, _LmsM> FromColorUnclamped<Lms<_LmsM, T>> for Hwb<S, T>

where _LmsM: HasXyzMeta<XyzMeta = <<S as RgbStandard>::Space as RgbSpace>::WhitePoint>, S: RgbStandard, Hsv<S, T>: FromColorUnclamped<Lms<_LmsM, T>> + IntoColorUnclamped<Hwb<S, T>>,

fn from_color_unclamped(color: Lms<_LmsM, T>) -> Hwb<S, T>

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

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

where _LmsM: HasXyzMeta<XyzMeta = Wp>, Wp: WhitePoint<T>, Xyz<Wp, T>: FromColorUnclamped<Lms<_LmsM, T>> + IntoColorUnclamped<Lab<Wp, T>>,

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

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

impl<Wp, T, _LmsM> FromColorUnclamped<Lms<_LmsM, T>> for Lch<Wp, T>

where _LmsM: HasXyzMeta<XyzMeta = Wp>, Wp: WhitePoint<T>, Lab<Wp, T>: FromColorUnclamped<Lms<_LmsM, T>> + IntoColorUnclamped<Lch<Wp, T>>,

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

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

impl<Wp, T, _LmsM> FromColorUnclamped<Lms<_LmsM, T>> for Lchuv<Wp, T>

where _LmsM: HasXyzMeta<XyzMeta = Wp>, Wp: WhitePoint<T>, Luv<Wp, T>: FromColorUnclamped<Lms<_LmsM, T>> + IntoColorUnclamped<Lchuv<Wp, T>>,

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

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

impl<S, T, _LmsM> FromColorUnclamped<Lms<_LmsM, T>> for Luma<S, T>

where _LmsM: HasXyzMeta<XyzMeta = <S as LumaStandard>::WhitePoint>, S: LumaStandard, Xyz<<S as LumaStandard>::WhitePoint, T>: FromColorUnclamped<Lms<_LmsM, T>> + IntoColorUnclamped<Luma<S, T>>,

fn from_color_unclamped(color: Lms<_LmsM, T>) -> Luma<S, T>

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

impl<Wp, T, _LmsM> FromColorUnclamped<Lms<_LmsM, T>> for Luv<Wp, T>

where _LmsM: HasXyzMeta<XyzMeta = Wp>, Wp: WhitePoint<T>, Xyz<Wp, T>: FromColorUnclamped<Lms<_LmsM, T>> + IntoColorUnclamped<Luv<Wp, T>>,

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

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

impl<T, _LmsM> FromColorUnclamped<Lms<_LmsM, T>> for Okhsl<T>

where _LmsM: HasXyzMeta<XyzMeta = D65>, D65: WhitePoint<T>, Oklab<T>: FromColorUnclamped<Lms<_LmsM, T>> + IntoColorUnclamped<Okhsl<T>>,

fn from_color_unclamped(color: Lms<_LmsM, T>) -> Okhsl<T>

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

impl<T, _LmsM> FromColorUnclamped<Lms<_LmsM, T>> for Okhsv<T>

where _LmsM: HasXyzMeta<XyzMeta = D65>, D65: WhitePoint<T>, Oklab<T>: FromColorUnclamped<Lms<_LmsM, T>> + IntoColorUnclamped<Okhsv<T>>,

fn from_color_unclamped(color: Lms<_LmsM, T>) -> Okhsv<T>

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

impl<T, _LmsM> FromColorUnclamped<Lms<_LmsM, T>> for Okhwb<T>

where _LmsM: HasXyzMeta<XyzMeta = D65>, D65: WhitePoint<T>, Okhsv<T>: FromColorUnclamped<Lms<_LmsM, T>> + IntoColorUnclamped<Okhwb<T>>,

fn from_color_unclamped(color: Lms<_LmsM, T>) -> Okhwb<T>

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

impl<T, _LmsM> FromColorUnclamped<Lms<_LmsM, T>> for Oklab<T>

where _LmsM: HasXyzMeta<XyzMeta = D65>, D65: WhitePoint<T>, Xyz<D65, T>: FromColorUnclamped<Lms<_LmsM, T>> + IntoColorUnclamped<Oklab<T>>,

fn from_color_unclamped(color: Lms<_LmsM, T>) -> Oklab<T>

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

impl<T, _LmsM> FromColorUnclamped<Lms<_LmsM, T>> for Oklch<T>

where _LmsM: HasXyzMeta<XyzMeta = D65>, D65: WhitePoint<T>, Oklab<T>: FromColorUnclamped<Lms<_LmsM, T>> + IntoColorUnclamped<Oklch<T>>,

fn from_color_unclamped(color: Lms<_LmsM, T>) -> Oklch<T>

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

impl<S, T, _LmsM> FromColorUnclamped<Lms<_LmsM, T>> for Rgb<S, T>

where _LmsM: HasXyzMeta<XyzMeta = <<S as RgbStandard>::Space as RgbSpace>::WhitePoint>, S: RgbStandard, Xyz<<<S as RgbStandard>::Space as RgbSpace>::WhitePoint, T>: FromColorUnclamped<Lms<_LmsM, T>> + IntoColorUnclamped<Rgb<S, T>>,

fn from_color_unclamped(color: Lms<_LmsM, T>) -> Rgb<S, T>

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

impl<Wp, T, _LmsM> FromColorUnclamped<Lms<_LmsM, T>> for Yxy<Wp, T>

where _LmsM: HasXyzMeta<XyzMeta = Wp>, Wp: WhitePoint<T>, Xyz<Wp, T>: FromColorUnclamped<Lms<_LmsM, T>> + IntoColorUnclamped<Yxy<Wp, T>>,

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

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

impl<M, T, _S, _Wp> FromColorUnclamped<Luma<_S, T>> for Lms<M, T>

where _S: LumaStandard<WhitePoint = _Wp>, Xyz<_Wp, T>: FromColorUnclamped<Luma<_S, T>> + IntoColorUnclamped<Lms<M, T>>,

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

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

impl<M, T, _Wp> FromColorUnclamped<Luv<_Wp, T>> for Lms<M, T>

where Xyz<_Wp, T>: FromColorUnclamped<Luv<_Wp, T>> + IntoColorUnclamped<Lms<M, T>>,

fn from_color_unclamped(color: Luv<_Wp, T>) -> Lms<M, T>

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

impl<M, T> FromColorUnclamped<Okhsl<T>> for Lms<M, T>

where Xyz<D65, T>: FromColorUnclamped<Okhsl<T>> + IntoColorUnclamped<Lms<M, T>>,

fn from_color_unclamped(color: Okhsl<T>) -> Lms<M, T>

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

impl<M, T> FromColorUnclamped<Okhsv<T>> for Lms<M, T>

where Xyz<D65, T>: FromColorUnclamped<Okhsv<T>> + IntoColorUnclamped<Lms<M, T>>,

fn from_color_unclamped(color: Okhsv<T>) -> Lms<M, T>

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

impl<M, T> FromColorUnclamped<Okhwb<T>> for Lms<M, T>

where Xyz<D65, T>: FromColorUnclamped<Okhwb<T>> + IntoColorUnclamped<Lms<M, T>>,

fn from_color_unclamped(color: Okhwb<T>) -> Lms<M, T>

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

impl<M, T> FromColorUnclamped<Oklab<T>> for Lms<M, T>

where Xyz<D65, T>: FromColorUnclamped<Oklab<T>> + IntoColorUnclamped<Lms<M, T>>,

fn from_color_unclamped(color: Oklab<T>) -> Lms<M, T>

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

impl<M, T> FromColorUnclamped<Oklch<T>> for Lms<M, T>

where Xyz<D65, T>: FromColorUnclamped<Oklch<T>> + IntoColorUnclamped<Lms<M, T>>,

fn from_color_unclamped(color: Oklch<T>) -> Lms<M, T>

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

impl<M, T, _S, _Wp> FromColorUnclamped<Rgb<_S, T>> for Lms<M, T>

where _S: RgbStandard, <_S as RgbStandard>::Space: RgbSpace<WhitePoint = _Wp>, Xyz<_Wp, T>: FromColorUnclamped<Rgb<_S, T>> + IntoColorUnclamped<Lms<M, T>>,

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

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

impl<M, T> FromColorUnclamped<Xyz<<M as HasXyzMeta>::XyzMeta, T>> for Lms<M, T>

where M: HasLmsMatrix + HasXyzMeta, <M as HasLmsMatrix>::LmsMatrix: XyzToLms<T>, T: Arithmetics,

fn from_color_unclamped(val: Xyz<<M as HasXyzMeta>::XyzMeta, T>) -> Lms<M, T>

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

impl<M, T, _Wp> FromColorUnclamped<Yxy<_Wp, T>> for Lms<M, T>

where Xyz<_Wp, T>: FromColorUnclamped<Yxy<_Wp, T>> + IntoColorUnclamped<Lms<M, T>>,

fn from_color_unclamped(color: Yxy<_Wp, T>) -> Lms<M, T>

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

impl<M, T, C> FromIterator<Lms<M, T>> for Lms<M, C>

where Lms<M, C>: Extend<Lms<M, T>>, C: Default,

fn from_iter<I>(iter: I) -> Lms<M, C>

where I: IntoIterator<Item = Lms<M, T>>,

Creates a value from an iterator.

impl<M, T> HasBoolMask for Lms<M, T>

where T: HasBoolMask,

type Mask = <T as HasBoolMask>::Mask

The mask type to use for selecting Self values.

impl<'a, 'b, M, T> IntoIterator for &'a Lms<M, &'b [T]>

type Item = Lms<M, &'a T>

The type of the elements being iterated over.

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

Which kind of iterator are we turning this into?

fn into_iter(self) -> <&'a Lms<M, &'b [T]> as IntoIterator>::IntoIter

Creates an iterator from a value.

impl<'a, 'b, M, T> IntoIterator for &'a Lms<M, &'b mut [T]>

type Item = Lms<M, &'a T>

The type of the elements being iterated over.

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

Which kind of iterator are we turning this into?

fn into_iter(self) -> <&'a Lms<M, &'b mut [T]> as IntoIterator>::IntoIter

Creates an iterator from a value.

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

type Item = Lms<M, &'a T>

The type of the elements being iterated over.

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

Which kind of iterator are we turning this into?

fn into_iter(self) -> <&'a Lms<M, [T; N]> as IntoIterator>::IntoIter

Creates an iterator from a value.

impl<'a, M, T> IntoIterator for &'a Lms<M, Box<[T]>>

Available on crate feature alloc only.

type Item = Lms<M, &'a T>

The type of the elements being iterated over.

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

Which kind of iterator are we turning this into?

fn into_iter(self) -> <&'a Lms<M, Box<[T]>> as IntoIterator>::IntoIter

Creates an iterator from a value.

impl<'a, M, T> IntoIterator for &'a Lms<M, Vec<T>>

Available on crate feature alloc only.

type Item = Lms<M, &'a T>

The type of the elements being iterated over.

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

Which kind of iterator are we turning this into?

fn into_iter(self) -> <&'a Lms<M, Vec<T>> as IntoIterator>::IntoIter

Creates an iterator from a value.

impl<'a, 'b, M, T> IntoIterator for &'a mut Lms<M, &'b mut [T]>

type Item = Lms<M, &'a mut T>

The type of the elements being iterated over.

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

Which kind of iterator are we turning this into?

fn into_iter(self) -> <&'a mut Lms<M, &'b mut [T]> as IntoIterator>::IntoIter

Creates an iterator from a value.

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

type Item = Lms<M, &'a mut T>

The type of the elements being iterated over.

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

Which kind of iterator are we turning this into?

fn into_iter(self) -> <&'a mut Lms<M, [T; N]> as IntoIterator>::IntoIter

Creates an iterator from a value.

impl<'a, M, T> IntoIterator for &'a mut Lms<M, Box<[T]>>

where T: 'a,

Available on crate feature alloc only.

type Item = Lms<M, &'a mut T>

The type of the elements being iterated over.

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

Which kind of iterator are we turning this into?

fn into_iter(self) -> <&'a mut Lms<M, Box<[T]>> as IntoIterator>::IntoIter

Creates an iterator from a value.

impl<'a, M, T> IntoIterator for &'a mut Lms<M, Vec<T>>

Available on crate feature alloc only.

type Item = Lms<M, &'a mut T>

The type of the elements being iterated over.

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

Which kind of iterator are we turning this into?

fn into_iter(self) -> <&'a mut Lms<M, Vec<T>> as IntoIterator>::IntoIter

Creates an iterator from a value.

impl<'a, M, T> IntoIterator for Lms<M, &'a [T]>

type Item = Lms<M, &'a T>

The type of the elements being iterated over.

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

Which kind of iterator are we turning this into?

fn into_iter(self) -> <Lms<M, &'a [T]> as IntoIterator>::IntoIter

Creates an iterator from a value.

impl<'a, M, T> IntoIterator for Lms<M, &'a mut [T]>

type Item = Lms<M, &'a mut T>

The type of the elements being iterated over.

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

Which kind of iterator are we turning this into?

fn into_iter(self) -> <Lms<M, &'a mut [T]> as IntoIterator>::IntoIter

Creates an iterator from a value.

impl<M, T, const N: usize> IntoIterator for Lms<M, [T; N]>

type Item = Lms<M, T>

The type of the elements being iterated over.

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

Which kind of iterator are we turning this into?

fn into_iter(self) -> <Lms<M, [T; N]> as IntoIterator>::IntoIter

Creates an iterator from a value.

impl<M, T> IntoIterator for Lms<M, Vec<T>>

Available on crate feature alloc only.

type Item = Lms<M, T>

The type of the elements being iterated over.

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

Which kind of iterator are we turning this into?

fn into_iter(self) -> <Lms<M, Vec<T>> as IntoIterator>::IntoIter

Creates an iterator from a value.

impl<M, T> IsWithinBounds for Lms<M, T>

where T: PartialCmp + Stimulus, <T as HasBoolMask>::Mask: BitAnd<Output = <T as HasBoolMask>::Mask>,

fn is_within_bounds(&self) -> <T as HasBoolMask>::Mask

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

impl<M, T> Mix for Lms<M, T>

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

type Scalar = T

The type of the mixing factor.

fn mix(self, other: Lms<M, T>, factor: T) -> Lms<M, T>

Mix the color with an other color, by factor.

impl<M, T> MixAssign for Lms<M, 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: Lms<M, T>, factor: T)

Mix the color with an other color, by factor.

impl<M, T> Mul<T> for Lms<M, T>

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

type Output = Lms<M, T>

The resulting type after applying the * operator.

fn mul(self, c: T) -> <Lms<M, T> as Mul<T>>::Output

Performs the * operation.

impl<M, T> Mul for Lms<M, T>

where T: Mul<Output = T>,

type Output = Lms<M, T>

The resulting type after applying the * operator.

fn mul(self, other: Lms<M, T>) -> <Lms<M, T> as Mul>::Output

Performs the * operation.

impl<M, T> MulAssign<T> for Lms<M, T>

where T: MulAssign + Clone,

fn mul_assign(&mut self, c: T)

Performs the *= operation.

impl<M, T> MulAssign for Lms<M, T>

where T: MulAssign,

fn mul_assign(&mut self, other: Lms<M, T>)

Performs the *= operation.

impl<M, T> PartialEq for Lms<M, T>

where T: PartialEq,

fn eq(&self, other: &Lms<M, T>) -> 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<M, T> Premultiply for Lms<M, T>

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

type Scalar = T

The color’s component type.

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

Alpha mask the color.

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

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

impl<M, T> RelativeEq for Lms<M, T>

where T: RelativeEq, <T as AbsDiffEq>::Epsilon: Clone,

Available on crate feature approx only.

fn default_max_relative() -> <T as AbsDiffEq>::Epsilon

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

fn relative_eq( &self, other: &Lms<M, T>, epsilon: <T as AbsDiffEq>::Epsilon, max_relative: <T as AbsDiffEq>::Epsilon, ) -> bool

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

fn relative_ne( &self, other: &Lms<M, T>, epsilon: <T as AbsDiffEq>::Epsilon, max_relative: <T as AbsDiffEq>::Epsilon, ) -> bool

The inverse of [RelativeEq::relative_eq].

impl<M, T> SaturatingAdd<T> for Lms<M, T>

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

type Output = Lms<M, T>

The resulting type.

fn saturating_add(self, c: T) -> <Lms<M, T> as SaturatingAdd<T>>::Output

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

impl<M, T> SaturatingAdd for Lms<M, T>

where T: SaturatingAdd<Output = T>,

type Output = Lms<M, T>

The resulting type.

fn saturating_add( self, other: Lms<M, T>, ) -> <Lms<M, T> as SaturatingAdd>::Output

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

impl<M, T> SaturatingSub<T> for Lms<M, T>

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

type Output = Lms<M, T>

The resulting type.

fn saturating_sub(self, c: T) -> <Lms<M, T> as SaturatingSub<T>>::Output

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

impl<M, T> SaturatingSub for Lms<M, T>

where T: SaturatingSub<Output = T>,

type Output = Lms<M, T>

The resulting type.

fn saturating_sub( self, other: Lms<M, T>, ) -> <Lms<M, T> as SaturatingSub>::Output

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

impl<M, T> Serialize for Lms<M, T>

where T: Serialize,

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl<M, T> Sub<T> for Lms<M, T>

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

type Output = Lms<M, T>

The resulting type after applying the - operator.

fn sub(self, c: T) -> <Lms<M, T> as Sub<T>>::Output

Performs the - operation.

impl<M, T> Sub for Lms<M, T>

where T: Sub<Output = T>,

type Output = Lms<M, T>

The resulting type after applying the - operator.

fn sub(self, other: Lms<M, T>) -> <Lms<M, T> as Sub>::Output

Performs the - operation.

impl<M, T> SubAssign<T> for Lms<M, T>

where T: SubAssign + Clone,

fn sub_assign(&mut self, c: T)

Performs the -= operation.

impl<M, T> SubAssign for Lms<M, T>

where T: SubAssign,

fn sub_assign(&mut self, other: Lms<M, T>)

Performs the -= operation.

impl<'a, M, T> TryFrom<&'a [T]> for &'a Lms<M, 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<&'a Lms<M, T>, <&'a Lms<M, T> as TryFrom<&'a [T]>>::Error>

Performs the conversion.

impl<'a, M, T> TryFrom<&'a mut [T]> for &'a mut Lms<M, 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<&'a mut Lms<M, T>, <&'a mut Lms<M, T> as TryFrom<&'a mut [T]>>::Error>

Performs the conversion.

impl<M, T> UlpsEq for Lms<M, T>

where T: UlpsEq, <T as AbsDiffEq>::Epsilon: Clone,

Available on crate feature approx only.

fn default_max_ulps() -> u32

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

fn ulps_eq( &self, other: &Lms<M, T>, epsilon: <T as AbsDiffEq>::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: &Lms<M, T>, epsilon: <T as AbsDiffEq>::Epsilon, max_ulps: u32, ) -> bool

The inverse of [UlpsEq::ulps_eq].

impl<M, T, _A> WithAlpha<_A> for Lms<M, T>

where _A: Stimulus,

type Color = Lms<M, T>

The opaque color type, without any transparency.

type WithAlpha = Alpha<Lms<M, T>, _A>

The color type with transparency applied.

fn with_alpha(self, alpha: _A) -> <Lms<M, T> as WithAlpha<_A>>::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) -> <Lms<M, T> as WithAlpha<_A>>::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) -> (<Lms<M, T> as WithAlpha<_A>>::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<M, T> Copy for Lms<M, T>

where T: Copy,

impl<M, T> Eq for Lms<M, T>

where T: Eq,

impl<M, T> StimulusColor for Lms<M, T>

where T: Stimulus,