Struct Cam16Qsh

#[repr(C)]
pub struct Cam16Qsh<T> {
    pub brightness: T,
    pub saturation: T,
    pub hue: Cam16Hue<T>,
}

Partial CIE CAM16, with brightness and saturation.

It contains enough information for converting CAM16 to other color spaces. See Cam16 for more details about CIE CAM16.

The full list of partial CAM16 variants is:

• Cam16Jch: lightness and chroma.
• Cam16Jmh: lightness and colorfulness.
• Cam16Jsh: lightness and saturation.
• Cam16Qch: brightness and chroma.
• Cam16Qmh: brightness and colorfulness.
• Cam16Qsh: brightness and saturation.

Creating a Value

Any partial CAM16 set can be obtained from the full set of attributes. It’s also possible to convert directly to it, using from_xyz, or to create a new value by calling new.

use palette::{
    Srgb, FromColor, IntoColor, hues::Cam16Hue,
    cam16::{Cam16, Parameters, Cam16Qsh},
};

let partial = Cam16Qsh::new(50.0f32, 80.0, 120.0);

// There's also `new_const`:
const PARTIAL: Cam16Qsh<f32> = Cam16Qsh::new_const(50.0, 80.0, Cam16Hue::new(120.0));

// Customize these according to the viewing conditions:
let mut example_parameters = Parameters::default_static_wp(40.0);

// Partial CAM16 from sRGB, or most other color spaces:
let rgb = Srgb::new(0.3f32, 0.8, 0.1);
let partial_from_rgb = Cam16Qsh::from_xyz(rgb.into_color(), example_parameters);

// Partial CAM16 from sRGB, via full CAM16:
let rgb = Srgb::new(0.3f32, 0.8, 0.1);
let cam16_from_rgb = Cam16::from_xyz(rgb.into_color(), example_parameters);
let partial_from_full = Cam16Qsh::from(cam16_from_rgb);

// Direct conversion has the same result as going via full CAM16.
assert_eq!(partial_from_rgb, partial_from_full);

// It's also possible to convert from (and to) arrays and tuples:
let partial_from_array = Cam16Qsh::from([50.0f32, 80.0, 120.0]);
let partial_from_tuple = Cam16Qsh::from((50.0f32, 80.0, 120.0));

Fields

brightness: T

The brightness (Q) of the color.

See Cam16::brightness.

saturation: T

The saturation (s) of the color.

See ’Cam16::saturation.

hue: Cam16Hue<T>

The hue (h) of the color.

See Cam16::hue.

Implementations

impl<T> Cam16Qsh<T>

pub fn new<H>(brightness: T, saturation: T, hue: H) -> Self

where H: Into<Cam16Hue<T>>,

Create a partial CIE CAM16 color.

pub const fn new_const(brightness: T, saturation: T, hue: Cam16Hue<T>) -> Self

Create a partial CIE CAM16 color. This is the same as Cam16Qsh::new without the generic hue type. It’s temporary until const fn supports traits.

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

Convert to a (brightness, saturation, hue) tuple.

pub fn from_components<H>((brightness, saturation, hue): (T, T, H)) -> Self

where H: Into<Cam16Hue<T>>,

Convert from a (brightness, saturation, hue) tuple.

pub fn from_xyz<WpParam>( color: Xyz<WpParam::StaticWp, T>, parameters: impl Into<BakedParameters<WpParam, T::Scalar>>, ) -> Self

where Xyz<WpParam::StaticWp, T>: IntoCam16Unclamped<WpParam, Self, Scalar = T::Scalar>, T: FromScalar, WpParam: WhitePointParameter<T::Scalar>,

Derive partial CIE CAM16 attributes for the provided color, under the provided viewing conditions.

use palette::{Srgb, IntoColor, cam16::{Cam16Qsh, Parameters}};

// Customize these according to the viewing conditions:
let mut example_parameters = Parameters::default_static_wp(40.0);

let rgb = Srgb::new(0.3f32, 0.8, 0.1);
let partial = Cam16Qsh::from_xyz(rgb.into_color(), example_parameters);

It’s also possible to “pre-bake” the parameters, to avoid recalculate some of the derived values when converting multiple color value.

