Enum PixelFormat 

#[non_exhaustive]
#[repr(u8)]
pub enum PixelFormat {
    Rgb8 = 1,
    Rgba8 = 2,
    Rgb16 = 3,
    Rgba16 = 4,
    RgbF32 = 5,
    RgbaF32 = 6,
    Gray8 = 7,
    Gray16 = 8,
    GrayF32 = 9,
    GrayA8 = 10,
    GrayA16 = 11,
    GrayAF32 = 12,
    Bgra8 = 13,
    Rgbx8 = 14,
    Bgrx8 = 15,
    OklabF32 = 16,
    OklabaF32 = 17,
    Cmyk8 = 18,
    RgbF16 = 19,
    RgbaF16 = 20,
    GrayF16 = 21,
    GrayAF16 = 22,
}

Physical pixel layout for match-based format dispatch.

Each variant encodes the channel type (U8/U16/F32) and layout (RGB/RGBA/ Gray/etc.) in one discriminant. Transfer function and alpha mode live on PixelDescriptor, not here.

Use this enum when you need exhaustive match dispatch over known pixel layouts.

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.

Rgb8 = 1

Rgba8 = 2

Rgb16 = 3

Rgba16 = 4

RgbF32 = 5

RgbaF32 = 6

Gray8 = 7

Gray16 = 8

GrayF32 = 9

GrayA8 = 10

GrayA16 = 11

GrayAF32 = 12

Bgra8 = 13

Rgbx8 = 14

Bgrx8 = 15

OklabF32 = 16

OklabaF32 = 17

Cmyk8 = 18

8-bit CMYK (4 bytes per pixel, no transfer function).

RgbF16 = 19

f16 (IEEE 754 half-precision) RGB.

RgbaF16 = 20

f16 (IEEE 754 half-precision) RGBA.

GrayF16 = 21

f16 (IEEE 754 half-precision) grayscale.

GrayAF16 = 22

f16 (IEEE 754 half-precision) grayscale with alpha.

Implementations

impl PixelFormat

pub const fn channel_type(self) -> ChannelType

Channel storage type.

pub const fn layout(self) -> ChannelLayout

Channel layout.

pub const fn color_model(self) -> ColorModel

Color model (what the channels represent).

pub const fn byte_order(self) -> ByteOrder

Byte order (Native or BGR).

pub const fn channels(self) -> usize

Number of channels (including alpha/padding if present).

pub const fn bytes_per_pixel(self) -> usize

Bytes per pixel.

pub const fn has_alpha_bytes(self) -> bool

Whether this format has alpha or padding bytes (4th channel).

pub const fn is_grayscale(self) -> bool

Whether this format is grayscale.

pub const fn default_alpha(self) -> Option<AlphaMode>

Default alpha mode for this format.

• Formats with no alpha bytes → None
• Formats with padding (Rgbx8, Bgrx8) → Some(AlphaMode::Undefined)
• Formats with alpha → Some(AlphaMode::Straight)

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

Short human-readable name.

pub const fn from_parts( channel_type: ChannelType, layout: ChannelLayout, alpha: Option<AlphaMode>, ) -> Option<PixelFormat>

Resolve a format from channel type, layout, and alpha presence.

Returns None for combinations that have no PixelFormat variant (e.g. (U16, Bgra, _)).

pub const fn descriptor(self) -> PixelDescriptor

Base descriptor with Unknown transfer and BT.709 primaries.

Trait Implementations

impl Clone for PixelFormat

fn clone(&self) -> PixelFormat

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for PixelFormat

impl Debug for PixelFormat

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

Formats the value using the given formatter.

impl Display for PixelFormat

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

Formats the value using the given formatter.

impl Eq for PixelFormat

impl Hash for PixelFormat

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 PartialEq for PixelFormat

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