Import coco-letters 0.1.0 upstream source snapshot

Original author: Pierre Sarrazin. Preserve upstream GPLv3-or-later and file-specific notices.
Source: http://sarrazip.com/dev/coco-letters-0.1.0.tar.gz
Archive SHA-256: ad7c7771845e1a35014644fb562634a558abee632e1d7738683db6e9e9e46b94
This commit is contained in:
Brian Holman committed 2026-11-09 23:39:21 -07:00
commit 4cedb2d94a
29 files changed
+20169

No files matched your search

+176
View File
@@ -0,0 +1,176 @@
/* defs.h
Copyright (C) 2026 Pierre Sarrazin <http://sarrazip.com/>
This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
You should have received a copy of the GNU General Public License
along with this program. If not, see <http://www.gnu.org/licenses/>.
*/
#ifndef _H_defs
#define _H_defs
#include <coco.h>
#if 0
#include <assert.h>
#else
#ifndef NDEBUG
void assertHandler(const char *file, int lineno, const char *condition);
#define assert(cond) do { if (!(cond)) assertHandler(__FILE__, __LINE__, ""); } while (0)
#define static_assert(cond) typedef char CONCAT(_StaticAssertDummyArray_, __LINE__)[(cond) ? 1 : -1]
#else
#define assert(cond) ((void) 0)
#define static_assert(cond) ((void) 0)
#endif
#define CONCAT2(a, b) a ## b
#define CONCAT(a, b) CONCAT2(a, b)
#endif
// STRINGIFY(FOO) gives "FOO".
//
#define STRINGIFY(x) #x
// If we have #define FOO 42
// then STRINGIFY_VALUE(FOO) gives "42".
//
#define STRINGIFY_VALUE(x) STRINGIFY(x)
#ifndef MAX_NUM_DICT_BLOCKS
#error "MAX_NUM_DICT_BLOCKS not defined."
#endif
#ifndef MIN_WORD_LEN
#error "MIN_WORD_LEN not defined."
#endif
#ifndef MAX_WORD_LEN
#error "MAX_WORD_LEN not defined."
#endif
// See HACKING.md for a memory map.
enum
{
NUM_DISK_DRIVES = 1,
IRQ_VECTOR = 0xFFF8,
TEXT_SCREEN = 0xE000, // 32x16 and 40x24 hardware text screen buffer
FONT_4x8_BUFFER = TEXT_SCREEN + 40 * 24, // contains bytes defined in font4x8-ascii.c
FONT_4x8_SECTORS = 3, // number of sectors to read to fill that buffer
FONT_5x8_BUFFER = FONT_4x8_BUFFER + FONT_4x8_SECTORS * 256, // contains bytes defined in font5x8-ascii.c
FONT_5x8_SECTORS = 1, // number of sectors to read to fill that buffer
STACK_BOTTOM = 0xFEEE,
BLOCK_SIZE = 8192, // size in bytes of a GIME MMU block
BREAK_KEY = 3,
// Graphics:
NUM_GRAPHICS_BLOCKS = 3, // 256x192x16 takes three 8k blocks
SCRN_WIDTH = 256u, // in pixels
SCRN_HEIGHT = 192u, // in pixels
NUM_COLORS = 16, // number of CoCo 3 palette slots
BYTES_PER_ROW = SCRN_WIDTH / 2,
CHAR_WIDTH = 5, // number of pixels per graphics text window character column
CHAR_HEIGHT = 8, // number of pixels per graphics text window character row
TEXT_SCREEN_WIDTH = 51, // in characters
TEXT_SCREEN_HEIGHT = 24,
TEXT_WIN_LEFT = 37, // leftmost 51x24 screen column of text window (at right of board)
TEXT_WIN_TOP = 18,
TEXT_WIN_WIDTH = TEXT_SCREEN_WIDTH - TEXT_WIN_LEFT, // in characters
TEXT_WIN_HEIGHT = TEXT_SCREEN_HEIGHT - TEXT_WIN_TOP,
TEXT_TURN_ROW = 3, // text row where "Your/My turn" is written
TEXT_RESULT_ROW = 5,
TEXT_INSTR_ROW = 10, // instructions
TEXT_SCORE_ROW = 16,
// Hardware text mode (no color attributes):
HW_TEXT_SCREEN_WIDTH = 40,
HW_TEXT_SCREEN_HEIGHT = 24,
HW_TEXT_SCREEN_BUFFER = 0xE000,
HW_TEXT_SCREEN_BACK_COLOR = 0,
HW_TEXT_SCREEN_FORE_COLOR = 63,
// Game:
BOARD_SIZE = 15, // number of board rows and columns
TILE_WIDTH = 12, // in pixels
TILE_HEIGHT = 12, // in pixels
NUM_TILE_TYPES = 27, // A..Z plus blank
RACK_SIZE = 7, // maximum number of tiles in a player's rack
TILE_TYPE_NONE = 255,
TILE_TYPE_BLANK = 0,
NUM_BLANK_TILES = 2,
NUM_PLAYERS = 2,
LEVEL_EASY = 0,
LEVEL_HARD = 1,
// CoCo 3 memory blocks. (A 128k machine has blocks 48..63.)
FIRST_GRAPHICS_BLOCK = 51, // graphics in 51..53
GRAPHICS_START = FIRST_GRAPHICS_BANK * BLOCK_SIZE,
GRAPHICS_END = GRAPHICS_START + SCRN_WIDTH * SCRN_HEIGHT / 2,
// SCRN_* need to be unsigned for this computation to work.
// CoCo 3 memory banks (0..7).
DICT_BANK = 0,
FIRST_GRAPHICS_BANK = 4,
// Palette values.
PAL_POS_CURSOR = PAL_BOARD_WRITING,
PAL_BLANK_TILE_FORE = PAL_BOARD_BG,
};
// Board square types.
//
enum
{
SQ_EMPTY,
SQ_START,
SQ_TRIPLE_WORD,
SQ_DOUBLE_WORD,
SQ_TRIPLE_LETTER,
SQ_DOUBLE_LETTER
};
typedef interrupt void (*ISR)(void);
// Gives a number of elements, not a number of bytes.
//
#define ARRAY_SIZE(array) (sizeof(array) / sizeof((array)[0]))
#define ARRAY_END(array) ((array) + ARRAY_SIZE(array))
#define poke(address, byteValue) (* (byte *) (address) = (byteValue))
#define pokeWord(address, wordValue) (* (word *) (address) = (wordValue))
#define mmuSet(bank, block) (poke(0xFFA0 + (bank), (block)))
typedef struct WordLengthRecord
{
byte blockNo; // MMU block that contains dictionary data;
// (0 .. MAX_NUM_DICT_BLOCKS - 2)
word wordOffset; // in dictionary words, from start of MMU block
word offset; // in bytes, from start of MMU block
} WordLengthRecord;
// Array that is defined in word-length-index.c, generated by build-data.pl.
//
extern const WordLengthRecord wordLengthRecords[];
extern const byte numWordLengthRecords; // number of elements in wordLengthRecords[]
#endif /* _H_defs */