use palette::{Srgb, IntoColor, cam16::{Cam16Qsh, Parameters}};

// Customize these according to the viewing conditions:
let mut example_parameters = Parameters::default_static_wp(40.0);

let baked_parameters = example_parameters.bake();

let rgb = Srgb::new(0.3f32, 0.8, 0.1);
let partial = Cam16Qsh::from_xyz(rgb.into_color(), baked_parameters);

pub fn into_xyz<WpParam>( self, parameters: impl Into<BakedParameters<WpParam, T::Scalar>>, ) -> Xyz<WpParam::StaticWp, T>

where Self: Cam16IntoUnclamped<WpParam, Xyz<WpParam::StaticWp, T>, Scalar = T::Scalar>, WpParam: WhitePointParameter<T>, T: FromScalar,

Construct an XYZ color from these CIE CAM16 attributes, under the provided viewing conditions.

use palette::{Srgb, FromColor, cam16::{Cam16Qsh, Parameters}};

// Customize these according to the viewing conditions:
let mut example_parameters = Parameters::default_static_wp(40.0);

let partial = Cam16Qsh::new(50.0f32, 80.0, 120.0);
let rgb = Srgb::from_color(partial.into_xyz(example_parameters));

It’s also possible to “pre-bake” the parameters, to avoid recalculate some of the derived values when converting multiple color value.

use palette::{Srgb, FromColor, cam16::{Cam16Qsh, Parameters}};

// Customize these according to the viewing conditions:
let mut example_parameters = Parameters::default_static_wp(40.0);

let baked_parameters = example_parameters.bake();

let partial = Cam16Qsh::new(50.0f32, 80.0, 120.0);
let rgb = Srgb::from_color(partial.into_xyz(baked_parameters));

pub fn from_full(full: Cam16<T>) -> Self

Create a partial set of CIE CAM16 attributes.

It’s also possible to use Cam16Qsh::from or Cam16::into.

pub fn into_full<WpParam>( self, parameters: impl Into<BakedParameters<WpParam, T::Scalar>>, ) -> Cam16<T>

where Self: IntoCam16Unclamped<WpParam, Cam16<T>, Scalar = T::Scalar>, T: FromScalar,

Reconstruct a full set of CIE CAM16 attributes, using the original viewing conditions.

use palette::{Srgb, IntoColor, cam16::{Cam16, Cam16Qsh, Parameters}};
use approx::assert_relative_eq;

// Customize these according to the viewing conditions:
let mut example_parameters = Parameters::default_static_wp(40.0);

// Optional, but saves some work:
let baked_parameters = example_parameters.bake();

let rgb = Srgb::new(0.3f64, 0.8, 0.1);
let cam16 = Cam16::from_xyz(rgb.into_color(), baked_parameters);
let partial = Cam16Qsh::from(cam16);
let reconstructed = partial.into_full(baked_parameters);

assert_relative_eq!(cam16, reconstructed, epsilon = 0.0000000000001);

impl<T> Cam16Qsh<&T>

pub fn copied(&self) -> Cam16Qsh<T>

where T: Copy,

Get an owned, copied version of this color.

pub fn cloned(&self) -> Cam16Qsh<T>

where T: Clone,

Get an owned, cloned version of this color.

impl<T> Cam16Qsh<&mut T>

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

Update this color with new values.

pub fn as_refs(&self) -> Cam16Qsh<&T>

Borrow this color’s components as shared references.

pub fn copied(&self) -> Cam16Qsh<T>

where T: Copy,

Get an owned, copied version of this color.

pub fn cloned(&self) -> Cam16Qsh<T>

where T: Clone,

Get an owned, cloned version of this color.

impl<C> Cam16Qsh<C>

pub fn iter<'a>(&'a self) -> <&'a Self as IntoIterator>::IntoIter

where &'a Self: IntoIterator,

Return an iterator over the colors in the wrapped collections.

pub fn iter_mut<'a>(&'a mut self) -> <&'a mut Self as IntoIterator>::IntoIter

where &'a mut Self: IntoIterator,

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

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

pub fn with_capacity(capacity: usize) -> Self

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

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

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

pub fn pop(&mut self) -> Option<Cam16Qsh<T>>

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

