Struct Hwb

#[repr(C)]
pub struct Hwb<S = Srgb, T = f32>
where
    T: Component + Float,
    S: RgbSpace,
{
    pub hue: RgbHue<T>,
    pub whiteness: T,
    pub blackness: T,
    pub space: PhantomData<S>,
}

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

space: PhantomData<S>

The white point and RGB primaries this color is adapted to. The default is the sRGB standard.

Implementations

impl<T> Hwb<Srgb, T>

where T: Component + Float,

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

where H: Into<RgbHue<T>>,

HWB for linear sRGB.

impl<S, T> Hwb<S, T>

where T: Component + Float, S: RgbSpace,

pub fn with_wp<H>(hue: H, whiteness: T, blackness: T) -> Hwb<S, T>

where H: Into<RgbHue<T>>,

Linear HWB.

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

Convert to a (hue, whiteness, blackness) tuple.

pub fn from_components<H>(_: (H, T, T)) -> Hwb<S, T>

where H: Into<RgbHue<T>>,

Convert from a (hue, whiteness, blackness) tuple.

Trait Implementations

impl<S, T> AbsDiffEq for Hwb<S, T>

where T: Component + Float + AbsDiffEq, <T as AbsDiffEq>::Epsilon: Copy + Float, S: RgbSpace + PartialEq,

type Epsilon = <T as AbsDiffEq>::Epsilon

Used for specifying relative comparisons.

fn default_epsilon() -> <Hwb<S, T> as AbsDiffEq>::Epsilon

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

fn abs_diff_eq( &self, other: &Hwb<S, T>, epsilon: <Hwb<S, 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: &Rhs, epsilon: Self::Epsilon) -> bool

The inverse of ApproxEq::abs_diff_eq.

impl<S, T> Add<T> for Hwb<S, T>

where T: Component + Float, S: RgbSpace,

type Output = Hwb<S, T>

The resulting type after applying the + operator.

fn add(self, c: T) -> <Hwb<S, T> as Add<T>>::Output

Performs the + operation.

impl<S, T> Add for Hwb<S, T>

where T: Component + Float, S: RgbSpace,

type Output = Hwb<S, T>

The resulting type after applying the + operator.

fn add(self, other: Hwb<S, T>) -> <Hwb<S, T> as Add>::Output

Performs the + operation.

impl<S, T> AddAssign<T> for Hwb<S, T>

where T: Component + Float + AddAssign, S: RgbSpace,

fn add_assign(&mut self, c: T)

Performs the += operation.

impl<S, T> AddAssign for Hwb<S, T>

where T: Component + Float + AddAssign, S: RgbSpace,

fn add_assign(&mut self, other: Hwb<S, T>)

Performs the += operation.

impl<S, T, P> AsMut<P> for Hwb<S, T>

where T: Component + Float, S: RgbSpace, P: RawPixel<T> + ?Sized,

fn as_mut(&mut self) -> &mut P

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

impl<S, T, P> AsRef<P> for Hwb<S, T>

where T: Component + Float, S: RgbSpace, P: RawPixel<T> + ?Sized,

fn as_ref(&self) -> &P

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

impl<S, T> Clone for Hwb<S, T>

where T: Component + Float, S: RgbSpace,

fn clone(&self) -> Hwb<S, T>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<S, T> Debug for Hwb<S, T>

where S: Debug + RgbSpace, T: Debug + Component + Float,

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

Formats the value using the given formatter.

impl<S, T> Default for Hwb<S, T>

where T: Component + Float, S: RgbSpace,

fn default() -> Hwb<S, T>

Returns the “default value” for a type.

impl<S, T, H> From<(H, T, T)> for Hwb<S, T>

where S: RgbSpace, T: Component + Float, H: Into<RgbHue<T>>,

fn from(components: (H, T, T)) -> Hwb<S, T>

Converts to this type from the input type.

impl<S, T> From<Alpha<Hsl<S, T>, T>> for Hwb<S, T>

where T: Component + Float, S: RgbSpace,

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

Converts to this type from the input type.

impl<S, T> From<Alpha<Hsv<S, T>, T>> for Hwb<S, T>

