Enum TextureError 

#[non_exhaustive]
pub enum TextureError {
    TextureStorageCreationFailed(String),
    NotEnoughPixels {
        expected_bytes: usize,
        provided_bytes: usize,
    },
    UnsupportedPixelFormat(PixelFormat),
    CannotRetrieveTexels(String),
    CannotUploadTexels(String),
}

Errors that might happen when working with textures.

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.

TextureStorageCreationFailed(String)

A texture’s storage failed to be created.

The carried String gives the reason of the failure.

NotEnoughPixels

Not enough pixel data provided for the given area asked.

You must provide at least as many pixels as expected by the area in the texture you’re uploading to.

Fields

expected_bytes: usize

Expected number of pixels in bytes.

provided_bytes: usize

Provided number of pixels in bytes.

UnsupportedPixelFormat(PixelFormat)

Unsupported pixel format.

Sometimes, some hardware might not support a given pixel format (or the format exists on the interface side but doesn’t in the implementation). That error represents such a case.

CannotRetrieveTexels(String)

Cannot retrieve texels from a texture.

That error might happen on some hardware implementations if the user tries to retrieve texels from a texture that doesn’t support getting its texels retrieved.

CannotUploadTexels(String)

Failed to upload texels.

Implementations

impl TextureError

pub fn texture_storage_creation_failed( reason: impl Into<String>, ) -> TextureError

A texture’s storage failed to be created.

pub fn not_enough_pixels( expected_bytes: usize, provided_bytes: usize, ) -> TextureError

Not enough pixel data provided for the given area asked.

pub fn unsupported_pixel_format(pf: PixelFormat) -> TextureError

Unsupported pixel format.

pub fn cannot_retrieve_texels(reason: impl Into<String>) -> TextureError

Cannot retrieve texels from a texture.

pub fn cannot_upload_texels(reason: impl Into<String>) -> TextureError

Failed to upload texels.

Trait Implementations

impl Clone for TextureError

fn clone(&self) -> TextureError

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for TextureError

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

Formats the value using the given formatter.

impl Display for TextureError

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

Formats the value using the given formatter.

impl Error for TextureError

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<TextureError> for FramebufferError

fn from(e: TextureError) -> FramebufferError

Converts to this type from the input type.

impl PartialEq for TextureError

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Eq for TextureError

impl StructuralPartialEq for TextureError