40 lines
2.1 KiB
Markdown
40 lines
2.1 KiB
Markdown
# Reviewed decisions
|
||
|
||
## November 10, 2026 — C graphics exception
|
||
|
||
The project owner approved the following limited implementation scope:
|
||
|
||
> C code for screen-memory mapping and drawing changed regions, using CMOC/BGraph
|
||
> where practical, with no assembly or emulator changes and explicit 128 KB validation.
|
||
|
||
Allowed scope: the narrowly proposed CoCo 3 C framebuffer/MMU renderer in
|
||
`src/platform/coco3_video.c/.h` and associated memory/build documentation. Prefer
|
||
standard CMOC/BGraph primitives where practical. Bound dirty-region/text drawing,
|
||
preserve code, stack, BASIC graphics/disk workspace and interrupt behavior during
|
||
temporary mapping, and restore the state needed by standard APIs and disk calls.
|
||
Retain the public-API fallback and compare measured drawing and visible input.
|
||
|
||
This approval does **not** authorize hand-written assembly, custom sound/input/
|
||
interrupt drivers, emulator source access or changes, custom app builds, or a
|
||
replacement MCP integration. Use stock VCC Plus and the public reference boundaries in AGENTS.md. New
|
||
exceptions require review by the owner of the working fork. The 128 KB baseline
|
||
has since been verified; changes affecting memory require fresh target checks.
|
||
|
||
### Evidence prompting review
|
||
|
||
Official build 48, Release `-O2`, isolated MC6809, 512 KB, NTSC-rate worker:
|
||
|
||
- One 8×8 block erase/redraw through `hset`: worst 4 BASIC ticks at ordinary speed.
|
||
- T-piece one-cell shift: only four changed 8×8 cells (256 plotted pixels), worst
|
||
12 ticks at ordinary approximately 0.895 MHz speed.
|
||
- Same 60-shift test using standard `setHighSpeed(TRUE)` at approximately
|
||
1.79 MHz: p95 and worst both 6 ticks, approximately 100 ms.
|
||
|
||
Build `B928140E-6147-4DB5-BEF0-729678C498B0`, MCP revision 2, artifact
|
||
`12931271-4662-4B9F-B138-03913F23E58B`, disk SHA-256
|
||
`87f9d22c0afe7313f08031b9b4d88c2e0b6eeb4e81050739d108d82fe1fe76ad`.
|
||
These measure foreground drawing cost, not full-game input-to-display latency.
|
||
Smaller blocks, sparse outlines and staged `hset` drawing remain possible API-only
|
||
alternatives, with board-area, appearance or latency compromises. No direct screen
|
||
code was implemented before this approval was received and recorded.
|