Struct DirtyRegion 

pub struct DirtyRegion { /* private fields */ }

Tracks which tiles of the framebuffer have been modified since the last clear, enabling callers to skip re-compositing unchanged tiles.

On construction every tile is marked dirty so the first repaint always paints the full surface. After DirtyRegion::clear_all only tiles touched by DirtyRegion::mark_rect or DirtyRegion::mark_tile are reported as dirty.

Implementations

impl DirtyRegion

pub fn new(fb_width: u32, fb_height: u32, tile_size: u32) -> Self

Create a new DirtyRegion for a framebuffer of fb_width × fb_height pixels using tile_size-pixel tiles.

All tiles start dirty so the first frame is always fully rendered.

pub fn mark_rect( &mut self, x: u32, y: u32, width: u32, height: u32, tile_size: u32, )

Mark the pixel rectangle (x, y, width, height) as dirty, dirtying every tile that overlaps it.

If all tiles are already dirty this is a no-op.

pub fn mark_tile(&mut self, tx: u32, ty: u32)

Mark the single tile at (tx, ty) as dirty.

If all tiles are already dirty this is a no-op.

pub fn is_tile_dirty(&self, tx: u32, ty: u32) -> bool

Return true if the tile at (tx, ty) needs to be re-rendered.

pub fn clear_all(&mut self)

Clear all dirty flags after a completed repaint.

After this call DirtyRegion::dirty_count returns 0 until a tile is explicitly marked dirty again.

pub fn invalidate_all(&mut self)

Mark every tile as dirty.

Use after a resize or any full framebuffer invalidation.

pub fn dirty_tiles(&self) -> impl Iterator<Item = (u32, u32)> + '_

Iterate over the (tx, ty) coordinates of all dirty tiles.

pub fn dirty_count(&self) -> usize

Return the number of tiles currently marked dirty.

pub fn total_tiles(&self) -> usize

Return the total number of tiles in the framebuffer.

Trait Implementations

impl Clone for DirtyRegion

fn clone(&self) -> DirtyRegion

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for DirtyRegion

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

Formats the value using the given formatter.