Implement CoCo 3 Quadrapassel and deliver build 01
Add gameplay, keyboard/joystick controls, disk-backed high scores and settings, standard CMOC effects, and the approved C graphics renderer. Include the clearer attributed font, title/credits updates, source-verified Modern and Classic (40.2) scoring, meaningful regression fixtures, and recorded guest validation. Deliver QUADPSL01.DSK with fresh high scores. Retain source, licenses and selected guest evidence; exclude personal disks, private connections and build scratch. Host rules/input/persistence/video checks and memory guards pass. Official 512 KB playtests pass the recorded checks; actual 128 KB/physical joystick qualification and the normal-window buzzing retest remain pending.
This commit is contained in:
1 parent
8a4b44bc73
commit
d412e35c4e
79 files changed
+4187
-16
No files matched your search
@@ -0,0 +1,49 @@
|
||||
# CoCo 3 memory contract
|
||||
|
||||
Current candidate uses stock Disk BASIC and `PCLEAR1`, then
|
||||
`LOADM"QUAD.BIN":EXEC`. `PCLEAR0` was tested in an isolated official build-48
|
||||
MC6809/512 KB machine and returned `?FC ERROR`; it is not used.
|
||||
|
||||
The standard CMOC linker places code/constant data at $1400 and writable static
|
||||
data at $0E00. The one reserved legacy PMODE page ($0E00–$13FF) is deliberately
|
||||
used for the game's static variables. This is a CoCo 3-only program: it never
|
||||
calls PMODE or PCLS. HSCREEN 2 uses its separate physical graphics banks $30–$33.
|
||||
Graphics is initialized once before preferences are created. Scene changes clear
|
||||
only the framebuffer through the approved renderer, keeping ROM initialization
|
||||
outside live game state. No BASIC user program or prior
|
||||
low-resolution picture is preserved by launching
|
||||
this game. BASIC system RAM, text RAM and disk buffers below $0E00 remain intact.
|
||||
|
||||
The November 11 layout/scoring-label update ends code/constants at $7AF4 and static data at
|
||||
$13DE (1,502 bytes including initialized variables). The limits remain unchanged.
|
||||
The font uses 336 row bytes plus 12 punctuation codes; 198 bytes of font/packing
|
||||
data are stored in the low data region and only read by the renderer. $7B00–$7FFF is kept free for
|
||||
the foreground/ROM stack, with CMOC configured for 1,024 bytes. The split layout has passed settings and earned-score save/reload checks on
|
||||
MC6809/512 KB in the official app. Full stack qualification and actual 128 KB
|
||||
testing remain pending. This is a checked
|
||||
address budget, not a claim that 128 KB has passed.
|
||||
|
||||
`tools/check_memory.pl` verifies every nonempty link-map section independently.
|
||||
This is necessary because CMOC's `--limit` checks `program_end`, which is the low
|
||||
static-data end when `--data` is used. The build fails if code/constants extend
|
||||
past $7B00 or static data extends past $1400. No data or stack may occupy the
|
||||
renderer’s temporary $8000–$9FFF MMU window.
|
||||
|
||||
The approved C renderer temporarily maps task-0 slot 4 to graphics banks $30–$33,
|
||||
copies bounded chunks and restores the prior mapping before standard APIs run.
|
||||
CMOC does not implement volatile: a separate read function is used and emitted
|
||||
reads/stores must be audited in each delivered candidate. No authored assembly,
|
||||
custom interrupt handler or custom sound driver is used.
|
||||
|
||||
Menu text is loaded through standard decbfile APIs from twelve independently
|
||||
checksummed 512-byte pages in QPTEXT.DAT. The menu buffer shares storage with the
|
||||
288-byte tile cache and 200-byte board cache; gameplay rebuilds those caches on
|
||||
resume. Original title lettering uses 84 bytes of shape data and a scanline
|
||||
scratch buffer, rather than a full-screen bitmap.
|
||||
|
||||
The score store keeps one 256-byte page and one 80-byte top-ten table in RAM.
|
||||
QPSAVE0.DAT/QPSAVE1.DAT each hold 35 sectors, with the commit header written last.
|
||||
Files longer than the schema allows are rejected and reported; the program does
|
||||
not truncate an unexpectedly oversized file. Missing/short inactive files can be
|
||||
created/extended using the documented file API. Only the two named save files
|
||||
are written. QPTEXT.DAT is read-only game data.
|
||||
Reference in new issue
Block a user