pub fn clear(&mut self)

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

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

where R: RangeBounds<usize> + Clone,

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

Trait Implementations

impl<T> AbsDiffEq for Cam16Qsh<T>

where T: AbsDiffEq, T::Epsilon: Clone, Cam16Hue<T>: AbsDiffEq<Epsilon = T::Epsilon>,

type Epsilon = <T as AbsDiffEq>::Epsilon

Used for specifying relative comparisons.

fn default_epsilon() -> Self::Epsilon

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

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

The inverse of AbsDiffEq::abs_diff_eq.

impl<T> Add<T> for Cam16Qsh<T>

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

type Output = Cam16Qsh<T>

The resulting type after applying the + operator.

fn add(self, c: T) -> Self::Output

Performs the + operation.

impl<T> Add for Cam16Qsh<T>

where T: Add<Output = T>,

type Output = Cam16Qsh<T>

The resulting type after applying the + operator.

fn add(self, other: Self) -> Self::Output

Performs the + operation.

impl<T> AddAssign<T> for Cam16Qsh<T>

where T: AddAssign + Clone,

fn add_assign(&mut self, c: T)

Performs the += operation.

impl<T> AddAssign for Cam16Qsh<T>

where T: AddAssign,

fn add_assign(&mut self, other: Self)

Performs the += operation.

impl<T> ArrayCast for Cam16Qsh<T>

type Array = [T; 3]

The output type of a cast to an array.

impl<T> AsMut<[T]> for Cam16Qsh<T>

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

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

impl<T> AsMut<[T; 3]> for Cam16Qsh<T>

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

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

impl<T> AsMut<Cam16Qsh<T>> for [T; 3]

fn as_mut(&mut self) -> &mut Cam16Qsh<T>

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

impl<T> AsRef<[T]> for Cam16Qsh<T>

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

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

impl<T> AsRef<[T; 3]> for Cam16Qsh<T>

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

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

impl<T> AsRef<Cam16Qsh<T>> for [T; 3]

fn as_ref(&self) -> &Cam16Qsh<T>

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

impl<WpParam, T> Cam16FromUnclamped<WpParam, Cam16Qsh<T>> for Cam16<T>

where WpParam: WhitePointParameter<T>, T: Real + FromScalar + Zero + Arithmetics + Sqrt + PartialCmp + Clone, T::Mask: LazySelect<T> + Clone, T::Scalar: Clone,

type Scalar = <T as FromScalar>::Scalar

The number type that’s used in parameters when converting.

fn cam16_from_unclamped( cam16: Cam16Qsh<T>, parameters: BakedParameters<WpParam, Self::Scalar>, ) -> Self

Converts color into Self, using the provided parameters.

impl<WpParam, T> Cam16FromUnclamped<WpParam, Xyz<<WpParam as WhitePointParameter<T>>::StaticWp, T>> for Cam16Qsh<T>

where Xyz<WpParam::StaticWp, T>: IntoCam16Unclamped<WpParam, Cam16<T>>, WpParam: WhitePointParameter<T>,

type Scalar = <Xyz<<WpParam as WhitePointParameter<T>>::StaticWp, T> as IntoCam16Unclamped<WpParam, Cam16<T>>>::Scalar

The number type that’s used in parameters when converting.

fn cam16_from_unclamped( color: Xyz<WpParam::StaticWp, T>, parameters: BakedParameters<WpParam, Self::Scalar>, ) -> Self

Converts color into Self, using the provided parameters.

impl<T> Clamp for Cam16Qsh<T>

where T: Clamp + Zero,

fn clamp(self) -> Self

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

impl<T> ClampAssign for Cam16Qsh<T>

where T: ClampAssign + Zero,

fn clamp_assign(&mut self)

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

impl<T: Clone> Clone for Cam16Qsh<T>

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

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<T: Debug> Debug for Cam16Qsh<T>

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

Formats the value using the given formatter.

impl<T: Default> Default for Cam16Qsh<T>

fn default() -> Cam16Qsh<T>

Returns the “default value” for a type.

impl<T, C> Extend<Cam16Qsh<T>> for Cam16Qsh<C>

where C: Extend<T>,

fn extend<I: IntoIterator<Item = Cam16Qsh<T>>>(&mut self, iter: I)

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

