implements PR-015 asset codec NONE in specs
This commit is contained in:
@@ -104,19 +104,28 @@ This table describes content identity and storage layout, not live residency.
|
||||
|
||||
`decoded_size` is the byte count of the materialized runtime bank after decode, not necessarily the same as the serialized payload size.
|
||||
|
||||
`codec` identifies how the runtime must interpret the serialized payload slice before the asset becomes a resident bank.
|
||||
`codec` identifies the generic transformation pipeline applied to the serialized payload slice before the asset becomes a resident bank.
|
||||
|
||||
`codec` does not define the bank-specific serialized layout itself. Specialized banks may still have normative decode rules even when `codec = NONE`.
|
||||
|
||||
### 4.1 `TILES` asset contract in v1
|
||||
|
||||
For `BankType::TILES`, the runtime-facing v1 contract is:
|
||||
|
||||
- `codec = RAW`
|
||||
- `codec = NONE`
|
||||
- serialized pixels use packed `u4` palette indices
|
||||
- serialized palettes use `RGB565` (`u16`, little-endian)
|
||||
- `palette_count = 64`
|
||||
- runtime materialization may expand pixel indices to one `u8` per pixel
|
||||
|
||||
`RAW` for `TILES` means there is no compression stage beyond deterministic reconstruction of the tile bank from its serialized payload. It does not require the serialized byte layout to be identical to the in-memory layout.
|
||||
`NONE` for `TILES` means there is no additional generic codec layer beyond the bank contract itself.
|
||||
|
||||
For the current transition window:
|
||||
|
||||
- `RAW` is a deprecated legacy alias of `NONE`
|
||||
- new published material must use `NONE` as the canonical value
|
||||
|
||||
Even with `codec = NONE`, `TILES` still requires deterministic bank-specific decode from its serialized payload. The serialized byte layout is therefore not required to be identical to the in-memory layout.
|
||||
|
||||
Required `AssetEntry.metadata` fields for `TILES`:
|
||||
|
||||
@@ -198,7 +207,8 @@ For v1:
|
||||
|
||||
- `OP_MODE` is derived from `codec`/CODEX;
|
||||
- explicit per-asset hinting is not part of the baseline contract.
|
||||
- `TILES` with `codec = RAW` may still stage in memory before bank installation because runtime decode expands packed pixel indices into the resident representation.
|
||||
- `TILES` with `codec = NONE` may still stage in memory before bank installation because bank-specific decode expands packed pixel indices into the resident representation.
|
||||
- during the migration window, runtime may accept legacy `RAW` as an alias of `NONE`.
|
||||
|
||||
The runtime does not treat asset installation as implicit side effect.
|
||||
|
||||
|
||||
Reference in New Issue
Block a user