Enum OpenOutputError 

#[non_exhaustive]
pub enum OpenOutputError {
    OutOfMemory,
    InvalidArgument,
    NotFound,
    IOError,
    PipeError,
    BadFileDescriptor,
    NotImplemented,
    OperationNotPermitted,
    PermissionDenied,
    Timeout,
    EncoderNotFound,
    EncoderUnavailable {
        name: String,
    },
    MatchesNoStreams(String),
    StreamMapCopyConflict {
        spec: String,
        what: &'static str,
    },
    InvalidLabel(String),
    NotContainStream,
    UnknownFrameFormat,
    InvalidFileIndexInIntput(usize, String),
    UnknownError(i32),
    InvalidSink,
    SeekFunctionMissing,
    FormatUnsupported(String),
    UnknownPixelFormat(String),
    UnknownSampleFormat(String),
    InvalidOption(String),
    AttachmentRead(String, Error),
    AttachmentEmpty(String),
    AttachmentTooLarge(String, u64, u64),
    AttachmentEmptyMimetype(String),
    FilterWithStreamCopy(String),
    SimpleAndComplexFilter(String),
    SimpleFilterInvalidShape {
        desc: String,
        reason: String,
    },
    VideoFilterUnused(String),
    AudioFilterUnused(String),
    SimpleFilterMediaTypeMismatch {
        desc: String,
        found: &'static str,
        expected: &'static str,
    },
}

Errors from opening and configuring an output: resolving formats and encoders, mapping streams, validating options, and opening the target for writing.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

OutOfMemory

Memory allocation failed (AVERROR(ENOMEM)).

InvalidArgument

FFmpeg rejected an argument as invalid (AVERROR(EINVAL)).

NotFound

The file or stream does not exist (AVERROR(ENOENT)).

IOError

A low-level I/O error occurred (AVERROR(EIO)).

PipeError

The stream or data connection was broken (AVERROR(EPIPE)).

BadFileDescriptor

An invalid file descriptor was used (AVERROR(EBADF)).

NotImplemented

The functionality or output format is not supported by the linked FFmpeg build (AVERROR(ENOSYS)).

OperationNotPermitted

The operation was not permitted (AVERROR(EPERM)).

PermissionDenied

Permission was denied (AVERROR(EACCES)).

Timeout

The operation timed out (AVERROR(ETIMEDOUT)).

EncoderNotFound

No encoder was found for the requested codec (AVERROR_ENCODER_NOT_FOUND).

EncoderUnavailable

A named encoder could not be opened because the linked FFmpeg build does not provide it — either it was compiled without that encoder (e.g. no --enable-libx264) or the name is not a known encoder at all. Unlike the bare EncoderNotFound errno mapping, this names the encoder so the fix is actionable. name is the encoder the caller requested, or the codec the output format guessed when none was set explicitly.

Fields

name: String

The requested encoder name, or the format’s guessed default codec when none was set explicitly.

MatchesNoStreams(String)

Returned when a stream map specifier matches no streams; the payload is the specifier.

StreamMapCopyConflict

A stream map combined stream copy with a per-map re-encoding request (StreamMap::codec / StreamMap::codec_opt): copied packets never pass through an encoder, so a per-map codec or per-map codec options could never take effect. Raised at build() instead of silently ignoring the request (the FFmpeg CLI merely warns about such unused options).

Fields

spec: String

The offending stream map specifier.

what: &'static str

The per-map re-encoding setting that conflicts with copy.

InvalidLabel(String)

Returned when an output references an invalid filtergraph link label; the payload is the label.

NotContainStream

Returned when the output ends up with no streams at all.

UnknownFrameFormat

Returned when the format of the frame feeding an output stream is unknown, so encoder parameters cannot be derived from it.

InvalidFileIndexInIntput(usize, String)

Returned when an input URL references a file index that does not exist; fields are the index and the URL.

UnknownError(i32)

Any other failure; the payload is the raw FFmpeg error code (rendered with av_err2str in the message).

InvalidSink

Returned when the output has no usable destination: neither a URL nor a custom write callback was configured.

SeekFunctionMissing

Returned when the output format requires seeking but the custom output sink provides no seek callback.

FormatUnsupported(String)

