Enum JpegEncodeError 

pub enum JpegEncodeError {
    EmptyDimensions,
    DimensionsTooLarge {
        width: u32,
        height: u32,
    },
    SampleLength {
        expected: usize,
        actual: usize,
    },
    MemoryCapExceeded {
        requested: usize,
        cap: usize,
    },
    HostAllocationFailed {
        bytes: usize,
    },
    IncompatibleSubsampling {
        subsampling: JpegSubsampling,
        samples: &'static str,
    },
    InvalidRestartInterval,
    UnsupportedBackend {
        backend: JpegBackend,
    },
    SegmentTooLarge {
        name: &'static str,
    },
    MissingHuffmanCode {
        symbol: u8,
    },
    InvalidDctImage {
        reason: JpegDctImageError,
    },
    InternalInvariant {
        reason: &'static str,
    },
}

Errors produced by baseline JPEG encoding.

Variants

EmptyDimensions

Width or height was zero.

DimensionsTooLarge

JPEG baseline SOF dimensions exceed the 16-bit marker fields.

Fields

width: u32

Requested width in pixels.

height: u32

Requested height in pixels.

SampleLength

Input sample buffer length does not match width, height, and format.

Fields

expected: usize

Required byte count.

actual: usize

Supplied byte count.

MemoryCapExceeded

A sample layout or encoded output exceeds the shared host allocation cap.

Fields

requested: usize

Required byte count, saturated when arithmetic overflows.

cap: usize

Maximum accepted host allocation size.

HostAllocationFailed

A required host buffer could not reserve its capacity.

Fields

bytes: usize

Requested allocation size in bytes.

IncompatibleSubsampling

Requested subsampling is incompatible with the supplied sample format.

Fields

subsampling: JpegSubsampling

Requested output sampling.

samples: &'static str

Human-readable sample format name.

InvalidRestartInterval

Restart interval was explicitly set to zero.

UnsupportedBackend

Requested backend is not available in this crate.

Fields

backend: JpegBackend

Requested backend.

SegmentTooLarge

A marker segment would exceed the JPEG 16-bit length field.

Fields

name: &'static str

Marker segment name.

MissingHuffmanCode

Encoder attempted to emit a symbol absent from the active Huffman table.

Fields

symbol: u8

Missing entropy symbol.

InvalidDctImage

Caller-supplied coefficient-domain input cannot be re-emitted as baseline JPEG.

Fields

reason: JpegDctImageError

Typed invalid-input reason.

InternalInvariant

A heap-free diagnostic for an impossible encoder state.

Fields

reason: &'static str

Static invariant description.

Trait Implementations

impl Clone for JpegEncodeError

fn clone(&self) -> JpegEncodeError

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for JpegEncodeError

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

Formats the value using the given formatter.

impl Display for JpegEncodeError

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

Formats the value using the given formatter.

impl Error for JpegEncodeError

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.