where T: Component + Float, S: RgbSpace,

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

Converts to this type from the input type.

impl<S, T> From<Alpha<Hwb<S, T>, T>> for Hwb<S, T>

where T: Component + Float, S: RgbSpace,

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

Converts to this type from the input type.

impl<S, T> From<Alpha<Lab<<S as RgbSpace>::WhitePoint, T>, T>> for Hwb<S, T>

where T: Component + Float, S: RgbSpace,

fn from(color: Alpha<Lab<<S as RgbSpace>::WhitePoint, T>, T>) -> Hwb<S, T>

Converts to this type from the input type.

impl<S, T> From<Alpha<Lch<<S as RgbSpace>::WhitePoint, T>, T>> for Hwb<S, T>

where T: Component + Float, S: RgbSpace,

fn from(color: Alpha<Lch<<S as RgbSpace>::WhitePoint, T>, T>) -> Hwb<S, T>

Converts to this type from the input type.

impl<S, T, _S> From<Alpha<Luma<_S, T>, T>> for Hwb<S, T>

where T: Component + Float, S: RgbSpace, _S: LumaStandard<WhitePoint = <S as RgbSpace>::WhitePoint>,

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

Converts to this type from the input type.

impl<S, T, _S> From<Alpha<Rgb<_S, T>, T>> for Hwb<S, T>

where T: Component + Float, S: RgbSpace, _S: RgbStandard<Space = S>,

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

Converts to this type from the input type.

impl<S, T> From<Alpha<Xyz<<S as RgbSpace>::WhitePoint, T>, T>> for Hwb<S, T>

where T: Component + Float, S: RgbSpace,

fn from(color: Alpha<Xyz<<S as RgbSpace>::WhitePoint, T>, T>) -> Hwb<S, T>

Converts to this type from the input type.

impl<S, T> From<Alpha<Yxy<<S as RgbSpace>::WhitePoint, T>, T>> for Hwb<S, T>

where T: Component + Float, S: RgbSpace,

fn from(color: Alpha<Yxy<<S as RgbSpace>::WhitePoint, T>, T>) -> Hwb<S, T>

Converts to this type from the input type.

impl<S, T> From<Hsl<S, T>> for Hwb<S, T>

where T: Component + Float, S: RgbSpace,

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

Converts to this type from the input type.

impl<S, T, Sp> From<Hsv<Sp, T>> for Hwb<S, T>

where T: Component + Float, S: RgbSpace, Sp: RgbSpace<WhitePoint = <S as RgbSpace>::WhitePoint>,

fn from(color: Hsv<Sp, T>) -> Hwb<S, T>

Converts to this type from the input type.

impl<S, T> From<Hwb<<S as RgbStandard>::Space, T>> for Alpha<Rgb<S, T>, T>

where S: RgbStandard, T: Component + Float,

fn from(color: Hwb<<S as RgbStandard>::Space, T>) -> Alpha<Rgb<S, T>, T>

Converts to this type from the input type.

impl<S, T> From<Hwb<<S as RgbStandard>::Space, T>> for Rgb<S, T>

where S: RgbStandard, T: Component + Float,

fn from(color: Hwb<<S as RgbStandard>::Space, T>) -> Rgb<S, T>

Converts to this type from the input type.

impl<S, T> From<Hwb<S, T>> for Alpha<Hsl<S, T>, T>

where T: Component + Float, S: RgbSpace,

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

Converts to this type from the input type.

impl<S, T> From<Hwb<S, T>> for Alpha<Hsv<S, T>, T>

where T: Component + Float, S: RgbSpace,

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

Converts to this type from the input type.

impl<S, T> From<Hwb<S, T>> for Hsl<S, T>

where T: Component + Float, S: RgbSpace,

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

Converts to this type from the input type.

impl<S, Sp, T> From<Hwb<Sp, T>> for Hsv<S, T>

where T: Component + Float, S: RgbSpace, Sp: RgbSpace<WhitePoint = <S as RgbSpace>::WhitePoint>,

fn from(color: Hwb<Sp, T>) -> Hsv<S, T>

Converts to this type from the input type.