Returned when the requested output format name is unknown to FFmpeg; the payload is the requested name.

UnknownPixelFormat(String)

Returned when a pixel format name is not recognized; the payload is the name.

UnknownSampleFormat(String)

Returned when a sample format name is not recognized; the payload is the name.

InvalidOption(String)

A builder option carried an invalid value (e.g. a malformed set_force_key_frames spec, an out-of-range set_io_buffer_size). Setters store values as given and defer validation to open time, so a bad value surfaces here instead of panicking in the setter or forcing a Result into the middle of a builder chain.

AttachmentRead(String, Error)

Returned when reading an attachment file fails; the payload is the path, with the underlying I/O error as the source.

AttachmentEmpty(String)

Returned when an attachment file is empty; the payload is the path.

AttachmentTooLarge(String, u64, u64)

Returned when an attachment file exceeds the size limit; fields are the path, its size in bytes, and the limit in bytes.

AttachmentEmptyMimetype(String)

Returned when an attachment was configured with an empty mimetype; the payload is the file path.

FilterWithStreamCopy(String)

A per-output simple filter (Output::set_video_filter or Output::set_audio_filter) was combined with stream copy for the same output stream — either set_video_codec("copy") / set_audio_codec("copy") or a copy stream map covering that stream. Mirrors the FFmpeg CLI error for -vf/-af + -c copy (“Filtering and streamcopy cannot be used together”, ffmpeg_mux_init.c streamcopy_init).

SimpleAndComplexFilter(String)

A per-output simple filter (Output::set_video_filter or Output::set_audio_filter) was set on an output whose matching stream is fed by a context-level filtergraph (FfmpegContextBuilder::filter_desc). Mirrors the FFmpeg CLI error for -vf/-af + -filter_complex on the same stream (ffmpeg_mux_init.c ost_get_filters: “Simple and complex filtering cannot be used together for the same stream”).

SimpleFilterInvalidShape

A per-output simple filtergraph must be one connected linear chain: exactly one video input pad, one video output pad, a single connected component, and a directed path from the input to the output (fftools fg_create_simple’s contract plus the topology rules a simple graph implies — a disconnected or unreachable description would encode unrelated frames or hang instead of filtering the stream). The path requirement is structural: the input pad must be wired into the flow that feeds the output pad, while a filter that may discard it at runtime (streamselect whose applied map selects another input — rewritable mid-stream via sendcmd) is accepted, matching the CLI. reason names the violated rule. Descriptions that split, merge or source streams belong in the context-level filter_desc.

Fields

desc: String

The offending filtergraph description, as configured.

reason: String

The topology rule the description violates.

VideoFilterUnused(String)

A configured Output::set_video_filter chain that no re-encoded video stream ended up consuming: the output has no video stream at all (audio-only input, disable_video(), or maps that matched no video stream). The ffmpeg CLI silently ignores -vf in that situation; the crate refuses instead of dropping configuration on the floor.

AudioFilterUnused(String)

A configured Output::set_audio_filter chain that no re-encoded audio stream ended up consuming: the output has no audio stream at all (video-only input, disable_audio(), or maps that matched no audio stream). The ffmpeg CLI silently ignores -af in that situation; the crate refuses instead of dropping configuration on the floor.

SimpleFilterMediaTypeMismatch

A per-output simple filtergraph’s pads must match the stream’s media type (fftools fg_create_simple: “Filtergraph has a %s output, cannot connect it to %s output stream”) — e.g. an audio chain like anull cannot be attached as a video filter.

The media-type labels are static ("video", "audio", … — the strings fftools prints), which keeps this variant inside Error’s 64-byte layout; three owned Strings would grow every hot-path Result in the crate.

Fields

desc: String

The offending filtergraph description, as configured.

found: &'static str

The media type of the mismatched pad.

expected: &'static str

The media type the output stream requires.

Trait Implementations

impl Debug for OpenOutputError

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

Formats the value using the given formatter.

impl Display for OpenOutputError

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

Formats the value using the given formatter.

impl Error for OpenOutputError

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<OpenOutputError> for Error

fn from(source: OpenOutputError) -> Self

Converts to this type from the input type.

impl From<i32> for OpenOutputError

fn from(err_code: i32) -> Self

Converts to this type from the input type.