Struct ExportPreset 

pub struct ExportPreset {
    pub name: String,
    pub video: Option<VideoEncoderConfig>,
    pub audio: AudioEncoderConfig,
}

A named export preset combining video and audio encoder configuration.

Create a predefined preset with ExportPreset::youtube_1080p() etc., or build a custom one as a struct literal. Call validate() before encoding to catch platform-constraint violations early.

video: None indicates an audio-only preset (e.g. podcast_mono).

Examples

use ff_encode::{ExportPreset, VideoEncoder};

let preset = ExportPreset::youtube_1080p();
preset.validate()?;

let mut encoder = preset
    .apply_video(VideoEncoder::create("output.mp4"))
    .build()?;

Fields

name: String

Human-readable name (e.g. "youtube_1080p").

video: Option<VideoEncoderConfig>

Video encoder configuration. None = audio-only preset.

audio: AudioEncoderConfig

Audio encoder configuration.

Implementations

impl ExportPreset

pub fn youtube_1080p() -> Self

YouTube 1080p preset: H.264, CRF 18, 1920×1080, 30 fps, AAC 192 kbps.

pub fn youtube_4k() -> Self

YouTube 4K preset: H.265, CRF 20, 3840×2160, 30 fps, AAC 256 kbps.

pub fn twitter() -> Self

Twitter/X preset: H.264, CRF 23, 1280×720, 30 fps, AAC 128 kbps.

pub fn instagram_square() -> Self

Instagram Square preset: H.264, CRF 23, 1080×1080, 30 fps, AAC 128 kbps.

pub fn instagram_reels() -> Self

Instagram Reels preset: H.264, CRF 23, 1080×1920, 30 fps, AAC 128 kbps.

pub fn bluray_1080p() -> Self

Blu-ray 1080p preset: H.264, CRF 18, 1920×1080, 24 fps, AC-3 384 kbps.

pub fn podcast_mono() -> Self

Podcast mono preset (audio-only): AAC 128 kbps, mono, 48 kHz.

pub fn lossless_rgb() -> Self

Lossless archive preset: FFV1 video (source resolution), FLAC audio.

pub fn web_h264() -> Self

Web H.264 preset (VP9): VP9, CRF 33, 1280×720, 30 fps, Opus 128 kbps.

pub fn validate(&self) -> Result<(), EncodeError>

Validates this preset against platform-specific constraints.

Call this before passing the preset to apply_video or apply_audio to surface constraint violations before encoding begins.

Errors

Returns EncodeError::PresetConstraintViolation when a platform rule is violated (e.g. fps > 60 on a YouTube preset, or wrong aspect ratio on an Instagram preset).

pub fn apply_video(&self, builder: VideoEncoderBuilder) -> VideoEncoderBuilder

Applies the video configuration to a VideoEncoderBuilder.

Sets the codec and bitrate mode unconditionally. Resolution and frame rate are only applied when all three (width, height, fps) are Some. Pixel format and per-codec options are applied when present.

Returns builder unchanged when video is None (audio-only preset).

pub fn apply_audio(&self, builder: VideoEncoderBuilder) -> VideoEncoderBuilder

Applies the audio configuration to a VideoEncoderBuilder.

Sets sample rate, channel count, codec, and bitrate.

Trait Implementations

impl Clone for ExportPreset

fn clone(&self) -> ExportPreset

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ExportPreset

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

Formats the value using the given formatter.