Struct RgbSpace 

pub struct RgbSpace {
    pub white: Chromaticity,
    pub to_xyz: Matrix3,
    pub from_xyz: Matrix3,
    pub transfer: Transfer,
}

A description of an RGB colour space: its white point, and how to move between its encoded channels and CIE XYZ.

The matrices are relative to the space’s own white point, with Y = 1 for that white.

The constants are the predefined RGB colour spaces of CSS Color 4, with the matrices from its sample code: https://drafts.csswg.org/css-color-4/#color-conversion-code

let white = RgbSpace::SRGB.xyz_from_encoded([1.0, 1.0, 1.0]);
assert!(white.iter().zip(RgbSpace::SRGB.white.xyz()).all(|(a, b)| (a - b).abs() < 1e-12));

Fields

white: Chromaticity

Chromaticity of the white point.

to_xyz: Matrix3

Linear RGB -> CIE XYZ, at this space’s white point.

from_xyz: Matrix3

CIE XYZ -> linear RGB, at this space’s white point.

transfer: Transfer

The transfer function between linear light and this space’s encoded channels.

Implementations

impl RgbSpace

pub const SRGB: Self

sRGB (IEC 61966-2-1), D65.

https://drafts.csswg.org/css-color-4/#predefined-sRGB

pub const SRGB_LINEAR: Self

sRGB primaries with no transfer function (“srgb-linear”), D65.

https://drafts.csswg.org/css-color-4/#predefined-sRGB-linear

pub const DISPLAY_P3: Self

Display P3 (DCI-P3 primaries, sRGB transfer), D65.

https://drafts.csswg.org/css-color-4/#predefined-display-p3

pub const A98_RGB: Self

Adobe RGB (1998), D65.

https://drafts.csswg.org/css-color-4/#predefined-a98-rgb

pub const PROPHOTO_RGB: Self

ProPhoto RGB (ROMM RGB), D50.

https://drafts.csswg.org/css-color-4/#predefined-prophoto-rgb

pub const REC2020: Self

ITU-R BT.2020 primaries, D65, with the transfer function described at Transfer::Rec2020.

https://drafts.csswg.org/css-color-4/#predefined-rec2020

pub const fn xyz_from_linear(&self, rgb: [f64; 3]) -> [f64; 3]

Converts linear channels of this space to CIE XYZ at this space’s white point.

pub const fn linear_from_xyz(&self, xyz: [f64; 3]) -> [f64; 3]

Converts CIE XYZ at this space’s white point to this space’s linear channels.

pub fn xyz_from_encoded(&self, rgb: [f64; 3]) -> [f64; 3]

Converts this space’s encoded channels to CIE XYZ at this space’s white point.

pub fn encoded_from_xyz(&self, xyz: [f64; 3]) -> [f64; 3]

Converts CIE XYZ at this space’s white point to this space’s encoded channels.

Trait Implementations

impl Clone for RgbSpace

fn clone(&self) -> RgbSpace

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for RgbSpace

impl Debug for RgbSpace

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

Formats the value using the given formatter.

impl PartialEq for RgbSpace

fn eq(&self, other: &RgbSpace) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl StructuralPartialEq for RgbSpace