ketraterm-protocol/io.github.ketraterm.protocol/TerminalColorRequest

TerminalColorRequest

class TerminalColorRequest(capacity: Int)

Reusable, ordered OSC 21 operations with borrowed original key bytes.

A producer fills this batch before synchronous delivery. Consumers must not retain or mutate it or its source bytes. Queries observe preceding operations and contribute to one reply in request order. Numeric targets are indexed colors in 0..255; named targets and operations use the constants below.

Storage is allocated once. capacity bounds the number of nonempty fields; it does not impose a wire payload limit, which belongs to the parser.

Constructors

TerminalColorRequest

constructor(capacity: Int)

Types

object Companion

Properties

Number of initialized operations.

Functions

fun add(target: Int, operation: Int, color: Int, keyStart: Int, keyEnd: Int)

Appends one operation. color is packed ARGB for SET, otherwise ignored. keyStart inclusive and keyEnd exclusive select the original nonempty key.

fun clear(payload: ByteArray)

Starts a new batch borrowing payload until its synchronous consumption finishes.

fun color(index: Int): Int

Packed ARGB argument at index.

fun keyByte(index: Int, offset: Int): Int

Unsigned original key byte. Unknown keys must be encoded before inclusion in replies.

fun keyLength(index: Int): Int

Length of the original key in bytes.

fun operation(index: Int): Int

Operation at index.

fun target(index: Int): Int

Semantic target at index.