Enum BlpError 

pub enum BlpError {
    Io(Error),
    InvalidMagic,
    InvalidFormatVersion(u32),
    UnsupportedEncoding(u8),
    NoMipmaps,
    OutOfBounds,
    DataTooShort,
    ImageTooLarge,
    JpegDecode(String),
}

All errors that can be returned by this crate.

Variants

Io(Error)

An I/O error occurred while reading the file or buffer.

InvalidMagic

The first four bytes of the file are not a recognised BLP magic number (BLP0, BLP1, or BLP2).

InvalidFormatVersion(u32)

A BLP2 file declared a format version other than 1.

UnsupportedEncoding(u8)

The color encoding byte is not one of the five known values (JPEG=0, Palette=1, DXT=2, ARGB8888=3, ARGB8888Dup=4).

NoMipmaps

[BlpFile::get_pixels] was called on a file whose mipmap offset table contains no non-zero entries.

OutOfBounds

A mipmap offset/size pair points outside the bounds of the file buffer, or offset + size overflows usize.

DataTooShort

The mipmap data slice is present but shorter than the decoded image requires (e.g. palette indices are truncated, or alpha bytes are missing).

ImageTooLarge

The declared image dimensions (width × height × 4) would exceed the 256 MiB allocation ceiling, or the multiplication overflows usize.

JpegDecode(String)

JPEG decoding failed. The inner string contains the decoder’s error message.

Trait Implementations

impl Debug for BlpError

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

Formats the value using the given formatter.

impl Display for BlpError

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

Formats the value using the given formatter.

impl Error for BlpError

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 BlpError

fn from(source: Error) -> Self

Converts to this type from the input type.