Add Bone Quest anatomy quiz for CoCo
This commit is contained in:
commit
3cc37be5fb
50 files changed
+10146
No files matched your search
@@ -0,0 +1,70 @@
|
||||
# Bone Quest anatomy bank
|
||||
|
||||
The quiz identifies **25 major bones or bone groups** in the supplied anterior
|
||||
skeleton illustration. It does not ask separately about every individual bone
|
||||
in the adult skeleton. Left and right counterparts share one topic. Vertebrae
|
||||
are grouped by region; the bones of each wrist, palm, hand digits, rear foot,
|
||||
mid-foot and toes are also grouped.
|
||||
|
||||
`data/bones.json` is the canonical ordered bank. `src/bones.c` contains three
|
||||
runtime fields: displayed name, short location hint, and pipe-separated accepted
|
||||
aliases. Stable codes remain in JSON; fixed topic order binds artwork, history
|
||||
and questions. `tools/prepare_questions.py` regenerates the C table. Names are at
|
||||
most 22 characters and hints at most 30 characters.
|
||||
|
||||
## Naming choices
|
||||
|
||||
- **Cranium** follows the illustration's labeled grouping above the separately
|
||||
drawn mandible. **Skull** is accepted as the familiar introductory term. This
|
||||
is not a quiz distinguishing all cranial and facial bones. The skull includes
|
||||
the mandible in complete anatomical descriptions; the game treats the lower
|
||||
jaw as its own highlighted topic.
|
||||
- **Pelvic girdle** means the paired hip bones here. The sacrum and coccyx are
|
||||
separate topics. Bare **pelvis** is deliberately not an accepted alias because
|
||||
the complete bony pelvis includes those additional bones.
|
||||
- **Finger phalanges** includes the thumb. **Toe phalanges** is a separate topic.
|
||||
Bare **phalanges** is not accepted for either because it cannot distinguish
|
||||
the hand from the foot. **Finger bones / hand phalanges** and **toe bones /
|
||||
foot phalanges** are accepted respectively.
|
||||
- **Radius** and **ulna** are distinguished using the anatomical position: the
|
||||
radius lies on the thumb side and the ulna on the little-finger side.
|
||||
**Tibia** and **fibula** use the inner and outer sides of the lower leg.
|
||||
- **Sternum** is the whole breastbone topic, including its manubrium portion;
|
||||
the manubrium is not a second overlapping answer.
|
||||
- Common names such as collarbone, shoulder blade, breastbone, kneecap,
|
||||
thighbone, shinbone and tailbone are accepted. A location hint is not
|
||||
automatically an accepted answer. Names of body regions such as **forearm**
|
||||
or **foot bones** are too broad to identify one highlighted topic.
|
||||
|
||||
Canonical names and aliases are unique after lowercasing and collapsing spaces.
|
||||
Case and extra-space handling belongs to the shared quiz normalization; this
|
||||
bank supplies no ambiguous duplicate alias. The data contains no treatment,
|
||||
injury or diagnostic questions.
|
||||
|
||||
## Primary references checked
|
||||
|
||||
The following OpenStax *Anatomy and Physiology 2e* sections were consulted to
|
||||
verify names, group boundaries and location facts on November 11, 2026:
|
||||
|
||||
- [The skull](https://openstax.org/books/anatomy-and-physiology-2e/pages/7-2-the-skull)
|
||||
- [The vertebral column](https://openstax.org/books/anatomy-and-physiology-2e/pages/7-3-the-vertebral-column)
|
||||
- [The thoracic cage](https://openstax.org/books/anatomy-and-physiology-2e/pages/7-4-the-thoracic-cage)
|
||||
- [The pectoral girdle](https://openstax.org/books/anatomy-and-physiology-2e/pages/8-1-the-pectoral-girdle)
|
||||
- [Bones of the upper limb](https://openstax.org/books/anatomy-and-physiology-2e/pages/8-2-bones-of-the-upper-limb)
|
||||
- [The pelvic girdle and pelvis](https://openstax.org/books/anatomy-and-physiology-2e/pages/8-3-the-pelvic-girdle-and-pelvis)
|
||||
- [Bones of the lower limb](https://openstax.org/books/anatomy-and-physiology-2e/pages/8-4-bones-of-the-lower-limb)
|
||||
|
||||
These are factual verification references. No textbook passages, assessments or
|
||||
artwork are imported into the game. The concise location hints are written for
|
||||
this quiz; they are not quotations from the textbook.
|
||||
|
||||
## Diagram provenance
|
||||
|
||||
The visual reference is [Human skeleton front en.svg](https://commons.wikimedia.org/wiki/File:Human_skeleton_front_en.svg)
|
||||
by **Mariana Ruiz Villarreal (LadyofHats)**. The author released it into the
|
||||
public domain. The original Wikimedia description distinguishes labels for
|
||||
individual bones from labels for groups. Bone Quest uses its selected group
|
||||
names while keeping a single stable topic for paired counterparts. The retained
|
||||
source SVG and source-receipt.json belong to the artwork workflow; generated
|
||||
geometry and any simplifications must preserve this attribution and explain
|
||||
what was adapted.
|
||||
@@ -0,0 +1,18 @@
|
||||
# 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] Verify25 major bones/bone groups 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 covers named major bones and groups shown in the diagram, not 206
|
||||
individually selectable bones. Paired left/right examples share one question.
|
||||
@@ -0,0 +1,54 @@
|
||||
[
|
||||
{
|
||||
"file": "docs/images/title.png",
|
||||
"width": 640,
|
||||
"height": 480,
|
||||
"sha256": "c760e20e70c3063f2938acad87c80979ef8f795ff981bfa3eacb6fff5b3db9f3",
|
||||
"emulator": "VCC Plus 3.6.1 (54)",
|
||||
"processor": "MC6809",
|
||||
"ramKB": 512,
|
||||
"video": "RGB",
|
||||
"diskSHA256": "cf9b2da5842551d76b58c3be2064a78163536526826fca13ac7ee58c269e1e66",
|
||||
"capture": "Unmodified guest frame from isolated keyboard-driven playtest",
|
||||
"note": "Scripted validation includes deliberate incorrect answers."
|
||||
},
|
||||
{
|
||||
"file": "docs/images/multiple-choice.png",
|
||||
"width": 640,
|
||||
"height": 480,
|
||||
"sha256": "a0f272e2e0355260e27bfef6b5021e4cb984e054eac9e39a0f910f05af66e3c5",
|
||||
"emulator": "VCC Plus 3.6.1 (54)",
|
||||
"processor": "MC6809",
|
||||
"ramKB": 512,
|
||||
"video": "RGB",
|
||||
"diskSHA256": "cf9b2da5842551d76b58c3be2064a78163536526826fca13ac7ee58c269e1e66",
|
||||
"capture": "Unmodified guest frame from isolated keyboard-driven playtest",
|
||||
"note": "Scripted validation includes deliberate incorrect answers."
|
||||
},
|
||||
{
|
||||
"file": "docs/images/typed-answer.png",
|
||||
"width": 640,
|
||||
"height": 480,
|
||||
"sha256": "f44cd5b9493a2b4704532f444f4666b536db375e4b7a6338683bcade9246444d",
|
||||
"emulator": "VCC Plus 3.6.1 (54)",
|
||||
"processor": "MC6809",
|
||||
"ramKB": 512,
|
||||
"video": "RGB",
|
||||
"diskSHA256": "cf9b2da5842551d76b58c3be2064a78163536526826fca13ac7ee58c269e1e66",
|
||||
"capture": "Unmodified guest frame from isolated keyboard-driven playtest",
|
||||
"note": "Scripted validation includes deliberate incorrect answers."
|
||||
},
|
||||
{
|
||||
"file": "docs/images/results.png",
|
||||
"width": 640,
|
||||
"height": 480,
|
||||
"sha256": "81839f1acdf3511d62c52fc6fdc53df138a5b86048563628b450df6ffe7c6297",
|
||||
"emulator": "VCC Plus 3.6.1 (54)",
|
||||
"processor": "MC6809",
|
||||
"ramKB": 512,
|
||||
"video": "RGB",
|
||||
"diskSHA256": "cf9b2da5842551d76b58c3be2064a78163536526826fca13ac7ee58c269e1e66",
|
||||
"capture": "Unmodified guest frame from isolated keyboard-driven playtest",
|
||||
"note": "Scripted validation includes deliberate incorrect answers."
|
||||
}
|
||||
]
|
||||
@@ -0,0 +1,64 @@
|
||||
# Initial Bone Quest verification — November 11, 2026
|
||||
|
||||
## Built and delivered
|
||||
|
||||
The root BONEQ.DSK is a standard 35-track DECB image, 161,280 bytes, SHA-256:
|
||||
|
||||
`cf9b2da5842551d76b58c3be2064a78163536526826fca13ac7ee58c269e1e66`
|
||||
|
||||
Built with installed VCC Plus 3.6.1 (54), bundled CMOC 0.1.100 and LWTools 4.25.
|
||||
Release, Debug and Test disk builds passed. Program/static storage ends at
|
||||
$764E (Release),$7687 (Debug),$7653 (Test), below the $7800 limit and separate
|
||||
2 KB stack reservation. Two graphics pages retain the public GIME512 KB contract.
|
||||
Generated skeleton geometry occupies 5,975 bytes; ordinary builds do not run an
|
||||
SVG renderer or need Python/Pillow/rsvg-convert.
|
||||
|
||||
## Logic and artwork
|
||||
|
||||
make test passed: 50,000 option sets across 2,000 games, all 25 topics once per game,
|
||||
four distinct choices, no consecutive repeated correct slot, all permitted
|
||||
slot transitions, replay reset, canonical names/common aliases, known-wrong
|
||||
name/alias priority, spelling checks, scoring and duplicate-answer guards.
|
||||
All 25 authoring topics/aliases agree exactly with generated C. The original SVG
|
||||
hash matches its receipt. Six geometry views have bounded, disjoint spans;
|
||||
each topic has nonempty overview coverage, with detailed small-bone views.
|
||||
|
||||
## Feedback audio
|
||||
|
||||
Separate bounded correct/incorrect feedback captures contained nonzero 44.1 kHz
|
||||
stereo PCM (peak 16128). Capture began at the actual feedback phase, before the
|
||||
tones; no microphone or host audio device was used. This establishes generated
|
||||
guest signal, not audible listening or comprehensive frequency analysis.
|
||||
|
||||
## Actual gameplay
|
||||
|
||||
The actual Release disk completed a 25-question multiple-choice game AND a
|
||||
25-question typed game on each emulated MC6809 and HD6309, with512 KB RAM,
|
||||
CoCo 3 BASIC, FD-502 Disk BASIC and RGB video. Tests used isolated app-owned
|
||||
machines and disposable disk copies; no personal emulator or desktop input
|
||||
was controlled.
|
||||
|
||||
The driver decoded displayed text against the matching linked font and checked
|
||||
the skeleton's actual pixels against the topic masks and answer history. It
|
||||
verified question numbers, readable choices, current highlighting, purple/red
|
||||
progress, no consecutive correct-slot repeats, held-key protection, deliberate
|
||||
wrong answers, common aliases, case/spacing, spelling retry and Backspace,
|
||||
33-character entry bounds, reveal, scores 20/25 (80%), one correction, paged
|
||||
review, neutral replay title and clean return to BASIC. Both runs preserved the
|
||||
disk hash and reported zero guest writes.
|
||||
|
||||
To repeat these developer checks, provide your own ROM paths explicitly:
|
||||
|
||||
```sh
|
||||
python3 tests/playtest.py --rom /path/to/coco3.rom --disk-rom /path/to/disk11.rom
|
||||
```
|
||||
|
||||
The harness uses the installed app's isolated helper and is qualified against
|
||||
the build identified above; it is not a general alternate MCP server. Private
|
||||
ROMs, raw captures, result JSON and build outputs stay ignored under test-output/.
|
||||
Selected unchanged guest frames are retained in docs/images/ and identified by
|
||||
docs/SCREENSHOTS.json. They are actual game frames, not native-window marketing
|
||||
captures or mockups.
|
||||
|
||||
No physical CoCo, host Intel, macOS 14 or audible listening qualification is
|
||||
claimed. Native editor/source-open UI is not exercised by the headless tests.
|
||||
Binary file not shown.
|
After Width: | Height: | Size: 14 KiB |
Binary file not shown.
|
After Width: | Height: | Size: 13 KiB |
Binary file not shown.
|
After Width: | Height: | Size: 13 KiB |
Binary file not shown.
|
After Width: | Height: | Size: 14 KiB |
Reference in new issue
Block a user