Struct prisma::ChromaticityCoordinates

pub struct ChromaticityCoordinates<T> {
    pub alpha: T,
    pub beta: T,
}

A pair of chromaticity coordinates $\alpha$ and $\beta$

Chromaticity coordinates are a basis set of a two-dimensional space defining the chroma and hue of the color without the luminance. These are primarily used for computing non-approximate (circular) HS* color values. Hsi is an example of a color space that uses these coordinates in its construction.

$\alpha$ is the "redness vs blue-greenness" whereas $\beta$ is "greenness vs blueness"

Hsv and similar models convert from RGB using a hexagonal transformation that is then treated as circular. This is convenient and very easy to compute, but it is slightly off of the "correct" value for hue and chroma obtained when using a circle.

From these coordinates, you can obtain the circular chroma and hue:

\begin{aligned}
H_{\textrm{circle}} &= atan2(\beta, \alpha) \\
C_{\textrm{circle}} &= \sqrt{\alpha^2 + \beta^2}
\end{aligned}

Fields

alpha: T

The alpha chromaticity coordinate

beta: T

The alpha chromaticity coordinate

Implementations

impl<T> ChromaticityCoordinates<T> where
    T: Float, 

pub fn new(alpha: T, beta: T) -> Self

Construct a new ChromaticityCoordinates instance

Trait Implementations

impl<T: Clone> Clone for ChromaticityCoordinates<T>

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

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<T: Copy> Copy for ChromaticityCoordinates<T>

impl<T: Debug> Debug for ChromaticityCoordinates<T>

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

Formats the value using the given formatter.

impl<T> Default for ChromaticityCoordinates<T> where
    T: Float, 

fn default() -> Self

Returns the "default value" for a type.

impl<T: Hash> Hash for ChromaticityCoordinates<T>

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given [Hasher].

fn hash_slice<H>(data: &[Self], state: &mut H) where
    H: Hasher, 

Feeds a slice of this type into the given [Hasher].

impl<T: PartialEq> PartialEq<ChromaticityCoordinates<T>> for ChromaticityCoordinates<T>

fn eq(&self, other: &ChromaticityCoordinates<T>) -> bool

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

fn ne(&self, other: &ChromaticityCoordinates<T>) -> bool

This method tests for !=.

impl<T: PartialOrd> PartialOrd<ChromaticityCoordinates<T>> for ChromaticityCoordinates<T>

fn partial_cmp(&self, other: &ChromaticityCoordinates<T>) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

fn lt(&self, other: &ChromaticityCoordinates<T>) -> bool

This method tests less than (for self and other) and is used by the < operator.

fn le(&self, other: &ChromaticityCoordinates<T>) -> bool

This method tests less than or equal to (for self and other) and is used by the <= operator.

fn gt(&self, other: &ChromaticityCoordinates<T>) -> bool

This method tests greater than (for self and other) and is used by the > operator.

fn ge(&self, other: &ChromaticityCoordinates<T>) -> bool

This method tests greater than or equal to (for self and other) and is used by the >= operator.

impl<T> StructuralPartialEq for ChromaticityCoordinates<T>