Struct NativeDecoder 

pub struct NativeDecoder { /* private fields */ }

Software video decoder with exact timestamp conversion and drain semantics.

Implementations

impl NativeDecoder

pub fn set_decode_policy(&mut self, policy: DecodePolicy)

Selects strict failure (default) or bounded, reported recovery.

pub fn declare_color(&mut self, color: Option<ColorMetadata>)

Sets the project’s declared color for this source, which replaces the frame and stream tags. None leaves the tags in charge.

pub fn set_decode_reporter( &mut self, reporter: impl Fn(DecodeDiagnostic) + Send + Sync + 'static, )

Receives each diagnostic before recovery continues, including before errors.

pub fn decode_diagnostics(&self) -> &DecodeDiagnostics

Cumulative corruption and concealment diagnostics, including seeks.

pub fn open(path: impl AsRef<Path>) -> Result<Self, DecodeError>

Opens the deterministically selected video stream.

Errors

Returns an error when no decodable video stream exists.

pub fn open_with_threads( path: impl AsRef<Path>, threads: i64, ) -> Result<Self, DecodeError>

Opens the selected stream with an explicit FFmpeg worker allocation.

Errors

Returns an error when no decodable video stream exists.

pub const fn dropped_layer(&self) -> Option<&DroppedLayer>

What this decoder leaves out (unreadable alpha, extra HEVC layers), or None.

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

Effective end of the selected video source.

Includes the container duration, which browser APIs expose, since the stream can end a few ticks earlier from time-base rounding.

pub fn presentation_deadline(&self, time: MediaTime) -> MediaTime

The latest timestamp a frame may carry and still be shown at time: time plus the stream’s alpha2_time::presentation_slack.

pub fn peek_video_pts( &mut self, cancel: &CancelToken, ) -> Result<Option<MediaTime>, DecodeError>

When the frame the next Decoder::decode_next returns is presented, or None at the end.

The frame is decoded now and kept for that call, so a caller can find the frame shown at a time without consuming the next one.

Errors

Returns cancellation and decode failures.

Trait Implementations

impl Decoder for NativeDecoder

fn streams(&self) -> &[StreamInfo]

Returns deterministic stream metadata and stream selection.

fn flush(&mut self) -> Result<(), DecodeError>

Flushes queued packets and frames without changing stream selection.

fn seek( &mut self, request: DecodeRequest, cancel: &CancelToken, ) -> Result<DecodeResult, DecodeError>

Seeks and returns what is presented at the request’s time.

fn decode_next( &mut self, cancel: &CancelToken, ) -> Result<DecodeEvent, DecodeError>

Advances packet draining by one observable event.