headless/dev.s7a.strata.runtime.headless/HeadlessImage

HeadlessImage

An immutable, thread-safe row-major physical ARGB image produced by headless rendering.

The implementation owns its pixel storage and exposes no mutable backing array or construction hook. Image reads and fresh output copies are safe from any thread after construction. Coordinates are physical pixels with a top-left origin.

Properties

size

abstract val size: IntSize

The positive physical image extent.

Functions

argbAt

abstract fun argbAt(x: Int, y: Int): Int

Returns one physical pixel without changing the image.

copyArgb

abstract fun copyArgb(): IntArray

Returns a fresh row-major copy of all physical ARGB pixels.

encodePng

abstract fun encodePng(): ByteArray

Encodes the image as deterministic PNG bytes.