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:
1 parent
d3a54e24ee
commit
f6676b83f0
10 files changed
+292
-100
No files matched your search
@@ -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.
|
||||
@@ -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.
|
||||
@@ -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 |
Reference in new issue
Block a user