Enum ColorRange 

#[non_exhaustive]
pub enum ColorRange {
    Limited,
    Full,
    Unknown,
}

Color range defining the valid range of color values.

Video typically uses “limited” range where black is at level 16 and white at level 235 (for 8-bit). Computer graphics typically use “full” range where black is 0 and white is 255.

Common Usage

• Limited: Broadcast video, Blu-ray, streaming services
• Full: Computer graphics, screenshots, game capture

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.

Limited

Limited/TV range (16-235 for Y, 16-240 for UV in 8-bit)

Full

Full/PC range (0-255 for all components in 8-bit)

Unknown

Color range is not specified or unknown

Implementations

impl ColorRange

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

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

Examples

use ff_format::color::ColorRange;

assert_eq!(ColorRange::Limited.name(), "limited");
assert_eq!(ColorRange::Full.name(), "full");

pub const fn is_full(&self) -> bool

Returns true if this is full (PC) range.

Examples

use ff_format::color::ColorRange;

assert!(ColorRange::Full.is_full());
assert!(!ColorRange::Limited.is_full());

pub const fn is_limited(&self) -> bool

Returns true if this is limited (TV) range.

Examples

use ff_format::color::ColorRange;

assert!(ColorRange::Limited.is_limited());
assert!(!ColorRange::Full.is_limited());

pub const fn is_unknown(&self) -> bool

Returns true if the color range is unknown.

Examples

use ff_format::color::ColorRange;

assert!(ColorRange::Unknown.is_unknown());
assert!(!ColorRange::Limited.is_unknown());

pub const fn luma_min_8bit(&self) -> u8

Returns the minimum value for luma (Y) in 8-bit.

Examples

use ff_format::color::ColorRange;

assert_eq!(ColorRange::Limited.luma_min_8bit(), 16);
assert_eq!(ColorRange::Full.luma_min_8bit(), 0);

pub const fn luma_max_8bit(&self) -> u8

Returns the maximum value for luma (Y) in 8-bit.

Examples

use ff_format::color::ColorRange;

assert_eq!(ColorRange::Limited.luma_max_8bit(), 235);
assert_eq!(ColorRange::Full.luma_max_8bit(), 255);

Trait Implementations

impl Clone for ColorRange

fn clone(&self) -> ColorRange

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ColorRange

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

Formats the value using the given formatter.

impl Default for ColorRange

fn default() -> ColorRange

Returns the “default value” for a type.

impl Display for ColorRange

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

Formats the value using the given formatter.

impl Hash for ColorRange

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 ColorRange

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

impl Eq for ColorRange

impl StructuralPartialEq for ColorRange