Struct YuvFormat 

pub struct YuvFormat {
    pub chroma_shift_x: u8,
    pub chroma_shift_y: u8,
    pub bit_depth: u8,
    pub interleaved_chroma: bool,
    pub msb_aligned: bool,
    pub alpha: bool,
}

How a planar or semi-planar YCbCr frame stores its samples.

Luma comes first, then separate U and V planes or one interleaved UV plane, each ceil(width / 2^chroma_shift_x) by ceil(height / 2^chroma_shift_y). Samples over eight bits are little-endian u16. With alpha, a straight full-range alpha plane at luma size and depth follows.

Fields

chroma_shift_x: u8

Log2 of the horizontal chroma subsampling: 0 for 4:4:4, 1 for 4:2:x.

chroma_shift_y: u8

Log2 of the vertical chroma subsampling: 1 for 4:2:0, 0 otherwise.

bit_depth: u8

Significant bits per sample, 8 through 16.

interleaved_chroma: bool

Whether U and V interleave in one plane, as NV12 and P010 do.

msb_aligned: bool

Whether samples sit in the high bits of their u16 (P010) rather than the low bits (yuv420p10le).

alpha: bool

Whether an alpha plane follows the chroma, as yuva444p16le’s does.

Implementations

impl YuvFormat

pub const I420: Self

8-bit planar 4:2:0 (yuv420p).

pub const NV12: Self

8-bit 4:2:0 with interleaved chroma (nv12).

pub const P010: Self

10-bit 4:2:0 with interleaved, high-aligned chroma (p010le).

pub const fn planar( chroma_shift_x: u8, chroma_shift_y: u8, bit_depth: u8, ) -> Self

Planar YCbCr with low-aligned samples.

pub const fn with_alpha(self) -> Self

The same format with an alpha plane after the chroma.

pub const fn is_supported(self) -> bool

Whether the renderer can sample this format: 8 to 16 bits, chroma subsampling of at most four per axis, and high alignment only below 16 bits.

pub const fn bytes_per_sample(self) -> u32

Bytes each stored sample takes: one up to 8 bits, two above.

pub const fn plane_count(self) -> usize

Number of stored planes, alpha included.

pub const fn color_plane_count(self) -> usize

Number of luma and chroma planes; the alpha plane, if any, follows them.

pub const fn chroma_size(self, width: u32, height: u32) -> (u32, u32)

Chroma plane dimensions, in sample positions, for a coded frame size.

Trait Implementations

impl Clone for YuvFormat

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 YuvFormat

impl Debug for YuvFormat

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

Formats the value using the given formatter.

impl Eq for YuvFormat

impl Hash for YuvFormat

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 YuvFormat

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for YuvFormat