Enum ColorSpace 

#[non_exhaustive]
pub enum ColorSpace {
    Bt709,
    Bt601,
    Bt2020,
    DciP3,
    Srgb,
    Unknown,
}

Color space (matrix coefficients) for YUV to RGB conversion.

The color space defines how YUV values are converted to RGB and vice versa. Different standards use different matrix coefficients for this conversion.

Common Usage

• BT.709: HD content (720p, 1080p)
• BT.601: SD content (480i, 576i)
• BT.2020: UHD/HDR content (4K, 8K)
• sRGB: Computer graphics, web content

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.

Bt709

ITU-R BT.709 - HD television standard (most common for HD video)

Bt601

ITU-R BT.601 - SD television standard

Bt2020

ITU-R BT.2020 - UHD/HDR television standard

DciP3

DCI-P3 - digital cinema wide color gamut

Srgb

sRGB color space - computer graphics and web

Unknown

Color space is not specified or unknown

Implementations

impl ColorSpace

pub const fn name(&self) -> &'static str

Returns the name of the color space as a human-readable string.

Examples

use ff_format::color::ColorSpace;

assert_eq!(ColorSpace::Bt709.name(), "bt709");
assert_eq!(ColorSpace::Bt601.name(), "bt601");

pub const fn is_hd(&self) -> bool

Returns true if this is an HD color space (BT.709).

Examples

use ff_format::color::ColorSpace;

assert!(ColorSpace::Bt709.is_hd());
assert!(!ColorSpace::Bt601.is_hd());

pub const fn is_sd(&self) -> bool

Returns true if this is an SD color space (BT.601).

Examples

use ff_format::color::ColorSpace;

assert!(ColorSpace::Bt601.is_sd());
assert!(!ColorSpace::Bt709.is_sd());

pub const fn is_uhd(&self) -> bool

Returns true if this is a UHD/HDR color space (BT.2020).

Examples

use ff_format::color::ColorSpace;

assert!(ColorSpace::Bt2020.is_uhd());
assert!(!ColorSpace::Bt709.is_uhd());

pub const fn is_cinema(&self) -> bool

Returns true if this is a cinema/DCI color space (DCI-P3).

Examples

use ff_format::color::ColorSpace;

assert!(ColorSpace::DciP3.is_cinema());
assert!(!ColorSpace::Bt709.is_cinema());

pub const fn is_unknown(&self) -> bool

Returns true if the color space is unknown.

Examples

use ff_format::color::ColorSpace;

assert!(ColorSpace::Unknown.is_unknown());
assert!(!ColorSpace::Bt709.is_unknown());

Trait Implementations

impl Clone for ColorSpace

fn clone(&self) -> ColorSpace

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ColorSpace

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

Formats the value using the given formatter.

impl Default for ColorSpace

fn default() -> ColorSpace

Returns the “default value” for a type.

impl Display for ColorSpace

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

Formats the value using the given formatter.

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: &ColorSpace) -> 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 Copy for ColorSpace

impl Eq for ColorSpace

impl StructuralPartialEq for ColorSpace