Struct OklabHue

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

A hue type for the Oklab color space.

It’s measured in degrees.

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> OklabHue<T>

pub const fn new(angle: T) -> OklabHue<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) -> OklabHue<U>

where U: FromAngle<T>,

Convert into another angle type.

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

where T: FromAngle<U>,

Convert from another angle type.

impl<T> OklabHue<T>

where T: RealAngle,

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

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

pub fn from_radians(radians: T) -> OklabHue<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> OklabHue<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> OklabHue<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> OklabHue<T>

where T: RealAngle + Trigonometry,

pub fn from_cartesian(a: T, b: T) -> OklabHue<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> OklabHue<&T>

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

where T: Copy,

Get an owned, copied version of this hue.

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

where T: Clone,

Get an owned, cloned version of this hue.

impl<T> OklabHue<&mut T>

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

Update this hue with a new value.

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

Borrow this hue’s value as shared references.

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

where T: Copy,

Get an owned, copied version of this hue.

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

where T: Clone,

Get an owned, cloned version of this hue.

impl<C> OklabHue<C>

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

where &'a OklabHue<C>: IntoIterator,

Return an iterator over the hues in the wrapped collection.

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

where &'a mut OklabHue<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<OklabHue<&'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<OklabHue<&'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> OklabHue<Vec<T>>

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

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

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

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

pub fn pop(&mut self) -> Option<OklabHue<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) -> OklabHueIter<Drain<'_, T>>

where R: RangeBounds<usize> + Clone,

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

Trait Implementations

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

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

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

The inverse of AbsDiffEq::abs_diff_eq.

impl<T> Add<T> for OklabHue<T>

where T: Add<Output = T>,

type Output = OklabHue<T>

The resulting type after applying the + operator.

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

Performs the + operation.

impl<T> Add for OklabHue<T>

where T: Add<Output = T>,

type Output = OklabHue<T>

The resulting type after applying the + operator.

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

Performs the + operation.

impl<T> AddAssign<T> for OklabHue<T>

where T: AddAssign,

fn add_assign(&mut self, other: T)

Performs the += operation.

impl<T> AddAssign for OklabHue<T>

where T: AddAssign,

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

Performs the += operation.

impl<T> Clone for OklabHue<T>

where T: Clone,

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

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<T> Debug for OklabHue<T>

where T: Debug,

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

Formats the value using the given formatter.

impl<T> Default for OklabHue<T>

where T: Default,

fn default() -> OklabHue<T>

Returns the “default value” for a type.

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

where T: Deserialize<'de>,

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl<C, T> Extend<T> for OklabHue<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 OklabHue<T>

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

Converts to this type from the input type.

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

type Item = OklabHue<&'a T>

The type of the elements being iterated over.

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

Which kind of iterator are we turning this into?

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

Creates an iterator from a value.

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

type Item = OklabHue<&'a T>

The type of the elements being iterated over.

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

Which kind of iterator are we turning this into?

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

Creates an iterator from a value.

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

type Item = OklabHue<&'a T>

The type of the elements being iterated over.

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

Which kind of iterator are we turning this into?

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

Creates an iterator from a value.

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

type Item = OklabHue<&'a T>

The type of the elements being iterated over.

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

Which kind of iterator are we turning this into?

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

Creates an iterator from a value.

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

type Item = OklabHue<&'a T>

The type of the elements being iterated over.

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

Which kind of iterator are we turning this into?

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

Creates an iterator from a value.

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

type Item = OklabHue<&'a mut T>

The type of the elements being iterated over.

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

Which kind of iterator are we turning this into?

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

Creates an iterator from a value.

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

type Item = OklabHue<&'a mut T>

The type of the elements being iterated over.

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

Which kind of iterator are we turning this into?

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

Creates an iterator from a value.

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

type Item = OklabHue<&'a mut T>

The type of the elements being iterated over.

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

Which kind of iterator are we turning this into?

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

Creates an iterator from a value.

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

type Item = OklabHue<&'a mut T>

The type of the elements being iterated over.

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

Which kind of iterator are we turning this into?

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

Creates an iterator from a value.

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

type Item = OklabHue<&'a T>

The type of the elements being iterated over.

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

Which kind of iterator are we turning this into?

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

Creates an iterator from a value.

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

type Item = OklabHue<&'a mut T>

The type of the elements being iterated over.

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

Which kind of iterator are we turning this into?

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

Creates an iterator from a value.

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

type Item = OklabHue<T>

The type of the elements being iterated over.

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

Which kind of iterator are we turning this into?

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

Creates an iterator from a value.

impl<T> IntoIterator for OklabHue<Vec<T>>

type Item = OklabHue<T>

The type of the elements being iterated over.

type IntoIter = OklabHueIter<IntoIter<T>>

Which kind of iterator are we turning this into?

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

Creates an iterator from a value.

impl<T> PartialEq<T> for OklabHue<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 OklabHue<T>

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

fn eq(&self, other: &OklabHue<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 OklabHue<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() -> <OklabHue<T> as AbsDiffEq>::Epsilon

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

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

The inverse of RelativeEq::relative_eq.

impl<T> SaturatingAdd<T> for OklabHue<T>

where T: SaturatingAdd<Output = T>,

type Output = OklabHue<T>

The resulting type.

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

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

impl<T> SaturatingAdd for OklabHue<T>

where T: SaturatingAdd<Output = T>,

type Output = OklabHue<T>

The resulting type.

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

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

impl<T> SaturatingSub<T> for OklabHue<T>

where T: SaturatingSub<Output = T>,

type Output = OklabHue<T>

The resulting type.

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

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

impl<T> SaturatingSub for OklabHue<T>

where T: SaturatingSub<Output = T>,

type Output = OklabHue<T>

The resulting type.

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

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

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

where T: Sub<Output = T>,

type Output = OklabHue<T>

The resulting type after applying the - operator.

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

Performs the - operation.

impl<T> Sub for OklabHue<T>

where T: Sub<Output = T>,

type Output = OklabHue<T>

The resulting type after applying the - operator.

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

Performs the - operation.

impl<T> SubAssign<T> for OklabHue<T>

where T: SubAssign,

fn sub_assign(&mut self, other: T)

Performs the -= operation.

impl<T> SubAssign for OklabHue<T>

where T: SubAssign,

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

Performs the -= operation.

impl<T> UlpsEq for OklabHue<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: &OklabHue<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: &OklabHue<T>, epsilon: <OklabHue<T> as AbsDiffEq>::Epsilon, max_ulps: u32, ) -> bool

The inverse of UlpsEq::ulps_eq.

impl<T> Copy for OklabHue<T>

where T: Copy,

impl<T> Eq for OklabHue<T>

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