Struct FfmpegDecoder 

pub struct FfmpegDecoder { /* private fields */ }

Decodes a video into Rgb8Image frames by pulling raw rgb24 from a system ffmpeg.

The mirror of FfmpegEncoder, and deliberately a pulling iterator rather than a callback: the simulator consumes frames in pairs and needs to hold one back, which a push API makes awkward.

Implementations

impl FfmpegDecoder

pub fn open(path: &Path, scale: Option<(usize, usize)>) -> Result<Self>

Opens path for decoding. scale optionally resizes on the way out, which is far cheaper than decoding at full resolution and downsampling afterwards.

pub fn info(&self) -> VideoInfo

pub fn next_frame(&mut self) -> Result<Option<Rgb8Image>>

Pulls the next frame, or None at the end of the stream.

A partial read at the end is treated as end-of-stream rather than an error: ffmpeg closing the pipe mid-frame is how a truncated source presents, and there is nothing useful to do with half a frame.

Trait Implementations

impl Drop for FfmpegDecoder

fn drop(&mut self)

Executes the destructor for this type.

fn pin_drop(self: Pin<&mut Self>)

🔬This is a nightly-only experimental API. (pin_ergonomics)

Execute the destructor for this type, but different to Drop::drop, it requires self to be pinned.