Struct nannou::color::Luma

pub struct Luma<T = f32> where
    T: Float,  {
    pub luma: T,
}

Linear luminance.

Luma is a purely gray scale color space, which is included more for completeness than anything else, and represents how bright a color is perceived to be. It's basically the Y component of CIE XYZ. The lack of any form of hue representation limits the set of operations that can be performed on it.

Fields

luma: T

The lightness of the color. 0.0 is black and 1.0 is white.

Methods

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

pub fn new(luma: T) -> Luma<T>

Linear luminance.

pub fn new_u8(luma: u8) -> Luma<T>

Linear luminance from an 8 bit value.

Trait Implementations

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

fn into_xyz(self) -> Xyz<T>

Convert into XYZ space

fn into_yxy(self) -> Yxy<T>

Convert into Yxy color space

fn into_lab(self) -> Lab<T>

Convert into Lab* color space

fn into_lch(self) -> Lch<T>

Convert into LCh° color space

fn into_rgb(self) -> Rgb<T>

Convert into RGB color space.

fn into_hsl(self) -> Hsl<T>

Convert into HSL color space

fn into_hsv(self) -> Hsv<T>

Convert into HSV color space

fn into_luma(self) -> Luma<T>

Convert into Luma

fn into_hwb(self) -> Hwb<T>

Convert into HWB color space

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

type Scalar = T

The scalar type for color components.

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

Perform a binary operation on this and an other color.

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

Perform a unary operation on this color.

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

type Epsilon = <T as ApproxEq>::Epsilon

Used for specifying relative comparisons.

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

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

fn default_max_relative() -> <Luma<T> as ApproxEq>::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: &Luma<T>,
    epsilon: <Luma<T> as ApproxEq>::Epsilon,
    max_relative: <Luma<T> as ApproxEq>::Epsilon
) -> bool

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

