Enum PipelineError 

pub enum PipelineError {
    Decode(DecodeError),
    Filter(FilterError),
    Encode(EncodeError),
    NoInput,
    NoOutput,
    SecondaryInputWithoutFilter,
    Cancelled,
    Io(Error),
    FrameNotAvailable,
    TimelineRenderFailed {
        reason: String,
    },
    ClipNotFound {
        path: String,
    },
}

Errors that can occur while building or running a pipeline.

Error Categories

• Downstream errors: Decode, Filter, Encode — propagated from the underlying crates via #[from]
• Configuration errors: NoInput, NoOutput, SecondaryInputWithoutFilter — returned by PipelineBuilder::build
• Runtime control: Cancelled — returned by Pipeline::run when the progress callback returns false
• Availability: FrameNotAvailable — no frame at position

Variants

Decode(DecodeError)

A decoding step failed.

Wraps ff_decode::DecodeError and is produced automatically via #[from] when a decode operation inside the pipeline returns an error.

Filter(FilterError)

A filter graph step failed.

Wraps ff_filter::FilterError and is produced automatically via #[from] when the filter graph inside the pipeline returns an error.

Encode(EncodeError)

An encoding step failed.

Wraps ff_encode::EncodeError and is produced automatically via #[from] when an encode operation inside the pipeline returns an error.

NoInput

No input path was provided to the builder.

At least one call to PipelineBuilder::input is required before PipelineBuilder::build.

NoOutput

No output path and config were provided to the builder.

A call to PipelineBuilder::output is required before PipelineBuilder::build.

SecondaryInputWithoutFilter

secondary_input() was called but no filter graph was provided.

A secondary input only makes sense when a multi-slot filter is set via PipelineBuilder::filter.

Cancelled

The pipeline was cancelled by the progress callback.

Returned by Pipeline::run when the ProgressCallback returns false.

Io(Error)

An I/O error (e.g. creating the output directory for thumbnails).

FrameNotAvailable

No frame was available at the requested position.

Returned by thumbnail and seek-and-decode operations when the decoder reports Ok(None) — the position is past the end of the stream or no decodable frame exists at that point.

TimelineRenderFailed

A Timeline::render() call failed for a structural reason not covered by a nested variant (e.g. PipelineError::Encode or PipelineError::Filter).

Fields

reason: String

Human-readable description of the failure.

ClipNotFound

A clip’s source file could not be found on disk.

Returned by TimelineBuilder::build() and Timeline::render() when Clip.source does not exist.

Fields

path: String

Absolute or relative path that could not be found.

Trait Implementations

impl Debug for PipelineError

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

Formats the value using the given formatter.

impl Display for PipelineError

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

Formats the value using the given formatter.

impl Error for PipelineError

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<DecodeError> for PipelineError

fn from(source: DecodeError) -> Self

Converts to this type from the input type.

impl From<EncodeError> for PipelineError

fn from(source: EncodeError) -> Self

Converts to this type from the input type.

impl From<Error> for PipelineError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<FilterError> for PipelineError

fn from(source: FilterError) -> Self

Converts to this type from the input type.