Struct TranscodeBuilder 

pub struct TranscodeBuilder { /* private fields */ }

Builder-style API for spinning up simple ffmpeg jobs.

Implementations

impl TranscodeBuilder

pub fn new() -> Self

Create a new builder with sensible defaults (overwrite enabled).

pub fn with_binaries(self, binaries: &FfmpegBinaryPaths) -> Self

Use pre-discovered binaries instead of searching PATH every call.

pub fn with_locator(self, locator: &FfmpegLocator) -> Self

Pin the builder to a specific locator.

pub fn input<P: AsRef<Path>>(self, path: P) -> Self

Input media path.

pub fn output<P: AsRef<Path>>(self, path: P) -> Self

Output media path.

pub fn video_codec(self, codec: impl Into<String>) -> Self

Desired video codec (e.g. libx264).

pub fn audio_codec(self, codec: impl Into<String>) -> Self

Desired audio codec (e.g. aac).

pub fn video_bitrate(self, kbps: u32) -> Self

Target video bitrate in kbps.

pub fn audio_bitrate(self, kbps: u32) -> Self

Target audio bitrate in kbps.

pub fn frame_rate(self, fps: f64) -> Self

Target frame rate.

pub fn preset(self, preset: impl Into<String>) -> Self

Apply a named preset (maps to -preset).

pub fn size(self, width: u32, height: u32) -> Self

Convenience helper to scale output.

pub fn add_video_filter(self, filter: VideoFilter) -> Self

Add a video filter to the processing chain.

pub fn add_audio_filter(self, filter: AudioFilter) -> Self

Add an audio filter to the processing chain.

pub fn add_filter(self, filter: VideoFilter) -> Self

👎Deprecated since 0.2.0: use add_video_filter() instead

Backward compatibility: alias for add_video_filter.

pub fn extra_arg(self, arg: impl Into<OsString>) -> Self

Pass a raw argument for advanced cases.

pub fn overwrite(self, enabled: bool) -> Self

Control whether ffmpeg should overwrite the output file.

pub fn input_path(&self) -> Option<&Path>

Accessor for the configured input path.

pub fn output_path(&self) -> Option<&Path>

Accessor for the configured output path.

pub fn video_codec_ref(&self) -> Option<&str>

Accessor for the configured video codec.

pub fn audio_codec_ref(&self) -> Option<&str>

Accessor for the configured audio codec.

pub fn video_bitrate_value(&self) -> Option<u32>

Accessor for the configured video bitrate.

pub fn audio_bitrate_value(&self) -> Option<u32>

Accessor for the configured audio bitrate.

pub fn frame_rate_value(&self) -> Option<f64>

Accessor for the configured frame rate.

pub fn preset_value(&self) -> Option<&str>

Accessor for the configured preset.

pub fn overwrite_enabled(&self) -> bool

Returns whether overwriting outputs is enabled.

pub fn video_filters(&self) -> &[VideoFilter]

Accessor for the configured video filter chain.

pub fn audio_filters(&self) -> &[AudioFilter]

Accessor for the configured audio filter chain.

pub fn run(self) -> Result<()>

Execute ffmpeg with the configured arguments.

Trait Implementations

impl Debug for TranscodeBuilder

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

Formats the value using the given formatter.

impl Default for TranscodeBuilder

fn default() -> TranscodeBuilder

Returns the “default value” for a type.