Struct FfmpegDemuxer 

pub struct FfmpegDemuxer { /* private fields */ }

mediadecode::demuxer::Demuxer impl wrapping ffmpeg::format::context::Input.

Construction is deliberately not on the trait — see Self::open and Self::open_reader.

Implementations

impl FfmpegDemuxer

pub fn open<P: AsRef<Path> + ?Sized>(path: &P) -> Result<Self, DemuxError>

Opens a container from a filesystem path.

Runs avformat_open_input followed by avformat_find_stream_info, then builds the track table and captures every attachment payload.

Call ffmpeg_next::init once before the first open if you want FFmpeg’s logging and network protocols configured; probing a local container does not require it.

pub fn open_reader<R: Read + Seek + Send + 'static>( reader: R, filename: Option<&str>, ) -> Result<Self, DemuxError>

Opens a container from any Read + Seek byte source, through a custom AVIOContext.

Seek is mandatory and not negotiable: MP4 files routinely put moov at the end, so a reader that cannot go backwards cannot be probed at all — and the seek law on the face would be unimplementable.

filename is a probe hint, not a path: libavformat uses its extension to break ties between formats whose byte signatures are ambiguous. Pass None when there is nothing to hint with.

A panicking reader

libavformat drives the reader from extern "C" callbacks, where a panic would abort the process rather than unwind. Every call into reader therefore runs under catch_unwind: a panic becomes an I/O error for libavformat and surfaces here — or from the next next_packet / seek — as DemuxError::ReaderPanic, carrying the panic’s message. The session is terminal from that point: the AVIOContext’s error state is sticky and the reader’s own state is unknown.

pub const fn input(&self) -> &Input

Borrows the wrapped ffmpeg::format::context::Input — for av_dump_format, container-level metadata, chapters, and anything else the portable track table has no seat for.

Trait Implementations

impl Demuxer for FfmpegDemuxer

type Adapter = Ffmpeg

Backend-specific vocabulary.

type Buffer = FfmpegBuffer

Buffer type held by the packets this session produces.

type Error = DemuxError

Demuxer-specific error type.

fn tracks(&self) -> &[TrackInfo<Ffmpeg>]

Returns the container’s track table.

fn take_tracks(&mut self) -> Vec<TrackInfo<Ffmpeg>>

Available on crate features alloc or std only.

Moves the whole track table out, once.

fn next_packet( &mut self, ) -> Result<Option<DemuxedPacket<Ffmpeg, FfmpegBuffer>>, DemuxError>

Pulls the next packet in interleaved file order, or Ok(None) at end of file.

fn seek(&mut self, target: Timestamp) -> Result<(), DemuxError>

Seeks to target, landing on the nearest keyframe at or before it.