Struct palette::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) -> Self

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>) -> Self

where T: FromAngle<U>,

Convert from another angle type.

impl<T: RealAngle> OklabHue<T>

pub fn from_degrees(degrees: T) -> Self

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

pub fn from_radians(radians: T) -> Self

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: RealAngle + SignedAngle> OklabHue<T>

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: RealAngle + UnsignedAngle> OklabHue<T>

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: RealAngle + Trigonometry> OklabHue<T>

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

where T: Add<T, 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 Self as IntoIterator>::IntoIter

where &'a Self: IntoIterator,

Return an iterator over the hues in the wrapped collection.

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 hues in the wrapped collection.

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

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: RealAngle + SignedAngle + Zero + AngleEq<Mask = bool> + Sub<Output = T> + AbsDiffEq + Clone, T::Epsilon: HalfRotation + Mul<Output = 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 Add<OklabHue<f64>> for f64

type Output = OklabHue<f64>

The resulting type after applying the + operator.

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

Performs the + operation.

impl Add<OklabHue> for f32

type Output = OklabHue

The resulting type after applying the + operator.

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

Performs the + operation.

impl<T: Add<Output = T>> Add<T> for OklabHue<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<Output = T>> Add for OklabHue<T>

type Output = OklabHue<T>

The resulting type after applying the + operator.

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

Performs the + operation.

impl AddAssign<OklabHue<f64>> for f64

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

Performs the += operation.

impl AddAssign<OklabHue> for f32

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

Performs the += operation.

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

fn add_assign(&mut self, other: T)

Performs the += operation.

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

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

Performs the += operation.

impl<T: Clone> Clone for OklabHue<T>

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

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

Formats the value using the given formatter.

impl<T: Default> Default for OklabHue<T>

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<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl<T> Distribution<OklabHue<T>> for Standard

where T: RealAngle + FullRotation + Mul<Output = T>, Standard: Distribution<T>,

fn sample<R: Rng + ?Sized>(&self, rng: &mut R) -> OklabHue<T>

Generate a random value of T, using rng as the source of randomness.

fn sample_iter<R>(self, rng: R) -> DistIter<Self, R, T>

where R: Rng, Self: Sized,

Create an iterator that generates random values of T, using rng as the source of randomness.

fn map<F, S>(self, func: F) -> DistMap<Self, F, T, S>

where F: Fn(T) -> S, Self: Sized,

Create a distribution of values of ‘S’ by mapping the output of Self through the closure F

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

where C: Extend<T>,

fn extend<I: IntoIterator<Item = 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 From<OklabHue<f64>> for f32

fn from(hue: OklabHue<f64>) -> f32

Converts to this type from the input type.

impl From<OklabHue<f64>> for f64

fn from(hue: OklabHue<f64>) -> f64

Converts to this type from the input type.

impl From<OklabHue<u8>> for u8

fn from(hue: OklabHue<u8>) -> u8

Converts to this type from the input type.

impl From<OklabHue> for f32

fn from(hue: OklabHue<f32>) -> f32

Converts to this type from the input type.

impl From<OklabHue> for f64

fn from(hue: OklabHue<f32>) -> f64

Converts to this type from the input type.

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) -> Self::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) -> Self::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) -> Self::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) -> Self::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) -> Self::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) -> Self::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) -> Self::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) -> Self::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) -> Self::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) -> Self::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) -> Self::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) -> Self::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) -> Self::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

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

fn ne(&self, other: &Rhs) -> bool

This method 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

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

fn ne(&self, other: &Rhs) -> bool

This method 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: RealAngle + SignedAngle + Zero + AngleEq<Mask = bool> + Sub<Output = T> + Clone + RelativeEq, T::Epsilon: HalfRotation + Mul<Output = T::Epsilon>,

fn default_max_relative() -> Self::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: Self::Epsilon, max_relative: Self::Epsilon ) -> bool

The inverse of [RelativeEq::relative_eq].

impl<T> SampleUniform for OklabHue<T>

where T: RealAngle + UnsignedAngle + FullRotation + Add<Output = T> + Mul<Output = T> + PartialOrd + Clone + SampleUniform,

type Sampler = UniformOklabHue<T>

The UniformSampler implementation supporting type X.

impl<T: SaturatingAdd<Output = T>> SaturatingAdd<T> for OklabHue<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<Output = T>> SaturatingAdd for OklabHue<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<Output = T>> SaturatingSub<T> for OklabHue<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<Output = T>> SaturatingSub for OklabHue<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::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Sub<OklabHue<f64>> for f64

type Output = OklabHue<f64>

The resulting type after applying the - operator.

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

Performs the - operation.

impl Sub<OklabHue> for f32

type Output = OklabHue

The resulting type after applying the - operator.

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

Performs the - operation.

impl<T: Sub<Output = T>> Sub<T> for OklabHue<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<Output = T>> Sub for OklabHue<T>

type Output = OklabHue<T>

The resulting type after applying the - operator.

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

Performs the - operation.

impl SubAssign<OklabHue<f64>> for f64

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

Performs the -= operation.

impl SubAssign<OklabHue> for f32

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

Performs the -= operation.

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

fn sub_assign(&mut self, other: T)

Performs the -= operation.

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

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

Performs the -= operation.

impl<T> UlpsEq for OklabHue<T>

where T: RealAngle + SignedAngle + Zero + AngleEq<Mask = bool> + Sub<Output = T> + Clone + UlpsEq, T::Epsilon: HalfRotation + Mul<Output = 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: Self::Epsilon, max_ulps: u32) -> bool

The inverse of [UlpsEq::ulps_eq].

impl<T: Zeroable> Zeroable for OklabHue<T>

fn zeroed() -> Self

Calls zeroed.

impl<T: Copy> Copy for OklabHue<T>

impl<T> Eq for OklabHue<T>

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

impl<T: Pod> Pod for OklabHue<T>