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),
    SimpleFilterMediaTypeMismatch {
        desc: String,
        found: &'static str,
        expected: &'static str,
    },
}

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

InvalidArgument

NotFound

IOError

PipeError

BadFileDescriptor

NotImplemented

OperationNotPermitted

PermissionDenied

Timeout

EncoderNotFound

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

MatchesNoStreams(String)

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

what: &'static str

InvalidLabel(String)

NotContainStream

UnknownFrameFormat

InvalidFileIndexInIntput(usize, String)

UnknownError(i32)

InvalidSink

SeekFunctionMissing

FormatUnsupported(String)

UnknownPixelFormat(String)

UnknownSampleFormat(String)

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)

AttachmentEmpty(String)

AttachmentTooLarge(String, u64, u64)

AttachmentEmptyMimetype(String)

FilterWithStreamCopy(String)

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

SimpleAndComplexFilter(String)

A per-output video filter (Output::set_video_filter) was set on an output whose video stream is fed by a context-level filtergraph (FfmpegContextBuilder::filter_desc). Mirrors the FFmpeg CLI error for -vf + -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

reason: String

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.

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.