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,164 @@
|
||||
# CoCo 3 implementation status — November 11, 2026
|
||||
|
||||
The current disk contains a playable CoCo 3 game with standard CMOC sound,
|
||||
settings and disk-backed high scores. Actual 128 KB qualification remains
|
||||
pending; CoCo 2 adaptation is deferred at Brian's direction.
|
||||
|
||||
## Current numbered delivery
|
||||
|
||||
Brian requested `QUADPSLxx.DSK` with a two-digit build number and fresh high
|
||||
scores. The first is **QUADPSL01.DSK**, byte-identical to the clean official
|
||||
artifact below. No QPSAVE files are included; old personal score disks remain
|
||||
untouched. The next changed delivery is 02. See [BUILDS.md](BUILDS.md).
|
||||
|
||||
## Current title, scoring-label and audio follow-up
|
||||
|
||||
The standard Release candidate now has an eight-pixel gap before the title
|
||||
copyright, the credits entry `Brian Holman - Mac & Coco`, and explicit
|
||||
**Scoring Rules: Modern / Classic (40.2)**. Keep high scores is the default;
|
||||
no personal records were erased. Inspection of Brian's supplied Mac source
|
||||
confirmed the existing scoring formulas, including the Classic 40.2 bottom-row
|
||||
bonus. All 25 cases also pass through actual piece drops.
|
||||
|
||||
Official build 51, project revision 2, build
|
||||
`DFDE8C57-3165-44B5-9027-E8B2F16DDF28`, artifact
|
||||
`BB277DE8-07A2-437B-9998-FFD1FB2C36C5`, zero diagnostics.
|
||||
Clean disk SHA-256:
|
||||
`4ac171e87c51dfd99b302b9e035a91a59c030144e5ae0661a6d2dfc84ba3a63f`.
|
||||
Code/constants end $7AF4; static data end $13DE. The normal-window buzz persists
|
||||
in Brian's prior candidate after restart and stops when paused; it remains
|
||||
unconfirmed fixed. An extra standard-library mute after input sampling passes
|
||||
worker silence/effect checks. Details, captures and score-preservation proof:
|
||||
[TITLE_AND_SCORING_UPDATE.md](TITLE_AND_SCORING_UPDATE.md).
|
||||
|
||||
## Previous font candidate
|
||||
|
||||
The November 11 font/border/copyright candidate passed an official VCC Plus
|
||||
3.6.0 (51) Release build and MC6809 / 512 KB disposable playtest. The font uses
|
||||
Pierre Sarrazin's public-domain CardGame data, with attribution. Modern outlines
|
||||
are dark gray while the background stays black. Title text is
|
||||
`(c) 2026 Brian Holman`, displayed in the font's uppercase character set.
|
||||
|
||||
- Project `84772EFC-B651-4A98-B09E-932247575EA7`, revision 1.
|
||||
- Build `FAD8FBEA-F07D-4FE8-AE45-E569EEA5E5CC`, artifact
|
||||
`4566B606-6576-482A-BA3E-BCC673EC729B`; no compiler diagnostics.
|
||||
- Binary 26,589 bytes, SHA-256
|
||||
`9eec745d50544884d74211492f0118360d79212f05864d9e81fa43a1a56ed041`.
|
||||
- Pristine DSK SHA-256
|
||||
`12f0ee508d5b48bbbe44d1f2b701eb31ae5bd5d3cbb863e1005540524d5dbfb3`.
|
||||
- Code/constants end $7AFE; static data end $13DD. Existing limits and
|
||||
1,024-byte stack reserve retained. Further growth needs compaction.
|
||||
- Pixel tests compare against the unmodified upstream font; palette, all seven
|
||||
Modern tile colors, Plain/Clean behavior and edge-cell clipping pass under
|
||||
AddressSanitizer/UndefinedBehaviorSanitizer.
|
||||
- Actual title, settings and gameplay framebuffer captures inspected. Hold/drop
|
||||
exercised; a normal settings save wrote the disposable disk successfully.
|
||||
- Captured idle audio is zero in both channels; movement has a brief effect and
|
||||
silent final 500 ms. Owned run stopped.
|
||||
- New private disk copy preserves both existing high-score files byte-for-byte.
|
||||
|
||||
Details, screenshots, saved-disk identity and remaining limits:
|
||||
[FONT_UPDATE.md](FONT_UPDATE.md). Persistence code and gameplay rules are unchanged;
|
||||
prior cold-boot score evidence below remains applicable to that unchanged code.
|
||||
Actual 128 KB and physical joystick qualification remain pending.
|
||||
|
||||
## Previous audio candidate — November 10 build identity
|
||||
|
||||
- Base Git revision: `8a4b44bc7358b1a999296d14d8c5272e57b65992`, main, with
|
||||
uncommitted implementation. No implementation commit or push was requested.
|
||||
- Official application: VCC Plus 3.5.5 (48), supported C-project MCP connection.
|
||||
- Previous code build: project revision 16, Release,
|
||||
build `CFC0A2F2-9247-4B1C-9CF8-8CC1AFE896B6`,
|
||||
artifact `261716EE-81C8-487D-A7BF-E5C9F51BC044`.
|
||||
- Binary: 26,370 bytes,
|
||||
SHA-256 `5c9f3be05fde79e09a5a583740e676f2fb06eddc136dd9d419f62f12da6bebfe`.
|
||||
- Previous pristine `Quadrapassel.DSK`: 161,280 bytes,
|
||||
SHA-256 `d23bc2a1aa60970becaf7ff8be064efc8ea47a5043adf9661d9a6c22bcedfd9b`.
|
||||
This matched that official MCP artifact, not a saved playtest copy.
|
||||
- Linked code/constants end at $7AE8 (24 bytes before the enforced $7B00 limit).
|
||||
Writable static data ends at $1318 (232 bytes before $1400). The stack reserve
|
||||
is 1,024 bytes; detailed contract and qualification limits are in MEMORY_LAYOUT.md.
|
||||
- The pristine disk has 50 free granules and no save files. Two 35-sector save
|
||||
files need four granules each. DOS loader tracks are reserved by the template.
|
||||
|
||||
## Implemented
|
||||
|
||||
- All 28 piece states, safe above-board behavior, specified kicks, gravity,
|
||||
hard/soft drop, persistent Hold swap, shadow and simultaneous compaction.
|
||||
- Modern/Classic 32-bit saturating scoring, level transitions and Relaxed mode.
|
||||
- Version-1 xorshift32 seeded stream, inverse-square balancing, prefill and
|
||||
Difficult Pieces metric/selection. Difficult search is currently synchronous.
|
||||
- Keyboard controls and a one-button joystick input state machine, settings,
|
||||
seed editor, pause/actions/confirmation screens, score browser and initials.
|
||||
- Code-drawn title and cached tiles; menu focus updates without full redraws.
|
||||
Scene text is a bounded, checksummed disk asset sharing the display cache.
|
||||
- Standard CardGame `initSound`/`beep` effects, with the standard bsound mute
|
||||
helper closing audio around joystick sampling and between effects. No custom driver.
|
||||
- Versioned QPSAVE0.DAT/QPSAVE1.DAT store for all 34 categories, ten records each,
|
||||
initials and scoring-rule markers. CRC/range/length validation, generation
|
||||
selection, older-slot recovery, header-last commits and readback verification.
|
||||
Only those two named files are written; errors are visible and play can continue.
|
||||
|
||||
## Evidence and limits
|
||||
|
||||
| Check | Result |
|
||||
| --- | --- |
|
||||
| Host rule fixtures, sanitizer build | Passed: 28 states, all kick fixtures, bounds/top-out, compaction, 25 scoring cases, gravity, Hold, RNG/prefill and Difficult metrics |
|
||||
| Host input fixtures, sanitizer build | Passed: repeat/conflicts/edges, fire timing, hysteresis, diagonal and disconnected-stick keyboard behavior |
|
||||
| Host persistence fixtures, sanitizer build | Passed: 34 categories, stable ties, rule markers, 32-bit values, CRC, read-only reset, all 36 logical torn-write boundaries and recovery |
|
||||
| Official Release build and memory bounds | Passed, final build above, no compiler diagnostics |
|
||||
| MC6809 / 512 KB | Passed: DOS title, gameplay, movement/rotation/Hold/hard drop, settings, cached settings redraw and fast menu focus |
|
||||
| Settings save and cold-boot reload | Passed on revision 12: Sound OFF and Custom Seed ON reloaded from the same disposable disk |
|
||||
| Earned high score save and cold-boot reload | Passed on revision 12: seed zero, 12 authored placements, one line/40 points, initials BRH, Modern marker in difficulty-0 Normal category; survived another cold boot |
|
||||
| Clean BASIC return and manual fallback | Passed on revision 13: Quit returned OK; PCLEAR1, LOADM"QUAD.BIN", EXEC reached the title |
|
||||
| HD6309 / 512 KB | Revision 16 idle/effect audio checks and prior title/gameplay framebuffer smoke passed in reset emulation mode; not a native-mode qualification |
|
||||
| Physical CoCo 3 / 512 KB | Brian reported successful gameplay on November 11, 2026 ("It worked great"); RAM confirmed as 512 KB. Exact disk hash, CPU upgrade status and individual audio/save/joystick checks were not specified |
|
||||
| CoCo 3 / 128 KB | Pending actual application/manual test; MCP workers remain fixed at 512 KB |
|
||||
| Physical joystick ports and joystick-only usability | Pending; logical fixtures/neutral samples are not physical-port passes |
|
||||
| Guest read-only/corrupt media and interrupted FAT/directory writes | Pending; logical host fault tests do not establish these physical disk cases |
|
||||
| Direct guest audio, idle/mute and bounded effects | Passed captured windows on 6809 and 6309; actual-app reported noise retest pending; see AUDIO_VALIDATION.md |
|
||||
| Current input/render latency, sound-on worst case, clears and Difficult search | Not fully qualified; earlier renderer probe timing is not a complete-game timing pass |
|
||||
| PAL/50 Hz, physical Intel, CoCo 2 | Not qualified by these runs |
|
||||
| Debug/Probe configurations with the final split layout | Not qualified; use Release for this disk |
|
||||
|
||||
The earned-score run was `9AFA5124-4FDE-4E3D-95EE-228FCE945951`.
|
||||
Its retained writable disk SHA-256 is
|
||||
`44ca3987b8d3a1e02ee41f1a0de8bd587be5a6835f8bdc5186b22138e6be0355`.
|
||||
That disk is separate from the pristine deliverable. All owned runs are stopped.
|
||||
Final menu/cache and 6309 changes did not alter the validated persistence codec.
|
||||
|
||||
## Capture interpretation
|
||||
|
||||
Presented-frame PNGs sometimes omitted unchanged screen content during these
|
||||
runs. The supported paused `capture_playtest_graphics` preview showed the title,
|
||||
HUD/frame and cached settings intact in the current physical HSCREEN 2 buffer.
|
||||
Visual verification therefore uses these direct guest-framebuffer previews in
|
||||
addition to ordinary screenshots. No emulator internals were inspected and no
|
||||
emulator change is required for the current disk.
|
||||
|
||||
Selected evidence is under docs/screenshots/, including
|
||||
high-score-saved-512k.png, high-score-reloaded-512k.png,
|
||||
title-clean-512k.png, gameplay-framebuffer-512k.png,
|
||||
settings-cached-framebuffer-512k.png and
|
||||
gameplay-6309-framebuffer-512k.png. Reference art is not runtime evidence.
|
||||
|
||||
Next qualification: follow TESTING_128K.md, measure complete-game latency and
|
||||
Difficult search separately, then physical joystick/read-only/fault cases.
|
||||
Further feature growth needs code compaction before exceeding the enforced limit.
|
||||
|
||||
## Latest user feedback and sound correction
|
||||
|
||||
Brian reported good keyboard pacing, then constant audio noise even while idle.
|
||||
The standard-library audio routing correction and direct MCP stereo WAV checks
|
||||
are recorded in [AUDIO_VALIDATION.md](AUDIO_VALIDATION.md). The isolated worker
|
||||
did not reproduce the original constant noise; the actual application needs a
|
||||
retest. The save codec and gameplay rules were not changed.
|
||||
|
||||
## November 11 — physical CoCo 3 playtest
|
||||
|
||||
Brian reported playing Quadrapassel successfully on a real Color Computer 3
|
||||
and described it as working great. He confirmed the RAM size as **512 KB**.
|
||||
This is user-reported physical-hardware gameplay evidence, separate from the
|
||||
isolated emulator runs. It does not establish a 128 KB pass or separate passes
|
||||
for the audio correction, persistence, joystick ports or every game option.
|
||||
The exact tested disk/build and detailed machine configuration were not supplied.
|
||||
Reference in new issue
Block a user