Publish Bone Quest player manual and release sources
This commit is contained in:
1 parent
2ceb44a48c
commit
ea87321e61
22 files changed
+996
-3
No files matched your search
@@ -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.
|
||||
Reference in new issue
Block a user