Struct Patch 

pub struct Patch {
    pub cols: u16,
    pub rows: u16,
    pub updates: Vec<CellUpdate>,
}

A minimal set of changes between two grid states.

Updates are stored in row-major order (row ascending, column ascending). This ordering is stable and deterministic for identical input grids.

Fields

cols: u16

Grid width at the time the patch was computed.

rows: u16

Grid height at the time the patch was computed.

updates: Vec<CellUpdate>

Individual cell updates in row-major order.

Implementations

impl Patch

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

Create an empty patch for a given grid shape.

pub fn is_empty(&self) -> bool

Whether the patch has no updates.

pub fn len(&self) -> usize

Number of changed cells.

pub fn push(&mut self, row: u16, col: u16, cell: Cell)

Append a single cell update.

pub fn runs(&self) -> Vec<ChangeRun>

Coalesce updates into contiguous horizontal runs.

Runs are in row-major order. Adjacent columns on the same row are merged into a single run.

pub fn runs_into(&self, out: &mut Vec<ChangeRun>)

Coalesce updates into runs, appending to the provided buffer.

Reuse the buffer across frames to avoid allocation.

pub fn density(&self) -> f64

Ratio of changed cells to total grid cells.

Returns 0.0 for empty grids.

Trait Implementations

impl Clone for Patch

fn clone(&self) -> Patch

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Patch

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

Formats the value using the given formatter.

impl Default for Patch

fn default() -> Patch

Returns the “default value” for a type.

impl PartialEq for Patch

fn eq(&self, other: &Patch) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Eq for Patch

impl StructuralPartialEq for Patch