Enum Error 

#[non_exhaustive]
pub enum Error {
    NotStarted,
    Url(UrlError),
    OpenInputStream(OpenInputError),
    FindStream(FindStreamError),
    Decoder(DecoderError),
    FilterGraphParse(FilterGraphParseError),
    FilterDescUtf8,
    FilterNameUtf8,
    FilterZeroOutputs,
    FilterZeroInputs,
    ParseInteger,
    AllocOutputContext(AllocOutputContextError),
    OpenOutput(OpenOutputError),
    FileSameAsInput(String),
    FindDevices(FindDevicesError),
    AllocFrame(AllocFrameError),
    AllocPacket(AllocPacketError),
    FrameWritable(FrameWritableError),
    Muxing(MuxingOperationError),
    OpenEncoder(OpenEncoderOperationError),
    Encoding(EncodingOperationError),
    FilterGraph(FilterGraphOperationError),
    OpenDecoder(OpenDecoderOperationError),
    Decoding(DecodingOperationError),
    Demuxing(DemuxingOperationError),
    PacketScanner(PacketScannerError),
    FrameFilterInit(Box<dyn Error + Send + Sync>),
    FrameFilterProcess(Box<dyn Error + Send + Sync>),
    FrameFilterRequest(Box<dyn Error + Send + Sync>),
    FrameFilterTypeNoMatched(String, String),
    FrameFilterStreamTypeNoMatched(String, usize, String),
    FrameFilterDstFinished,
    FrameFilterFrameDuplicateFailed,
    FrameFilterThreadExited,
    WorkerPanicked(String),
    StartFailed,
    RtmpStreamAlreadyExists(String),
    RtmpCreateStream,
    RtmpRegistrationQueueFull,
    RtmpThreadExited,
    RtmpStreamClosed,
    RtmpServerAlreadyStarted,
    Subtitle(SubtitleError),
    WgpuFilter(WgpuFilterError),
    OpenGLFilter(OpenGLFilterError),
    IO(Error),
    EOF,
    Exit,
    Bug,
    InvalidRecipeArg(String),
    ContainerInfo(ContainerInfoError),
    FrameExport(FrameExportError),
    Writer(WriterError),
    Push(PushError),
    FrameSourceThreadExited,
    PacketSink(PacketSinkError),
    AmbiguousVideoSource {
        video_streams: usize,
    },
    UnconsumedCliOption {
        site: String,
        option: String,
    },
}

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.

NotStarted

Url(UrlError)

OpenInputStream(OpenInputError)

FindStream(FindStreamError)

Decoder(DecoderError)

FilterGraphParse(FilterGraphParseError)

FilterDescUtf8

FilterNameUtf8

FilterZeroOutputs

FilterZeroInputs

ParseInteger

AllocOutputContext(AllocOutputContextError)

OpenOutput(OpenOutputError)

FileSameAsInput(String)

FindDevices(FindDevicesError)

AllocFrame(AllocFrameError)

AllocPacket(AllocPacketError)

FrameWritable(FrameWritableError)

Muxing(MuxingOperationError)

OpenEncoder(OpenEncoderOperationError)

Encoding(EncodingOperationError)

FilterGraph(FilterGraphOperationError)

OpenDecoder(OpenDecoderOperationError)

Decoding(DecodingOperationError)

Demuxing(DemuxingOperationError)

PacketScanner(PacketScannerError)

FrameFilterInit(Box<dyn Error + Send + Sync>)

FrameFilterProcess(Box<dyn Error + Send + Sync>)

FrameFilterRequest(Box<dyn Error + Send + Sync>)

FrameFilterTypeNoMatched(String, String)

FrameFilterStreamTypeNoMatched(String, usize, String)

FrameFilterDstFinished

FrameFilterFrameDuplicateFailed

FrameFilterThreadExited

WorkerPanicked(String)

StartFailed

Recorded as the scheduler result when start() fails after some worker threads were already launched. start() itself returns the actual init error to its caller; this recorded value is what concurrent observers (packet-sink terminal callbacks) report, so a sink can never mistake a torn-down startup for a settled-Ok job.

RtmpStreamAlreadyExists(String)

RtmpCreateStream

RtmpRegistrationQueueFull

RtmpThreadExited

RtmpStreamClosed

RtmpServerAlreadyStarted

Subtitle(SubtitleError)

WgpuFilter(WgpuFilterError)

OpenGLFilter(OpenGLFilterError)

IO(Error)

EOF

Exit

Bug

InvalidRecipeArg(String)

ContainerInfo(ContainerInfoError)

FrameExport(FrameExportError)

