Enum ImageSkip 

pub enum ImageSkip {
    AtlasDisabled,
    UnsupportedFormat(ImageFormat),
    DegenerateExtent {
        width: u32,
        height: u32,
    },
    TooLarge {
        width: u32,
        height: u32,
        max: u32,
    },
    MalformedPixels {
        width: u32,
        height: u32,
        expected: usize,
        actual: usize,
    },
    SingularTransform,
    NoAtlasSpace {
        width: u32,
        height: u32,
        atlas_width: u32,
        atlas_height: u32,
    },
    SameFrameExtentConflict {
        width: u32,
        height: u32,
    },
}

Why one image could not be made resident.

Every variant is a skip, never a frame failure: the draw paints nothing and the rest of the frame proceeds. They are distinguished because the remedies differ — a too-large image is an application decision, an exhausted atlas is a budget one, and a disabled atlas is the operator’s own doing.

Variants

AtlasDisabled

FRUST_ENGINE_NO_ATLAS is set; the atlas is out of the frame entirely.

UnsupportedFormat(ImageFormat)

The image declares a format the atlas does not store.

DegenerateExtent

The image has no area, so there is nothing to make resident.

Fields

width: u32

Declared width in pixels.

height: u32

Declared height in pixels.

TooLarge

The image is larger than MAX_IMAGE_DIMENSION on at least one axis.

Fields

width: u32

Declared width in pixels.

height: u32

Declared height in pixels.

max: u32

The per-axis ceiling that refused it.

MalformedPixels

The pixel buffer’s length disagrees with the declared extent and format.

Fields

width: u32

Declared width in pixels.

height: u32

Declared height in pixels.

expected: usize

Bytes the declared extent and format require.

actual: usize

Bytes the blob actually holds.

SingularTransform

The paint transform cannot be inverted, so there is no device-to-image mapping for the shader to sample through.

NoAtlasSpace

The image fits the ceiling but not the configured atlas budget, and no resident image could be evicted to make room for it — either the atlas holds nothing but images this same frame drew, or what it holds beside them still leaves no rectangle this one fits in.

Fields

width: u32

Declared width in pixels.

height: u32

Declared height in pixels.

atlas_width: u32

Configured atlas width.

atlas_height: u32

Configured atlas height.

SameFrameExtentConflict

The same blob was already resolved earlier in this same frame at a different extent.

Not an atlas-capacity refusal: the atlas may be nearly empty. The plan clears before it uploads (see the module doc), so releasing this blob’s rectangle to make room for its own second extent would schedule a clear over texels this frame already sampled — the first extent’s draw keeps its texels and the second is skipped until the next frame instead.

Fields

width: u32

The refused extent’s width, after fit_extent the same way NoAtlasSpace reports it.

height: u32

The refused extent’s height, after fit_extent.

Trait Implementations

impl Clone for ImageSkip

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for ImageSkip

impl Debug for ImageSkip

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

Formats the value using the given formatter.

impl Display for ImageSkip

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

Formats the value using the given formatter.

impl Eq for ImageSkip

impl Error for ImageSkip

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 PartialEq for ImageSkip

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for ImageSkip