Struct ColorSpace 

pub struct ColorSpace {
    pub primaries: Primaries,
    pub transfer: Transfer,
    pub matrix: Matrix,
    pub range: Range,
}

Everything needed to turn a frame’s samples into light, in one place.

Fields

primaries: Primaries

The chromaticities.

transfer: Transfer

The transfer curve.

matrix: Matrix

The luma coefficients.

range: Range

Full or limited.

Implementations

impl ColorSpace

pub fn guess_for(width: u32, height: u32) -> Self

What a frame of this size is, when the file does not say.

Files with no colour metadata are common, and guessing by resolution is what every player does: SD was made on 601, HD on 709, UHD increasingly on 2020. It is a convention rather than a rule, so anything the container does state overrides this.

pub fn srgb() -> Self

What a still image is: sRGB, full range, no chroma subsampling to undo.

pub fn yuv_to_rgb(self, bit_depth: u32) -> [[f32; 4]; 3]

The YUV→RGB matrix for these settings, as three rows of [y, u, v, offset].

Feed it samples normalised by the maximum code value — code / 255 at 8 bits, code / 1023 at 10 — and it returns display RGB in 0.0..=1.0. The offset column absorbs both the limited-range pedestal and chroma’s neutral point, so a shader is one matrix * yuv + offset with no branches and no per-pixel arithmetic of its own.

bit_depth is needed even though the samples arrive normalised, because the neutral chroma code is 2^(n-1) against a maximum of 2^n - 1: 128/255 at 8 bits, 512/1023 at 10. Calling it exactly 0.5 is the approximation most shaders make, and it tints neutral greys by a fraction of a code value in the wrong direction. It costs nothing to be right.

Trait Implementations

impl Clone for ColorSpace

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for ColorSpace

impl Debug for ColorSpace

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

Formats the value using the given formatter.

impl Default for ColorSpace

fn default() -> Self

Returns the “default value” for a type.

impl Eq for ColorSpace

impl Hash for ColorSpace

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, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for ColorSpace

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for ColorSpace