libws libws
WSwan hardware library for the Wonderful toolchain
Loading...
Searching...
No Matches
display.h
Go to the documentation of this file.
1/*
2 * Copyright (c) 2022, 2023 Adrian "asie" Siekierka
3 *
4 * This software is provided 'as-is', without any express or implied
5 * warranty. In no event will the authors be held liable for any damages
6 * arising from the use of this software.
7 *
8 * Permission is granted to anyone to use this software for any purpose,
9 * including commercial applications, and to alter it and redistribute it
10 * freely, subject to the following restrictions:
11 *
12 * 1. The origin of this software must not be misrepresented; you must not
13 * claim that you wrote the original software. If you use this software
14 * in a product, an acknowledgment in the product documentation would be
15 * appreciated but is not required.
16 *
17 * 2. Altered source versions must be plainly marked as such, and must not be
18 * misrepresented as being the original software.
19 *
20 * 3. This notice may not be removed or altered from any source distribution.
21 */
22
23#ifndef LIBWS_DISPLAY_H_
24#define LIBWS_DISPLAY_H_
25
26#ifndef __ASSEMBLER__
27#include <stdbool.h>
28#include <stdint.h>
29#include <string.h>
30#endif
31#include <wonderful.h>
32#include "memory.h"
33#include "ports.h"
34
38
43
44#define WS_DISPLAY_WIDTH_TILES 28
45#define WS_DISPLAY_HEIGHT_TILES 18
46#define WS_DISPLAY_WIDTH_PIXELS (WS_DISPLAY_WIDTH_TILES * WS_DISPLAY_TILE_WIDTH)
47#define WS_DISPLAY_HEIGHT_PIXELS (WS_DISPLAY_HEIGHT_TILES * WS_DISPLAY_TILE_HEIGHT)
48
49#define WS_DISPLAY_TILE_WIDTH 8
50#define WS_DISPLAY_TILE_HEIGHT 8
54#define WS_DISPLAY_TILE_SIZE 16
58#define WS_DISPLAY_TILE_SIZE_4BPP 32
59
60#ifndef WS_DISPLAY_VTOTAL
64#define WS_DISPLAY_VTOTAL 159
65#endif
66
67#ifndef __ASSEMBLER__
71typedef struct {
72 union {
75 };
77
81typedef struct {
82 union {
85 };
87#endif
88
92#define WS_SCREEN_ATTR_TILE(x) (x)
93#define WS_SCREEN_ATTR_TILE_MASK (0x1FF)
97#define WS_SCREEN_ATTR_PALETTE(x) ((x) << 9)
98#define WS_SCREEN_ATTR_PALETTE_MASK (0xF << 9)
102#define WS_SCREEN_ATTR_BANK(x) ((x) << 13)
103#define WS_SCREEN_ATTR_BANK_MASK (0x2000)
107#define WS_SCREEN_ATTR_TILE_EX(x) (((x) & 0x1FF) | (((x) >> 13) << 13))
108#define WS_SCREEN_ATTR_TILE_EX_MASK (0x21FF)
109
113#define WS_SCREEN_ATTR_FLIP_H 0x4000
117#define WS_SCREEN_ATTR_FLIP_V 0x8000
121#define WS_SCREEN_ATTR_FLIP 0xC000
122#define WS_SCREEN_ATTR_FLIP_MASK 0xC000
123
124#define WS_SCREEN_WIDTH_TILES 32
125#define WS_SCREEN_HEIGHT_TILES 32
126#define WS_SCREEN_WIDTH_PIXELS (WS_SCREEN_WIDTH_TILES * WS_DISPLAY_TILE_WIDTH)
127#define WS_SCREEN_HEIGHT_PIXELS (WS_SCREEN_HEIGHT_TILES * WS_DISPLAY_TILE_HEIGHT)
128
129#ifndef __ASSEMBLER__
130typedef struct {
131 uint16_t attr;
132 uint8_t y;
133 uint8_t x;
135#endif
136
140#define WS_SPRITE_ATTR_PALETTE(x) ((x) << 9)
141#define WS_SPRITE_ATTR_PALETTE_MASK (0x7 << 9)
145#define WS_SPRITE_ATTR_OUTSIDE 0x1000
149#define WS_SPRITE_ATTR_PRIORITY 0x2000
153#define WS_SPRITE_ATTR_FLIP_H 0x4000
157#define WS_SPRITE_ATTR_FLIP_V 0x8000
161#define WS_SPRITE_ATTR_FLIP 0xC000
162#define WS_SPRITE_ATTR_FLIP_MASK 0xC000
163
164#define WS_SPRITE_MAX_COUNT 128
165
173#define WS_RGB(r, g, b) (((r) << 8) | ((g) << 4) | (b))
174
178#define WS_DISPLAY_MONO_PALETTE(c0, c1, c2, c3) ((c0) | ((c1) << 4) | ((c2) << 8) | ((c3) << 12))
179
180#ifndef __ASSEMBLER__
181
187#define WS_TILE_MEM(i) ((ws_display_tile_t ws_iram *) (0x2000 + ((i) << 4)))
188
194#define WS_TILE_4BPP_MEM(i) ((ws_display_tile_4bpp_t ws_iram *) (0x4000 + ((i) << 5)))
195
202#define WS_TILE_BANKED_MEM(b, i) ((ws_display_tile_t ws_iram *) (0x2000 + (!!(b) << 13) + ((i) << 4)))
203
210#define WS_TILE_4BPP_BANKED_MEM(b, i) ((ws_display_tile_4bpp_t ws_iram *) (0x4000 + (!!(b) << 14) + ((i) << 5)))
211
217#define WS_DISPLAY_COLOR_MEM(i) ((uint16_t ws_iram *) (0xFE00 + ((i) << 5)))
218
224#define WS_SCREEN_COLOR_MEM WS_DISPLAY_COLOR_MEM
225
231#define WS_SPRITE_COLOR_MEM(i) ((uint16_t ws_iram *) (0xFF00 + ((i) << 5)))
232
233#define WS_DISPLAY_SHADE_LUT(c0, c1, c2, c3, c4, c5, c6, c7) \
234 (((uint32_t)(c0)) | (((uint32_t)(c1)) << 4) | (((uint32_t)(c2)) << 8) | (((uint32_t)(c3)) << 12) | \
235 (((uint32_t)(c4)) << 16) | (((uint32_t)(c5)) << 20) | (((uint32_t)(c6)) << 24) | (((uint32_t)(c7)) << 28))
236#define WS_DISPLAY_SHADE_LUT_DEFAULT WS_DISPLAY_SHADE_LUT(0, 2, 4, 6, 9, 11, 13, 15)
237
238// TODO: Add ws_display_set_backdrop (has to consider mono/color modes have different values)
239
247static inline void ws_display_load_palette_mono(const void __far* data, int first, int count) {
248 ws_portcpy(WS_SCR_PAL_PORT(first), data, count * 2);
249}
250
258void ws_display_load_palette_color_2bpp(const void __far* data, int first, int count);
259
267static inline void ws_display_load_palette_color_4bpp(const void __far* data, int first, int count) {
268 memcpy(WS_DISPLAY_COLOR_MEM(first), data, count * 32);
269}
270
271#define ws_sprite_load_palette_mono(data, first, count) ws_display_load_palette_mono((data), (first) + 8, (count))
272#define ws_sprite_load_palette_color_2bpp(data, first, count) ws_display_load_palette_color_2bpp((data), (first) + 8, (count))
273#define ws_sprite_load_palette_color_4bpp(data, first, count) ws_display_load_palette_color_4bpp((data), (first) + 8, (count))
274
286static inline void ws_display_set_control(uint8_t value) {
287 outportb(WS_DISPLAY_CTRL_PORT, value);
288}
289
293static inline uint8_t ws_display_get_control(void) {
294 return inportb(WS_DISPLAY_CTRL_PORT);
295}
296
303static inline void ws_display_set_screen_addresses(const void __wf_iram* scr1_addr, const void __wf_iram* scr2_addr) {
304 outportb(WS_SCR_BASE_PORT, WS_SCR_BASE_ADDR1(scr1_addr) | WS_SCR_BASE_ADDR2(scr2_addr));
305}
306
313static inline void ws_display_set_screen_address(uint8_t screen, const void __wf_iram* address) {
314 outportb(WS_SCR_BASE_PORT, (inportb(WS_SCR_BASE_PORT) & (0xF0 >> (screen * 4))) | (WS_SCR_BASE_ADDR1(address) << (screen * 4)));
315}
316
322#define ws_display_set_screen1_address(address) ws_display_set_screen_address(0, (address))
323
329#define ws_display_set_screen2_address(address) ws_display_set_screen_address(1, (address))
330
336static inline void ws_display_set_sprite_address(const void __wf_iram* address) {
337 outportb(WS_SPR_BASE_PORT, WS_SPR_BASE_ADDR(address));
338}
339
348static inline void ws_display_set_screen2_window(uint8_t x, uint8_t y, uint8_t width, uint8_t height) {
349 outportw(WS_SCR2_WIN_X1_PORT, x | (y << 8));
350 outportw(WS_SCR2_WIN_X2_PORT, ((x + width - 1) & 0xFF) | ((y + height - 1) << 8));
351}
352
361static inline void ws_display_set_screen2_window_corners(uint8_t left, uint8_t top, uint8_t right, uint8_t bottom) {
362 outportw(WS_SCR2_WIN_X1_PORT, left | (top << 8));
363 outportw(WS_SCR2_WIN_X2_PORT, right | (bottom << 8));
364}
365
374static inline void ws_display_set_sprite_window(uint8_t x, uint8_t y, uint8_t width, uint8_t height) {
375 outportw(WS_SPR_WIN_X1_PORT, x | (y << 8));
376 outportw(WS_SPR_WIN_X2_PORT, ((x + width - 1) & 0xFF) | ((y + height - 1) << 8));
377}
378
387static inline void ws_display_set_sprite_window_corners(uint8_t left, uint8_t top, uint8_t right, uint8_t bottom) {
388 outportw(WS_SPR_WIN_X1_PORT, left | (top << 8));
389 outportw(WS_SPR_WIN_X2_PORT, right | (bottom << 8));
390}
391
399static inline void ws_display_scroll_screen_to(uint8_t screen, uint8_t x, uint8_t y) {
400 outportw(WS_SCR1_SCRL_X_PORT + (screen * 2), x | (y << 8));
401}
402
409#define ws_display_scroll_screen1_to(x, y) ws_display_scroll_screen_to(0, (x), (y))
410
417#define ws_display_scroll_screen2_to(x, y) ws_display_scroll_screen_to(1, (x), (y))
418
426void ws_display_scroll_screen_by(uint8_t screen, int16_t x, int16_t y);
427
435static inline uint8_t ws_display_get_current_line(void) {
436 return inportb(WS_DISPLAY_LINE_PORT);
437}
438
445static inline void ws_display_scroll_screen1_by(uint8_t x, uint8_t y) {
446 __asm (
447 "in $0x10, %%ax\nadd %0, %%al\nadd %1, %%ah\nout %%ax, $0x10"
448 : : "g"(x), "g"(y) : "a", "cc"
449 );
450}
451
458static inline void ws_display_scroll_screen2_by(uint8_t x, uint8_t y) {
459 __asm (
460 "in $0x12, %%ax\nadd %0, %%al\nadd %1, %%ah\nout %%ax, $0x12"
461 : : "g"(x), "g"(y) : "a", "cc"
462 );
463}
464
476static inline void ws_display_set_icons(uint8_t mask) {
477 outportb(WS_LCD_ICON_PORT, mask);
478}
479
491static inline void ws_display_show_icons(uint8_t mask) {
492 outportb(WS_LCD_ICON_PORT, inportb(WS_LCD_ICON_PORT) | mask);
493}
494
506static inline void ws_display_hide_icons(uint8_t mask) {
507 outportb(WS_LCD_ICON_PORT, inportb(WS_LCD_ICON_PORT) & ~mask);
508}
509
521static inline void ws_display_toggle_icons(uint8_t mask) {
522 outportb(WS_LCD_ICON_PORT, inportb(WS_LCD_ICON_PORT) ^ mask);
523}
524
532__attribute__((no_assume_ds_data, no_assume_ss_data, save_all))
533void ws_display_set_shade_lut(uint32_t lut);
534
538#define ws_display_set_shade_lut_default() ws_display_set_shade_lut(WS_DISPLAY_SHADE_LUT_DEFAULT)
539
545static inline void ws_lcd_control_enable(void) {
547}
548
552static inline void ws_lcd_control_disable(void) {
554}
555
566static inline void ws_screen_put_tiles(void ws_iram *dest, const void __far *src, uint16_t x, uint16_t y, uint16_t width, uint16_t height) {
567 void __libws_screen_put_tiles(void ws_iram *dest, const void __far *src, uint16_t x, uint16_t y, uint16_t width, uint16_t height, uint16_t pitch);
568 __libws_screen_put_tiles(dest, src, x, y, width, height, width);
569}
570
585static inline void ws_screen_put_tiles_ex(void ws_iram *dest, const void __far *src, uint16_t sx, uint16_t sy, uint16_t pitch, uint16_t dx, uint16_t dy, uint16_t width, uint16_t height) {
586 void __libws_screen_put_tiles(void ws_iram *dest, const void __far *src, uint16_t x, uint16_t y, uint16_t width, uint16_t height, uint16_t pitch);
587 __libws_screen_put_tiles(dest, ((const uint16_t __far*) src) + (sy * pitch) + sx, dx, dy, width, height, pitch);
588}
589
600void ws_screen_get_tiles(void __far *dest, const void ws_iram *src, uint16_t x, uint16_t y, uint16_t width, uint16_t height);
601
612void ws_screen_fill_tiles(void ws_iram *dest, uint16_t src, uint16_t x, uint16_t y, uint16_t width, uint16_t height);
613
625void ws_screen_modify_tiles(void ws_iram *dest, uint16_t mask, uint16_t value, uint16_t x, uint16_t y, uint16_t width, uint16_t height);
626
635static inline void ws_screen_put_tile(void ws_iram *dest, uint16_t src, uint16_t x, uint16_t y) {
636 ((uint16_t ws_iram*) dest)[((y & 0x1F) << 5) | (x & 0x1F)] = src;
637}
638
646static inline uint16_t ws_screen_get_tile(void ws_iram *src, uint16_t x, uint16_t y) {
647 return ((uint16_t ws_iram*) src)[((y & 0x1F) << 5) | (x & 0x1F)];
648}
649
650#endif
651
653
654#endif /* LIBWS_DISPLAY_H_ */
static void ws_display_scroll_screen1_by(uint8_t x, uint8_t y)
Scroll screen 1 by a specified number of pixels.
Definition display.h:445
static void ws_display_load_palette_mono(const void __far *data, int first, int count)
Load monochrome palette data (2 bytes per palette).
Definition display.h:247
static void ws_display_set_screen2_window(uint8_t x, uint8_t y, uint8_t width, uint8_t height)
Set the position and size of the screen 2 window.
Definition display.h:348
static void ws_screen_put_tiles_ex(void ws_iram *dest, const void __far *src, uint16_t sx, uint16_t sy, uint16_t pitch, uint16_t dx, uint16_t dy, uint16_t width, uint16_t height)
Place a map of tiles on the screen. This varianta llows specifying the source X position,...
Definition display.h:585
static void ws_display_toggle_icons(uint8_t mask)
Toggle specified LCD icons.
Definition display.h:521
static void ws_display_set_sprite_address(const void __wf_iram *address)
Set the base addresses of the sprite table.
Definition display.h:336
static void ws_display_scroll_screen2_by(uint8_t x, uint8_t y)
Scroll screen 2 by a specified number of pixels.
Definition display.h:458
void ws_display_scroll_screen_by(uint8_t screen, int16_t x, int16_t y)
Scroll the specified screen by a specified number of pixels.
static void ws_screen_put_tile(void ws_iram *dest, uint16_t src, uint16_t x, uint16_t y)
Put a tile on the screen.
Definition display.h:635
static void ws_display_set_control(uint8_t value)
Set which layers and windows are visible on the display.
Definition display.h:286
static void ws_display_set_icons(uint8_t mask)
Set the list of displayed LCD icons, clearing any unspecified icons.
Definition display.h:476
void ws_display_load_palette_color_2bpp(const void __far *data, int first, int count)
Load 2BPP color palette data (4 words per palette).
static void ws_display_set_screen_address(uint8_t screen, const void __wf_iram *address)
Set the base addresses of the specified screen.
Definition display.h:313
void ws_screen_fill_tiles(void ws_iram *dest, uint16_t src, uint16_t x, uint16_t y, uint16_t width, uint16_t height)
Fill an area on the screen with a given tile.
static void ws_display_scroll_screen_to(uint8_t screen, uint8_t x, uint8_t y)
Scroll the specified screen to a specified location.
Definition display.h:399
static void ws_display_set_screen2_window_corners(uint8_t left, uint8_t top, uint8_t right, uint8_t bottom)
Set the corners of the screen 2 window.
Definition display.h:361
static void ws_display_hide_icons(uint8_t mask)
Hide specified LCD icons.
Definition display.h:506
static void ws_display_load_palette_color_4bpp(const void __far *data, int first, int count)
Load 4BPP color palette data (16 words per palette).
Definition display.h:267
static uint16_t ws_screen_get_tile(void ws_iram *src, uint16_t x, uint16_t y)
Get a tile on the screen.
Definition display.h:646
void ws_screen_get_tiles(void __far *dest, const void ws_iram *src, uint16_t x, uint16_t y, uint16_t width, uint16_t height)
Copy a map of tiles from the screen.
static void ws_display_show_icons(uint8_t mask)
Show specified LCD icons.
Definition display.h:491
static void ws_lcd_control_enable(void)
Enable the LCD panel.
Definition display.h:545
static void ws_lcd_control_disable(void)
Disable the LCD panel.
Definition display.h:552
static void ws_screen_put_tiles(void ws_iram *dest, const void __far *src, uint16_t x, uint16_t y, uint16_t width, uint16_t height)
Place a map of tiles on the screen.
Definition display.h:566
static uint8_t ws_display_get_control(void)
Query which layers and windows are visible on the display.
Definition display.h:293
static void ws_display_set_sprite_window(uint8_t x, uint8_t y, uint8_t width, uint8_t height)
Set the position and size of the sprite window.
Definition display.h:374
void ws_screen_modify_tiles(void ws_iram *dest, uint16_t mask, uint16_t value, uint16_t x, uint16_t y, uint16_t width, uint16_t height)
Modify an area on the screen with given data.
static void ws_display_set_screen_addresses(const void __wf_iram *scr1_addr, const void __wf_iram *scr2_addr)
Set the base addresses of screens 1 and 2.
Definition display.h:303
void ws_display_set_shade_lut(uint32_t lut)
Configure the shade LUT.
static uint8_t ws_display_get_current_line(void)
Get the line currently being drawn to the line buffer.
Definition display.h:435
#define WS_DISPLAY_TILE_HEIGHT
Definition display.h:50
static void ws_display_set_sprite_window_corners(uint8_t left, uint8_t top, uint8_t right, uint8_t bottom)
Set the corners of the sprite window.
Definition display.h:387
#define WS_DISPLAY_COLOR_MEM(i)
Pointer to color palette.
Definition display.h:217
#define WS_SCR2_WIN_X2_PORT
Definition ports.h:242
#define WS_SCR_PAL_PORT(i)
Definition ports.h:403
#define WS_DISPLAY_CTRL_PORT
Definition ports.h:159
#define WS_SPR_BASE_PORT
Definition ports.h:209
#define WS_SPR_BASE_ADDR(n)
Definition ports.h:210
#define WS_LCD_CTRL_PORT
Definition ports.h:292
#define WS_SPR_WIN_X1_PORT
Definition ports.h:252
#define WS_DISPLAY_LINE_PORT
Definition ports.h:199
#define WS_SCR1_SCRL_X_PORT
Definition ports.h:272
#define WS_SCR_BASE_ADDR1(n)
Definition ports.h:226
#define WS_SCR_BASE_ADDR2(n)
Definition ports.h:227
#define WS_LCD_CTRL_DISPLAY_ENABLE
Definition ports.h:315
#define WS_SPR_WIN_X2_PORT
Definition ports.h:262
#define WS_LCD_ICON_PORT
Definition ports.h:325
#define WS_SCR2_WIN_X1_PORT
Definition ports.h:232
#define WS_SCR_BASE_PORT
Definition ports.h:225
#define ws_iram
Definition memory.h:55
void ws_portcpy(uint16_t port, const void __far *src, uint16_t count)
Copy memory data to I/O ports, in order.
A structure representing a 4 bit per pixel tile.
Definition display.h:81
uint8_t plane[WS_DISPLAY_TILE_HEIGHT][4]
Per-byte access: 8 rows of 4 planes.
Definition display.h:84
uint32_t row[WS_DISPLAY_TILE_HEIGHT]
Per-row access: 32 bits per row.
Definition display.h:83
A structure representing a 2 bit per pixel tile.
Definition display.h:71
uint8_t plane[WS_DISPLAY_TILE_HEIGHT][2]
Per-byte access: 8 rows of 2 planes.
Definition display.h:74
uint16_t row[WS_DISPLAY_TILE_HEIGHT]
Per-row access: 16 bits per row.
Definition display.h:73
uint8_t x
Definition display.h:133
uint8_t y
Definition display.h:132
uint16_t attr
Definition display.h:131