33 lines
1.9 KiB
Markdown
33 lines
1.9 KiB
Markdown
# 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.
|