implements PLN-0067

This commit is contained in:
2026-05-23 19:15:14 +01:00
parent 4d5818c244
commit 1256d33a72
7 changed files with 103 additions and 52 deletions
@@ -220,6 +220,30 @@ For `asset.load`:
- JSON-on-the-wire bank inspection payloads are not valid public ABI;
- `bank.info` returns stack values, not textual structured payloads.
### GFX surface (`gfx`, v1)
The public GFX ABI uses format-neutral operation names. API and syscall names
MUST NOT encode RGB565 or any other pixel format suffix.
Canonical operations in v1 include:
- `gfx.clear(color) -> void`
- `gfx.fill_rect(x, y, w, h, color) -> void`
- `gfx.draw_line(x0, y0, x1, y1, color) -> void`
- `gfx.draw_circle(x, y, radius, color) -> void`
- `gfx.draw_disc(x, y, radius, color) -> void`
- `gfx.draw_square(x, y, size, color) -> void`
- `gfx.draw_text(x, y, text, color) -> void`
Rules:
- `color` arguments are packed RGBA8888 values using RGBA channel order.
- RGB565 raw values are not a public ABI contract.
- `Gfx*565` syscall names and `gfx.*_565` canonical identities are not valid
current ABI.
- The runtime framebuffer exposed across the host boundary is RGBA8888, not
`u16` RGB565.
### Composition surface (`composer`, v1)
The canonical frame-orchestration public ABI uses module `composer`.