Struct ImageFrameExtra 

pub struct ImageFrameExtra { /* private fields */ }

Per-ImageFrame extras — cover art, an embedded thumbnail, a poster frame.

One seat, deliberately. This household is minimal at birth because a still image’s AVFrame carries almost nothing a motion frame’s does: no picture type, no field order, no best-effort timestamp, no SAR worth a seat. What it does carry is side data, and that is what is here.

EXIF orientation takes a seat here, read off the frame’s AV_FRAME_DATA_DISPLAYMATRIX side data — see ImageOrientation for the measurement that establishes that road, and for why an earlier reading of libavcodec (which put orientation in AVFrame.metadata) was wrong about where it arrives.

An ICC profile arrives as side data too (AV_FRAME_DATA_ICC_PROFILE) and does not get a seat: it is a payload, not a fact — kilobytes of colour transform this crate has no vocabulary for and no business parsing. Self::side_data carries it unparsed and whole for a consumer that does. That is the line: a fact a picture cannot be displayed correctly without is typed; a payload only a specialist reads rides raw.

Implementations

impl ImageFrameExtra

pub const fn new() -> Self

Constructs an ImageFrameExtra with no orientation and no side data.

pub const fn orientation(&self) -> Option<ImageOrientation>

How the picture should be turned for display, when the file said.

None means the frame carried no display matrix — the ordinary case for a still with no EXIF orientation tag, and also what an out-of-range tag produces, because libavcodec emits no matrix for one. A malformed matrix (not nine int32_t) is None too. In every one of those cases the raw entry, if there was one, is still in Self::side_data.

A consumer that ignores this displays a sideways photograph.

pub fn side_data(&self) -> &[SideDataEntry]

Returns the raw side-data entries from AVFrame.side_data — AV_FRAME_DATA_ICC_PROFILE and the display matrix among them.

pub const fn with_orientation(self, value: Option<ImageOrientation>) -> Self

Sets the orientation (consuming builder).

pub fn with_side_data(self, value: Vec<SideDataEntry>) -> Self

Sets the side-data list (consuming builder).

pub const fn set_orientation( &mut self, value: Option<ImageOrientation>, ) -> &mut Self

Sets the orientation in place.

pub fn set_side_data(&mut self, value: Vec<SideDataEntry>) -> &mut Self

Sets the side-data list in place.

Trait Implementations

impl Clone for ImageFrameExtra

fn clone(&self) -> ImageFrameExtra

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ImageFrameExtra

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

Formats the value using the given formatter.

impl Default for ImageFrameExtra

fn default() -> ImageFrameExtra

Returns the “default value” for a type.