Struct picto::color::Hwb

pub struct Hwb<T = f32> where
    T: Float,  {
    pub hue: RgbHue<T>,
    pub whiteness: T,
    pub blackness: T,
}

Linear HWB color space.

HWB is a cylindrical version of RGB and it’s very closely related to HSV. It describes colors with a starting hue, then a degree of whiteness and blackness to mix into that base hue.

It is very intuitive for humans to use and many color-pickers are based on the HWB color system

Fields

hue: RgbHue<T>

The hue of the color, in degrees. Decides if it’s red, blue, purple, etc. Same as the hue for HSL and HSV.

whiteness: T

The whiteness of the color. It specifies the amount white to mix into the hue. It varies from 0 to 1, with 1 being always full white and 0 always being the color shade (a mixture of a pure hue with black) chosen with the other two controls.

blackness: T

The blackness of the color. It specifies the amount black to mix into the hue. It varies from 0 to 1, with 1 being always full black and 0 always being the color tint (a mixture of a pure hue with white) chosen with the other two

Implementations

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

pub fn new(hue: RgbHue<T>, whiteness: T, blackness: T) -> Hwb<T>

Linear HWB.

Trait Implementations

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

type Output = Hwb<T>

The resulting type after applying the + operator.

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

Performs the + operation.

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

type Output = Hwb<T>

The resulting type after applying the + operator.

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

Performs the + operation.

impl<T> ApproxEq for Hwb<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() -> <Hwb<T> as ApproxEq>::Epsilon

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

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

The inverse of ApproxEq::relative_eq.

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

The inverse of ApproxEq::ulps_eq.

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

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

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<T> Debug for Hwb<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 Hwb<T> where
    T: Float, 

pub fn default() -> Hwb<T>

Returns the “default value” for a type.

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

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

Performs the conversion.

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

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

Performs the conversion.

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

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

Performs the conversion.

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

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

Performs the conversion.

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

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

Performs the conversion.

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

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

Performs the conversion.

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

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

Performs the conversion.

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

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

Performs the conversion.

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

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

Performs the conversion.

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

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

Performs the conversion.

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

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

Performs the conversion.

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

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

Performs the conversion.

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

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

Performs the conversion.

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

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

Performs the conversion.

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

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

Performs the conversion.

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

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

Performs the conversion.

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

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

Performs the conversion.

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

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

Performs the conversion.

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

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

Performs the conversion.

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

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

Performs the conversion.

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

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

Performs the conversion.

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

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

Performs the conversion.

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

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

Performs the conversion.

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

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

Performs the conversion.

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

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

Performs the conversion.

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

pub fn from(color: Hwb<T>) -> Alpha<Luma<T>, 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<Hwb<T>> for Alpha<Lch<T>, T> where
    T: Float, 

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

Performs the conversion.

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

pub fn from(color: Hwb<T>) -> Alpha<Lab<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<Lch<T>> for Hwb<T> where
    T: Float, 

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

Performs the conversion.

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

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

Performs the conversion.

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

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

Performs the conversion.

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

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

Performs the conversion.

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

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

Performs the conversion.

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

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

Convert from XYZ color space

pub fn from_hsv(hsv: Hsv<T>) -> Hwb<T>

Convert from HSV color space

pub fn from_hwb(hwb: Hwb<T>) -> Hwb<T>

Convert from HWB color space

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

Convert from Yxy color space

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_rgb(inp: Rgb<T>) -> Self

Convert from RGB color space

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

Convert from HSL color space

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

Convert from Luma

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

type Hue = RgbHue<T>

The kind of hue unit this color space uses.

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

Calculate a hue if possible.

impl<T> Hue for Hwb<T> where
    T: Float, 

pub fn with_hue(&self, hue: RgbHue<T>) -> Hwb<T>

Return a new copy of self, but with a specific hue.

pub fn shift_hue(&self, amount: RgbHue<T>) -> Hwb<T>

Return a new copy of self, but with the hue shifted by amount.

impl<T> IntoColor<T> for Hwb<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 Hwb<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) -> Hwb<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 Hwb<T> where
    T: Float, 

type Scalar = T

The type of the mixing factor.

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

Mix the color with an other color, by factor.

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

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

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

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

This method tests for !=.

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

fn channels() -> usize

The number of channels in the Pixel.

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

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

Read a Pixel from the slice.

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

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

Read a Pixel from the slice.

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

type Scalar = T

The type of the lighten/darken amount.

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

Lighten the color by amount.

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

Darken the color by amount.

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

type Output = Hwb<T>

The resulting type after applying the - operator.

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

Performs the - operation.

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

type Output = Hwb<T>

The resulting type after applying the - operator.

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

Performs the - operation.

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

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

Write the Pixel to the slice.

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

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