Enum ValidationError 

pub enum ValidationError {
    IoError(Error),
    JpegDetected,
    WebpDetected,
    NotPng,
    UnsupportedColorSpace {
        found: String,
    },
    ImageTooSmall {
        width: u32,
        height: u32,
        min: u32,
    },
    ImageTooLarge {
        width: u32,
        height: u32,
        pixels: u64,
        max: u64,
    },
    DecodingError(String),
    JpegArtifactsDetected {
        ratio: f32,
    },
}

Every way the validation pipeline can reject a candidate container image.

Variants

IoError(Error)

The file could not be read from disk.

JpegDetected

The file is a JPEG. Lossy containers destroy embedded payloads.

WebpDetected

The file is a WebP. Lossy containers destroy embedded payloads.

NotPng

The file is not a PNG, and not a format we can name specifically.

UnsupportedColorSpace

The PNG decodes to a pixel layout the embedder cannot use.

Fields

found: String

Debug representation of the layout reported by the decoder.

ImageTooSmall

The image is smaller than the minimum accepted size.

Fields

width: u32

Width reported by the decoder, in pixels.

height: u32

Height reported by the decoder, in pixels.

min: u32

Minimum accepted side length, in pixels.

ImageTooLarge

The image has more pixels than the analysis will attempt.

Reported from the header, before anything is decoded; see [MAX_PIXELS] for why a limit exists at all.

Fields

width: u32

Width reported by the header, in pixels.

height: u32

Height reported by the header, in pixels.

pixels: u64

Pixels the image contains.

max: u64

Pixels the analysis will attempt.

DecodingError(String)

The PNG stream is malformed or truncated.

JpegArtifactsDetected

The image is a lossless re-encoding of previously JPEG-compressed data.

Fields

ratio: f32

Blocking ratio measured over the sampled 8x8 blocks. Around 1.0 for a clean image; the higher it is, the stronger the JPEG grid. See crate::image_io::jpeg_detect::detect_jpeg_artifacts.

Trait Implementations

impl Debug for ValidationError

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

Formats the value using the given formatter.

impl Display for ValidationError

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

Formats the value using the given formatter.

impl Error for ValidationError

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 ValidationError

fn from(err: Error) -> Self

Converts to this type from the input type.

impl From<ValidationError> for PipelineError

fn from(err: ValidationError) -> Self

Converts to this type from the input type.