Files

2.1 KiB
Raw Permalink Blame History

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.