Files
BoneQuest/graphics.h
T

28 lines
1.4 KiB
C

// SPDX-License-Identifier: GPL-3.0-or-later
#ifndef BONE_GRAPHICS_H
#define BONE_GRAPHICS_H
#define GFX_WIDTH 640
#define GFX_HEIGHT 225
/* Bone Quest's local four-color GIME driver, adapted from VCC Plus's GPL SDK.
Open from stock IRQ-enabled CoCo 3 BASIC text, with at least 512 KiB RAM.
Code/globals/stack must be below $8000. Both pages reserve physical blocks
$1E-$27 ($3C000-$4FFFF, 80 KiB); the bank library's $28-$2B remain available.
Drawing borrows task 0's $8000 window briefly and restores it and CC before
returning. Do not change the MMU/video registers or call from an interrupt.
Coordinates and rectangles clip to 640x225; palette slots are 0..3.
A successful present flips on BASIC's vertical interrupt and draws into the
former front page, whose contents persist. Close restores BASIC and palette. */
unsigned char gfx_open(void);
void gfx_fill_rect(unsigned x,unsigned y,unsigned w,unsigned h,unsigned char color);
void gfx_plot(unsigned x,unsigned y,unsigned char color);
void gfx_clear(unsigned char color);
void gfx_set_palette(unsigned char slot,unsigned char rgb);
/* Copy the displayed image into the hidden page without showing/flipping it.
Mapping and interrupt state are restored between each 32-byte chunk.
Returns 0 while closed; 1 after copying all 36,000 visible bytes. */
unsigned char gfx_copy_front(void);
unsigned char gfx_present(void);
void gfx_close(void);
#endif