Enum Pixels 

#[non_exhaustive]
pub enum Pixels {
    Stencil(BitImage),
    Gray8(Box<[u8]>),
    Rgb8(Box<[u8]>),
    Cmyk8(Box<[u8]>),
    Indexed {
        indices: Box<[u8]>,
        palette: Box<[Rgb]>,
    },
}

Decoded pixels, in whichever shape the source produced.

Keeping the shape rather than always widening to RGB matters: an indexed image’s palette is what a renderer needs to resample correctly, and a one-bit stencil is a mask, not a picture.

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.

Stencil(BitImage)

One bit per pixel, packed MSB-first with byte-aligned rows. A set bit paints; this is what a stencil mask produces.

Gray8(Box<[u8]>)

Eight-bit grey.

Rgb8(Box<[u8]>)

Eight-bit red, green, blue.

Cmyk8(Box<[u8]>)

Eight-bit cyan, magenta, yellow, black.

Indexed

Palette indices with the palette to resolve them.

Fields

indices: Box<[u8]>

One index per pixel.

palette: Box<[Rgb]>

The resolved colours, one per index value.

Implementations

impl Pixels

pub fn components(&self) -> usize

How many components each pixel carries.

pub fn byte_size(&self) -> usize

Bytes held.

Trait Implementations

impl Clone for Pixels

fn clone(&self) -> Pixels

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Pixels

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

Formats the value using the given formatter.

impl PartialEq for Pixels

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for Pixels