1.9 KiB
Isolated high-resolution graphics checks
Run the independent graphics fixture with your own private ROMs:
python3 tests/check_graphics.py --rom /path/to/coco3.rom --disk-rom /path/to/disk11.rom
The installed VCC Plus app supplies the CMOC tools and isolated vcc-playtest
helper. This does not launch or control the normal emulator, use personal media,
or rebuild/replace the game disk. Each run builds a fresh fixture disk and keeps
its source hashes, logs and captures beneath ignored test-output/graphics/.
Use --app for another app bundle or --evidence for another output directory.
Private ROM paths must be supplied explicitly; no ROMs are retained by the test.
The guest fixture checks every pixel in four observations of three 640 × 225 four-color presentations, partial byte edges, all four 8 KiB bank seams, the final scan line, clipping and no-op inputs. It copies the displayed second page into the hidden first page, changes a few edge pixels, and verifies that every other pixel is preserved. A capture before the explicit third presentation verifies that the hidden edits have not appeared prematurely. It verifies normal MMU mappings between draw calls, page flipping, return to BASIC and zero disk writes on both emulated CPUs. Captures are actual guest frames, not synthesized previews. They do not establish physical hardware, host Intel or audible behavior.
The supplemental host check compiles the actual current gfx_fill_rect function
with only its hardware span writer substituted. It compares all horizontal
positions/widths on 15 critical rows and 1,000 clipped multirow rectangles with
an independent per-pixel reference, including untouched neighboring bits and
memory beyond the visible image. A host C compiler is required for this optional
check; --skip-host records the skip instead of reporting it as a pass. Ordinary
game builds do not require a host compiler or these tests.