impl<Wp, T, _S> From<Hwb<_S, T>> for Alpha<Lab<Wp, T>, T>

where T: Component + Float, Wp: WhitePoint, _S: RgbSpace<WhitePoint = Wp>,

fn from(color: Hwb<_S, T>) -> Alpha<Lab<Wp, T>, T>

Converts to this type from the input type.

impl<Wp, T, _S> From<Hwb<_S, T>> for Alpha<Lch<Wp, T>, T>

where T: Component + Float, Wp: WhitePoint, _S: RgbSpace<WhitePoint = Wp>,

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

Converts to this type from the input type.

impl<S, T, _S> From<Hwb<_S, T>> for Alpha<Luma<S, T>, T>

where T: Component + Float, S: LumaStandard, _S: RgbSpace<WhitePoint = <S as LumaStandard>::WhitePoint>,

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

Converts to this type from the input type.

impl<Wp, T, _S> From<Hwb<_S, T>> for Alpha<Xyz<Wp, T>, T>

where T: Component + Float, Wp: WhitePoint, _S: RgbSpace<WhitePoint = Wp>,

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

Converts to this type from the input type.

impl<Wp, T, _S> From<Hwb<_S, T>> for Alpha<Yxy<Wp, T>, T>

where T: Component + Float, Wp: WhitePoint, _S: RgbSpace<WhitePoint = Wp>,

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

Converts to this type from the input type.

impl<Wp, T, _S> From<Hwb<_S, T>> for Lab<Wp, T>

where T: Component + Float, Wp: WhitePoint, _S: RgbSpace<WhitePoint = Wp>,

fn from(color: Hwb<_S, T>) -> Lab<Wp, T>

Converts to this type from the input type.

impl<Wp, T, _S> From<Hwb<_S, T>> for Lch<Wp, T>

where T: Component + Float, Wp: WhitePoint, _S: RgbSpace<WhitePoint = Wp>,

fn from(color: Hwb<_S, T>) -> Lch<Wp, T>

Converts to this type from the input type.

impl<S, T, _S> From<Hwb<_S, T>> for Luma<S, T>

where T: Component + Float, S: LumaStandard, _S: RgbSpace<WhitePoint = <S as LumaStandard>::WhitePoint>,

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

Converts to this type from the input type.

impl<Wp, T, _S> From<Hwb<_S, T>> for Xyz<Wp, T>

where T: Component + Float, Wp: WhitePoint, _S: RgbSpace<WhitePoint = Wp>,

fn from(color: Hwb<_S, T>) -> Xyz<Wp, T>

Converts to this type from the input type.

impl<Wp, T, _S> From<Hwb<_S, T>> for Yxy<Wp, T>

where T: Component + Float, Wp: WhitePoint, _S: RgbSpace<WhitePoint = Wp>,

fn from(color: Hwb<_S, T>) -> Yxy<Wp, T>

Converts to this type from the input type.

impl<S, T> From<Lab<<S as RgbSpace>::WhitePoint, T>> for Hwb<S, T>

where T: Component + Float, S: RgbSpace,

fn from(color: Lab<<S as RgbSpace>::WhitePoint, T>) -> Hwb<S, T>

Converts to this type from the input type.

impl<S, T> From<Lch<<S as RgbSpace>::WhitePoint, T>> for Hwb<S, T>

where T: Component + Float, S: RgbSpace,

fn from(color: Lch<<S as RgbSpace>::WhitePoint, T>) -> Hwb<S, T>

Converts to this type from the input type.

impl<S, T, _S> From<Luma<_S, T>> for Hwb<S, T>

where T: Component + Float, S: RgbSpace, _S: LumaStandard<WhitePoint = <S as RgbSpace>::WhitePoint>,

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

Converts to this type from the input type.

impl<S, T, _S> From<Rgb<_S, T>> for Hwb<S, T>

where T: Component + Float, S: RgbSpace, _S: RgbStandard<Space = S>,

fn from(color: Rgb<_S, T>) -> Hwb<S, T>

Converts to this type from the input type.

impl<S, T> From<Xyz<<S as RgbSpace>::WhitePoint, T>> for Hwb<S, T>

