Enum JpegCompressError 

pub enum JpegCompressError {
    NotEightBit,
    UnsupportedArrayStructure,
    UnknownColorMode(i32),
    EncodeFailed,
}

Why compress_jpeg refused an array, carrying the exact errorMessage C writes at that rejection point.

C’s compressJPEG sets a different string at each failure and the plugin copies it verbatim into the CodecError PV, so the message is part of the observable contract — which means the encoder, not its caller, has to name the failure. A bare Option forced the caller to invent one generic text for all of them.

Variants

NotEightBit

C :135-143 — only NDInt8/NDUInt8 reach the encoder.

UnsupportedArrayStructure

C :165-169 — ndims is neither 2 nor 3.

UnknownColorMode(i32)

C :200-204 (and the identical guard inside the scanline loop, :228-232) — the colorMode switch has no arm for this mode: Bayer and the YUVs.

EncodeFailed

C :234-238 — libjpeg would not take the data.

The port also lands here for the arrays C hands to libjpeg’s fatal error handler: jpeg_std_error (:115) exits the process on error, so C has no recovery path for dimensions past libjpeg’s limit, nor for the 3-D layouts its else if chain (:155-164) leaves image_width/image_height unset for — a 3-D array whose ColorMode is Mono, or whose colour axis is not 3. The port reports the failure instead of aborting the IOC, under C’s own text for “the encoder would not take this array”.

Implementations

impl JpegCompressError

pub fn message(&self) -> Cow<'static, str>

The errorMessage C writes (NDPluginCodec.cpp:140, :166, :201, :235).

Trait Implementations

impl Clone for JpegCompressError

fn clone(&self) -> JpegCompressError

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for JpegCompressError

impl Debug for JpegCompressError

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

Formats the value using the given formatter.

impl Eq for JpegCompressError

impl PartialEq for JpegCompressError

fn eq(&self, other: &JpegCompressError) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for JpegCompressError