Writer(WriterError)

Push(PushError)

FrameSourceThreadExited

PacketSink(PacketSinkError)

AmbiguousVideoSource

CLI-compat pipelines only: a -vf command was lowered onto an input whose OPENED demuxer does not carry exactly one video stream. The check runs on the demuxer instance the pipeline actually executes with (no separate probe opening, no TOCTOU window). The facade maps this to its public AmbiguousFilterSource diagnostic.

Fields

video_streams: usize

UnconsumedCliOption

Strict AVOption handling (CLI-compat pipelines): an option the caller supplied was not consumed by the component it targeted. The default builder path only WARNS about such leftovers; pipelines built through the cli feature’s entry points fail instead, mirroring fftools’ check_avoptions abort. Only exists with the cli feature — the feature-off API surface is unchanged.

Fields

site: String

option: String

Trait Implementations

impl Debug for Error

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

Formats the value using the given formatter.

impl Display for Error

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

Formats the value using the given formatter.

impl Error for Error

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

fn from(source: AllocFrameError) -> Self

Converts to this type from the input type.

impl From<AllocOutputContextError> for Error

fn from(source: AllocOutputContextError) -> Self

Converts to this type from the input type.

impl From<AllocPacketError> for Error

fn from(source: AllocPacketError) -> Self

Converts to this type from the input type.

impl From<ContainerInfoError> for Error

fn from(source: ContainerInfoError) -> Self

Converts to this type from the input type.

impl From<DecoderError> for Error

fn from(source: DecoderError) -> Self

Converts to this type from the input type.

impl From<DecodingOperationError> for Error

fn from(source: DecodingOperationError) -> Self

Converts to this type from the input type.

impl From<DemuxingOperationError> for Error

fn from(source: DemuxingOperationError) -> Self

Converts to this type from the input type.

impl From<EncodingOperationError> for Error

fn from(source: EncodingOperationError) -> Self

Converts to this type from the input type.

impl From<Error> for CliError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<Error> for Error

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<Error> for StreamError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<FilterGraphOperationError> for Error

fn from(source: FilterGraphOperationError) -> Self

Converts to this type from the input type.

impl From<FilterGraphParseError> for Error

fn from(source: FilterGraphParseError) -> Self

Converts to this type from the input type.

impl From<FindDevicesError> for Error

fn from(source: FindDevicesError) -> Self

Converts to this type from the input type.

impl From<FindStreamError> for Error

fn from(source: FindStreamError) -> Self

Converts to this type from the input type.

impl From<FrameExportError> for Error

fn from(source: FrameExportError) -> Self

Converts to this type from the input type.

impl From<FrameWritableError> for Error

fn from(source: FrameWritableError) -> Self

Converts to this type from the input type.

impl From<MuxingOperationError> for Error

fn from(source: MuxingOperationError) -> Self

Converts to this type from the input type.

impl From<NulError> for Error

fn from(err: NulError) -> Self

Converts to this type from the input type.

impl From<OpenDecoderOperationError> for Error

fn from(source: OpenDecoderOperationError) -> Self

Converts to this type from the input type.

impl From<OpenEncoderOperationError> for Error

fn from(source: OpenEncoderOperationError) -> Self

Converts to this type from the input type.

impl From<OpenGLFilterError> for Error

Available on crate feature opengl only.

fn from(err: OpenGLFilterError) -> Self

Converts to this type from the input type.

impl From<OpenInputError> for Error

fn from(source: OpenInputError) -> Self

Converts to this type from the input type.

impl From<OpenOutputError> for Error

fn from(source: OpenOutputError) -> Self

Converts to this type from the input type.

impl From<PacketScannerError> for Error

fn from(source: PacketScannerError) -> Self

Converts to this type from the input type.

impl From<PacketSinkError> for Error

fn from(source: PacketSinkError) -> Self

Converts to this type from the input type.

impl From<PushError> for Error

fn from(source: PushError) -> Self

Converts to this type from the input type.

impl From<SubtitleError> for Error

fn from(source: SubtitleError) -> Self

Converts to this type from the input type.

impl From<UrlError> for Error

fn from(source: UrlError) -> Self

Converts to this type from the input type.

impl From<WgpuFilterError> for Error

fn from(source: WgpuFilterError) -> Self

Converts to this type from the input type.

impl From<WriterError> for Error

fn from(source: WriterError) -> Self

Converts to this type from the input type.

impl PartialEq for Error

fn eq(&self, other: &Self) -> bool

Structural equality for payload-less variants only. Variants carrying an inner error compare unequal even to themselves — use matches! on the variant when that is what you mean.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.