Struct MediaEngine 

pub struct MediaEngine { /* private fields */ }

The ffmpeg engine for video and audio.

Implementations

impl MediaEngine

pub fn new() -> Self

pub fn with_cancel(cancel: CancelToken) -> Self

An engine whose run / estimate stop when cancel is set: the running ffmpeg is killed, the partial output removed, and the call returns an error for which EngineError::is_cancelled is true.

pub fn run_with_progress( &self, plan: &EncodePlan, on_progress: &mut dyn FnMut(PassKind, f64), ) -> Result<Outcome, EngineError>

Like Engine::run but reports progress: on_progress(pass, fraction) is called with fraction in 0.0..=1.0 as each pass proceeds.

pub fn estimate(&self, plan: &EncodePlan) -> Result<Option<u64>, EngineError>

The expected output size of plan, without running it — the honest preview for a UI. Size targets and audio come straight from the plan (pure); a quality-mode (CRF) video is predicted from short sample encodes, like the “never bigger” guard does (~2–3 s for any length). Compare the result with the source: at or above it, a guarded run keeps the original (Outcome::already_compact). None if it can’t be told.

Trait Implementations

impl Clone for MediaEngine

fn clone(&self) -> Self

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for MediaEngine

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for MediaEngine

fn default() -> Self

Returns the “default value” for a type.

impl Engine for MediaEngine

fn supports(&self, input: &Path) -> bool

Whether this engine handles the given file.

fn probe(&self, input: &Path) -> Result<MediaInfo, EngineError>

Read metadata (side effect: run a probe, e.g. ffprobe).

fn plan( &self, info: &MediaInfo, opts: &ShrinkOpts, ) -> Result<EncodePlan, EngineError>

Build the encode plan. Pure function — tested without encoding.

fn run(&self, plan: &EncodePlan) -> Result<Outcome, EngineError>

Execute the plan (side effect: run the encoder binary).