Struct LuvHue

#[repr(C)]
pub struct LuvHue<T = f32>(/* private fields */);

A hue type for the CIE L*u*v* family of color spaces.

The hue is a circular type, where 0 and 360 is the same, and it’s normalized to (-180, 180] when it’s converted to a linear number (like f32). This makes many calculations easier, but may also have some surprising effects if it’s expected to act as a linear number.

Implementations

impl<T> LuvHue<T>

pub const fn new(angle: T) -> LuvHue<T>

Create a new hue, specified in the default unit for the angle type T.

f32, f64 and other real number types represent degrees, while u8 simply represents the range [0, 360] as [0, 256].

pub fn into_inner(self) -> T

Get the internal representation without normalizing or converting it.

f32, f64 and other real number types represent degrees, while u8 simply represents the range [0, 360] as [0, 256].

pub fn into_format<U>(self) -> LuvHue<U>

where U: FromAngle<T>,

Convert into another angle type.

pub fn from_format<U>(hue: LuvHue<U>) -> LuvHue<T>

where T: FromAngle<U>,

Convert from another angle type.

impl<T> LuvHue<T>

where T: RealAngle,

pub fn from_degrees(degrees: T) -> LuvHue<T>

Create a new hue from degrees. This is an alias for new.

pub fn from_radians(radians: T) -> LuvHue<T>

Create a new hue from radians, instead of degrees.

pub fn into_raw_degrees(self) -> T

Get the internal representation as degrees, without normalizing it.

pub fn into_raw_radians(self) -> T

Get the internal representation as radians, without normalizing it.

impl<T> LuvHue<T>

where T: RealAngle + SignedAngle,

pub fn into_degrees(self) -> T

Get the hue as degrees, in the range (-180, 180].

pub fn into_radians(self) -> T

Convert the hue to radians, in the range (-π, π].

impl<T> LuvHue<T>

where T: RealAngle + UnsignedAngle,

pub fn into_positive_degrees(self) -> T

Convert the hue to positive degrees, in the range [0, 360).

pub fn into_positive_radians(self) -> T

Convert the hue to positive radians, in the range [0, 2π).

impl<T> LuvHue<T>

where T: RealAngle + Trigonometry,

pub fn from_cartesian(a: T, b: T) -> LuvHue<T>

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

Returns a hue from a and b, normalized to [0°, 360°).

If a and b are both 0, returns 0,

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

Returns a and b values for this hue, normalized to [-1, 1].

They will have to be multiplied by a radius values, such as saturation, value, chroma, etc., to represent a specific color.

impl<T> LuvHue<&T>

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

where T: Copy,

Get an owned, copied version of this hue.

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

where T: Clone,

Get an owned, cloned version of this hue.

impl<T> LuvHue<&mut T>

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

Update this hue with a new value.

pub fn as_ref(&self) -> LuvHue<&T>

Borrow this hue’s value as shared references.

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

where T: Copy,

Get an owned, copied version of this hue.

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

where T: Clone,

Get an owned, cloned version of this hue.

impl<C> LuvHue<C>

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

where &'a LuvHue<C>: IntoIterator,

Return an iterator over the hues in the wrapped collection.

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

where &'a mut LuvHue<C>: IntoIterator,

Return an iterator that allows modifying the hues in the wrapped collection.

pub fn get<'a, I, T>( &'a self, index: I, ) -> Option<LuvHue<&'a <I as SliceIndex<[T]>>::Output>>

where T: 'a, C: AsRef<[T]>, I: SliceIndex<[T]> + Clone,

Get a hue, or slice of hues, with references to the values at index. See slice::get for details.

pub fn get_mut<'a, I, T>( &'a mut self, index: I, ) -> Option<LuvHue<&'a mut <I as SliceIndex<[T]>>::Output>>

where T: 'a, C: AsMut<[T]>, I: SliceIndex<[T]> + Clone,

Get a hue, or slice of hues, that allows modifying the values at index. See slice::get_mut for details.

impl<T> LuvHue<Vec<T>>

pub fn with_capacity(capacity: usize) -> LuvHue<Vec<T>>

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

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

Push an additional hue onto the hue vector. See Vec::push for details.

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

Pop a hue from the hue vector. See Vec::pop for details.

pub fn clear(&mut self)

Clear the hue vector. See Vec::clear for details.

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

where R: RangeBounds<usize> + Clone,

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

Trait Implementations

impl<T> AbsDiffEq for LuvHue<T>

where T: Zero + AngleEq<Mask = bool> + Sub<Output = T> + RealAngle + AbsDiffEq + Clone + SignedAngle, <T as AbsDiffEq>::Epsilon: HalfRotation + Mul<Output = <T as AbsDiffEq>::Epsilon>,

type Epsilon = <T as AbsDiffEq>::Epsilon

Used for specifying relative comparisons.

fn default_epsilon() -> <LuvHue<T> as AbsDiffEq>::Epsilon

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

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

The inverse of AbsDiffEq::abs_diff_eq.

impl<T> Add<T> for LuvHue<T>

where T: Add<Output = T>,

type Output = LuvHue<T>

The resulting type after applying the + operator.

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

Performs the + operation.

impl<T> Add for LuvHue<T>

where T: Add<Output = T>,

type Output = LuvHue<T>

The resulting type after applying the + operator.

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

Performs the + operation.

impl<T> AddAssign<T> for LuvHue<T>

where T: AddAssign,

fn add_assign(&mut self, other: T)

Performs the += operation.

impl<T> AddAssign for LuvHue<T>

where T: AddAssign,

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

Performs the += operation.

impl<T> Clone for LuvHue<T>

