Struct DisplayMatrix 

pub struct DisplayMatrix {
    pub chunks: Arc<[Arc<DisplayChunk>]>,
    pub chunk_size: u32,
    pub source_line_count: u32,
    pub visible_line_count: u32,
    pub version: MatrixVersion,
    pub wrap_width: u32,
    pub reveal_line: Option<u32>,
}

Chunked, viewport-windowed cache of DisplayLines. Mirrors CellMatrix exactly; only the row payload differs.

Fields

chunks: Arc<[Arc<DisplayChunk>]>

Chunks ordered by start_source_line. Whole-doc mode has one.

chunk_size: u32

Logical lines per chunk, or CHUNK_SIZE_WHOLE_DOC for whole-doc mode.

source_line_count: u32

Total logical lines in the source buffer (pre-fold).

visible_line_count: u32

Total display rows across all chunks (post-fold).

version: MatrixVersion

Component-wise version captured at build time.

wrap_width: u32

Soft-wrap column width, or 0 when wrapping is off (one display row per source line). Stamped by the worker from the pane width.

reveal_line: Option<u32>

CL.1: the line this matrix was built with its conceals suppressed on.

Carried on the matrix rather than folded into MatrixVersion on purpose. The version is the cache-hit key, and the reveal line moves with the CURSOR — folding it in would invalidate the whole matrix on every j, turning a 47 ns cache hit into a ~1.5 ms window rebuild. Kept beside the version instead, so the worker can see the reveal moved and rebuild exactly the two rows that changed.

Implementations

impl DisplayMatrix

pub fn empty() -> Self

pub fn chunked( chunks: impl Into<Arc<[Arc<DisplayChunk>]>>, chunk_size: u32, source_line_count: u32, version: MatrixVersion, ) -> Self

pub fn whole_doc(chunk: Arc<DisplayChunk>, source_line_count: u32) -> Self

pub fn is_whole_doc(&self) -> bool

pub fn is_empty(&self) -> bool

pub fn segment_count(&self, target: u32) -> u32

How many display rows source line target occupies under soft-wrap (1 when wrapping off / line missing / folded).

pub fn covered_start_line(&self) -> u32

First source line the chunks were built to cover (0 for whole-doc / full-coverage chunked; the window lower bound when windowed). H.3 coverage semantics, ported.

pub fn covered_end_line(&self) -> u32

Exclusive upper bound of the covered source-line range.

pub fn covers(&self, lo: u32, hi: u32) -> bool

Does the matrix cover all of [lo, hi)? Empty matrix covers nothing. Drives the worker cache-hit / window-extend gate.

pub fn row_at_source_line(&self, target: u32) -> Option<&DisplayLine>

Row whose source_line == target, walking chunks in order. None when folded or outside coverage (the renderer falls back to its rope/plain path only transiently, off-window).

Trait Implementations

impl Clone for DisplayMatrix

fn clone(&self) -> DisplayMatrix

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for DisplayMatrix

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

Formats the value using the given formatter.

impl Default for DisplayMatrix

fn default() -> Self

Returns the “default value” for a type.