Enum FlameError 

pub enum FlameError {
    Io(Error),
    NpyLoad {
        name: String,
        source: ReadNpyError,
    },
    ShapeMismatch {
        name: String,
        expected: String,
        got: String,
    },
    ModelDir(String),
    InvalidParams(String),
    Export {
        format: String,
        reason: String,
    },
    Animation {
        frame: usize,
        reason: String,
    },
    Landmark {
        index: usize,
        reason: String,
    },
    Transfer {
        reason: String,
    },
    Numerical {
        reason: String,
    },
    IndexOutOfBounds {
        context: String,
        index: usize,
        len: usize,
    },
    SafeTensorsLoad {
        path: PathBuf,
        message: String,
    },
    SafeTensorsSave {
        path: PathBuf,
        message: String,
    },
    SafeTensorsMissing {
        name: String,
        message: String,
    },
    SafeTensorsInvalidDtype {
        name: String,
        expected: String,
        got: String,
    },
    IoError {
        source: Error,
        path: PathBuf,
    },
}

Errors that can occur when working with the FLAME model.

Variants

Io(Error)

I/O error reading model files.

NpyLoad

Error loading .npy array data.

Fields

name: String

source: ReadNpyError

ShapeMismatch

Array shape does not match expected dimensions.

Fields

name: String

expected: String

got: String

ModelDir(String)

Model directory does not exist or is missing required files.

InvalidParams(String)

Invalid parameter dimensions.

Export

Export failed (OBJ/PLY/glTF).

Fields

format: String

Export format (e.g., “OBJ”, “PLY”, “glTF”).

reason: String

Detailed reason for failure.

Animation

Animation sequence error.

Fields

frame: usize

Frame index where error occurred.

reason: String

Detailed reason for failure.

Landmark

Landmark detection or projection error.

Fields

index: usize

Landmark index that caused the error.

reason: String

Detailed reason for failure.

Transfer

Expression transfer failure.

Fields

reason: String

Detailed reason for failure.

Numerical

Numerical computation error (e.g., matrix inversion failure).

Fields

reason: String

Detailed reason for failure.

IndexOutOfBounds

Index out of bounds error.

Fields

context: String

Context where the error occurred.

index: usize

The invalid index.

len: usize

The maximum valid length.

SafeTensorsLoad

Error loading safetensors file.

Fields

path: PathBuf

Path to the safetensors file.

message: String

Error details.

SafeTensorsSave

Error saving safetensors file.

Fields

path: PathBuf

Path to the safetensors file.

message: String

Error details.

SafeTensorsMissing

Missing tensor in safetensors file.

Fields

name: String

Name of the missing tensor.

message: String

Error details.

SafeTensorsInvalidDtype

Invalid dtype in safetensors tensor.

Fields

name: String

Name of the tensor.

expected: String

Expected dtype.

got: String

Actual dtype.

IoError

I/O error with path context.

Fields

source: Error

The I/O error source.

path: PathBuf

Path where error occurred.

Implementations

impl FlameError

pub fn export(format: impl Into<String>, reason: impl Into<String>) -> Self

Create an export error with format and reason.

pub fn animation(frame: usize, reason: impl Into<String>) -> Self

Create an animation error with frame and reason.

pub fn landmark(index: usize, reason: impl Into<String>) -> Self

Create a landmark error with index and reason.

pub fn transfer(reason: impl Into<String>) -> Self

Create a transfer error with reason.

pub fn numerical(reason: impl Into<String>) -> Self

Create a numerical error with reason.

pub fn index_out_of_bounds( context: impl Into<String>, index: usize, len: usize, ) -> Self

Create an index out of bounds error.

Trait Implementations

impl Debug for FlameError

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

Formats the value using the given formatter.

impl Display for FlameError

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

Formats the value using the given formatter.

impl Error for FlameError

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

fn from(source: Error) -> Self

Converts to this type from the input type.