Enum PreviewError 

pub enum PreviewError {
    FileNotFound {
        path: PathBuf,
    },
    NoVideoStream {
        path: PathBuf,
    },
    SeekFailed {
        target: Duration,
        reason: String,
    },
    Decode(DecodeError),
    Ffmpeg {
        code: i32,
        message: String,
    },
    Probe(ProbeError),
    Pipeline(PipelineError),
    Io(Error),
    SeekOutOfRange {
        pts: Duration,
    },
    NeedsGpuCompositor {
        reason: String,
    },
    DecodeThreadPoisoned,
}

Errors that can occur during preview and proxy operations.

Variants

FileNotFound

The media file was not found at the specified path.

Fields

path: PathBuf

Path that was not found.

NoVideoStream

The media file has no video stream.

Fields

path: PathBuf

Path to the media file.

SeekFailed

A seek operation failed.

Fields

target: Duration

Target timestamp of the failed seek.

reason: String

Human-readable reason for the failure.

Decode(DecodeError)

An underlying decode error occurred.

Ffmpeg

A raw FFmpeg error.

code is the negative integer returned by the FFmpeg API, or 0 when no numeric code is available. message is from av_strerror or an internal description.

Fields

code: i32

Raw FFmpeg error code (negative i32). 0 when no numeric code is available.

message: String

Human-readable message from av_strerror or an internal description.

Probe(ProbeError)

A probe error while analysing the media file.

Pipeline(PipelineError)

A proxy generation pipeline error.

Io(Error)

An I/O error during file operations.

SeekOutOfRange

A seek target lies outside the valid range of the timeline.

Fields

pts: Duration

The requested presentation timestamp that fell outside all clips.

NeedsGpuCompositor

The scene needs the GPU compositor for something the CPU compositor refuses to build.

Raised at open time so a timeline that cannot play correctly on this machine fails before decoding starts, instead of showing frames with the offending layer silently missing.

Fields

reason: String

What the CPU compositor refused, and where in the scene.

DecodeThreadPoisoned

The background decode thread panicked and could not be recovered.

The buffer cannot continue decoding; recover at the application level by rebuilding it (e.g. reopen the file). This replaces an earlier internal panic on the same condition.

Trait Implementations

impl Debug for PreviewError

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

Formats the value using the given formatter.

impl Display for PreviewError

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

Formats the value using the given formatter.

impl Error for PreviewError

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 PreviewError

fn from(source: DecodeError) -> Self

Converts to this type from the input type.

impl From<Error> for PreviewError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<PipelineError> for PreviewError

fn from(source: PipelineError) -> Self

Converts to this type from the input type.

impl From<ProbeError> for PreviewError

fn from(source: ProbeError) -> Self

Converts to this type from the input type.

impl MediaError for PreviewError

fn severity(&self) -> ErrorSeverity

Classifies this error.

fn is_recoverable(&self) -> bool

Returns true if the failing operation can be retried without rebuilding.

fn is_fatal(&self) -> bool

Returns true if the component must be discarded or reconfigured.