Files
BoneQuest/README.md
T

85 lines
4.7 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.
# Bone Quest for CoCo
An anatomy quiz for a 512 KB Color Computer 3, built from Capital Quest's working
quiz foundation. Identify 28 skeletal structures on a human skeleton,
choose among four names or type the answer, then review missed questions.
The skeleton uses native 640 × 225 graphics with four colors and page swapping.
Download the ready-to-test [BONEQ.DSK](BONEQ.DSK). Both complete quiz modes have
been checked in VCC Plus on emulated MC6809 and HD6309 processors.
![Bone Quest identifying ribs in the high-resolution full skeleton and enlarged chest view](docs/images/multiple-choice.png)
## Machine and loading
Use a CoCo 3 with 512 KB RAM, BASIC, an FD-502 Disk BASIC controller and a keyboard.
RGB is the intended color presentation. Insert a copy of BONEQ.DSK in FD0,
preserve existing guest work, choose Cold Restart, then type DOS at the OK prompt.
The direct loading command is `LOADM"BONEQ.BIN":EXEC`. The game does not save scores
or write to its disk. Use disposable copies while developing.
## Controls and rules
- At any screen, Q, Escape or CoCo Break quits to BASIC, including during
a question or the automatic feedback pause.
- Title: 1 multiple choice, 2 typed answers, C credits.
- Multiple choice: 1–4 selects an answer. The correct slot is chosen randomly from
the three that were not correct last time; the first question can use any slot.
Feedback advances automatically after its sound and reading pause.
- Typed answers: Enter submits, Backspace edits, blank Enter reveals, Space advances
after feedback. Case and extra spaces are ignored. Common names such as
collarbone, shoulder blade, thighbone, kneecap, shinbone and tailbone are accepted.
A close spelling offers R to retry or V to reveal; a corrected answer earns
one point, with corrections counted separately. A blank answer or reveal counts
as a miss. The entry limit is 33 characters.
- Progress: white bones, red missed structures, yellow current. Correct answers
return to white; feedback and the score confirm success. The full skeleton keeps
context while a detail panel enlarges the selected area. Dark linework separates
neighboring bones and individual ribs. Unquizzed anatomy stays white for context.
- Results: R review, N next review page, B back, P play again, Q quit. Each topic is
asked once. One correct answer earns one point; percentage is correct/28×100.
The quiz follows the 28 labels in the supplied reference: bones, bone groups,
bone parts and two facial cavities. It does not cover every individual bone
in an adult skeleton. Paired left/right counterparts share a question. The
manubrium, sternum body and xiphoid process are separate topics, as are the
ilium and pubis. Finger and toe phalanges are separate topics;
bare "phalanges" is deliberately not a complete answer. See docs/ANATOMY.md.
## Build
Open the folder containing Makefile and vccplus-project.json in VCC Plus's
Develop → C Development workspace. Select Release and Build, then use Show Build
Products to locate build/BONEQ.dsk. Normal builds use the installed app's bundled
CMOC/LWTools/Make/Perl and need no Xcode, Homebrew or asset-generation tools.
Equivalent command-line build:
```sh
export PATH="/Applications/VCC Plus.app/Contents/Resources/Toolchain/bin:$PATH"
make VCC_CONFIGURATION=Release disk
```
Debug uses optimized code with frame pointers; Test uses deterministic seed 2709.
Clean between configurations in one working folder. Generated anatomy metadata
and BONES.DAT are retained for normal builds. Optional asset regeneration needs Python 3, Pillow
and rsvg-convert; optional host logic tests need a host C compiler.
After editing data/bones.json or the skeleton artwork, run make assets to refresh
the retained metadata and drawing data. make test detects stale question data and invalid geometry.
## Credits and source
Based on Capital Quest by Brian Holman, revision
[afa6f3c](https://vccplus-git.brianholman.com/VCCPlusApps/CoCoCapitalQuiz/commit/afa6f3c2a05cbd71c1f22ec3506f4f63421b2bc6),
GPL-3.0-or-later. Bone Quest is a separate project; Capital Quest is unchanged.
Skeleton artwork: Mariana Ruiz Villarreal (LadyofHats), author's public-domain
release via Wikimedia Commons. The original SVG and source receipt are retained.
Adaptations remove labels, fit the CoCo pixel aspect, preserve bone/rib linework,
recolor and encode per-topic masks and enlarged detail views. See assets/CREDITS.md and docs/ANATOMY.md.
The game remains GPL-3.0-or-later; preserve the full LICENSE and component notices.
Pierre Sarrazin's font and boot helper keep their public-domain headers. The
bundled libraries retain their individual terms, including the original BControl
notice. No ROM image or private connection is included here.