Files
BoneQuest/tests/GRAPHICS.md
T

33 lines
1.9 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Isolated high-resolution graphics checks
Run the independent graphics fixture with your own private ROMs:
```sh
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.