Enum Error 

#[non_exhaustive]
pub enum Error {
    Validation(ValidationError),
    Io(Error),
    Asset {
        kind: &'static str,
        source_name: String,
        cause: BoxedError,
    },
    Svg(BoxedError),
    Formula {
        message: String,
        source: Option<BoxedError>,
    },
    Parameters(BoxedError),
    Timeline {
        timeline: String,
        message: String,
    },
    GpuUnavailable(BoxedError),
    Gpu(BoxedError),
    DeviceLost(BoxedError),
    ScenePanic {
        timeline: String,
        frame: u64,
        message: String,
    },
    Encoder(BoxedError),
    Cancelled,
    AtFrame {
        frame: u64,
        cause: Box<Error>,
    },
    Other(BoxedError),
}

Engine failure retaining its original source and optional frame context.

Lower-level geometry APIs still return ValidationError directly. Converting them into this type retains all property/path information. Synchronous scene callbacks still unwind; workers turn caught payloads into ScenePanic.

use motion_core::{Error, ErrorKind};
let error = Error::from(std::io::Error::other("disk failure")).at_frame(12);
assert_eq!(error.kind(), ErrorKind::Io);
assert_eq!(error.frame(), Some(12));
assert!(error.downcast_ref::<std::io::Error>().is_some());

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.

Validation(ValidationError)

Detailed scene/property diagnostic.

Io(Error)

Original filesystem or operating-system error.

Asset

Named resource failure with the original decoder/load error.

Fields

kind: &'static str

Resource category, such as image, font or model.

source_name: String

User-facing resource identifier or source path.

cause: BoxedError

Original failure.

Svg(BoxedError)

SVG parser failure.

Formula

Formula compilation failure, optionally retaining structured diagnostics.

Fields

message: String

User-facing explanation.

source: Option<BoxedError>

Original structured diagnostics with source ranges, when available.

Parameters(BoxedError)

Invalid serialized project parameters.

Timeline

Timeline construction failure.

Fields

timeline: String

Timeline identifier.

message: String

Violated timing contract.

GpuUnavailable(BoxedError)

GPU setup failure; explicit GPU selection must not silently fall back.

Gpu(BoxedError)

GPU submission/readback failure without a confirmed device-loss callback.

DeviceLost(BoxedError)

Runtime GPU loss with its original driver error.

ScenePanic

Caught scene panic. The message is retained for string payloads.

Fields

timeline: String

Registered scene or timeline name.

frame: u64

Requested frame index.

message: String

Panic payload text, or a non-string-payload marker.

Encoder(BoxedError)

Native encoder failure with its original source.

Cancelled

Export was cancelled before destination commit.

AtFrame

An otherwise classified error annotated with a frame index.

Fields

frame: u64

Requested frame index.

cause: Box<Error>

Original classified error.

Other(BoxedError)

Extension error not covered by a more specific category.

Implementations

impl Error

pub fn report(&self) -> Option<&ErrorReport>

The report of several failures carried by this single error, if any.

pub fn asset( kind: &'static str, source_name: impl Into<String>, cause: impl StdError + Send + Sync + 'static, ) -> Self

Associates an original failure with a named resource load.

pub fn formula(message: impl Into<String>) -> Self

Formula failure without structured diagnostics.

pub fn formula_with_source( message: impl Into<String>, source: impl StdError + Send + Sync + 'static, ) -> Self

Formula failure retaining its structured diagnostics as the source.

pub fn kind(&self) -> ErrorKind

Classifies an error independently of any frame annotation.

pub fn frame(&self) -> Option<u64>

Frame of failure, if supplied by rendering or a worker boundary.

pub fn at_frame(self, frame: u64) -> Self

Attaches a frame without replacing a more specific existing frame. Validation diagnostics keep their original concrete type and fields.

pub fn downcast_ref<T: StdError + 'static>(&self) -> Option<&T>

Finds an original concrete error through the complete source chain. This preserves property-diagnostic queries without parsing display strings.

pub fn scene_panic( timeline: impl Into<String>, frame: u64, payload: Box<dyn Any + Send>, ) -> Self

Classifies a caught scene panic while preserving its scene and frame.

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 StdError + '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<Box<dyn Error + Sync + Send>> for Error

fn from(error: BoxedError) -> Self

Converts to this type from the input type.

impl From<Error> for Error

fn from(error: Error) -> Self

Converts to this type from the input type.

impl From<Error> for ErrorReport

fn from(error: Error) -> Self

Converts to this type from the input type.

impl From<ErrorReport> for Error

fn from(report: ErrorReport) -> Self

Converts to this type from the input type.

impl From<RecvError> for Error

fn from(error: RecvError) -> Self

Converts to this type from the input type.

impl From<TryFromSliceError> for Error

fn from(error: TryFromSliceError) -> Self

Converts to this type from the input type.

impl From<TryReserveError> for Error

fn from(error: TryReserveError) -> Self

Converts to this type from the input type.

impl From<Utf8Error> for Error

fn from(error: Utf8Error) -> Self

Converts to this type from the input type.

impl From<ValidationError> for Error

fn from(error: ValidationError) -> Self

Converts to this type from the input type.

impl From<VarError> for Error

fn from(error: VarError) -> Self

Converts to this type from the input type.