Enum image::codecs::pnm::decoder::DecoderError

enum DecoderError {
    PnmMagicInvalid([u8; 2]),
    UnparsableValue(ErrorDataSource, String, ParseIntError),
    NonAsciiByteInHeader(u8),
    NonAsciiLineInPamHeader,
    NonAsciiSample,
    NotNewlineAfterP7Magic(u8),
    UnexpectedPnmHeaderEnd,
    HeaderLineDuplicated(PnmHeaderLine),
    HeaderLineUnknown(String),
    HeaderLineMissing {
        height: Option<u32>,
        width: Option<u32>,
        depth: Option<u32>,
        maxval: Option<u32>,
    },
    InputTooShort,
    UnexpectedByteInRaster(u8),
    SampleOutOfBounds(u8),
    MaxvalZero,
    MaxvalTooBig(u32),
    InvalidDepthOrMaxval {
        tuple_type: ArbitraryTuplType,
        depth: u32,
        maxval: u32,
    },
    InvalidDepth {
        tuple_type: ArbitraryTuplType,
        depth: u32,
    },
    TupleTypeUnrecognised,
    Overflow,
}

All errors that can occur when attempting to parse a PNM

Variants

PnmMagicInvalid([u8; 2])

PNM’s “P[123456]” signature wrong or missing

UnparsableValue(ErrorDataSource, String, ParseIntError)

Couldn’t parse the specified string as an integer from the specified source

NonAsciiByteInHeader(u8)

More than the exactly one allowed plane specified by the format

NonAsciiLineInPamHeader

The PAM header contained a non-ASCII byte

NonAsciiSample

A sample string contained a non-ASCII byte

NotNewlineAfterP7Magic(u8)

The byte after the P7 magic was not 0x0A NEWLINE

UnexpectedPnmHeaderEnd

The PNM header had too few lines

HeaderLineDuplicated(PnmHeaderLine)

The specified line was specified twice

HeaderLineUnknown(String)

The line with the specified ID was not understood

HeaderLineMissing

Fields

height: Option<u32>

width: Option<u32>

depth: Option<u32>

maxval: Option<u32>

At least one of the required lines were missing from the header (are None here)

Same names as PnmHeaderLine

InputTooShort

Not enough data was provided to the Decoder to decode the image

UnexpectedByteInRaster(u8)

Sample raster contained unexpected byte

SampleOutOfBounds(u8)

Specified sample was out of bounds (e.g. >1 in B&W)

MaxvalZero

The image’s maxval is zero

MaxvalTooBig(u32)

The image’s maxval exceeds 0xFFFF

InvalidDepthOrMaxval

Fields

tuple_type: ArbitraryTuplType

depth: u32

maxval: u32

The specified tuple type supports restricted depths and maxvals, those restrictions were not met

InvalidDepth

Fields

tuple_type: ArbitraryTuplType

depth: u32

The specified tuple type supports restricted depths, those restrictions were not met

TupleTypeUnrecognised

The tuple type was not recognised by the parser

Overflow

Overflowed the specified value when parsing

Trait Implementations

impl Clone for DecoderError

fn clone(&self) -> DecoderError

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for DecoderError

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

Formats the value using the given formatter.

impl Display for DecoderError

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

Formats the value using the given formatter.

impl Error for DecoderError

fn source(&self) -> Option<&(dyn Error + 'static)>

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<DecoderError> for ImageError

Note: should pnm be extracted into a separate crate, this will need to be hidden until that crate hits version 1.0.

fn from(e: DecoderError) -> ImageError

Converts to this type from the input type.