Struct DirtyTracker 

pub struct DirtyTracker { /* private fields */ }

Tracks which cells have been modified since the last frame.

Used by GridDiff::diff_dirty to skip unchanged rows and focus only on dirty spans within changed rows, achieving sub-linear diff cost for typical workloads (1-5 rows changed per frame).

Merge gap

When two dirty spans are separated by merge_gap or fewer clean cells, they are merged into a single span. This reduces overhead from many tiny spans (e.g., character-by-character typing). Default: 1.

Implementations

impl DirtyTracker

pub fn new(cols: u16, rows: u16) -> Self

Create a new tracker for a grid of the given dimensions.

pub fn row_count(&self) -> u16

Number of rows tracked.

pub fn set_merge_gap(&mut self, gap: u16)

Set the merge gap for span coalescing.

pub fn is_dirty(&self) -> bool

Whether any cell is dirty.

pub fn dirty_row_count(&self) -> usize

Number of dirty rows.

pub fn mark_cell(&mut self, row: u16, col: u16)

Mark a single cell as dirty.

pub fn mark_span(&mut self, row: u16, start_col: u16, end_col: u16)

Mark a horizontal range [start_col, end_col) as dirty.

pub fn mark_row(&mut self, row: u16)

Mark an entire row as dirty.

pub fn mark_all(&mut self)

Mark all rows as dirty (forces full redraw).

pub fn clear(&mut self)

Clear all dirty state for the next frame.

pub fn is_row_dirty(&self, row: u16) -> bool

Whether a specific row is dirty.

pub fn row_spans(&self, row: u16) -> Option<&[DirtySpan]>

Get dirty spans for a row.

Returns None if the entire row is dirty (caller should scan all columns). Returns Some(&[DirtySpan]) for partial dirty rows. Returns Some(&[]) for clean rows.

pub fn resize(&mut self, new_cols: u16, new_rows: u16)

Resize the tracker for a new grid size.

Trait Implementations

impl Clone for DirtyTracker

fn clone(&self) -> DirtyTracker

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for DirtyTracker

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

Formats the value using the given formatter.