fn from(array: &'a [T; 3]) -> Self

Converts to this type from the input type.

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

fn from(color: &'a Cam16Qsh<T>) -> Self

Converts to this type from the input type.

impl<'a, T> From<&'a Cam16Qsh<T>> for &'a [T; 3]

fn from(color: &'a Cam16Qsh<T>) -> Self

Converts to this type from the input type.

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

fn from(array: &'a mut [T; 3]) -> Self

Converts to this type from the input type.

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

fn from(color: &'a mut Cam16Qsh<T>) -> Self

Converts to this type from the input type.

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

fn from(color: &'a mut Cam16Qsh<T>) -> Self

Converts to this type from the input type.

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

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

fn from(colors: [Cam16Qsh<T>; N]) -> Self

Converts to this type from the input type.

impl<T> From<[T; 3]> for Cam16Qsh<T>

fn from(array: [T; 3]) -> Self

Converts to this type from the input type.

impl<T, H: Into<Cam16Hue<T>>> From<(T, T, H)> for Cam16Qsh<T>

fn from(components: (T, T, H)) -> Self

Converts to this type from the input type.

impl<T> From<Box<[T; 3]>> for Box<Cam16Qsh<T>>

fn from(array: Box<[T; 3]>) -> Self

Converts to this type from the input type.

impl<T> From<Cam16<T>> for Cam16Qsh<T>

fn from(value: Cam16<T>) -> Self

Converts to this type from the input type.

impl<T> From<Cam16Qsh<T>> for [T; 3]

fn from(color: Cam16Qsh<T>) -> Self

Converts to this type from the input type.

impl<T> From<Cam16Qsh<T>> for (T, T, Cam16Hue<T>)

fn from(color: Cam16Qsh<T>) -> (T, T, Cam16Hue<T>)

Converts to this type from the input type.

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

where Self: Default, V: IntoScalarArray<N, Scalar = T>,

fn from(color: Cam16Qsh<V>) -> Self

Converts to this type from the input type.

impl<WpParam, T> FromCam16Unclamped<WpParam, Cam16Qsh<T>> for Cam16<T>

where Self: Cam16FromUnclamped<WpParam, Cam16Qsh<T>>,

type Scalar = <Cam16<T> as Cam16FromUnclamped<WpParam, Cam16Qsh<T>>>::Scalar

The number type that’s used in parameters when converting.

fn from_cam16_unclamped( cam16: Cam16Qsh<T>, parameters: BakedParameters<WpParam, Self::Scalar>, ) -> Self

Converts cam16 into Self, using the provided parameters.

impl<WpParam, T> FromCam16Unclamped<WpParam, Cam16Qsh<T>> for Xyz<WpParam::StaticWp, T>

where WpParam: WhitePointParameter<T>, T: Real + FromScalar + One + Zero + Sqrt + Powf + Abs + Signum + Arithmetics + Trigonometry + RealAngle + SignedAngle + PartialCmp + Clone, T::Mask: LazySelect<T> + Clone, T::Scalar: Clone,

type Scalar = <T as FromScalar>::Scalar

The number type that’s used in parameters when converting.

fn from_cam16_unclamped( cam16: Cam16Qsh<T>, parameters: BakedParameters<WpParam, Self::Scalar>, ) -> Self

Converts cam16 into Self, using the provided parameters.

impl<T, _C, _A> FromColorUnclamped<Alpha<_C, _A>> for Cam16Qsh<T>

where _C: IntoColorUnclamped<Self>,

fn from_color_unclamped(color: Alpha<_C, _A>) -> Self

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

impl<T> FromColorUnclamped<Cam16<T>> for Cam16Qsh<T>

fn from_color_unclamped(val: Cam16<T>) -> Self

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

impl<T> FromColorUnclamped<Cam16Qsh<T>> for Cam16Qsh<T>

fn from_color_unclamped(val: Self) -> Self

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

impl<T, C> FromIterator<Cam16Qsh<T>> for Cam16Qsh<C>

where Self: Extend<Cam16Qsh<T>>, C: Default,

fn from_iter<I: IntoIterator<Item = Cam16Qsh<T>>>(iter: I) -> Self

Creates a value from an iterator.

impl<T> GetHue for Cam16Qsh<T>

where T: Clone,

type Hue = Cam16Hue<T>

The kind of hue unit this color space uses.

fn get_hue(&self) -> Cam16Hue<T>

Calculate a hue if possible.

impl<T> HasBoolMask for Cam16Qsh<T>

where T: HasBoolMask,

type Mask = <T as HasBoolMask>::Mask

The mask type to use for selecting Self values.

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

type Item = Cam16Qsh<&'a T>

The type of the elements being iterated over.

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

Which kind of iterator are we turning this into?

fn into_iter(self) -> Self::IntoIter

Creates an iterator from a value.

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

type Item = Cam16Qsh<&'a T>

The type of the elements being iterated over.

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

Which kind of iterator are we turning this into?

fn into_iter(self) -> Self::IntoIter

Creates an iterator from a value.

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

type Item = Cam16Qsh<&'a T>

The type of the elements being iterated over.

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

Which kind of iterator are we turning this into?

fn into_iter(self) -> Self::IntoIter

Creates an iterator from a value.

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

type Item = Cam16Qsh<&'a T>

The type of the elements being iterated over.

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

Which kind of iterator are we turning this into?

fn into_iter(self) -> Self::IntoIter

Creates an iterator from a value.

impl<'a, T> IntoIterator for &'a Cam16Qsh<Vec<T>>

type Item = Cam16Qsh<&'a T>

The type of the elements being iterated over.

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

Which kind of iterator are we turning this into?

fn into_iter(self) -> Self::IntoIter

Creates an iterator from a value.

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

type Item = Cam16Qsh<&'a mut T>

The type of the elements being iterated over.

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

Which kind of iterator are we turning this into?

fn into_iter(self) -> Self::IntoIter

Creates an iterator from a value.

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

type Item = Cam16Qsh<&'a mut T>

The type of the elements being iterated over.

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

Which kind of iterator are we turning this into?

fn into_iter(self) -> Self::IntoIter

Creates an iterator from a value.

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

type Item = Cam16Qsh<&'a mut T>

The type of the elements being iterated over.

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

Which kind of iterator are we turning this into?

fn into_iter(self) -> Self::IntoIter

Creates an iterator from a value.

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

type Item = Cam16Qsh<&'a mut T>

The type of the elements being iterated over.

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

Which kind of iterator are we turning this into?

fn into_iter(self) -> Self::IntoIter

Creates an iterator from a value.

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

type Item = Cam16Qsh<&'a T>

The type of the elements being iterated over.

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

Which kind of iterator are we turning this into?

fn into_iter(self) -> Self::IntoIter

Creates an iterator from a value.

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

type Item = Cam16Qsh<&'a mut T>

The type of the elements being iterated over.

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

Which kind of iterator are we turning this into?

fn into_iter(self) -> Self::IntoIter

Creates an iterator from a value.

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

type Item = Cam16Qsh<T>

The type of the elements being iterated over.

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

Which kind of iterator are we turning this into?

fn into_iter(self) -> Self::IntoIter

Creates an iterator from a value.

impl<T> IntoIterator for Cam16Qsh<Vec<T>>

type Item = Cam16Qsh<T>

The type of the elements being iterated over.

type IntoIter = Iter<IntoIter<T>>

Which kind of iterator are we turning this into?

fn into_iter(self) -> Self::IntoIter

Creates an iterator from a value.

impl<T> IsWithinBounds for Cam16Qsh<T>

where T: PartialCmp + Zero, T::Mask: BitAnd<Output = T::Mask>,

fn is_within_bounds(&self) -> T::Mask

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

impl<T> Mix for Cam16Qsh<T>

where T: RealAngle + SignedAngle + Zero + One + Clamp + Arithmetics + Clone,

type Scalar = T

The type of the mixing factor.

fn mix(self, other: Self, factor: T) -> Self

Mix the color with an other color, by factor.

impl<T> MixAssign for Cam16Qsh<T>

where T: RealAngle + SignedAngle + Zero + One + Clamp + AddAssign + Arithmetics + Clone,

type Scalar = T

The type of the mixing factor.

fn mix_assign(&mut self, other: Self, factor: T)

Mix the color with an other color, by factor.

impl<T> PartialEq for Cam16Qsh<T>

where T: PartialEq, Cam16Hue<T>: PartialEq,

fn eq(&self, other: &Self) -> 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<T> RelativeEq for Cam16Qsh<T>

where T: RelativeEq, T::Epsilon: Clone, Cam16Hue<T>: RelativeEq + AbsDiffEq<Epsilon = T::Epsilon>,

fn default_max_relative() -> T::Epsilon

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

fn relative_eq( &self, other: &Self, epsilon: T::Epsilon, max_relative: T::Epsilon, ) -> bool

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

fn relative_ne( &self, other: &Self, epsilon: T::Epsilon, max_relative: T::Epsilon, ) -> bool

The inverse of RelativeEq::relative_eq.

impl<T> SaturatingAdd<T> for Cam16Qsh<T>

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

type Output = Cam16Qsh<T>

The resulting type.

fn saturating_add(self, c: T) -> Self::Output

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

impl<T> SaturatingAdd for Cam16Qsh<T>

where T: SaturatingAdd<Output = T>,

type Output = Cam16Qsh<T>

The resulting type.

fn saturating_add(self, other: Self) -> Self::Output

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

impl<T> SaturatingSub<T> for Cam16Qsh<T>

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

type Output = Cam16Qsh<T>

The resulting type.

fn saturating_sub(self, c: T) -> Self::Output

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

impl<T> SaturatingSub for Cam16Qsh<T>

where T: SaturatingSub<Output = T>,

type Output = Cam16Qsh<T>

The resulting type.

fn saturating_sub(self, other: Self) -> Self::Output

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

impl<T, H> SetHue<H> for Cam16Qsh<T>

where H: Into<Cam16Hue<T>>,

fn set_hue(&mut self, hue: H)

Change the hue to a specific value.

impl<T> ShiftHue for Cam16Qsh<T>

where T: Add<Output = T>,

type Scalar = T

The type of the hue modifier.

fn shift_hue(self, amount: Self::Scalar) -> Self

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

impl<T> ShiftHueAssign for Cam16Qsh<T>

where T: AddAssign,

type Scalar = T

The type of the hue modifier.

fn shift_hue_assign(&mut self, amount: Self::Scalar)

Shifts the hue by amount.

impl<T> Sub<T> for Cam16Qsh<T>

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

type Output = Cam16Qsh<T>

The resulting type after applying the - operator.

fn sub(self, c: T) -> Self::Output

Performs the - operation.

impl<T> Sub for Cam16Qsh<T>

where T: Sub<Output = T>,

type Output = Cam16Qsh<T>

The resulting type after applying the - operator.

fn sub(self, other: Self) -> Self::Output

Performs the - operation.

impl<T> SubAssign<T> for Cam16Qsh<T>

where T: SubAssign + Clone,

fn sub_assign(&mut self, c: T)

Performs the -= operation.

impl<T> SubAssign for Cam16Qsh<T>

where T: SubAssign,

fn sub_assign(&mut self, other: Self)

Performs the -= operation.

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

Performs the conversion.

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

Performs the conversion.

impl<T> UlpsEq for Cam16Qsh<T>

where T: UlpsEq, T::Epsilon: Clone, Cam16Hue<T>: UlpsEq + AbsDiffEq<Epsilon = T::Epsilon>,

fn default_max_ulps() -> u32

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

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

The inverse of UlpsEq::ulps_eq.

impl<T, _A> WithAlpha<_A> for Cam16Qsh<T>

where _A: Stimulus,

type Color = Cam16Qsh<T>

The opaque color type, without any transparency.

type WithAlpha = Alpha<Cam16Qsh<T>, _A>

The color type with transparency applied.

fn with_alpha(self, alpha: _A) -> Self::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) -> Self::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) -> (Self::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<T, H> WithHue<H> for Cam16Qsh<T>

where H: Into<Cam16Hue<T>>,

fn with_hue(self, hue: H) -> Self

Return a copy of self with a specific hue.

impl<T: Copy> Copy for Cam16Qsh<T>

impl<T> Eq for Cam16Qsh<T>

where T: Eq, Cam16Hue<T>: Eq,