core/dev.s7a.strata.runtime.render/DrawCommand

DrawCommand

A retained drawing command in accumulated tree coordinates.

Commands are returned in retained paint order, including explicit nested child clips and post-child overlays. A backend must execute the list in that order. Backends must intersect drawing with every active PushClip until the matching PopClip. The core records these contracts without clipping, blending, or sampling pixels. Portable commands carry platform-neutral values, while the opt-in Platform variant preserves an opaque version-adapter payload without teaching core its type. Version 0.1.1 adds SampledImage to this sealed hierarchy; older exhaustive backends must handle or explicitly reject it before producing output. Existing JVM members remain available, but an older compiled visitor can fail when given the new variant.

Inheritors

Types

BlitImage

data class BlitImage(val image: DrawImage, val source: IntRect, val destination: IntRect) : DrawCommand

Copies an image source rectangle into a tree-coordinate destination rectangle.

BlitImagePixels

data class BlitImagePixels(val image: DrawImage, val source: IntRect, val destination: IntRect) : DrawCommand

Samples an immutable image independently at every output pixel in a logical destination rectangle.

FillRectangle

data class FillRectangle(val bounds: IntRect, val color: ArgbColor) : DrawCommand

Fills a rectangle with one color.

Platform

data class Platform(val command: PlatformDrawCommand, val bounds: IntRect) : DrawCommand

Preserves an opaque platform payload at one tree-coordinate rectangle.

PopClip

data object PopClip : DrawCommand

Ends the most recently begun child clip.

PushClip

data class PushClip(val bounds: IntRect) : DrawCommand

Begins clipping subsequent drawing to bounds intersected with every active outer clip.

SampledImage

data class SampledImage(val image: DrawImage, val source: FloatRect, val destination: FloatRect, val tint: ArgbColor = ArgbColor(-1), val alphaCutoff: Float = 0.1f, val orientation: SampledImageOrientation) : DrawCommand

Samples an immutable image through fractional geometry at the backend's final physical pixel density.