Struct XyzD65 

pub struct XyzD65;

🌌 The CIE XYZ color space with a 2° observer and a reference white of D65.

Its components are [X, Y, Z]. The components are unbounded, but are usually positive. Reference white has a luminance Y of 1.

This corresponds to the color space in CSS Color Module Level 4 § 10.8. It is defined in CIE 015:2018. Following CSS Color Module Level 4 § 11, the conversion between D50 and D65 white points is done with the standard Bradford linear chromatic adaptation transform.

Human color vision and color spaces

Human color vision uses three types of photoreceptive cell in the eye that are sensitive to light. These cells have their peak sensitivity at different wavelengths of light: roughly 570 nm, 535 nm and 430 nm, usually named Long, Medium and Short (LMS) respectively. The cells’ sensitivities to light taper off as the wavelength moves away from their peaks, but all three cells overlap in wavelength sensitivity.

Visible light with a combination of wavelengths at specific intensities (the light’s spectral density), causes excitation of these three cell types in varying amounts. The human brain interprets this as a specific color at a certain luminosity. Importantly, humans do not directly perceive the light’s wavelength: for example, monochromatic light with a wavelength of 580 nm is perceived as “yellow,” and light made up of two wavelengths at roughly 550nm (“green”) and 610 nm (“red”) is also perceived as “yellow.”

The CIE XYZ color space is an experimentally-obtained mapping of monochromatic light at a specific wavelength to the response of human L, M and S photoreceptive cells (with some additional mathematically desirable properties). Light of a specific spectral density maps onto a specific coordinate in the XYZ color space. Light of a different spectral density that maps onto the same XYZ coordinate is predicted by the color space to be perceived as the same color and luminosity.

The XYZ color space is often used in the characterization of other color spaces.

White point

An important concept in color spaces is the white point. Whereas pure black is the absence of illumination and has a natural representation in additive color spaces, white is more difficult to define. CIE D65 defines white as the perceived color of diffuse standard noon daylight perfectly reflected off a surface observed under some foveal angle; here 2°.

In many color spaces, their white point is the brightest illumination they can naturally represent.

For further reading, the Wikipedia article on the CIE XYZ color space provides a good introduction to color theory as relevant to color spaces.

Trait Implementations

impl Clone for XyzD65

fn clone(&self) -> XyzD65

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl ColorSpace for XyzD65

const IS_LINEAR: bool = true

Whether the color space is linear.

const TAG: Option<ColorSpaceTag>

The tag corresponding to this color space, if a matching tag exists.

const WHITE_COMPONENTS: [f32; 3]

The component values for the color white within this color space.

fn to_linear_srgb(src: [f32; 3]) -> [f32; 3]

Convert an opaque color to linear sRGB.

fn from_linear_srgb(src: [f32; 3]) -> [f32; 3]

Convert an opaque color from linear sRGB.

fn clip(_: [f32; 3]) -> [f32; 3]

Clip the color’s components to fit within the natural gamut of the color space.

const LAYOUT: ColorSpaceLayout = ColorSpaceLayout::Rectangular

The layout of the color space.

const WHITE_POINT: Chromaticity = Chromaticity::D65

The white point of the color space.

fn convert<TargetCS>(src: [f32; 3]) -> [f32; 3]

where TargetCS: ColorSpace,

Convert to a different color space.

fn to_linear_srgb_absolute(src: [f32; 3]) -> [f32; 3]

Convert an opaque color to linear sRGB, without chromatic adaptation.

fn from_linear_srgb_absolute(src: [f32; 3]) -> [f32; 3]

Convert an opaque color from linear sRGB, without chromatic adaptation.

fn convert_absolute<TargetCS>(src: [f32; 3]) -> [f32; 3]

where TargetCS: ColorSpace,

Convert to a different color space, without chromatic adaptation.

fn chromatically_adapt( src: [f32; 3], from: Chromaticity, to: Chromaticity, ) -> [f32; 3]

Chromatically adapt the color between the given white point chromaticities.

fn scale_chroma(src: [f32; 3], scale: f32) -> [f32; 3]

Scale the chroma by the given amount.

impl Debug for XyzD65

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

Formats the value using the given formatter.

impl From<XyzD65> for ColorSpaceTag

fn from(_: XyzD65) -> ColorSpaceTag

Converts to this type from the input type.

impl Copy for XyzD65