headless/dev.s7a.strata.runtime.headless/rasterizeHeadlessInto

rasterizeHeadlessInto

fun rasterizeHeadlessInto(commands: List<DrawCommand>, bounds: IntRect, scale: Int, pixels: IntArray)(source)

Rasterizes an original-coordinate region into borrowed caller-owned ARGB storage for synchronous native upload. Materializes the transparent background lazily and writes only the checked physical region prefix; excess capacity remains untouched. Every output pixel is initialized before use, including empty commands and clipped primitives. The caller exclusively owns pixels throughout this call, and no image, command, array or callback is retained. Preflight rejects invalid input before any storage changes. Pixel arithmetic follows rasterizeHeadlessRegion.

fun rasterizeHeadlessInto(commands: List<DrawCommand>, bounds: IntRect, scale: Int, pixels: IntArray, scratch: HeadlessRasterScratch)(source)

Borrows owner-thread source-color scratch across regions in one synchronous frame preparation. The caller closes scratch after the final region or failure; this call retains no borrowed storage. Preflight and exact pixel semantics follow rasterizeHeadlessInto.