// 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