Enum TextureDataError 

#[non_exhaustive]
pub enum TextureDataError {
    InvalidDimensions {
        width: u32,
        height: u32,
    },
    WidthOutOfRange(u32),
    HeightOutOfRange(u32),
    ByteSizeOutOfRange {
        width: u32,
        height: u32,
        bytes_per_pixel: usize,
    },
    InvalidLayout {
        width: i32,
        height: i32,
        bytes_per_pixel: i32,
    },
    ByteLengthMismatch {
        expected: usize,
        actual: usize,
    },
    InvalidStatus(TextureStatus),
    MissingPixelStorage(TextureStatus),
    FullUpdateRectOutOfRange {
        width: u32,
        height: u32,
    },
    InvalidRegionDimensions {
        width: u32,
        height: u32,
    },
    UpdateRegionOutOfBounds {
        region: TextureRegion,
        width: u32,
        height: u32,
    },
    UpdateRegionNotRepresentable(TextureRegion),
    RowPitchTooSmall {
        minimum: usize,
        actual: usize,
    },
    PayloadSizeOutOfRange {
        row_pitch: usize,
        height: u32,
    },
}

Validation failure while creating or mutating CPU-side texture data.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

InvalidDimensions

Width or height was zero.

Fields

width: u32

Requested texture width.

height: u32

Requested texture height.

WidthOutOfRange(u32)

Width does not fit Dear ImGui’s signed native dimension field.

HeightOutOfRange(u32)

Height does not fit Dear ImGui’s signed native dimension field.

ByteSizeOutOfRange

The native allocation size overflowed or exceeded its signed size limit.

Fields

width: u32

Texture width.

height: u32

Texture height.

bytes_per_pixel: usize

Bytes per pixel.

InvalidLayout

Native metadata is not a valid texture layout.

Fields

width: i32

Native width.

height: i32

Native height.

bytes_per_pixel: i32

Native bytes per pixel.

ByteLengthMismatch

The supplied payload does not exactly match the requested byte contract.

Fields

expected: usize

Required payload length.

actual: usize

Supplied payload length.

InvalidStatus(TextureStatus)

Pixel mutation is unavailable in the WantDestroy or Destroyed lifecycle state.

MissingPixelStorage(TextureStatus)

A live texture does not have CPU-side pixel storage.

FullUpdateRectOutOfRange

The full texture cannot be represented by Dear ImGui’s 16-bit update rectangle.

Fields

width: u32

Texture width.

height: u32

Texture height.

InvalidRegionDimensions

A subresource region has a zero width or height.

Fields

width: u32

Requested region width.

height: u32

Requested region height.

UpdateRegionOutOfBounds

A subresource rectangle exceeds the texture bounds.

Fields

region: TextureRegion

Requested region.

width: u32

Texture width.

height: u32

Texture height.

UpdateRegionNotRepresentable(TextureRegion)

A live update region cannot be represented by Dear ImGui’s native update queue.

RowPitchTooSmall

The supplied row pitch cannot hold one tightly packed source row.

Fields

minimum: usize

Minimum tightly packed row size.

actual: usize

Supplied row pitch.

PayloadSizeOutOfRange

Computing the strided payload size overflowed.

Fields

row_pitch: usize

Supplied row pitch.

height: u32

Rectangle height.

Trait Implementations

impl Clone for TextureDataError

fn clone(&self) -> TextureDataError

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for TextureDataError

impl Debug for TextureDataError

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

Formats the value using the given formatter.

impl Display for TextureDataError

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

Formats the value using the given formatter.

impl Eq for TextureDataError

impl Error for TextureDataError

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<TextureDataError> for ManagedTextureMutationError

fn from(source: TextureDataError) -> Self

Converts to this type from the input type.

impl PartialEq for TextureDataError

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for TextureDataError