fn ulps_eq(
    &self,
    other: &Luma<T>,
    epsilon: <Luma<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.

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

The inverse of ApproxEq::relative_eq.

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

The inverse of ApproxEq::ulps_eq.

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

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

Performs the conversion.

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

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

Performs the conversion.

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

fn from(other: Luma<T>) -> Xyz<T>

Performs the conversion.

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

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

Performs the conversion.

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

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

Performs the conversion.

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

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

Performs the conversion.

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

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

Performs the conversion.

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

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

Performs the conversion.

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

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

Performs the conversion.

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

fn from(color: Luma<T>) -> Color<T>

Performs the conversion.

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

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

Performs the conversion.

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

fn from(other: Luma<T>) -> Hsv<T>

Performs the conversion.

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

fn from(other: Luma<T>) -> Hsl<T>

Performs the conversion.

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

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

Performs the conversion.

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

fn from(other: Luma<T>) -> Yxy<T>

Performs the conversion.

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

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

Performs the conversion.

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

fn from(other: Luma<T>) -> Lch<T>

Performs the conversion.

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

fn from(other: Xyz<T>) -> Luma<T>

Performs the conversion.

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

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

Performs the conversion.

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

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

Performs the conversion.

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

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

Performs the conversion.

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

fn from(other: Hsv<T>) -> Luma<T>

Performs the conversion.

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

fn from(other: Rgb<T>) -> Luma<T>

Performs the conversion.

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

fn from(other: Yxy<T>) -> Luma<T>

Performs the conversion.

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

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

Performs the conversion.

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

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

Performs the conversion.

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

fn from(color: Color<T>) -> Luma<T>

Performs the conversion.

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

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

Performs the conversion.

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

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

Performs the conversion.

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

fn from(other: Hsl<T>) -> Luma<T>

Performs the conversion.

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

fn from(other: Lch<T>) -> Luma<T>

Performs the conversion.

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

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

Performs the conversion.

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

fn from(other: Luma<T>) -> Rgb<T>

Performs the conversion.

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

fn from(other: Luma<T>) -> Hwb<T>

Performs the conversion.

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

fn from(other: Hwb<T>) -> Luma<T>

Performs the conversion.

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

type Output = Luma<T>

The resulting type after applying the / operator.

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

Performs the / operation.

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

type Output = Luma<T>

The resulting type after applying the / operator.

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

Performs the / operation.

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

fn is_valid(&self) -> bool

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

fn clamp(&self) -> Luma<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<T> Default for Luma<T> where
    T: Float, 

fn default() -> Luma<T>

Returns the "default value" for a type.

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

type Output = Luma<T>

The resulting type after applying the * operator.

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

Performs the * operation.

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

type Output = Luma<T>

The resulting type after applying the * operator.

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

Performs the * operation.

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

fn from_xyz(xyz: Xyz<T>) -> Luma<T>

Convert from XYZ color space

fn from_yxy(yxy: Yxy<T>) -> Luma<T>

Convert from Yxy color space

fn from_rgb(rgb: Rgb<T>) -> Luma<T>

Convert from RGB color space

fn from_luma(luma: Luma<T>) -> Luma<T>

Convert from Luma

fn from_lab(inp: Lab<T>) -> Self

Convert from Lab* color space

fn from_lch(inp: Lch<T>) -> Self

Convert from LCh° 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

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

type Scalar = T

The type of the lighten/darken amount.

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

Lighten the color by amount.

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

Darken the color by amount.

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

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

Formats the value using the given formatter.

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

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

type Scalar = T

The type of the mixing factor.

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

Mix the color with an other color, by factor.

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

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

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

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

This method tests for !=.

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

type Output = Luma<T>

The resulting type after applying the + operator.

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

Performs the + operation.

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

type Output = Luma<T>

The resulting type after applying the + operator.

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

Performs the + operation.

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

type Output = Luma<T>

The resulting type after applying the - operator.

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

Performs the - operation.

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

type Output = Luma<T>

The resulting type after applying the - operator.

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

Performs the - operation.

impl<T> Blend for Luma<T> where
    T: Float, 

type Color = Luma<T>

The core color type. Typically Self for color types without alpha.

fn into_premultiplied(self) -> PreAlpha<Luma<T>, T>

Convert the color to premultiplied alpha.

fn from_premultiplied(color: PreAlpha<Luma<T>, T>) -> Luma<T>

Convert the color from premultiplied alpha.

fn blend<F>(self, destination: Self, blend_function: F) -> Self where
    F: BlendFunction<Self::Color>, 

Blend self, as the source color, with destination, using blend_function. Anything that implements BlendFunction is acceptable, including functions and closures.

fn over(self, other: Self) -> Self

Place self over other. This is the good old common alpha composition equation.

fn inside(self, other: Self) -> Self

Results in the parts of self that overlaps the visible parts of other.

fn outside(self, other: Self) -> Self

Results in the parts of self that lies outside the visible parts of other.

fn atop(self, other: Self) -> Self

Place self over only the visible parts of other.

fn xor(self, other: Self) -> Self

Results in either self or other, where they do not overlap.

fn plus(self, other: Self) -> Self

Add self and other. This uses the alpha component to regulate the effect, so it's not just plain component wise addition.

fn multiply(self, other: Self) -> Self

Multiply self with other. This uses the alpha component to regulate the effect, so it's not just plain component wise multiplication.

fn screen(self, other: Self) -> Self

Make a color which is at least as light as self or other.

fn overlay(self, other: Self) -> Self

Multiply self or other if other is dark, or screen them if other is light. This results in an S curve.

fn darken(self, other: Self) -> Self

Return the darkest parts of self and other.

fn lighten(self, other: Self) -> Self

Return the lightest parts of self and other.

fn dodge(self, other: Self) -> Self

Lighten other to reflect self. Results in other if self is black.

fn burn(self, other: Self) -> Self

Darken other to reflect self. Results in other if self is white.

fn hard_light(self, other: Self) -> Self

Multiply self or other if other is dark, or screen them if self is light. This is similar to overlay, but depends on self instead of other.

fn soft_light(self, other: Self) -> Self

Lighten other if self is light, or darken other as if it's burned if self is dark. The effect is increased if the components of self is further from 0.5.

fn difference(self, other: Self) -> Self

Return the absolute difference between self and other. It's basically abs(self - other), but regulated by the alpha component.

fn exclusion(self, other: Self) -> Self

Similar to difference, but appears to result in a lower contrast. other is inverted if self is white, and preserved if self is black.

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

fn clone(&self) -> Luma<T>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<S> IntoRgba<S> for Luma<S> where
    S: Float + One, 

fn into_rgba(self) -> Rgba<S>

Convert self into RGBA.