Enum Coefficients

#[non_exhaustive]
#[repr(u32)]
pub enum Coefficients {
    Identity = 1,
    Bt709 = 2,
    Fcc = 3,
    Bt601 = 4,
    Smpte240 = 5,
    Bt2020 = 6,
    Bt2020Cl = 7,
    Ictcp = 8,
}

Available on crate feature wayland and Linux only.

named coefficients

Named matrix coefficients used to encode well-known sets of coefficients. H.273 is the authority, when it comes to the exact values of coefficients and authoritative specifications, where an equivalent code point exists.

A value of 0 is invalid and will never be present in the list of enums.

Descriptions do list the specifications for convenience.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

Identity = 1

The identity matrix

Coefficients as defined by

• IEC 61966-2-1 sRGB
• SMPTE ST 428-1 (2019)

Equivalent to H.273 MatrixCoefficients code point 0. Compatible with pixel formats of the RGB family.

Bt709 = 2

BT.709 matrix coefficients

Coefficients as defined by

• Rec. ITU-R BT.709-6
• Rec. ITU-R BT.1361-0 conventional colour gamut system (historical)
• Rec. ITU-R BT.1361-0 conventional colour gamut system and extended colour gamut system (historical)
• IEC 61966-2-4 xvYCC709
• SMPTE RP 177 (1993) Annex B

Equivalent to H.273 MatrixCoefficients code point 1. Compatible with pixel formats of the YCbCr family.

Fcc = 3

FCC matrix coefficients

Coefficients as defined by

• United States Federal Communications Commission (2003) Title 47 Code of Federal Regulations 73.682 (a) (20)

Equivalent to H.273 MatrixCoefficients code point 4. Compatible with pixel formats of the YCbCr family.

Bt601 = 4

BT.601-7 matrix coefficients

Coefficients as defined by

• Rec. ITU-R BT.470-6 System B, G (historical)
• Rec. ITU-R BT.601-7 625
• Rec. ITU-R BT.601-7 525
• Rec. ITU-R BT.1358-0 625 (historical)
• Rec. ITU-R BT.1358-1 525 or 625 (historical)
• Rec. ITU-R BT.1700-0 625 PAL and 625 SECAM
• Rec. ITU-R BT.1700-0 NTSC
• IEC 61966-2-1 sYCC
• IEC 61966-2-4 xvYCC601
• SMPTE ST 170 (2004)

Equivalent to H.273 MatrixCoefficients code point 5, 6. Compatible with pixel formats of the YCbCr family.

Smpte240 = 5

SMPTE ST 240 matrix coefficients

Coefficients as defined by

• SMPTE ST 240 (1999)

Equivalent to H.273 MatrixCoefficients code point 7. Compatible with pixel formats of the YCbCr family.

Bt2020 = 6

BT.2020 and BT.2100 YCbCr matrix coefficients

Coefficients as defined by

• Rec. ITU-R BT.2020-2 (non-constant luminance)
• Rec. ITU-R BT.2100-2 Y′CbCr

Equivalent to H.273 MatrixCoefficients code point 9. Compatible with pixel formats of the YCbCr family.

Bt2020Cl = 7

BT.2020 matrix coefficients for constant luminance

Coefficients as defined by

• Rec. ITU-R BT.2020-2 (constant luminance)

Equivalent to H.273 MatrixCoefficients code point 10. Compatible with pixel formats of the YCbCr family.

Ictcp = 8

BT.2100 ICtCp matrix coefficients

Coefficients as defined by

• Rec. ITU-R BT.2100-2 ICTCP

Equivalent to H.273 MatrixCoefficients code point 14. Compatible with pixel formats of the YCbCr family.

Trait Implementations

impl Clone for Coefficients

fn clone(&self) -> Coefficients

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Coefficients

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

Formats the value using the given formatter.

impl Hash for Coefficients

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

where __H: Hasher,

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 Ord for Coefficients

fn cmp(&self, other: &Coefficients) -> Ordering

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Self

where Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

where Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

where Self: Sized,

Restrict a value to a certain interval.

impl PartialEq for Coefficients

fn eq(&self, other: &Coefficients) -> 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 PartialOrd for Coefficients

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

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

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

Tests less than (for self and other) and is used by the < operator.

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

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

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

Tests greater than (for self and other) and is used by the > operator.

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

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

impl TryFrom<u32> for Coefficients

type Error = ()

The type returned in the event of a conversion error.

fn try_from(val: u32) -> Result<Coefficients, ()>

Performs the conversion.

impl Copy for Coefficients

impl Eq for Coefficients

impl StructuralPartialEq for Coefficients