|
GBDK 2020 Docs
4.0.6
API Documentation for GBDK 2020
|
Go to the documentation of this file.
16 #if defined(__TARGET_sms)
18 #elif defined(__TARGET_gg)
23 #define VBK_REG VDP_ATTR_SHIFT
38 #define J_UP 0b00000001
39 #define J_DOWN 0b00000010
40 #define J_LEFT 0b00000100
41 #define J_RIGHT 0b00001000
42 #define J_A 0b00010000
43 #define J_B 0b00100000
44 #if defined(__TARGET_sms)
45 #define J_SELECT 0b00100000
46 #define J_START 0b00010000
47 #elif defined(__TARGET_gg)
48 #define J_SELECT 0b00100000
49 #define J_START 0b10000000
56 #define M_TEXT_OUT 0x02U
57 #define M_TEXT_INOUT 0x03U
63 #define M_NO_SCROLL 0x04U
67 #define M_NO_INTERP 0x08U
77 #define S_PALETTE 0x08U
80 #define S_PRIORITY 0x10U
83 #define __WRITE_VDP_REG(REG, v) shadow_##REG=(v);__critical{VDP_CMD=(shadow_##REG),VDP_CMD=REG;}
84 #define __READ_VDP_REG(REG) shadow_##REG
106 #define EMPTY_IFLAG 0x00U
112 #define VBL_IFLAG 0x01U
116 #define LCD_IFLAG 0x02U
119 #define TIM_IFLAG 0x04U
122 #define SIO_IFLAG 0x08U
125 #define JOY_IFLAG 0x10U
132 #define SCREENWIDTH DEVICE_SCREEN_PX_WIDTH
135 #define SCREENHEIGHT DEVICE_SCREEN_PX_HEIGHT
138 #define MINWNDPOSX 0x00U
141 #define MINWNDPOSY 0x00U
144 #define MAXWNDPOSX 0x00U
147 #define MAXWNDPOSY 0x00U
229 __WRITE_VDP_REG(VDP_R1, __READ_VDP_REG(VDP_R1) |= R1_DISP_ON)
234 #define DISPLAY_OFF \
244 #define HIDE_LEFT_COLUMN \
245 __WRITE_VDP_REG(VDP_R0, __READ_VDP_REG(VDP_R0) |= R0_LCB)
250 #define SHOW_LEFT_COLUMN \
251 __WRITE_VDP_REG(VDP_R0, __READ_VDP_REG(VDP_R0) &= (~R0_LCB))
285 #define SPRITES_8x16 \
286 __WRITE_VDP_REG(VDP_R1, __READ_VDP_REG(VDP_R1) |= R1_SPR_8X16)
290 #define SPRITES_8x8 \
291 __WRITE_VDP_REG(VDP_R1, __READ_VDP_REG(VDP_R1) &= (~R1_SPR_8X16))
296 #define DEVICE_SUPPORTS_COLOR (TRUE)
308 #define _current_bank MAP_FRAME1
309 #define CURRENT_BANK MAP_FRAME1
321 #define BANK(VARNAME) ( (uint8_t) & __bank_ ## VARNAME )
336 #define BANKREF(VARNAME) void __func_ ## VARNAME() __banked __naked { \
338 .local b___func_ ## VARNAME \
339 ___bank_ ## VARNAME = b___func_ ## VARNAME \
340 .globl ___bank_ ## VARNAME \
353 #define BANKREF_EXTERN(VARNAME) extern const void __bank_ ## VARNAME;
360 #define SWITCH_ROM(b) MAP_FRAME1=(b)
361 #define SWITCH_ROM1 SWITCH_ROM
367 #define SWITCH_ROM2(b) MAP_FRAME2=(b)
373 #define SWITCH_RAM(b) RAM_CONTROL=((b)&1)?RAM_CONTROL|RAMCTL_BANK:RAM_CONTROL&(~RAMCTL_BANK)
378 #define ENABLE_RAM RAM_CONTROL|=RAMCTL_RAM
383 #define DISABLE_RAM RAM_CONTROL&=(~RAMCTL_RAM)
417 uint8_t joy0, joy1, joy2, joy3;
442 #if defined(__TARGET_sms)
444 #define RGB(r,g,b) ((r) | ((g) << 2) | ((b) << 4))
445 #define RGB8(r,g,b) (((r) >> 6) | (((g) >> 6) << 2) | (((b) >> 6) << 4))
446 #define RGBHTML(RGB24bit) (((RGB24bit) >> 22) | ((((RGB24bit) & 0xFFFF) >> 14) << 2) | ((((RGB24bit) & 0xFF) >> 6) << 4))
450 #define RGB_RED RGB( 3, 0, 0)
451 #define RGB_DARKRED RGB( 2, 0, 0)
452 #define RGB_GREEN RGB( 0, 3, 0)
453 #define RGB_DARKGREEN RGB( 0, 2, 0)
454 #define RGB_BLUE RGB( 0, 0, 3)
455 #define RGB_DARKBLUE RGB( 0, 0, 2)
456 #define RGB_YELLOW RGB( 3, 3, 0)
457 #define RGB_DARKYELLOW RGB( 2, 2, 0)
458 #define RGB_CYAN RGB( 0, 3, 3)
459 #define RGB_AQUA RGB( 3, 1, 2)
460 #define RGB_PINK RGB( 3, 0, 3)
461 #define RGB_PURPLE RGB( 2, 0, 2)
462 #define RGB_BLACK RGB( 0, 0, 0)
463 #define RGB_DARKGRAY RGB( 1, 1, 1)
464 #define RGB_LIGHTGRAY RGB( 2, 2, 2)
465 #define RGB_WHITE RGB( 3, 3, 3)
469 #elif defined(__TARGET_gg)
471 #define RGB(r,g,b) ((uint16_t)(r) | (uint16_t)((g) << 4) | (uint16_t)((b) << 8))
472 #define RGB8(r,g,b) ((uint16_t)((r) >> 4) | ((uint16_t)((g) >> 4) << 4) | ((uint16_t)((b) >> 4) << 8))
473 #define RGBHTML(RGB24bit) (((RGB24bit) >> 20) | ((((RGB24bit) & 0xFFFF) >> 12) << 4)|((((RGB24bit) & 0xFF) >> 4) << 8))
477 #define RGB_RED RGB(15, 0, 0)
478 #define RGB_DARKRED RGB( 7, 0, 0)
479 #define RGB_GREEN RGB( 0, 15, 0)
480 #define RGB_DARKGREEN RGB( 0, 7, 0)
481 #define RGB_BLUE RGB( 0, 0, 15)
482 #define RGB_DARKBLUE RGB( 0, 0, 7)
483 #define RGB_YELLOW RGB(15, 15, 0)
484 #define RGB_DARKYELLOW RGB( 7, 7, 0)
485 #define RGB_CYAN RGB( 0, 15, 15)
486 #define RGB_AQUA RGB(14, 2, 11)
487 #define RGB_PINK RGB(15, 0, 15)
488 #define RGB_PURPLE RGB(10, 0, 10)
489 #define RGB_BLACK RGB( 0, 0, 0)
490 #define RGB_DARKGRAY RGB( 5, 5, 5)
491 #define RGB_LIGHTGRAY RGB(10, 10, 10)
492 #define RGB_WHITE RGB(15, 15, 15)
494 #define RGB_LIGHTFLESH RGB(15, 10, 7)
495 #define RGB_BROWN RGB( 5, 5, 0)
496 #define RGB_ORANGE RGB(15, 10, 0)
497 #define RGB_TEAL RGB( 7, 7, 0)
502 #error Unrecognized port
509 #define set_bkg_palette_entry set_palette_entry
510 #define set_sprite_palette_entry(palette,entry,rgb_data) set_palette_entry(1,entry,rgb_data)
512 #define set_bkg_palette set_palette
513 #define set_sprite_palette(first_palette,nb_palettes,rgb_data) set_palette(1,1,rgb_data)
523 #define COMPAT_PALETTE(C0,C1,C2,C3) (((uint16_t)(C3) << 12) | ((uint16_t)(C2) << 8) | ((uint16_t)(C1) << 4) | (uint16_t)(C0))
568 #define set_bkg_tiles set_tile_map_compat
569 #define set_win_tiles set_tile_map_compat
606 #define fill_bkg_rect fill_rect_compat
607 #define fill_win_rect fill_rect_compat
645 #define DISABLE_VBL_TRANSFER \
650 #define ENABLE_VBL_TRANSFER \
651 _shadow_OAM_base = (uint8_t)((uint16_t)&shadow_OAM >> 8)
655 #define MAX_HARDWARE_SPRITES 64
771 #define set_bkg_tile_xy set_tile_xy
772 #define set_win_tile_xy set_tile_xy
778 #define get_win_xy_addr get_bkg_xy_addr
void set_data(uint16_t dst, const void *src, uint16_t size) Z88DK_CALLEE PRESERVES_REGS(iyh
void set_sprite_2bpp_data(uint16_t start, uint16_t ntiles, const void *src)
Definition: sms.h:538
void set_bkg_based_tiles(uint8_t x, uint8_t y, uint8_t w, uint8_t h, const uint8_t *tiles, uint8_t base_tile)
Definition: sms.h:572
unsigned char uint8_t
Definition: stdint.h:51
void set_bkg_2bpp_data(uint16_t start, uint16_t ntiles, const void *src)
Definition: sms.h:535
signed char int8_t
Definition: stdint.h:43
void add_LCD(int_handler h) Z88DK_FASTCALL PRESERVES_REGS(b
void add_TIM(int_handler h) Z88DK_FASTCALL
void set_tile_map(uint8_t x, uint8_t y, uint8_t w, uint8_t h, const uint8_t *tiles) Z88DK_CALLEE PRESERVES_REGS(iyh
void set_bkg_4bpp_data(uint16_t start, uint16_t ntiles, const void *src)
Definition: sms.h:516
void display_off()
Definition: sms.h:221
void waitpadup() PRESERVES_REGS(b
void set_sprite_tile(uint8_t nb, uint8_t tile)
Definition: sms.h:679
void d
Definition: sms.h:86
void hide_sprite(uint8_t nb)
Definition: sms.h:742
void remove_JOY(int_handler h) Z88DK_FASTCALL
uint8_t _submap_tile_offset
void set_win_based_tiles(uint8_t x, uint8_t y, uint8_t w, uint8_t h, const uint8_t *tiles, uint8_t base_tile)
Definition: sms.h:577
void set_bkg_1bpp_data(uint16_t start, uint16_t ntiles, const void *src)
Definition: sms.h:547
#define VDP_R1
Definition: hardware.h:74
void set_win_submap(uint8_t x, uint8_t y, uint8_t w, uint8_t h, const uint8_t *map, uint8_t map_w)
Definition: sms.h:588
volatile uint16_t sys_time
void set_bkg_submap(uint8_t x, uint8_t y, uint8_t w, uint8_t h, const uint8_t *map, uint8_t map_w)
Definition: sms.h:585
void l
Definition: sms.h:215
uint8_t cancel_pending_interrupts()
Definition: sms.h:190
uint8_t waitpad(uint8_t mask) Z88DK_FASTCALL PRESERVES_REGS(b
void set_win_based_submap(uint8_t x, uint8_t y, uint8_t w, uint8_t h, const uint8_t *map, uint8_t map_w, uint8_t base_tile)
Definition: sms.h:598
unsigned short int uint16_t
Definition: stdint.h:52
void WRITE_VDP_DATA(uint16_t data) Z88DK_FASTCALL PRESERVES_REGS(b
void set_tile_2bpp_data(uint16_t start, uint16_t ntiles, const void *src, uint16_t palette) Z88DK_CALLEE PRESERVES_REGS(iyh
void set_vram_byte(uint8_t *addr, uint8_t v) Z88DK_CALLEE PRESERVES_REGS(iyh
void add_JOY(int_handler h) Z88DK_FASTCALL
#define R1_DISP_ON
Definition: hardware.h:79
uint8_t * set_tile_xy(uint8_t x, uint8_t y, uint8_t t) Z88DK_CALLEE PRESERVES_REGS(iyh
uint8_t * get_bkg_xy_addr(uint8_t x, uint8_t y) Z88DK_CALLEE PRESERVES_REGS(iyh
uint8_t get_sprite_tile(uint8_t nb)
Definition: sms.h:690
void fill_rect(uint8_t x, uint8_t y, uint8_t w, uint8_t h, const uint16_t tile) Z88DK_CALLEE PRESERVES_REGS(iyh
void c
Definition: sms.h:86
void add_SIO(int_handler h) Z88DK_FASTCALL
void set_tile_1bpp_data(uint16_t start, uint16_t ntiles, const void *src, uint16_t colors) Z88DK_CALLEE PRESERVES_REGS(iyh
#define Z88DK_CALLEE
Definition: types.h:42
void set_tile_submap_compat(uint8_t x, uint8_t y, uint8_t w, uint8_t h, uint8_t map_w, const uint8_t *map) Z88DK_CALLEE PRESERVES_REGS(iyh
#define VDP_RSCX
Definition: hardware.h:124
short int int16_t
Definition: stdint.h:44
void fill_rect_compat(uint8_t x, uint8_t y, uint8_t w, uint8_t h, const uint16_t tile) Z88DK_CALLEE PRESERVES_REGS(iyh
void move_bkg(uint8_t x, uint8_t y)
Definition: sms.h:194
void vmemcpy(uint16_t dst, const void *src, uint16_t size) Z88DK_CALLEE PRESERVES_REGS(iyh
void set_sprite_prop(uint8_t nb, uint8_t prop)
Definition: sms.h:694
void set_palette(uint8_t first_palette, uint8_t nb_palettes, palette_color_t *rgb_data) Z88DK_CALLEE
void WRITE_VDP_CMD(uint16_t cmd) Z88DK_FASTCALL PRESERVES_REGS(b
#define __READ_VDP_REG(REG)
Definition: sms.h:84
void mode(uint8_t m) OLDCALL
void add_VBL(int_handler h) Z88DK_FASTCALL PRESERVES_REGS(d
#define __WRITE_VDP_REG(REG, v)
Definition: sms.h:83
uint8_t get_mode() OLDCALL
#define VDP_RSCY
Definition: hardware.h:129
void set_bkg_based_submap(uint8_t x, uint8_t y, uint8_t w, uint8_t h, const uint8_t *map, uint8_t map_w, uint8_t base_tile)
Definition: sms.h:593
void scroll_sprite(uint8_t nb, int8_t x, int8_t y)
Definition: sms.h:731
void cpu_fast()
Definition: sms.h:506
void set_1bpp_colors(uint8_t fgcolor, uint8_t bgcolor)
Definition: sms.h:543
uint16_t palette_color_t
Definition: cgb.h:85
void set_native_tile_data(uint16_t start, uint16_t ntiles, const void *src) Z88DK_CALLEE PRESERVES_REGS(iyh
volatile uint8_t _shadow_OAM_base
Definition: gb.h:1404
void b
Definition: gb.h:608
void set_sprite_4bpp_data(uint16_t start, uint16_t ntiles, const void *src)
Definition: sms.h:519
#define OLDCALL
Definition: types.h:19
uint8_t * set_attributed_tile_xy(uint8_t x, uint8_t y, uint16_t t) Z88DK_CALLEE PRESERVES_REGS(iyh
void set_sprite_data(uint16_t start, uint16_t ntiles, const void *src)
Definition: sms.h:532
void joypad_ex(joypads_t *joypads) Z88DK_FASTCALL PRESERVES_REGS(iyh
uint8_t joypad_init(uint8_t npads, joypads_t *joypads) Z88DK_CALLEE
#define Z88DK_FASTCALL
Definition: types.h:43
volatile uint8_t shadow_OAM[]
void set_bkg_data(uint16_t start, uint16_t ntiles, const void *src)
Definition: sms.h:529
void remove_LCD(int_handler h) Z88DK_FASTCALL PRESERVES_REGS(b
void SET_SHADOW_OAM_ADDRESS(void *address)
Definition: sms.h:659
void delay(uint16_t d) Z88DK_FASTCALL
void remove_SIO(int_handler h) Z88DK_FASTCALL
uint16_t _current_1bpp_colors
void move_sprite(uint8_t nb, uint8_t x, uint8_t y)
Definition: sms.h:715
uint8_t get_sprite_prop(uint8_t nb)
Definition: sms.h:698
uint16_t _current_2bpp_palette
void remove_VBL(int_handler h) Z88DK_FASTCALL PRESERVES_REGS(iyh
#define VDP_SAT_TERM
Definition: hardware.h:188
void set_2bpp_palette(uint16_t palette)
Definition: sms.h:525
volatile uint8_t _shadow_OAM_OFF
void iyl
Definition: sms.h:86
uint8_t joypad() OLDCALL PRESERVES_REGS(b
void set_tile_map_compat(uint8_t x, uint8_t y, uint8_t w, uint8_t h, const uint8_t *tiles) Z88DK_CALLEE PRESERVES_REGS(iyh
#define NONBANKED
Definition: types.h:36
void set_default_palette()
void wait_vbl_done() PRESERVES_REGS(b
void scroll_bkg(int8_t x, int8_t y)
Definition: sms.h:199
void remove_TIM(int_handler h) Z88DK_FASTCALL
#define PRESERVES_REGS(...)
Definition: types.h:29
void set_sprite_1bpp_data(uint16_t start, uint16_t ntiles, const void *src)
Definition: sms.h:550
void set_palette_entry(uint8_t palette, uint8_t entry, uint16_t rgb_data) Z88DK_CALLEE PRESERVES_REGS(iyh
void h
Definition: sms.h:215
void iyh
Definition: sms.h:86
void(* int_handler)(void) NONBANKED
Definition: sms.h:152
void set_interrupts(uint8_t flags) Z88DK_FASTCALL
void set_tile_submap(uint8_t x, uint8_t y, uint8_t w, uint8_t h, uint8_t map_w, const uint8_t *map) Z88DK_CALLEE PRESERVES_REGS(iyh
void e
Definition: sms.h:86