Struct TextureDataMut 

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

A guarded mutable view of a single ImTextureData.

The guard is created by TextureMutCursor::next and borrows the cursor for its lifetime, so safe Rust cannot hold multiple mutable texture views from the same list at the same time.

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

Get this managed texture’s stable ImGui identity.

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 texture_ref(&mut self) -> TextureRef<'_>

Get the current texture reference for this managed texture.

pub fn format(&self) -> TextureFormat

Get the texture format

pub fn width(&self) -> u32

Get the texture width

pub fn height(&self) -> u32

Get the texture height

pub fn bytes_per_pixel(&self) -> usize

Get the bytes per pixel

pub fn unused_frames(&self) -> usize

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: u32, y: u32) -> 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) -> usize

Get the pitch (bytes per row)

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

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.