Enum UpdateTextureError 

pub enum UpdateTextureError {
    WrongDataSize {
        expect: usize,
        actual: usize,
    },
    OutOfBounds,
    NegativeSize,
}

Errors returned when updating texture data on the GPU.

Examples

use raylib::core::error::UpdateTextureError;

fn handle(e: UpdateTextureError) {
    match e {
        UpdateTextureError::WrongDataSize { expect, actual } => {
            eprintln!("texture expects {expect} bytes, got {actual}");
        }
        UpdateTextureError::OutOfBounds => eprintln!("region exceeds texture bounds"),
        UpdateTextureError::NegativeSize => eprintln!("region has negative extents"),
    }
}

Variants

WrongDataSize

The pixel-buffer slice does not match the byte size of the texture region.

Cause: raylib-rs computed width * height * bytes_per_pixel for the target region and the supplied slice was a different length; passing it to ffi::UpdateTexture would read out of bounds.

Recovery: Size the input buffer to exactly expect bytes (region width times height times bytes per pixel for the texture’s format).

Fields

expect: usize

Byte count raylib-rs derived from the texture region’s dimensions and format.

actual: usize

Byte count of the slice the caller actually supplied.

OutOfBounds

The destination rectangle extends past the texture’s width or height.

Cause: The rectangle’s x + width or y + height exceeds the texture dimensions; raylib-rs blocks this before ffi::UpdateTextureRec would otherwise overflow.

Recovery: Clamp the rectangle so it lies entirely within the texture’s bounds.

NegativeSize

The destination rectangle has a negative width or height.

Cause: raylib treats the rectangle’s width/height as unsigned at the FFI boundary; raylib-rs rejects negative values up front so they cannot wrap into very large positive sizes.

Recovery: Pass non-negative extents; swap the corners if the caller’s coordinates were inverted.

Trait Implementations

impl Debug for UpdateTextureError

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

Formats the value using the given formatter.

impl Display for UpdateTextureError

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

Formats the value using the given formatter.

impl Error for UpdateTextureError

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<UpdateTextureError> for RaylibError

fn from(source: UpdateTextureError) -> Self

Converts to this type from the input type.