Enum luminance::texture::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 of NotEnoughPixels

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>) -> Self

A texture’s storage failed to be created.

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

Not enough pixel data provided for the given area asked.

pub fn unsupported_pixel_format(pf: PixelFormat) -> Self

Unsupported pixel format.

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

Cannot retrieve texels from a texture.

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

Failed to upload texels.

Trait Implementations

impl Clone for TextureError

fn clone(&self) -> TextureError

Returns a copy 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

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

impl Error for TextureError

fn source(&self) -> Option<&(dyn Error + 'static)>

The lower-level source of this error, if any.

fn backtrace(&self) -> Option<&Backtrace>

🔬 This is a nightly-only experimental API. (backtrace)

Returns a stack backtrace, if available, of where this error occurred.

fn description(&self) -> &str

👎 Deprecated since 1.42.0:

use the Display impl or to_string()

if let Err(e) = "xc".parse::<u32>() { // Print e itself, no need for description(). eprintln!("Error: {}", e); }

fn cause(&self) -> Option<&dyn Error>

👎 Deprecated since 1.33.0:

replaced by Error::source, which can support downcasting

impl From<TextureError> for FramebufferError

fn from(e: TextureError) -> Self

Performs the conversion.

impl PartialEq<TextureError> for TextureError

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

This method tests for self and other values to be equal, and is used by ==.

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

This method tests for !=.

impl StructuralEq for TextureError

impl StructuralPartialEq for TextureError