Files
BoneQuest/tests/GRAPHICS.md
T

1.9 KiB
Raw Blame History

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.