where T: Component + Float, S: RgbSpace,

fn from(color: Xyz<<S as RgbSpace>::WhitePoint, T>) -> Hwb<S, T>

Converts to this type from the input type.

impl<S, T> From<Yxy<<S as RgbSpace>::WhitePoint, T>> for Hwb<S, T>

where T: Component + Float, S: RgbSpace,

fn from(color: Yxy<<S as RgbSpace>::WhitePoint, T>) -> Hwb<S, T>

Converts to this type from the input type.

impl<S, T> FromColor<<S as RgbSpace>::WhitePoint, T> for Hwb<S, T>

where T: Component + Float, S: RgbSpace,

fn from_xyz(color: Xyz<<S as RgbSpace>::WhitePoint, T>) -> Hwb<S, T>

Convert from XYZ color space

fn from_hsv<_S>(color: Hsv<_S, T>) -> Hwb<S, T>

where _S: RgbSpace<WhitePoint = <S as RgbSpace>::WhitePoint>,

Convert from HSV color space

fn from_hwb<_S>(color: Hwb<_S, T>) -> Hwb<S, T>

where _S: RgbSpace<WhitePoint = <S as RgbSpace>::WhitePoint>,

Convert from HWB color space

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

Convert from Yxy color space

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

Convert from L*a*b* color space

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

Convert from L*C*h° color space

fn from_rgb<S>(inp: Rgb<Linear<S>, T>) -> Self

where S: RgbSpace<WhitePoint = Wp>,

Convert from RGB color space

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

where S: RgbSpace<WhitePoint = Wp>,

Convert from HSL color space

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

Convert from Luma

impl<S, T> GetHue for Hwb<S, T>

where T: Component + Float, S: RgbSpace,

type Hue = RgbHue<T>

The kind of hue unit this color space uses.

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

Calculate a hue if possible.

impl<S, T> Hue for Hwb<S, T>

where T: Component + Float, S: RgbSpace,

fn with_hue<H>(&self, hue: H) -> Hwb<S, T>

where H: Into<<Hwb<S, T> as GetHue>::Hue>,

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

fn shift_hue<H>(&self, amount: H) -> Hwb<S, T>

where H: Into<<Hwb<S, T> as GetHue>::Hue>,

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

impl<S, T> Into<(RgbHue<T>, T, T)> for Hwb<S, T>

where S: RgbSpace, T: Component + Float,

fn into(self) -> (RgbHue<T>, T, T)

Converts this type into the (usually inferred) input type.

impl<S, Wp, T> IntoColor<Wp, T> for Hwb<S, T>

where T: Component + Float, Wp: WhitePoint, S: RgbSpace<WhitePoint = Wp>,

fn into_xyz(self) -> Xyz<Wp, T>

Convert into XYZ space

fn into_yxy(self) -> Yxy<Wp, T>

Convert into Yxy color space

fn into_lab(self) -> Lab<Wp, T>

Convert into L*a*b* color space

fn into_lch(self) -> Lch<Wp, T>

Convert into L*C*h° color space

fn into_rgb<Sp>(self) -> Rgb<Linear<Sp>, T>

where Sp: RgbSpace<WhitePoint = Wp>,

Convert into RGB color space.

fn into_hsl<Sp>(self) -> Hsl<Sp, T>

where Sp: RgbSpace<WhitePoint = Wp>,

Convert into HSL color space

fn into_hsv<Sp>(self) -> Hsv<Sp, T>

where Sp: RgbSpace<WhitePoint = Wp>,

Convert into HSV color space

fn into_luma(self) -> Luma<Linear<Wp>, T>

Convert into Luma

fn into_hwb<S>(self) -> Hwb<S, T>

where S: RgbSpace<WhitePoint = Wp>,

Convert into HWB color space

impl<S, T> Limited for Hwb<S, T>

where T: Component + Float, S: RgbSpace,

fn is_valid(&self) -> bool

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

fn clamp(&self) -> Hwb<S, 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<S, T> Mix for Hwb<S, T>

where T: Component + Float, S: RgbSpace,

type Scalar = T

