Original author: Pierre Sarrazin. Public-domain library and demo. Source: http://sarrazip.com/dev/cardgame-0.1.15.tar.gz Archive SHA-256: ca706dddd96fec63b829f8958c2e47485b0e1166129d45fda0b6369404c1bb54
183 lines
5.5 KiB
C
183 lines
5.5 KiB
C
/* cardgame.h - PMODE 4 playing cards library for Disk Basic.
|
|
|
|
By Pierre Sarrazin <http://sarrazip.com/>.
|
|
This file is in the public domain.
|
|
*/
|
|
|
|
#ifndef _H_cardgame
|
|
#define _H_cardgame
|
|
|
|
#include "pmode4game.h"
|
|
#include "compiled-cards.h" /* card bitmaps */
|
|
|
|
#ifdef OS9
|
|
#include "OS9Timer.h"
|
|
#endif
|
|
|
|
|
|
#define NUMCARDS 54
|
|
#define BAD_CARD_SUIT 0xFF
|
|
#define BAD_CARD_VALUE 0
|
|
#define BAD_INDEX 0xFF
|
|
|
|
#define ROWS_ABOVE_SUIT 2
|
|
#define ROWS_BELOW_SUIT 6
|
|
#define ROWS_PER_CARD_TOP 5
|
|
#define ROWS_PER_CARD_BOTTOM ROWS_PER_CARD_TOP
|
|
#define BYTES_PER_CARD_WIDTH 4
|
|
#define ROWS_PER_CARD_VALUE 10
|
|
#define ROWS_PER_SUIT 7
|
|
|
|
#define SUIT_HEARTS 0
|
|
#define SUIT_SPADES 1
|
|
#define SUIT_DIAMONDS 2
|
|
#define SUIT_CLUBS 3
|
|
#define SUIT_JOKER 4
|
|
#define SUIT_NONE 255
|
|
|
|
|
|
///////////////////////////////////////////////////////////////////////////////
|
|
|
|
|
|
// Draws a 16-bit-wide pixmap on the screen that starts at scrnBuffer.
|
|
// byteOffset: Offset in bytes from the left of the screen (must be < BYTES_PER_SCREEN_ROW).
|
|
// pixelRow: Vertical position (in pixels) of the row at which to start drawing (downwards).
|
|
// Must be < PIXEL_ROWS_PER_SCREEN.
|
|
// wordArray: Words that define the pixmap.
|
|
// numRows: Number of words in wordArray[]. Must be > 0.
|
|
// rowRepetitions: Number of times that each row must be repeated. Must be > 0.
|
|
// Example: If wordArray contains values { A, B, C }, and rowRepetitions is 2,
|
|
// then values A, A, B, B, C, C will be written in successive screen rows.
|
|
// Returns the address of the top left byte of the region that was modified.
|
|
// Uses global variable scrnBuffer as the start of the PMODE 4 screen buffer.
|
|
//
|
|
byte *drawCompiledPixMap(byte byteOffset, byte pixelRow, const word *wordArray, byte numRows, byte rowRepetitions);
|
|
|
|
|
|
// cardValue: 1..13 (1 = ace).
|
|
// cardSuit: SUIT_* (0..3).
|
|
// Except for jokers: cardValue must be 1 (red) or 2 (black) and cardSuit must be SUIT_JOKER.
|
|
// byteColumn: 0..28 (maps to pixel columns 0, 8, 16, ..., 224).
|
|
// pixelRow: 0..150.
|
|
//
|
|
// The number of pixels rows occupied by the card is given by getNumPixelRowsPerCard().
|
|
// A card is 4 bytes wide, i.e., 32 pixels.
|
|
//
|
|
void drawCompiledCard(byte cardValue, byte cardSuit, byte byteColumn, byte pixelRow);
|
|
|
|
|
|
// Like drawCompiledCard(), but with these additiona parameters:
|
|
// suitRowOffset: Has the suit drawn a little higher or lower than the default.
|
|
// To draw the suit 2 pixel rows higher than the default, pass -2.
|
|
// maxNumRowsToDraw: Maximum of rows to draw, from the top of the card.
|
|
// Allows drawing only the top portion of a card.
|
|
// A card normally has a number of pixel rows that is given by
|
|
// getNumPixelRowsPerCard().
|
|
//
|
|
void drawCompiledCard2(byte cardValue, byte cardSuit, byte byteColumn, byte pixelRow,
|
|
char suitRowOffset, byte maxNumRowsToDraw);
|
|
|
|
|
|
// Height of a card drawn by drawCompiledCard().
|
|
// A card is 4 bytes wide, i.e., 32 pixels.
|
|
//
|
|
byte getNumPixelRowsPerCard();
|
|
|
|
|
|
void eraseCard(byte byteColumn, byte pixelRow);
|
|
|
|
|
|
// rowInPixels: Offset in pixels down the top of the screen.
|
|
// colInBytes: Horizontal position of the card, in bytes (0..28).
|
|
//
|
|
void drawFaceDownCard(byte rowInPixels, byte colInBytes);
|
|
|
|
|
|
// Returns SUIT_HEARTS, SUIT_SPADES, SUIT_DIAMONDS, SUIT_CLUBS
|
|
// or SUIT_JOKER if 'card' is valid, BAD_CARD_SUIT otherwise.
|
|
//
|
|
byte getCardType(byte card);
|
|
|
|
|
|
// Returns 1..13 if 'card' is an ordinary ace-to-king card.
|
|
// Returns 1..2 if 'card' is a joker, i.e., getCardType()
|
|
// returns SUIT_JOKER for this card value.
|
|
// Returns BAD_CARD_VALUE otherwise.
|
|
//
|
|
byte getCardValue(byte card);
|
|
|
|
|
|
const char *getSuitName(byte suit);
|
|
|
|
|
|
void shuffleDeck(byte deck[], byte numCards);
|
|
|
|
|
|
// Removes a card from the end of the designated deck, which
|
|
// initially contains a number of cards given by *pNumCards,
|
|
// decrements this number, then returns the removed card.
|
|
// (The "top" of a deck is at the highest valid index,
|
|
// while the "bottom" is at index 0.)
|
|
//
|
|
byte pickCardFromDeck(byte deck[], byte *pNumCards);
|
|
|
|
|
|
// col: Byte offset in targeted row.
|
|
// row: Pixel row where to draw top of suit.
|
|
// suit: Index into suits[].
|
|
//
|
|
void drawSuit(byte col, byte row, byte suit);
|
|
|
|
|
|
// Calls openPMode4Game().
|
|
//
|
|
void openCardGame(void *_scrnBuffer, byte _emulatePMode4OnCoCo3);
|
|
|
|
|
|
// Calls closePMode4Game().
|
|
//
|
|
void closeCardGame(void);
|
|
|
|
|
|
enum
|
|
{
|
|
BEEP_MIN_VOL = 0,
|
|
BEEP_MAX_VOL = 63,
|
|
};
|
|
|
|
|
|
// Must be called before using the functions that follow.
|
|
// CAUTION: These sound functions address the hardware directly
|
|
// and thus are not suitable for OS-9.
|
|
//
|
|
void initSound();
|
|
|
|
|
|
// Returns the number of ticks to pass to beep() to have it play a
|
|
// square wave of the given frequency (in hertz).
|
|
//
|
|
word getTicksForFrequency(word hertz);
|
|
|
|
|
|
// initSound() MUST have been called before calling this function.
|
|
// duration: Must be positive (max 255).
|
|
// Should be >= 5 for usable sound.
|
|
// ticks: Length of the half period of the square wave.
|
|
// See getTicksForFrequency().
|
|
// Larger number means lower sound.
|
|
// Should be <= 4000 for usable sound. Should not be 0.
|
|
// volume: 0..BEEP_MAX_VOL.
|
|
//
|
|
void beep(byte duration, word ticks, byte volume);
|
|
|
|
|
|
// duration: Must be positive (max 255).
|
|
// Should be >= 5 for usable sound.
|
|
// spacing: 0..65535: length of each random sample send to the speaker.
|
|
// volume: 0..BEEP_MAX_VOL.
|
|
//
|
|
void whiteNoise(word duration, word spacing, byte volume);
|
|
|
|
|
|
#endif /* _H_cardgame */
|