Struct ThumbnailSelector 

pub struct ThumbnailSelector { /* private fields */ }

Automatically selects the best thumbnail frame from a video file.

Candidates are sampled at regular intervals. Frames that are near-black (mean luma < 10), near-white (mean luma > 245), or blurry (Laplacian variance < 100) are skipped. The first candidate that passes all quality gates is returned. If no candidate passes, the sharpest frame seen is returned as a fallback.

Examples

use ff_decode::ThumbnailSelector;
use std::time::Duration;

let frame = ThumbnailSelector::new("video.mp4")
    .candidate_interval(Duration::from_secs(5))
    .run()?;

Implementations

impl ThumbnailSelector

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

Creates a new ThumbnailSelector for the given input file.

Default candidate interval is 5 seconds.

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

Sets the interval between candidate frames (default: 5s).

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

Runs thumbnail selection and returns the best frame.

Errors

• DecodeError::AnalysisFailed — the interval is zero, or no frame can be sampled from the video.
• Any other DecodeError propagated from the decoder.