The type of the mixing factor.

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

Mix the color with an other color, by factor.

impl<S, T> PartialEq for Hwb<S, T>

where S: PartialEq + RgbSpace, T: PartialEq + Component + Float,

fn eq(&self, other: &Hwb<S, 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<S, T> Pixel<T> for Hwb<S, T>

where T: Component + Float, S: RgbSpace,

const CHANNELS: usize = 3usize

The number of color channels.

fn as_raw<P>(&self) -> &P

where P: RawPixel<T> + ?Sized,

Cast as a reference to raw color components.

fn as_raw_mut<P>(&mut self) -> &mut P

where P: RawPixel<T> + ?Sized,

Cast as a mutable reference to raw color components.

fn into_raw<P>(self) -> P

where P: RawPixelSized<T>,

Convert from raw color components.

fn from_raw<P>(pixel: &P) -> &Self

where P: RawPixel<T> + ?Sized,

Cast from a reference to raw color components.

fn from_raw_mut<P>(pixel: &mut P) -> &mut Self

where P: RawPixel<T> + ?Sized,

Cast from a mutable reference to raw color components.

fn from_raw_slice(slice: &[T]) -> &[Self]

Cast a slice of raw color components to a slice of colors.

fn from_raw_slice_mut(slice: &mut [T]) -> &mut [Self]

Cast a mutable slice of raw color components to a mutable slice of colors.

fn into_raw_slice(slice: &[Self]) -> &[T]

Cast a slice of colors to a slice of raw color components.

fn into_raw_slice_mut(slice: &mut [Self]) -> &mut [T]

Cast a mutable slice of colors to a mutable slice of raw color components.

impl<S, T> RelativeEq for Hwb<S, T>

where T: Component + Float + RelativeEq, <T as AbsDiffEq>::Epsilon: Copy + Float, S: RgbSpace + PartialEq,

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

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

fn relative_eq( &self, other: &Hwb<S, T>, epsilon: <Hwb<S, T> as AbsDiffEq>::Epsilon, max_relative: <Hwb<S, 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: &Rhs, epsilon: Self::Epsilon, max_relative: Self::Epsilon, ) -> bool

The inverse of ApproxEq::relative_eq.

impl<S, T> Shade for Hwb<S, T>

where T: Component + Float, S: RgbSpace,

type Scalar = T

The type of the lighten/darken amount.

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

Lighten the color by amount.

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

Darken the color by amount.

impl<S, T> Sub<T> for Hwb<S, T>

where T: Component + Float, S: RgbSpace,

type Output = Hwb<S, T>

The resulting type after applying the - operator.

fn sub(self, c: T) -> <Hwb<S, T> as Sub<T>>::Output

Performs the - operation.

impl<S, T> Sub for Hwb<S, T>

where T: Component + Float, S: RgbSpace,

type Output = Hwb<S, T>

The resulting type after applying the - operator.

fn sub(self, other: Hwb<S, T>) -> <Hwb<S, T> as Sub>::Output

Performs the - operation.

impl<S, T> SubAssign<T> for Hwb<S, T>

where T: Component + Float + SubAssign, S: RgbSpace,

fn sub_assign(&mut self, c: T)

Performs the -= operation.

impl<S, T> SubAssign for Hwb<S, T>

where T: Component + Float + SubAssign, S: RgbSpace,

fn sub_assign(&mut self, other: Hwb<S, T>)

Performs the -= operation.

impl<S, T> UlpsEq for Hwb<S, T>

where T: Component + Float + UlpsEq, <T as AbsDiffEq>::Epsilon: Copy + Float, S: RgbSpace + PartialEq,

fn default_max_ulps() -> u32

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

fn ulps_eq( &self, other: &Hwb<S, T>, epsilon: <Hwb<S, 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: &Rhs, epsilon: Self::Epsilon, max_ulps: u32) -> bool

The inverse of ApproxEq::ulps_eq.

impl<S, T> Copy for Hwb<S, T>

where T: Component + Float, S: RgbSpace,

impl<S, T> StructuralPartialEq for Hwb<S, T>

where T: Component + Float, S: RgbSpace,