implements PLN-0022
This commit is contained in:
@@ -39,6 +39,7 @@ Example:
|
||||
```
|
||||
("gfx", "present", 1)
|
||||
("audio", "play", 2)
|
||||
("composer", "emit_sprite", 1)
|
||||
```
|
||||
|
||||
This identity is:
|
||||
@@ -198,6 +199,24 @@ For `asset.load`:
|
||||
- `slot` is the target slot index;
|
||||
- bank kind is resolved from `asset_table` by `asset_id`, not supplied by the caller.
|
||||
|
||||
### Composition surface (`composer`, v1)
|
||||
|
||||
The canonical frame-orchestration public ABI uses module `composer`.
|
||||
|
||||
Canonical operations in v1 are:
|
||||
|
||||
- `composer.bind_scene(bank_id) -> (status)`
|
||||
- `composer.unbind_scene() -> (status)`
|
||||
- `composer.set_camera(x, y) -> void`
|
||||
- `composer.emit_sprite(glyph_id, palette_id, x, y, layer, bank_id, flip_x, flip_y, priority) -> (status)`
|
||||
|
||||
For mutating composer operations:
|
||||
|
||||
- `status` is a `ComposerOpStatus` value;
|
||||
- `bind_scene`, `unbind_scene`, and `emit_sprite` are status-returning;
|
||||
- `set_camera` remains `void` in v1;
|
||||
- no caller-provided sprite index or `active` flag is part of the canonical contract.
|
||||
|
||||
## 7 Syscalls as Callable Entities (Not First-Class)
|
||||
|
||||
Syscalls behave like call sites, not like first-class guest values.
|
||||
|
||||
Reference in New Issue
Block a user