ketraterm-render-cache/io.github.ketraterm.render.cache/TerminalTextRangeCopy

TerminalTextRangeCopy

class TerminalTextRangeCopy(val maxRows: Int = 64, val maxCells: Int = 4096)

Worker-confined, reusable text-only copy of a bounded absolute row range.

Only primitive copying occurs inside the reader callback. Arrays are borrowed until the next read; only rows times columns cells are active. Every active code/flag entry is overwritten, so spare capacity needs no clearing. Cluster references are meaningful only for cells with the CLUSTER flag and a nonzero reference.

Bounds and cancellation have the same meaning as TerminalRenderRangeCopy. Failed or empty reads leave rows zero; partially copied arrays must not be consumed.

Constructors

TerminalTextRangeCopy

constructor(maxRows: Int = 64, maxCells: Int = 4096)

Properties

activeBuffer

var activeBuffer: TerminalRenderBufferKind

Source buffer for the completed batch.

clusterCodepoints

var clusterCodepoints: IntArray

Primitive cluster payload, valid only through references in active cluster cells.

clusterRefs

var clusterRefs: LongArray

Packed cluster offset (high 32 bits) and length (low 32 bits).

codeWords

var codeWords: IntArray

Unicode scalars, with zero for empty, cluster, and trailing cells.

columns

var columns: Int

Column stride of the active cell arrays; usable when rows is nonzero.

contentGeneration

var contentGeneration: Long

Source content generation for the completed batch.

firstAbsoluteRow

var firstAbsoluteRow: Long

First row of the requested/retained intersection.

flags

var flags: IntArray

Public render cell flags, including wide cells and wrap padding.

historyContentGeneration

var historyContentGeneration: Long

Source history identity/layout generation for the completed batch.

lastAbsoluteRow

var lastAbsoluteRow: Long

Inclusive last copied row, or less than firstAbsoluteRow for an empty read.

lineGenerations

var lineGenerations: LongArray

Source generations for active rows.

lineIds

var lineIds: LongArray

Source identities for active rows.

lineWrapped

var lineWrapped: BooleanArray

Whether each active physical row continues into the next.

maxCells

val maxCells: Int

maxRows

val maxRows: Int

rows

var rows: Int

Number of usable rows; zero until a read completes successfully.

Functions

read

fun read(reader: TerminalRenderFrameReader, startAbsoluteRow: Long, endAbsoluteRow: Long, checkCancelled: () -> Unit = {}): Boolean

Copies one retained intersection, at most maxRows rows and maxCells cells, except that a single row wider than the cell budget is allowed. Returns whether a complete nonempty batch was copied. checkCancelled must not suspend or block.