Publish Bone Quest player manual and release sources

This commit is contained in:
Brian Holman committed 2026-11-11 23:49:29 -07:00
1 parent 2ceb44a48c
commit ea87321e61
22 files changed
+996 -3

No files matched your search

+100
View File
@@ -0,0 +1,100 @@
# Sources, attribution and licenses
Bone Quest is Brian Holman's C anatomy quiz, developed with assistance from
ChatGPT/Codex. It uses the GPL-3.0-or-later Capital Quest foundation at revision
[afa6f3c2a05cbd71c1f22ec3506f4f63421b2bc6](https://vccplus-git.brianholman.com/VCCPlusApps/CoCoCapitalQuiz/commit/afa6f3c2a05cbd71c1f22ec3506f4f63421b2bc6).
The geography dataset and Fla-shop map are not part of Bone Quest.
## Game, manual and anatomy bank
Game source and the player manual are GPL-3.0-or-later. The manual is
© Brian K. Holman 2026. LICENSE retains the full GPL version 3 text. These
statements do not replace an original component's file-specific terms.
The authored facts and accepted answer aliases are in data/bones.json. The
28 learning units are bones, bone groups, parts of bones and two cavities;
they do not claim to identify every individual adult bone. Paired left/right
examples share a question. docs/ANATOMY.md explains terminology, factual
references and grouping. tools/prepare_questions.py validates and regenerates
the small runtime table. Textbook questions, passages and images are not copied.
## Skeleton source and adaptations
The original Human_skeleton_front_en.svg is by **Mariana Ruiz Villarreal
(LadyofHats)**, released into the public domain by its author. The retained
SVG and metadata are unchanged:
- [Original/terms](https://commons.wikimedia.org/wiki/File:Human_skeleton_front_en.svg)
- [Original SVG](https://upload.wikimedia.org/wikipedia/commons/c/ca/Human_skeleton_front_en.svg)
- SHA-256: `501752c94533439a31521a929a10ad1dd1b781f588d44fc87144c426a38b8773`
Adaptations remove labels/leader lines, fit the CoCo's native pixel aspect,
preserve internal linework, assign per-structure ownership, encode compact
runs, recolor, and prepare enlarged regions. The sternum and hip components
use documented coordinate cuts. The anatomical left thumb is rotated toward
the palm as one three-bone chain, preserving relative lengths and joints.
The second, user-supplied labeled raster reference guides the 28-topic list and
outline preference; its pixels are not included in the game or public source.
Exact source elements, geometry cuts and masks are recorded in
data/geometry-manifest.json. The optional authoring script is retained;
ordinary builds use the generated C metadata and BONES.DAT, without an SVG
renderer. The artist does not endorse this adaptation. See assets/CREDITS.md.
## Linked components and corresponding sources
- Pierre Sarrazin's **font5x8**, from HiresTxt 0.5.1, retains its explicit
public-domain dedication in the source companion and component notice.
- tools/boot.c adapts Pierre Sarrazin's public-domain autostart.c 0.1.2 to load
BONEQ.BIN. Its original header remains.
- **BControl 0.1.6** provides the original Keyboard_init/poll/shutdown routines.
Its full sources and notices are preserved unchanged. Keyboard.c states public
domain except parts that come from Color Basic. The game's GPL does not rewrite
that source-specific wording; see assets/BCONTROL-NOTICE.txt.
- The original **VCC Plus bank/input SDK** sources and public headers retain
GPL-3.0-or-later. The bank library stores the read-only drawing data. The input
archive appears in the game Makefile but contributes no object to this binary.
- **decbfile 0.1.13** is Pierre Sarrazin's public-domain file library. Only its
ordinary ROM-backed core is linked. It uses the Disk BASIC already in the
guest; no Disk BASIC ROM bytes or standalone Disk BASIC-derived driver are
included. Its exact upstream release and original file hashes are retained.
- **CMOC 0.1.100** supplies CRT, standard-library and BASIC-backed numeric runtime
objects. The companion preserves the source-only pinned snapshot, licenses,
original build system, import/compiler patches and build references.
- The complete local 640 × 225 graphics implementation is in src/graphics.c and
graphics.h. It adapts VCC Plus's GPL SDK gime.c at upstream revision
`f1ab8538a5b6b88a82951e9305db349a470a4e86`, original file SHA-256
`3a4ec27d3bc19cf59b1bcf23ae9ccb89aa308731e97ec12ef9609516c323859d`.
Its four-color packing, page sizes and copy operation do not change the public
SDK's separate 320 × 192 contract. The companion retains that foundation
source; libgime.a is not linked by Bone Quest.
Download the [matching library-source companion](https://vccplus.brianholman.com/dl/software/CoCoLibrary/Sources/Exclusives/BoneQuest/2026-11-11/cfa179075827/Bone-Quest-Library-Sources.zip).
It is separate from the small writable C-workspace starter so opening the game
need not import hundreds of compiler/runtime files. SOURCE_INVENTORY.json pins
component files, upstream releases and patch provenance. The target-only rebuild
driver uses installed VCC Plus tools in a fresh copy and never modifies snapshots
or the installed app. The full rebuild and comparison receipt accompanies it.
The reconstructed bank, input, ROM-backed decbfile, BControl, CMOC CRT, standard
and BASIC-backed float archives match installed VCC Plus 3.6.1 (54) byte for
byte. The font-only HiresTxt archive intentionally omits unrelated members;
its font5x8.o matches the installed member exactly. Keyboard.o also matches. The relevant runtime/library artifacts in the retained
public VCC Plus 3.6.2 (55) app are identical to those build 54 inputs.
No ROM image, Float09.bin, standalone Disk BASIC-derived driver, private grant,
credential or generated compiler binary is included in the source companion.
Rebuilding a host compiler from its sources is a separate developer task with
additional dependencies; normal game builds use the supported bundled tools.
## Release identity
The accepted game implementation is revision
`2ceb44a48ce45382ab5a531a1db9341de69ca6ca`. Its approved BONEQ.DSK is
161,280 bytes, SHA-256:
`373a3f387daf541b1eb4edd3421a125dd57094e600ee48d162802ac22f65ceba`
The public release adds documentation and packaging without changing executable
inputs or disk bytes. docs/PUBLIC_RELEASE.md describes qualification;
docs/manual/screenshots.json identifies selected unmodified guest illustrations.
The final release descriptor records the publication/source revision separately.