Struct KeyframeEnumerator 

pub struct KeyframeEnumerator { /* private fields */ }

Enumerates the timestamps of all keyframes in a video stream.

Reads only packet headers — no decoding is performed — making this significantly faster than frame-by-frame decoding. By default the first video stream is selected; call stream_index to target a specific stream.

Examples

use ff_decode::KeyframeEnumerator;

let keyframes = KeyframeEnumerator::new("video.mp4").run()?;
for ts in &keyframes {
    println!("Keyframe at {:?}", ts);
}

Implementations

impl KeyframeEnumerator

pub fn new(input: impl AsRef<Path>) -> Self

Creates a new enumerator for the given video file.

The first video stream is used by default. Call stream_index to select a different stream.

pub fn stream_index(self, idx: usize) -> Self

Selects a specific stream by zero-based index.

When not set (the default), the first video stream in the file is used.

pub fn run(self) -> Result<Vec<Duration>, DecodeError>

Enumerates keyframe timestamps and returns them in presentation order.

Errors

• DecodeError::AnalysisFailed — input file not found, no video stream exists, the requested stream index is out of range, or an internal FFmpeg error occurs.