Enum NativeVideoFrame 

pub enum NativeVideoFrame {
    Cpu(DecodedVideoFrame),
    Hardware {
        metadata: NativeVideoFrameMetadata,
        surface: Arc<dyn HardwareFrameLease>,
    },
}

One decoded export frame with either owned CPU pixels or an opaque surface.

Variants

Cpu(DecodedVideoFrame)

Software-decoded frame.

Hardware

Hardware-decoded frame whose platform details remain behind its lease.

Fields

metadata: NativeVideoFrameMetadata

Presentation and cache identity.

surface: Arc<dyn HardwareFrameLease>

Ref-counted decoder-surface ownership.

Implementations

impl NativeVideoFrame

pub fn pts(&self) -> MediaTime

Presentation timestamp.

pub fn duration(&self) -> Option<MediaTime>

Nominal frame duration when known.

pub fn metadata(&self) -> NativeVideoFrameMetadata

Returns metadata without exposing the backing representation.

pub const fn is_hardware(&self) -> bool

Whether this frame is backed by a decoder surface rather than CPU pixels.

pub fn as_cpu(&self) -> Option<&DecodedVideoFrame>

Returns the software frame when this is the CPU variant.

pub fn to_cpu(&self) -> Result<DecodedVideoFrame, DecodeError>

A CPU copy of this frame: the frame itself when it already is one, or the decoder surface’s pixels downloaded through FFmpeg.

This is the fallback for a surface the renderer could not import, so the frame still reaches the export instead of failing it. Timing and presentation come from this frame’s metadata; the pixels go through the same conversion a software decoder’s frames do.

Errors

Returns a native decode error when the surface cannot be downloaded or converted.

pub fn retained_bytes(&self) -> u64

Approximate retained bytes for separate CPU and surface budgets.

Trait Implementations

impl Debug for NativeVideoFrame

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

Formats the value using the given formatter.