Enum Error 

#[non_exhaustive]
pub enum Error {
    InvalidOptions {
        reason: String,
    },
    Metadata {
        reason: String,
    },
    UnsupportedPixelData {
        reason: String,
    },
    Unsupported {
        reason: String,
    },
    SourceOpen {
        path: PathBuf,
        message: String,
    },
    Identity {
        reason: String,
    },
    SlideRead {
        message: String,
    },
    Encode {
        message: String,
    },
    FrameEncode {
        level: u32,
        row: u64,
        col: u64,
        message: String,
    },
    Io {
        path: PathBuf,
        source: Error,
    },
    DicomWrite {
        path: PathBuf,
        message: String,
    },
    Json {
        path: PathBuf,
        source: Error,
    },
    JsonSerialize {
        message: String,
    },
    ExportTransaction {
        recovery_path: PathBuf,
        reason: String,
    },
    Validation {
        reason: String,
    },
}

Error type returned by public wsi-dicom APIs.

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.

InvalidOptions

Export or validation options are internally inconsistent.

Fields

reason: String

Human-readable reason safe to show to users.

Metadata

Metadata is missing required fields or cannot be mapped safely.

Fields

reason: String

Human-readable reason safe to show to users.

UnsupportedPixelData

Source or prepared pixel data cannot be represented by the requested output.

Fields

reason: String

Human-readable reason safe to show to users.

Unsupported

The requested route, transfer syntax, or backend is unsupported.

Fields

reason: String

Human-readable reason safe to show to users.

SourceOpen

The source slide could not be opened.

Fields

path: PathBuf

Source path that failed to open.

message: String

Underlying open error message.

Identity

DICOM export identity generation failed.

Fields

reason: String

Human-readable identity generation failure.

SlideRead

The source slide failed while reading pixels or metadata.

Fields

message: String

Underlying read error message.

Encode

JPEG 2000 or HTJ2K encoding failed before a frame location was available.

Fields

message: String

Underlying encode error message.

FrameEncode

JPEG 2000 or HTJ2K encoding failed for one DICOM frame.

Fields

level: u32

Source pyramid level being encoded.

row: u64

DICOM tile row being encoded.

col: u64

DICOM tile column being encoded.

message: String

Underlying encode error message.

Io

Filesystem I/O failed at a known path.

Fields

path: PathBuf

Path involved in the failed I/O operation.

source: Error

Underlying I/O error.

DicomWrite

DICOM object construction or writing failed.

Fields

path: PathBuf

Destination path being written.

message: String

Underlying DICOM writer message.

Json

JSON parsing failed at a known path.

Fields

path: PathBuf

JSON path being read.

source: Error

Underlying JSON parser error.

JsonSerialize

JSON serialization failed.

Fields

message: String

Serialization error message.

ExportTransaction

A staged export could not be committed or rolled back completely.

Fields

recovery_path: PathBuf

Directory containing the durable manifest, staged files, and backups.

reason: String

Human-readable commit or rollback failure details.

Validation

External DICOM validation failed.

Fields

reason: String

Human-readable validation failure reason.

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.