Integrate Color8 with VCC Plus and document verified disk launch
This commit is contained in:
1 parent
e8edf6455e
commit
e5049f2078
12 files changed
+366
-8
No files matched your search
@@ -0,0 +1,45 @@
|
||||
# Source provenance
|
||||
|
||||
## Upstream snapshot
|
||||
|
||||
- Original author: Pierre Sarrazin.
|
||||
- Package: color8 0.1.14.
|
||||
- Source archive: <http://sarrazip.com/dev/color8-0.1.14.tar.gz>.
|
||||
- Author project page: <http://sarrazip.com/dev/color8.html>.
|
||||
- Archive SHA-256: `a98828720d91ac2b9c0939102bf5873650cd3df79323c7d6e086db9604546361`.
|
||||
- Git import baseline: `e8edf6455ebed241edb2f5a0933ac77a238c1149`.
|
||||
|
||||
The first Git commit is the regular-file contents of the original release archive,
|
||||
with its single enclosing package directory removed and executable modes retained.
|
||||
It is an archive snapshot, not a reconstruction of upstream Git history.
|
||||
The following integration commit records the VCC Plus adaptations separately.
|
||||
The original README is preserved byte-for-byte in
|
||||
[UPSTREAM_README.md](UPSTREAM_README.md) and at the root as `README`.
|
||||
|
||||
The author’s project index linked the matching archive during provenance review.
|
||||
No historical HTTP receipt establishes the date of the original download; the
|
||||
SHA-256 identifies the observed archive bytes, not authenticity or a license grant.
|
||||
|
||||
## VCC Plus integration
|
||||
|
||||
- The Makefile discovers optional sibling CardGame/BControl folders and otherwise
|
||||
uses the installed target libraries; this avoids requiring sibling checkouts.
|
||||
`Makefile.orig` is the byte-identical upstream Makefile.
|
||||
- `vccplus-project.json` selects the disk build and `DOS` launch recipe.
|
||||
- The verified build produces `color8-0.1.14-coco.dsk`; `Color8.DSK` is an
|
||||
identically hashed copy provided under a convenient download name.
|
||||
- Public documentation, build-output exclusions and actual guest screenshots
|
||||
accompany the verified disk. Source notices and authored runtime data remain
|
||||
intact. Generated intermediate build files are excluded from Git.
|
||||
|
||||
## License scope
|
||||
|
||||
The main application is GPL-3.0-or-later. The archive’s original `COPYING`
|
||||
and source notices are retained. CardGame/BControl and other target libraries
|
||||
retain their own applicable notices; this record does not relicense dependencies.
|
||||
|
||||
## Verification
|
||||
|
||||
The Release disk build and guest execution were verified through the public MCP
|
||||
interface of installed VCC Plus 3.5.0 build 43. The checked-in disk and screenshots
|
||||
are identified in [VALIDATION.md](VALIDATION.md), including the limits of that check.
|
||||
@@ -0,0 +1,35 @@
|
||||
Color Eights
|
||||
Copyright (C) 2015-2024 Pierre Sarrazin <http://sarrazip.com/>
|
||||
|
||||
License: see the COPYING file.
|
||||
|
||||
Home page: http://sarrazip.com/dev/color8.html
|
||||
|
||||
Version history:
|
||||
0.1.0 2015-05-31 First public release.
|
||||
0.1.1 2015-06-06 Resolved warnings on some function calls.
|
||||
0.1.2 2015-06-09 Fixed bug in putOrdinaryCardOnTopOfDeck().
|
||||
0.1.3 2015-06-13 Added support for cartridge ROM format.
|
||||
0.1.4 2015-07-05 Adapted for CMOC 0.1.8.
|
||||
0.1.5 2015-07-12 Hide help/quit prompt when not relevant.
|
||||
Fixed a typo in the help page.
|
||||
0.1.6 2016-04-03 Restructured to make generic card game code
|
||||
reusable in other games.
|
||||
0.1.7 2018-04-03 Emulates PMODE 4 in a CoCo 3 mode to
|
||||
approximate the artifact colors.
|
||||
Converted to compile in linker mode.
|
||||
Compatible with CMOC 0.1.51 (float, long, const).
|
||||
0.1.8 2018-08-04 Now links with libcardgame.a as a separate project.
|
||||
0.1.9 2018-09-20 Adapted for CMOC 0.1.53.
|
||||
0.1.10 2018-10-04 Now using single-argument pcls().
|
||||
0.1.11 2018-11-25 Now requires cardgame 0.1.8. Now compilable for the Dragon.
|
||||
0.1.12 2019-06-03 OS-9 port. Requires cardgame 0.1.9.
|
||||
Also requires bcontrol 0.1.1 if targeting OS-9.
|
||||
0.1.13 2023-06-27 ROM image now created with CMOC's --raw option (>= 0.1.70).
|
||||
bin-to-xroar-rom.pl obsolete, not distributed anymore.
|
||||
Adapted to version 0.1.11 of the cardgame library.
|
||||
OS-9 support is suspended.
|
||||
0.1.14 2024-06-08 OS-9 support restored.
|
||||
The presentation and help screen prompts now wait
|
||||
for the space key specifically, the "any" key being
|
||||
a mythological creature.
|
||||
@@ -0,0 +1,46 @@
|
||||
# VCC Plus validation
|
||||
|
||||
Verified November 9, 2026 (Mountain time; receipts continue into November 10 UTC).
|
||||
|
||||
## Environment and scope
|
||||
|
||||
- Installed VCC Plus **3.5.0, build 43**, using its public MCP project/build/playtest
|
||||
interface and bundled toolchain.
|
||||
- An isolated native copy retained the installed emulator code; its bundle identity
|
||||
and ad-hoc signature were changed to avoid interfering with another active app.
|
||||
- **Release**, **512 KB CoCo 3**, emulated **MC6809**, Disk BASIC.
|
||||
- This verifies the source layout and build recipe in this repository. No host
|
||||
rebuild, Xcode toolchain or alternate emulator was used for the guest check.
|
||||
|
||||
The build succeeded. The existing autostart loader emitted a function-pointer-to-`void *` warning at `autostart.c:73`; the main game compiled without reported warnings.
|
||||
|
||||
## Observed result
|
||||
|
||||
The disk launched with `DOS`, displayed the title screen, and accepted Space
|
||||
to enter the card table. The inspected gameplay capture shows the player’s hand,
|
||||
computer card count, deck and requested suit. The application itself was not
|
||||
modified to produce the screenshot. No full hand, win/loss, scoring, help or quit
|
||||
behavior was exercised.
|
||||
|
||||
The playtest was stopped cleanly. The receipt reported no disk writes and matching
|
||||
initial/final disk hashes. The screenshots are actual emulator framebuffer captures,
|
||||
not mockups.
|
||||
|
||||
- Download disk: [`Color8.DSK`](../Color8.DSK), 161280 bytes.
|
||||
- Disk SHA-256: `8ec05aa84af69e0ba03a8c1501547664e1abf0349a4460311a222a9e4afe5989`.
|
||||
- Main screenshot: [`screenshots/gameplay.png`](screenshots/gameplay.png).
|
||||
- Initial screen: [`screenshots/running.png`](screenshots/running.png).
|
||||
|
||||
## Evidence identifiers
|
||||
|
||||
- Build: `EDE7DA7A-F25E-42F7-BDC4-F44E81135EE9`.
|
||||
- Artifact: `30850FE5-DBBF-4CB8-9717-2F7380C294C8`.
|
||||
- Run: `14AE7FB6-F7C3-49E1-B2A1-0A9EFC46B244`.
|
||||
- Gameplay capture: machine frame `1204`; guest GIME graphics, 128 × 192,
|
||||
captured as a 640 × 480 framebuffer.
|
||||
|
||||
Private build/run/input/capture/stop receipts supplied these identifiers. Raw logs,
|
||||
access grants and machine-specific paths are intentionally excluded.
|
||||
|
||||
No claim is made for full application coverage, audible output, emulated HD6309,
|
||||
Intel/Rosetta execution, physical Intel hardware or all supported macOS versions.
|
||||
Binary file not shown.
|
After Width: | Height: | Size: 9.8 KiB |
Binary file not shown.
|
After Width: | Height: | Size: 10 KiB |
Reference in new issue
Block a user