Integrate CardGame with VCC Plus disk builds and verified graphics demo

Preserve the upstream library, demo sources and Makefile unchanged. Add the vccplus-disk target, project settings, delivered CardGame.DSK and actual public-MCP screenshot with build-43 validation.
This commit is contained in:
Brian Holman committed 2026-11-09 23:35:34 -07:00
1 parent d3a54e24ee
commit f6676b83f0
10 files changed
+292 -100

No files matched your search

+35
View File
@@ -0,0 +1,35 @@
# Source provenance
## Original package
- Original author: **Pierre Sarrazin**.
- Package: **Cardgame 0.1.15**.
- [Author index](http://sarrazip.com/dev/cmoc.html).
- [Source archive](http://sarrazip.com/dev/cardgame-0.1.15.tar.gz).
- Archive SHA-256: `ca706dddd96fec63b829f8958c2e47485b0e1166129d45fda0b6369404c1bb54`.
- Upstream terms: public-domain library/demo, with original file-level notices.
The VCCPlus Cardgame source manifest also records the historical author-hosted
URL `http://gvlsywt.cluster051.hosting.ovh.net/dev/cardgame-0.1.15.tar.gz` with
the same SHA-256. A checksum identifies the imported bytes; it is not an
independent authenticity guarantee.
## Git history and VCC Plus integration
The original distribution was a source archive. The initial commit,
`d3a54e24eef8b1cb6f8427cc1d8968504d403b48`, imports its 39 original regular files before integration.
The original README is also preserved byte-for-byte in `UPSTREAM_README.md`.
Original author notices remain in the source.
The integration leaves the library/demo C/header files and upstream `Makefile`
unchanged. `VCCPlus.mk` includes that Makefile and adds the `vccplus-disk` target,
which packages `cardgame.bin` into `CardGame.DSK`. The VCC Plus project selects
that disk target and `LOADM"CARDGAME":EXEC` launcher. The top-level disk is an
intentional playable artifact, while incidental objects/libraries/maps are
excluded through `.gitignore`.
The new public README, actual framebuffer screenshot and
[validation record](VALIDATION.md) describe the installed build-43 public MCP
build and displayed four-suit deck. Source import, integration, validation and
later hosting/avatar changes remain separate events. The original distribution
archive and earlier local project were not modified by this import.
+115
View File
@@ -0,0 +1,115 @@
CardGame
========
By Pierre Sarrazin (<http://sarrazip.com/>).
This library is in the public domain.
It is a C library that offers a PMODE 4 game library that can display
playing cards. It targets the Tandy Color Computer but should also work
on the Dragon. Most of the features should also work on CoCo-based
versions of OS-9.
# OS-9 Support
OS-9 was suspended with version 0.1.11 but has been restored with version 0.1.12.
Note that the sound features of this version of the library are not supported under OS-9.
To compile with OS-9, pass TARGET=os9 to make.
The "cardgame" demo program MUST be run from a 32x16 VDG terminal.
Use the Clear key to find one.
If none exists, create one with the "shell i=/v1" command, then use Clear to find it.
The "os9timer" demo program can be run from any terminal.
There is no "beep" demo program for OS-9.
# Adapting to version 0.1.11
openPMode4GameScreenMode() and closePMode4GameScreenMode() have been renamed to
openPMode4Game() and closePMode4Game() because the latter does not restore
the screen mode anymore. It cannot know in which mode the screen was initially.
openPMode4Game() does not call resetPalette() anymore, which assumed that Basic
was present. That call was made only when TRUE was passed for emulatePMode4OnCoCo3.
Now, in this case, only palette slots 0..3 are initialized.
openCardGameScreenMode() and closeCardGameScreenMode() have been renamed to
openCardGame() and closeCardGame() for similar reasons.
restoreOriginalTextMode() has been removed from the interface, since it relied
on Basic. The program must restore the text mode itself, if needed.
Under OS-9, this can be done this way:
putstr("\x12\x0E", 2);
Under the native environment:
screen(0, 0);
Function waitForKeyWithAnimatedCursor() and readLineFromKeyboard() must now
be passed a callback to a function that returns a timer value that increments
60 times per second. See pmode4game.h for details.
# Text font
The text font supports ASCII characters 32 to 96 inclusively. It does not
support lower-case letters.
The font is 8 bits wide, which makes it relatively efficient to write.
See 8-bit-wide-font.h and 8-bit-wide-font.c.
# Version history
0.1.0 - 2015-08-12 - First public release.
0.1.1 - 2016-03-12 - New #defines. New function drawFaceDownCard().
0.1.2 - 2016-03-25 - setConsoleOutHook() and resetConsoleOutHook() now taken
from <coco.h>.
0.1.3 - 2017-12-01 - openCardGameScreenMode() now optionally emulates PMODE 4
in a CoCo 3 mode to approximate the artifact colors.
Assumes RGB mode. Adapted to compile in linker mode.
0.1.4 - 2018-04-03 - Adaptation to CMOC 0.1.51 (const).
0.1.5 - 2018-08-04 - Added square brackets and backslash to 8-bit-wide-font.c.
Added sound routines.
0.1.6 - 2018-09-20 - Adapted to CMOC 0.1.53.
Sound functions now declared by cardgame.h. beep.h now obsolete.
0.1.7 - 2018-10-04 - Fixed openPMode4GameScreenMode() re: CoCo 3 mode.
0.1.8 - 2018-11-25 - Now compilable for the Dragon (make TARGET=dragon).
0.1.9 - 2019-06-03 - OS-9 supported, except for sound.
0.1.10 - 2020-06-28 - Functions added: drawCharWithoutMovingCursor(), moveCursorLeft(),
invertCharAtCursor(), waitForKeyWithAnimatedCursor(), readLineFromKeyboard().
Removed PMODE4_PAGE0 and PMODE4_PAGE1: use
(byte *) (((word) * (byte *) 0x00BC) << 8)
to get the ECB PMODE buffer address instead.
0.1.11 - 2023-06-27 - The library does not assume the presence of Basic anymore.
See section "Adapting to version 0.1.11" for details.
OS-9 support is suspended [restored with 0.1.12].
0.1.12 - 2024-06-08 - Added setScreenBuffer2(), which allows to omit showing the screen.
Put several functions in individual C files to help reduce the size
of programs that do not use all functions of this library.
Added os9timer-demo.c to the archive generated by 'make dist'.
0.1.13 - 2025-11-16 Added drawCompiledCard2(), which supports drawing the suit a little
higher or lower than the default, and supports only drawing the top
of a card, by specifying the number of pixel rows to draw.
Fixed drawCompiledPixMap() so that its inline assembly does not
refer to any global C variable in the code section that uses
the Y register. (That register is used under OS-9 to point to
the current process's global variables segment.) The old code
was not defective but its structure was error prone.
Added getCursor(), which returns the current position of the cursor.
Removed runPMode4GameDoubleBufferLoop(), which is obsolete.
0.1.14 - 2026-02-05 Added setInvertedColorsParameters(), which determines how caracters
are rendered in inverted colors mode, from parameters drawRowOverGlyph
and drawColumnAtRightOfGlyph.
Added makeSpacesTransparent(), which determines if space characters
are drawn (the pixels take the background color) or not (the pixels
remain unmodified).
0.1.15 - 2026-09-06 Added ^, _ and ` to the 8-bit-wide font.
+54
View File
@@ -0,0 +1,54 @@
# CardGame installed-app validation
Verified **November 9, 2026** through the installed VCC Plus public MCP build
and disposable-playtest interface. This records the supplied graphics demo;
it is not a complete library regression suite or card-game playthrough.
## Configuration
- VCC Plus **3.5.0 build 43** with bundled CMOC/Make/disk tools.
- An isolated native copy of the installed app preserved the active CoCoMan
workspace. Its emulator code was unchanged; the bundle identity was changed
and the copy was ad-hoc signed for isolation.
- **Release**, **512 KB RAM**, **MC6809**, **Disk BASIC**.
- Approved Make recipe: `VCCPlus.mk`, including upstream `Makefile`.
- Public build action: `disk`; declared target: `vccplus-disk`.
- Launch command: `LOADM"CARDGAME":EXEC`.
## Build evidence
- Project ID: `7E8305F0-FF04-46E8-A991-7E86A76F372F`; source revision: `0`.
- Recipe ID: `d0430e152313d2964ea1f3a601b2e0062cb10119c9f5084ed6c717f5bed995f0`.
- Build ID: `47760045-032C-490F-AA75-1B29BB368D37`; result: **succeeded**.
- Artifact ID: `E27DB402-DF5B-49C4-9CFC-63E1F5D4632E`.
- `cardgame.bin`: **6,190 bytes**; SHA-256
`35a87b7f8027b2343c533005c0f388ee47ee7b17ef88b9405aeaad9eaa961688`.
- Delivered `CardGame.DSK`: **161,280 bytes**; SHA-256
`584df711fc5814cadaf958c772c57cedc6aeaac39731fe9095ebb43ee000c475`.
Compilation, library creation, linking and disk packaging completed. The
available build log contained no compiler warnings, and the build receipt
reported no diagnostics. Original library/demo source and Makefile were unchanged.
## Execution and screenshot
MCP-owned run `1BC4F286-AFA5-4F93-A888-B06BDE0A4F8D` displayed the complete
four-suit deck and **PRESS BREAK TO QUIT** prompt. The actual framebuffer was
captured after **1,096 emulated video fields**, with **6,912 bytes read from
disk**, zero disk writes and the same disk SHA-256 as the verified artifact.
The run was then stopped and its test disk retained by VCC Plus.
[The screenshot](screenshots/running.png) is the actual **640 × 480** framebuffer
returned by MCP. SHA-256:
`5968f09c6ca539b250cf6589e67263d2bb3c07d573c3acaf7c99dd7236af6f67`.
It is not an illustration or a capture of an older supplied disk.
The capture shows the quit instruction. Sending Break and checking the return
to BASIC were not separately tested; the owned run was stopped after capture.
## Scope
This establishes the specified fresh Release disk build and displayed demo.
It does not claim all library APIs, OS-9/Dragon targets, HD6309 execution,
Intel/Rosetta qualification, physical CoCo hardware, audible audio or a full
card-game test. No private connection grant or raw host log is included.
Binary file not shown.

After

Width:  |  Height:  |  Size: 12 KiB