Enum EncodeError 

pub enum EncodeError {
    CannotCreateFile {
        path: PathBuf,
    },
    UnsupportedCodec {
        codec: String,
    },
    NoSuitableEncoder {
        codec: String,
        tried: Vec<String>,
    },
    EncodingFailed {
        frame: u64,
        reason: String,
    },
    InvalidConfig {
        reason: String,
    },
    HwEncoderUnavailable {
        encoder: String,
    },
    EncoderUnavailable {
        codec: String,
        hint: String,
    },
    MuxingFailed {
        reason: String,
    },
    Ffmpeg {
        code: i32,
        message: String,
    },
    Io(Error),
    InvalidOption {
        name: String,
        reason: String,
    },
    UnsupportedContainerCodecCombination {
        container: String,
        codec: String,
        hint: String,
    },
    InvalidDimensions {
        width: u32,
        height: u32,
    },
    InvalidBitrate {
        bitrate: u64,
    },
    InvalidChannelCount {
        count: u32,
    },
    InvalidSampleRate {
        rate: u32,
    },
    Cancelled,
    WorkerPanicked,
    MediaOperationFailed {
        reason: String,
    },
    PresetConstraintViolation {
        preset: String,
        reason: String,
    },
}

Encoding error type.

Variants

CannotCreateFile

Cannot create output file

Fields

path: PathBuf

File path that failed

UnsupportedCodec

Unsupported codec

Fields

codec: String

Codec name

NoSuitableEncoder

No suitable encoder found

Fields

codec: String

Requested codec

tried: Vec<String>

Attempted encoders

EncodingFailed

Encoding failed at specific frame

Fields

frame: u64

Frame number where encoding failed

reason: String

Failure reason

InvalidConfig

Invalid configuration

Fields

reason: String

Configuration issue description

HwEncoderUnavailable

Hardware encoder unavailable

Fields

encoder: String

Hardware encoder name

EncoderUnavailable

Specific encoder is unavailable — the hint explains what is needed.

Fields

codec: String

Requested codec name (e.g. "h265/hevc").

hint: String

Human-readable guidance (e.g. how to build FFmpeg with this encoder).

MuxingFailed

Muxing failed

Fields

reason: String

Failure reason

Ffmpeg

FFmpeg error

Fields

code: i32

Raw FFmpeg error code (negative integer). 0 when no numeric code is available.

message: String

Human-readable error message from av_strerror or an internal description.

Io(Error)

IO error

InvalidOption

Invalid option value

Fields

name: String

Option name

reason: String

Description of the constraint that was violated

UnsupportedContainerCodecCombination

Codec is incompatible with the target container format

Fields

container: String

Container format name (e.g. "webm")

codec: String

Codec name that was rejected (e.g. "h264")

hint: String

Human-readable guidance on compatible codecs

InvalidDimensions

Video dimensions are outside the supported range [2, 32768].

Fields

width: u32

Requested frame width.

height: u32

Requested frame height.

InvalidBitrate

Target bitrate exceeds the 800 Mbps maximum.

Fields

bitrate: u64

Requested bitrate in bits per second.

InvalidChannelCount

Audio channel count exceeds the supported maximum of 8.

Fields

count: u32

Requested channel count.

InvalidSampleRate

Audio sample rate is outside the supported range [8000, 384000] Hz.

Fields

rate: u32

Requested sample rate in Hz.

Cancelled

Encoding cancelled by user

WorkerPanicked

Async encoder worker thread panicked or disconnected unexpectedly

MediaOperationFailed

A media operation (trim, extract, replace, …) failed.

Returned by StreamCopyTrim and other media_ops types when a structural precondition is violated or an FFmpeg mux/remux call fails.

Fields

reason: String

Human-readable description of the failure.

PresetConstraintViolation

An export preset violated a platform-specific constraint.

Returned by ExportPreset::validate() when the preset’s configuration conflicts with a platform rule (e.g. fps > 60 for a YouTube preset).

Fields

preset: String

Name of the preset that failed validation.

reason: String

Human-readable description of the violated constraint.

Trait Implementations

impl Debug for EncodeError

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

Formats the value using the given formatter.

impl Display for EncodeError

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

Formats the value using the given formatter.

impl Error for EncodeError

fn source(&self) -> Option<&(dyn Error + 'static)>

Returns the lower-level source of this error, if any.

fn description(&self) -> &str

👎Deprecated since 1.42.0:

use the Display impl or to_string()

fn cause(&self) -> Option<&dyn Error>

👎Deprecated since 1.33.0:

replaced by Error::source, which can support downcasting

fn provide<'a>(&'a self, request: &mut Request<'a>)

🔬This is a nightly-only experimental API. (error_generic_member_access)

Provides type-based access to context intended for error reports.

impl From<Error> for EncodeError

fn from(source: Error) -> Self

Converts to this type from the input type.