Logical Render Pipelines and Command Packets
JaCoCo Coverage #### Project Overview
No changes detected, that affect the code coverage.
* Line Coverage: 61.06% (17124/28043)
* Branch Coverage: 51.92% (6584/12681)
* Lines of Code: 28043
* Cyclomatic Complexity: 11219
#### Quality Gates Summary
Output truncated.
Test / Build skipped: 15, passed: 594
Intrepid/Prometeu/Studio/pipeline/head This commit looks good
JaCoCo Coverage #### Project Overview
No changes detected, that affect the code coverage.
* Line Coverage: 61.06% (17124/28043)
* Branch Coverage: 51.92% (6584/12681)
* Lines of Code: 28043
* Cyclomatic Complexity: 11219
#### Quality Gates Summary
Output truncated.
Test / Build skipped: 15, passed: 594
Intrepid/Prometeu/Studio/pipeline/head This commit looks good
This commit is contained in:
@@ -922,7 +922,7 @@ Examples in this section are intended to stay mutually consistent with the synta
|
||||
|
||||
```pbs
|
||||
declare host Gfx {
|
||||
[Host(module = "gfx", name = "draw_pixel", version = 1)]
|
||||
[Host(module = "gfx2d", name = "draw_pixel", version = 1)]
|
||||
fn draw_pixel(x: int, y: int, c: color);
|
||||
}
|
||||
```
|
||||
|
||||
+3
-3
@@ -375,7 +375,7 @@ Illustrative stdlib interface module:
|
||||
declare enum color(red, green, blue);
|
||||
|
||||
declare host Gfx {
|
||||
[Host(module = "gfx", name = "draw_pixel", version = 1)]
|
||||
[Host(module = "gfx2d", name = "draw_pixel", version = 1)]
|
||||
fn draw_pixel(x: int, y: int, c: color);
|
||||
}
|
||||
```
|
||||
@@ -391,7 +391,7 @@ Another valid reserved stdlib interface module in stdlib line `1` is the sprite-
|
||||
```pbs
|
||||
declare host LowComposer {
|
||||
[Host(module = "composer", name = "emit_sprite", version = 1)]
|
||||
[Capability(name = "gfx")]
|
||||
[Capability(name = "composer")]
|
||||
fn emit_sprite(
|
||||
glyph_id: int,
|
||||
palette_id: int,
|
||||
@@ -446,7 +446,7 @@ Rules:
|
||||
The canonical reserved host-binding attribute is:
|
||||
|
||||
```pbs
|
||||
[Host(module = "gfx", name = "draw_pixel", version = 1)]
|
||||
[Host(module = "gfx2d", name = "draw_pixel", version = 1)]
|
||||
```
|
||||
|
||||
Rules:
|
||||
|
||||
+6
-6
@@ -127,8 +127,8 @@ The source-level call may originate from an SDK declaration such as:
|
||||
|
||||
```pbs
|
||||
declare host Gfx {
|
||||
[Host(module = "gfx", name = "draw_pixel", version = 1)]
|
||||
[Capability(name = "gfx")]
|
||||
[Host(module = "gfx2d", name = "draw_pixel", version = 1)]
|
||||
[Capability(name = "gfx2d")]
|
||||
fn draw_pixel(x: int, y: int, c: color);
|
||||
}
|
||||
```
|
||||
@@ -145,15 +145,15 @@ For example, the PBS-facing declaration:
|
||||
```pbs
|
||||
declare host LowComposer {
|
||||
[Host(module = "composer", name = "bind_scene", version = 1)]
|
||||
[Capability(name = "gfx")]
|
||||
[Capability(name = "composer")]
|
||||
fn bind_scene(scene_bank_id: int) -> int;
|
||||
|
||||
[Host(module = "composer", name = "unbind_scene", version = 1)]
|
||||
[Capability(name = "gfx")]
|
||||
[Capability(name = "composer")]
|
||||
fn unbind_scene() -> int;
|
||||
|
||||
[Host(module = "composer", name = "emit_sprite", version = 1)]
|
||||
[Capability(name = "gfx")]
|
||||
[Capability(name = "composer")]
|
||||
fn emit_sprite(
|
||||
glyph_id: int,
|
||||
palette_id: int,
|
||||
@@ -453,7 +453,7 @@ The cartridge manifest is the current declarative source for requested runtime c
|
||||
Rules:
|
||||
|
||||
- cartridge capability declarations are external to `program.pbx`,
|
||||
- capability declarations are serializable nominal identifiers such as `gfx` or `audio`,
|
||||
- capability declarations are serializable nominal identifiers such as `gfx2d`, `composer`, or `audio`,
|
||||
- the loader converts that nominal declaration into the internal capability flag set used by the runtime,
|
||||
- the loader MUST NOT infer granted authority solely from the presence of `SYSC` entries.
|
||||
|
||||
|
||||
+7
-5
@@ -62,7 +62,7 @@ The current manifest shape relevant to this document is:
|
||||
"title": "Example",
|
||||
"app_version": "1.0.0",
|
||||
"app_mode": "game",
|
||||
"capabilities": ["gfx", "input"],
|
||||
"capabilities": ["gfx2d", "input"],
|
||||
"asset_table": [],
|
||||
"preload": []
|
||||
}
|
||||
@@ -96,7 +96,8 @@ Rules:
|
||||
The current nominal capability set is:
|
||||
|
||||
- `system`
|
||||
- `gfx`
|
||||
- `gfx2d`
|
||||
- `composer`
|
||||
- `input`
|
||||
- `audio`
|
||||
- `fs`
|
||||
@@ -123,7 +124,8 @@ The normative external model is:
|
||||
Canonical mapping:
|
||||
|
||||
- `system` -> `SYSTEM`
|
||||
- `gfx` -> `GFX`
|
||||
- `gfx2d` -> `GFX2D`
|
||||
- `composer` -> `COMPOSER`
|
||||
- `input` -> `INPUT`
|
||||
- `audio` -> `AUDIO`
|
||||
- `fs` -> `FS`
|
||||
@@ -221,7 +223,7 @@ Recommended JSON:
|
||||
|
||||
```json
|
||||
{
|
||||
"capabilities": ["gfx", "input", "audio"]
|
||||
"capabilities": ["gfx2d", "input", "audio"]
|
||||
}
|
||||
```
|
||||
|
||||
@@ -244,7 +246,7 @@ The current temporary contract is:
|
||||
|
||||
1. `manifest.json` is the cartridge-facing load descriptor.
|
||||
2. `capabilities` is declared in `manifest.json`, not in `prometeu.json`.
|
||||
3. `capabilities` uses nominal canonical names such as `gfx` and `audio`.
|
||||
3. `capabilities` uses nominal canonical names such as `gfx2d`, `composer`, and `audio`.
|
||||
4. The runtime may keep using internal `CapFlags`.
|
||||
5. The loader converts nominal manifest capabilities into internal flags.
|
||||
6. PBX `SYSC` declares required host bindings, not authority.
|
||||
|
||||
+3
-3
@@ -208,7 +208,7 @@ Stdlib interface modules may contain reserved compile-time attributes such as:
|
||||
|
||||
```pbs
|
||||
declare host Gfx {
|
||||
[Host(module = "gfx", name = "draw_pixel", version = 1)]
|
||||
[Host(module = "gfx2d", name = "draw_pixel", version = 1)]
|
||||
fn draw_pixel(x: int, y: int, c: color);
|
||||
}
|
||||
```
|
||||
@@ -229,7 +229,7 @@ or:
|
||||
```pbs
|
||||
declare host LowComposer {
|
||||
[Host(module = "composer", name = "emit_sprite", version = 1)]
|
||||
[Capability(name = "gfx")]
|
||||
[Capability(name = "composer")]
|
||||
fn emit_sprite(
|
||||
glyph_id: int,
|
||||
palette_id: int,
|
||||
@@ -253,7 +253,7 @@ Rules:
|
||||
- later lowering stages may consume the extracted metadata to produce PBX host-binding declarations.
|
||||
- stdlib line `1` MUST expose the sprite-composition interface module at `@sdk:composer`,
|
||||
- that module MUST declare `LowComposer` and public service `Composer`,
|
||||
- that module MUST use runtime module `composer` and capability `gfx`,
|
||||
- that module MUST use runtime module `composer` and capability `composer`,
|
||||
- that module MUST expose `bind_scene(scene_bank_id: int) -> int`,
|
||||
- that module MUST expose `unbind_scene() -> int`,
|
||||
- that module MUST expose `emit_sprite(glyph_id: int, palette_id: int, x: int, y: int, layer: int, bank_id: int, flip_x: bool, flip_y: bool, priority: int) -> int`,
|
||||
|
||||
@@ -175,10 +175,12 @@ Rules:
|
||||
- `Composer.bind_scene(scene_bank_id: int)` MUST lower through canonical host identity `("composer", "bind_scene", 1)`.
|
||||
- `Composer.unbind_scene()` MUST lower through canonical host identity `("composer", "unbind_scene", 1)`.
|
||||
- `Composer.emit_sprite(...)` MUST lower through canonical host identity `("composer", "emit_sprite", 1)`.
|
||||
- `@sdk:composer` host bindings MUST require manifest capability `composer`.
|
||||
- `Composer.bind_scene(...)` MUST return a raw `int` in stdlib line `1`.
|
||||
- `Composer.unbind_scene()` MUST return a raw `int` in stdlib line `1`.
|
||||
- `Composer.emit_sprite(...)` MUST return a raw `int` in this wave.
|
||||
- `@sdk:gfx` MAY continue to expose primitive and overlay-oriented operations.
|
||||
- `@sdk:gfx` host bindings MUST require manifest capability `gfx2d`.
|
||||
- `@sdk:gfx` MUST NOT expose `set_sprite`.
|
||||
- `set_camera` may remain deferred if not yet exposed by the active stdlib line.
|
||||
|
||||
|
||||
Reference in New Issue
Block a user