Struct FrameExtractor 

pub struct FrameExtractor { /* private fields */ }

Extracts one frame per time interval from a video file.

Examples

use ff_decode::FrameExtractor;
use std::time::Duration;

let frames = FrameExtractor::new("video.mp4")
    .interval(Duration::from_secs(5))
    .run()?;
println!("extracted {} frames", frames.len());

Implementations

impl FrameExtractor

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

Creates a new FrameExtractor for the given input file.

The default extraction interval is 1 second.

pub fn interval(self, d: Duration) -> Self

Sets the time interval between extracted frames.

Passing Duration::ZERO causes run to return DecodeError::AnalysisFailed.

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

Runs the extraction and returns one frame per interval.

Timestamps 0, interval, 2×interval, … up to (but not including) the video duration are sampled. DecodeError::NoFrameAtTimestamp for a given timestamp is silently skipped with a warn! log; all other errors are propagated immediately.

Errors

• DecodeError::AnalysisFailed — interval is zero, or the input file cannot be opened.
• Any other DecodeError propagated from the decoder.