where T: Clone,

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

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<T> Debug for LuvHue<T>

where T: Debug,

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

Formats the value using the given formatter.

impl<T> Default for LuvHue<T>

where T: Default,

fn default() -> LuvHue<T>

Returns the “default value” for a type.

impl<'de, T> Deserialize<'de> for LuvHue<T>

where T: Deserialize<'de>,

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

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

where C: Extend<T>,

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

where I: IntoIterator<Item = 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<T> From<T> for LuvHue<T>

fn from(degrees: T) -> LuvHue<T>

Converts to this type from the input type.

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

type Item = LuvHue<&'a T>

The type of the elements being iterated over.

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

Which kind of iterator are we turning this into?

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

Creates an iterator from a value.

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

type Item = LuvHue<&'a T>

The type of the elements being iterated over.

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

Which kind of iterator are we turning this into?

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

Creates an iterator from a value.

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

type Item = LuvHue<&'a T>

The type of the elements being iterated over.

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

Which kind of iterator are we turning this into?

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

Creates an iterator from a value.

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

type Item = LuvHue<&'a T>

The type of the elements being iterated over.

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

Which kind of iterator are we turning this into?

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

Creates an iterator from a value.

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

type Item = LuvHue<&'a T>

The type of the elements being iterated over.

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

Which kind of iterator are we turning this into?

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

Creates an iterator from a value.

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

type Item = LuvHue<&'a mut T>

The type of the elements being iterated over.

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

Which kind of iterator are we turning this into?

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

Creates an iterator from a value.

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

type Item = LuvHue<&'a mut T>

The type of the elements being iterated over.

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

Which kind of iterator are we turning this into?

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

Creates an iterator from a value.

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

type Item = LuvHue<&'a mut T>

The type of the elements being iterated over.

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

Which kind of iterator are we turning this into?

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

Creates an iterator from a value.

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

type Item = LuvHue<&'a mut T>

The type of the elements being iterated over.

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

Which kind of iterator are we turning this into?

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

Creates an iterator from a value.

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

type Item = LuvHue<&'a T>

The type of the elements being iterated over.

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

Which kind of iterator are we turning this into?

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

Creates an iterator from a value.

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

type Item = LuvHue<&'a mut T>

The type of the elements being iterated over.

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

Which kind of iterator are we turning this into?

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

Creates an iterator from a value.

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

type Item = LuvHue<T>

The type of the elements being iterated over.

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

Which kind of iterator are we turning this into?

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

Creates an iterator from a value.

impl<T> IntoIterator for LuvHue<Vec<T>>

type Item = LuvHue<T>

The type of the elements being iterated over.

type IntoIter = LuvHueIter<IntoIter<T>>

Which kind of iterator are we turning this into?

fn into_iter(self) -> <LuvHue<Vec<T>> as IntoIterator>::IntoIter

Creates an iterator from a value.

impl<T> PartialEq<T> for LuvHue<T>

where T: AngleEq<Mask = bool> + PartialEq,

fn eq(&self, other: &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<T> PartialEq for LuvHue<T>

where T: AngleEq<Mask = bool> + PartialEq,

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

where T: Zero + AngleEq<Mask = bool> + Sub<Output = T> + RealAngle + Clone + RelativeEq + SignedAngle, <T as AbsDiffEq>::Epsilon: HalfRotation + Mul<Output = <T as AbsDiffEq>::Epsilon>,

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

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

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

The inverse of RelativeEq::relative_eq.

impl<T> SaturatingAdd<T> for LuvHue<T>

where T: SaturatingAdd<Output = T>,

type Output = LuvHue<T>

The resulting type.

fn saturating_add(self, other: T) -> LuvHue<T>

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

impl<T> SaturatingAdd for LuvHue<T>

where T: SaturatingAdd<Output = T>,

type Output = LuvHue<T>

The resulting type.

fn saturating_add(self, other: LuvHue<T>) -> LuvHue<T>

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

impl<T> SaturatingSub<T> for LuvHue<T>

where T: SaturatingSub<Output = T>,

type Output = LuvHue<T>

The resulting type.

fn saturating_sub(self, other: T) -> LuvHue<T>

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

impl<T> SaturatingSub for LuvHue<T>

where T: SaturatingSub<Output = T>,

type Output = LuvHue<T>

The resulting type.

fn saturating_sub(self, other: LuvHue<T>) -> LuvHue<T>

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

impl<T> Serialize for LuvHue<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<T> Sub<T> for LuvHue<T>

where T: Sub<Output = T>,

type Output = LuvHue<T>

The resulting type after applying the - operator.

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

Performs the - operation.

impl<T> Sub for LuvHue<T>

where T: Sub<Output = T>,

type Output = LuvHue<T>

The resulting type after applying the - operator.

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

Performs the - operation.

impl<T> SubAssign<T> for LuvHue<T>

where T: SubAssign,

fn sub_assign(&mut self, other: T)

Performs the -= operation.

impl<T> SubAssign for LuvHue<T>

where T: SubAssign,

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

Performs the -= operation.

impl<T> UlpsEq for LuvHue<T>

where T: Zero + AngleEq<Mask = bool> + Sub<Output = T> + RealAngle + Clone + UlpsEq + SignedAngle, <T as AbsDiffEq>::Epsilon: HalfRotation + Mul<Output = <T as AbsDiffEq>::Epsilon>,

fn default_max_ulps() -> u32

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

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

The inverse of UlpsEq::ulps_eq.

impl<T> Copy for LuvHue<T>

where T: Copy,

impl<T> Eq for LuvHue<T>

where T: AngleEq<Mask = bool> + Eq,