Enum AtxError 

pub enum AtxError {
    NotAtx {
        found: Vec<u8>,
    },
    NoHead,
    NoPayload,
    UnsupportedPixelFormat {
        pixel_format: (u32, u32),
    },
    InvalidDimensions {
        width: u32,
        height: u32,
    },
    PayloadTooSmall {
        got: usize,
        expected: usize,
    },
    Decompress(String),
    AstcDecode(String),
}

Errors from reading or decoding an ATX container.

Bad magic is a bootstrap failure (the buffer is not an ATX container at all) and fails loud. Per-artifact misses after a validated magic — a missing HEAD, a truncated chunk — degrade to Atx::warnings rather than an error, so the chunk inventory and any metadata still reach the caller.

Variants

NotAtx

The buffer does not begin with the 8-byte AAPL magic.

Fields

found: Vec<u8>

The leading bytes actually present (up to 8).

NoHead

No HEAD chunk was present, so no metadata could be parsed.

NoPayload

No astc/ASTC/LZFS texture payload chunk was present.

UnsupportedPixelFormat

The pixel-format discriminator is not a recognized ASTC 4x4 mapping. The raw pair is surfaced so the analyst can identify it.

Fields

pixel_format: (u32, u32)

The raw (a, b) discriminator pair from HEAD.

InvalidDimensions

HEAD declared dimensions that cannot form an image.

Fields

width: u32

Declared width.

height: u32

Declared height.

PayloadTooSmall

The texture payload was smaller than the declared geometry requires.

Fields

got: usize

Bytes actually present.

expected: usize

Bytes the padded ASTC geometry requires.

Decompress(String)

LZFSE decompression of an LZFS payload failed.

AstcDecode(String)

The ASTC decoder failed to consume the (de-tiled) block stream.

Trait Implementations

impl Debug for AtxError

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

Formats the value using the given formatter.

impl Display for AtxError

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

Formats the value using the given formatter.

impl Error for AtxError

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.