Struct nannou::color::LabHue

pub struct LabHue<T = f32>(_)
 where
    T: Float;

A hue type for the CIE Lab* 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_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π).

Trait Implementations

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

type Epsilon = <T as ApproxEq>::Epsilon

Used for specifying relative comparisons.

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

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

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

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

fn default_max_ulps() -> u32

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

fn relative_eq(
    &self,
    other: &LabHue<T>,
    epsilon: <LabHue<T> as ApproxEq>::Epsilon,
    max_relative: <LabHue<T> as ApproxEq>::Epsilon
) -> bool

A test for equality that uses a relative comparison if the values are far apart.

fn ulps_eq(
    &self,
    other: &LabHue<T>,
    epsilon: <LabHue<T> as ApproxEq>::Epsilon,
    max_ulps: u32
) -> bool

A test for equality that uses units in the last place (ULP) if the values are far apart.

fn relative_ne(
    &self,
    other: &LabHue<T>,
    epsilon: <LabHue<T> as ApproxEq>::Epsilon,
    max_relative: <LabHue<T> as ApproxEq>::Epsilon
) -> bool

The inverse of ApproxEq::relative_eq.

fn ulps_ne(
    &self,
    other: &LabHue<T>,
    epsilon: <LabHue<T> as ApproxEq>::Epsilon,
    max_ulps: u32
) -> bool

The inverse of ApproxEq::ulps_eq.

impl<T> From<T> for LabHue<T> where
    T: Float, 

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

Performs the conversion.

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

fn default() -> LabHue<T>

Returns the "default value" for a type.

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

impl Into<f32> for LabHue<f32>

fn into(self) -> f32

Performs the conversion.

impl Into<f64> for LabHue<f64>

fn into(self) -> f64

Performs the conversion.

impl Into<f32> for LabHue<f64>

fn into(self) -> f32

Performs the conversion.

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