Struct nannou::color::LabHue

#[repr(C)]
pub struct LabHue<T = f32>(/* private fields */)
where
    T: Float;

A hue type for the CIE L*a*b* family of color spaces.

It’s measured in degrees and it’s based on the four physiological elementary colors red, yellow, green and blue. This makes it different from the hue of RGB based 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> LabHue<T>

where T: Float,

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

Create a new hue from degrees.

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

Create a new hue from radians, instead of degrees.

pub fn to_degrees(self) -> T

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

pub fn to_radians(self) -> T

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

pub fn to_positive_degrees(self) -> T

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

pub fn to_positive_radians(self) -> T

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

pub fn to_raw_degrees(self) -> T

Get the internal representation, without normalizing it.

pub fn to_raw_radians(self) -> T

Get the internal representation as radians, without normalizing it.

Trait Implementations

impl<T> AbsDiffEq for LabHue<T>

where T: Float + AbsDiffEq, <T as AbsDiffEq>::Epsilon: Float,

type Epsilon = <T as AbsDiffEq>::Epsilon

Used for specifying relative comparisons.

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

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

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

The inverse of ApproxEq::abs_diff_eq.

impl<T> Add<T> for LabHue<T>

where T: Float,

type Output = LabHue<T>

The resulting type after applying the + operator.

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

Performs the + operation.

impl<T> Add for LabHue<T>

where T: Float,

type Output = LabHue<T>

The resulting type after applying the + operator.

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

Performs the + operation.

impl<T> AddAssign<T> for LabHue<T>

where T: Float + AddAssign,

fn add_assign(&mut self, other: T)

Performs the += operation.

impl<T> AddAssign for LabHue<T>

where T: Float + AddAssign,

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

Performs the += operation.

impl<T> Clone for LabHue<T>

where T: Clone + Float,

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

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<T> Debug for LabHue<T>

where T: Debug + Float,

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

Formats the value using the given formatter.

impl<T> Default for LabHue<T>

where T: Default + Float,

fn default() -> LabHue<T>

Returns the “default value” for a type.

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

where T: Float + Deserialize<'de>,

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl<T> From<T> for LabHue<T>

where T: Float,

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

Converts to this type from the input type.

impl Into<f32> for LabHue

fn into(self) -> f32

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

impl Into<f32> for LabHue<f64>

fn into(self) -> f32

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

impl Into<f64> for LabHue<f64>

fn into(self) -> f64

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

impl<T> PartialEq<T> for LabHue<T>

where T: Float,

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

where T: Float,

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

where T: Float + RelativeEq, <T as AbsDiffEq>::Epsilon: Float,

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

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

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

The inverse of ApproxEq::relative_eq.

impl<T> Serialize for LabHue<T>

where T: Float + 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 LabHue<T>

where T: Float,

type Output = LabHue<T>

The resulting type after applying the - operator.

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

Performs the - operation.

impl<T> Sub for LabHue<T>

where T: Float,

type Output = LabHue<T>

The resulting type after applying the - operator.

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

Performs the - operation.

impl<T> SubAssign<T> for LabHue<T>

where T: Float + SubAssign,

fn sub_assign(&mut self, other: T)

Performs the -= operation.

impl<T> SubAssign for LabHue<T>

where T: Float + SubAssign,

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

Performs the -= operation.

impl<T> UlpsEq for LabHue<T>

where T: Float + UlpsEq, <T as AbsDiffEq>::Epsilon: Float,

fn default_max_ulps() -> u32

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

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

The inverse of ApproxEq::ulps_eq.

impl<T> Copy for LabHue<T>

where T: Copy + Float,