Struct nannou::color::LabHue

#[repr(C)]
pub struct LabHue<T = f32>(_)
 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.

Methods

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<LabHue<T>> for LabHue<T> where
    T: AbsDiffEq<T> + Float,
    <T as AbsDiffEq<T>>::Epsilon: Float, 

type Epsilon = <T as AbsDiffEq<T>>::Epsilon

Used for specifying relative comparisons.

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

The inverse of ApproxEq::abs_diff_eq.

impl<T> Add<LabHue<T>> 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> 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> AddAssign<LabHue<T>> for LabHue<T> where
    T: AddAssign<T> + Float, 

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

Performs the += operation.

impl<T> AddAssign<T> for LabHue<T> where
    T: AddAssign<T> + Float, 

fn add_assign(&mut self, other: 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> Copy for LabHue<T> where
    T: Copy + Float, 

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<T> From<T> for LabHue<T> where
    T: Float, 

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

Performs the conversion.

impl Into<f32> for LabHue<f32>

fn into(self) -> f32

Performs the conversion.

impl Into<f32> for LabHue<f64>

fn into(self) -> f32

Performs the conversion.

impl Into<f64> for LabHue<f64>

fn into(self) -> f64

Performs the conversion.

impl<T> PartialEq<LabHue<T>> 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 ==.

#[must_use] fn ne(&self, other: &Rhs) -> bool

This method tests for !=.

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 ==.

#[must_use] fn ne(&self, other: &Rhs) -> bool

This method tests for !=.

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

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

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

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

The inverse of ApproxEq::relative_eq.

impl<T> Sub<LabHue<T>> 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> 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> SubAssign<LabHue<T>> for LabHue<T> where
    T: SubAssign<T> + Float, 

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

Performs the -= operation.

impl<T> SubAssign<T> for LabHue<T> where
    T: SubAssign<T> + Float, 

fn sub_assign(&mut self, other: T)

Performs the -= operation.

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

The inverse of ApproxEq::ulps_eq.