Struct UnsupportedPixelFormat 

pub struct UnsupportedPixelFormat { /* private fields */ }

Payload for ConvertError::UnsupportedPixelFormat.

The frame’s pixel format isn’t in the closed CPU-format set this crate supports for safe per-plane access.

A compact tag, and why it is not a PixelFormat

This payload used to carry the vocabulary’s PixelFormat beside the raw id. mediaframe 0.11 widened that type’s text arm, which made this the biggest arm of ConvertError at 144 bytes — a cost every Result on the convert road pays on its success path. Boxing the format fixed the size and introduced a worse thing: an infallible allocation on the refusal path, so a container-selected unsupported format could abort the process precisely while the converter was trying to report it. An error that says “this is unsupported” must not depend on the allocator agreeing.

So the payload is a tag: the raw AVPixelFormat integer, and libavutil’s own name for it borrowed from the static descriptor table. Twenty-four bytes, no allocation, no lifetime that can dangle — the table outlives the process. The PixelFormat field is gone rather than boxed, and its own documentation is why that costs nothing: it said the vocabulary answer “is deliberately not made to carry the integer: raw and name are where the identity survives”. A caller that wants the vocabulary’s word for a raw id can ask for it; a caller reading an error wants to know which format was refused.

Implementations

impl UnsupportedPixelFormat

pub const fn new(raw: i32, name: Option<&'static str>) -> Self

Constructs an UnsupportedPixelFormat payload.

const again, and allocation-free: see the type’s own note.

pub const fn raw(&self) -> i32

The raw AVFrame.format integer, exactly as FFmpeg wrote it.

Present at every tier — it costs one i32 — because it is the only field that is always available and always precise. Without it the message for the fall-through case says None and names nothing at all.

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

FFmpeg’s own name for Self::raw (av_get_pix_fmt_name), when libavutil has one.

None for an integer libavutil does not describe — a corrupt read, or a format from a newer library than the one linked.

Trait Implementations

impl Clone for UnsupportedPixelFormat

fn clone(&self) -> UnsupportedPixelFormat

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for UnsupportedPixelFormat

impl Debug for UnsupportedPixelFormat

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

Formats the value using the given formatter.

impl Display for UnsupportedPixelFormat

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

Formats the value using the given formatter.

impl Eq for UnsupportedPixelFormat

impl PartialEq for UnsupportedPixelFormat

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for UnsupportedPixelFormat