66 lines
3.8 KiB
Markdown
66 lines
3.8 KiB
Markdown
# Bone Quest implementation
|
||
|
||
Working checklist:
|
||
|
||
- [x] Create private VCCPlusApps/BoneQuest repository and separate main checkout.
|
||
- [x] Adapt the supplied public-domain SVG into compact per-topic graphics.
|
||
- [x] Verify 28 reference structures and accepted answer aliases.
|
||
- [x] Implement anatomy-specific layout, two modes, feedback/review/replay.
|
||
- [x] Build with stock VCC Plus tools and create BONEQ.DSK.
|
||
- [x] Run host/geometry and isolated6809/6309 gameplay checks.
|
||
- [x] Retain representative real screenshots and usable build/play instructions.
|
||
|
||
Foundation: Capital Quest, revision afa6f3c2a05cbd71c1f22ec3506f4f63421b2bc6,
|
||
GPL-3.0-or-later. Its geography assets/manuals are not used by Bone Quest.
|
||
Skeleton: Mariana Ruiz Villarreal (LadyofHats), Wikimedia Human_skeleton_front_en.svg,
|
||
author's public-domain dedication; original retained under assets/ with hash receipt.
|
||
The quiz follows the 28 structures in Brian's reference, including distinct
|
||
sternum sections, ilium/pubis and orbital/nasal cavities. It does not cover 206
|
||
individually selectable bones. Paired left/right examples share one question.
|
||
The original SVG remains the retained source; the supplied raster reference
|
||
guides subject selection and the preference for clear outlines and rib gaps.
|
||
|
||
|
||
## High-resolution rendering
|
||
|
||
Brian requested the highest native CoCo 3 resolution with a mostly black-and-white
|
||
skeleton. The game now uses 640 × 225, four colors: black background/linework,
|
||
white anatomy, yellow current structure and red missed structures. Correct
|
||
structures return to white rather than consuming another palette entry.
|
||
|
||
The local GPL graphics driver adapts VCC Plus's original SDK GIME implementation;
|
||
its upstream revision/hash remain in src/graphics.c. It owns two 40 KiB pages in
|
||
physical banks $1E–$27, leaving the documented bank library's $28–$2B available
|
||
for artwork. Both drawings and the 2 KB stack stay separate from the program.
|
||
The driver clips 2-bit pixels, borrows the $8000 window only in short masked
|
||
sections, restores the MMU/interrupt state, flips at vertical blank, and restores
|
||
BASIC on exit. gfx_copy_front copies the visible page to the hidden page so
|
||
feedback and spelling prompts can reuse the skeleton rather than repainting it.
|
||
|
||
BONES.DAT contains six compact drawing views, loaded read-only from drive 0 into
|
||
asset banks once at startup. The loader validates exact size and a generated
|
||
checksum; host checks verify SHA-256. Normal builds retain this data and the small
|
||
C metadata, with no asset authoring dependencies. The original SVG is rendered
|
||
anew at 872 × 1684 before reduction, with native pixels treated as 1:2 in physical
|
||
width:height. The 159 × 184 overview and enlarged regional views retain rib gaps,
|
||
facial recesses, joints and bone boundaries. Precise source selection, coordinate
|
||
cuts and ownership evidence are in data/geometry-manifest.json.
|
||
|
||
The source game, emulator and website repositories remain separate. This work
|
||
changes Bone Quest only; the VCC Plus app and Capital Quest are unchanged.
|
||
|
||
|
||
## Hand pose and global exit refinement
|
||
|
||
The anatomical left thumb (screen right) now rests closer to the palm. The
|
||
converter rotates its metacarpal and both phalanges together by 30 degrees about
|
||
source point (367,416), preserving bone lengths and joint relationships. Both
|
||
region ownership and linework use that same transform in overview/detail views;
|
||
the original SVG is unchanged. The exact source element IDs are in the manifest.
|
||
|
||
Q/q, Escape (ASCII 27) and CoCo Break (ASCII 3) now call one cleanup path from
|
||
all interactive screens. It releases the keyboard, closes graphics and asset
|
||
banks, restores normal CPU speed and returns to BASIC. The automatic reading
|
||
pause polls those keys too. Escape/Break are no longer reveal shortcuts: blank
|
||
Enter reveals an answer as a miss; the spelling-help menu retains V to reveal.
|