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,
    },
    Cancelled,
    WorkerPanicked,
}

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

Cancelled

Encoding cancelled by user

WorkerPanicked

Async encoder worker thread panicked or disconnected unexpectedly

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.