Struct TextureDataMut 

pub struct TextureDataMut<'a> { /* private fields */ }

A guarded mutable view of a single ImTextureData.

This exists because the texture list is exposed from a shared &DrawData reference in order to keep renderer APIs ergonomic, but the list still needs to be mutated by the backend. The guard ensures at runtime that only one mutable view is alive at a time, preventing Rust aliasing UB.

Methods from Deref<Target = TextureData>

pub fn as_raw(&self) -> *const ImTextureData

Get the raw pointer to the underlying ImTextureData

pub fn as_raw_mut(&mut self) -> *mut ImTextureData

Get the raw mutable pointer to the underlying ImTextureData

pub fn unique_id(&self) -> i32

Get the unique ID of this texture (for debugging)

pub fn status(&self) -> TextureStatus

Get the current status of this texture

pub fn set_status(&mut self, status: TextureStatus)

Set the status of this texture

This should only be called by renderer backends after handling a request.

pub fn backend_user_data(&self) -> *mut c_void

Get the backend user data

pub fn set_backend_user_data(&mut self, data: *mut c_void)

Set the backend user data

pub fn tex_id(&self) -> TextureId

Get the texture ID

pub fn set_tex_id(&mut self, tex_id: TextureId)

Set the texture ID

This should only be called by renderer backends after creating or destroying the texture.

pub fn format(&self) -> TextureFormat

Get the texture format

pub fn width(&self) -> i32

Get the texture width

pub fn height(&self) -> i32

Get the texture height

pub fn bytes_per_pixel(&self) -> i32

Get the bytes per pixel

pub fn unused_frames(&self) -> i32

Get the number of unused frames

pub fn ref_count(&self) -> u16

Get the reference count

pub fn use_colors(&self) -> bool

Check if the texture uses colors (rather than just white + alpha)

pub fn want_destroy_next_frame(&self) -> bool

Check if the texture is queued for destruction next frame

pub fn pixels(&self) -> Option<&[u8]>

Get the pixel data

Returns None if no pixel data is available.

pub fn used_rect(&self) -> TextureRect

Get the bounding box of all used pixels in the texture

pub fn update_rect(&self) -> TextureRect

Get the bounding box of all queued updates

pub fn updates(&self) -> impl Iterator<Item = TextureRect> + '_

Iterate over queued update rectangles (copying to safe TextureRect)

pub fn pixels_at(&self, x: i32, y: i32) -> Option<&[u8]>

Get the pixel data at a specific position

Returns None if no pixel data is available or coordinates are out of bounds.

pub fn pitch(&self) -> i32

Get the pitch (bytes per row)

pub fn create(&mut self, format: TextureFormat, width: i32, height: i32)

Create a new texture with the specified format and dimensions

This allocates pixel data and sets the status to WantCreate.

pub fn destroy_pixels(&mut self)

Destroy the pixel data

This frees the CPU-side pixel data but doesn’t affect the GPU texture.

pub fn set_data(&mut self, data: &[u8])

Set the pixel data for the texture

This copies the provided data into the texture’s pixel buffer.

pub fn set_width(&mut self, width: u32)

Set the width of the texture

pub fn set_height(&mut self, height: u32)

Set the height of the texture

pub fn set_format(&mut self, format: TextureFormat)

Set the format of the texture

Trait Implementations

impl Deref for TextureDataMut<'_>

type Target = TextureData

The resulting type after dereferencing.

fn deref(&self) -> &Self::Target

Dereferences the value.

impl DerefMut for TextureDataMut<'_>

fn deref_mut(&mut self) -> &mut Self::Target

Mutably dereferences the value.

impl Drop for TextureDataMut<'_>

fn drop(&mut self)

Executes the destructor for this type.