Data Structures
struct	ws_display_tile_t
struct	ws_display_tile_4bpp_t
struct	ws_sprite_t

Macros
#define	WS_DISPLAY_WIDTH_TILES 28
#define	WS_DISPLAY_HEIGHT_TILES 18
#define	WS_DISPLAY_WIDTH_PIXELS (WS_DISPLAY_WIDTH_TILES * WS_DISPLAY_TILE_WIDTH)
#define	WS_DISPLAY_HEIGHT_PIXELS (WS_DISPLAY_HEIGHT_TILES * WS_DISPLAY_TILE_HEIGHT)
#define	WS_DISPLAY_TILE_WIDTH 8
#define	WS_DISPLAY_TILE_HEIGHT 8
#define	WS_DISPLAY_TILE_SIZE 16
	Tile 2-bit-per-pixel graphic data size, in bytes.
#define	WS_DISPLAY_TILE_SIZE_4BPP 32
	Tile 4-bit-per-pixel graphic data size, in bytes.
#define	WS_DISPLAY_VTOTAL 159
	Number of vertical lines in a frame.
#define	WS_SCREEN_ATTR_TILE(x)
	Attribute: tile index (0-511).
#define	WS_SCREEN_ATTR_TILE_MASK (0x1FF)
#define	WS_SCREEN_ATTR_PALETTE(x)
	Attribute: palette (0-15).
#define	WS_SCREEN_ATTR_PALETTE_MASK (0xF << 9)
#define	WS_SCREEN_ATTR_BANK(x)
	Attribute: tile bank (0-1).
#define	WS_SCREEN_ATTR_BANK_MASK (0x2000)
#define	WS_SCREEN_ATTR_TILE_EX(x)
	Attribute: tile index (0-1023). Calculates both bank and index.
#define	WS_SCREEN_ATTR_TILE_EX_MASK (0x21FF)
#define	WS_SCREEN_ATTR_FLIP_H 0x4000
	Attribute: flip tile graphic horizontally.
#define	WS_SCREEN_ATTR_FLIP_V 0x8000
	Attribute: flip tile graphic vertically.
#define	WS_SCREEN_ATTR_FLIP 0xC000
	Attribute: flip tile graphic in both axes (180-degree rotation).
#define	WS_SCREEN_ATTR_FLIP_MASK 0xC000
#define	WS_SCREEN_WIDTH_TILES 32
#define	WS_SCREEN_HEIGHT_TILES 32
#define	WS_SCREEN_WIDTH_PIXELS (WS_SCREEN_WIDTH_TILES * WS_DISPLAY_TILE_WIDTH)
#define	WS_SCREEN_HEIGHT_PIXELS (WS_SCREEN_HEIGHT_TILES * WS_DISPLAY_TILE_HEIGHT)
#define	WS_SPRITE_ATTR_PALETTE(x)
	Attribute: palette (0-7; corresponds to screen palettes 8-15).
#define	WS_SPRITE_ATTR_PALETTE_MASK (0x7 << 9)
#define	WS_SPRITE_ATTR_OUTSIDE 0x1000
	Attribute: draw sprite outside instead of inside window, if window enabled.
#define	WS_SPRITE_ATTR_PRIORITY 0x2000
	Attribute: draw sprite in front of instead of behind Screen 2.
#define	WS_SPRITE_ATTR_FLIP_H 0x4000
	Attribute: flip tile graphic horizontally.
#define	WS_SPRITE_ATTR_FLIP_V 0x8000
	Attribute: flip tile graphic vertically.
#define	WS_SPRITE_ATTR_FLIP 0xC000
	Attribute: flip tile graphic in both axes (180-degree rotation).
#define	WS_SPRITE_ATTR_FLIP_MASK 0xC000
#define	WS_SPRITE_MAX_COUNT 128
#define	WS_RGB(r, g, b)
	Create an RGB color.
#define	WS_DISPLAY_MONO_PALETTE(c0, c1, c2, c3)
	Define a mono mode palette of four shades (0-7).
#define	WS_TILE_MEM(i)
	Pointer to tile.
#define	WS_TILE_4BPP_MEM(i)
	Pointer to 4bpp tile.
#define	WS_TILE_BANKED_MEM(b, i)
	Pointer to tile, with bank specified separately.
#define	WS_TILE_4BPP_BANKED_MEM(b, i)
	Pointer to 4bpp, tile, with bank specified separately.
#define	WS_DISPLAY_COLOR_MEM(i)
	Pointer to color palette.
#define	WS_SCREEN_COLOR_MEM WS_DISPLAY_COLOR_MEM
	Pointer to screen color palette.
#define	WS_SPRITE_COLOR_MEM(i)
	Pointer to sprite color palette.
#define	WS_DISPLAY_SHADE_LUT(c0, c1, c2, c3, c4, c5, c6, c7)
#define	WS_DISPLAY_SHADE_LUT_DEFAULT WS_DISPLAY_SHADE_LUT(0, 2, 4, 6, 9, 11, 13, 15)
#define	ws_display_set_screen1_address(address)
	Set the base addresses of screen 1.
#define	ws_display_set_screen2_address(address)
	Set the base addresses of screen 2.
#define	ws_display_scroll_screen1_to(x, y)
	Scroll screen 1 to a specified location.
#define	ws_display_scroll_screen2_to(x, y)
	Scroll screen 2 to a specified location.

Functions
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.
static void	ws_display_set_screen_address (uint8_t screen, const void __wf_iram *address)
	Set the base addresses of the specified screen.
static void	ws_display_set_sprite_address (const void __wf_iram *address)
	Set the base addresses of the sprite table.
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.
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.
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.
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.
static void	ws_display_scroll_screen_to (uint8_t screen, uint8_t x, uint8_t y)
	Scroll the specified screen to a specified location.
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 uint8_t	ws_display_get_current_line (void)
	Get the line currently being drawn to the line buffer.
static void	ws_display_scroll_screen1_by (uint8_t x, uint8_t y)
	Scroll screen 1 by a specified number of pixels.
static void	ws_display_scroll_screen2_by (uint8_t x, uint8_t y)
	Scroll screen 2 by a specified number of pixels.
static void	ws_display_set_icons (uint8_t mask)
	Set the list of displayed LCD icons, clearing any unspecified icons.
static void	ws_display_show_icons (uint8_t mask)
	Show specified LCD icons.
static void	ws_display_hide_icons (uint8_t mask)
	Hide specified LCD icons.
static void	ws_display_toggle_icons (uint8_t mask)
	Toggle specified LCD icons.
void	ws_display_set_shade_lut (uint32_t lut)
	Configure the shade LUT.
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.
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, Y position and width.
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.
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.
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_screen_put_tile (void ws_iram *dest, uint16_t src, uint16_t x, uint16_t y)
	Put a tile on the screen.
static uint16_t	ws_screen_get_tile (void ws_iram *src, uint16_t x, uint16_t y)
	Get a tile on the screen.

Detailed Description

Macro Definition Documentation

◆ WS_DISPLAY_COLOR_MEM

#define WS_DISPLAY_COLOR_MEM ( i )

Value:

((uint16_t ws_iram *) (0xFE00 + ((i) << 5)))

ws_iram

#define ws_iram

Definition memory.h:55

Pointer to color palette.

Parameters

i	Color palette (0-15).

Definition at line 204 of file display.h.

◆ WS_DISPLAY_HEIGHT_PIXELS

#define WS_DISPLAY_HEIGHT_PIXELS (WS_DISPLAY_HEIGHT_TILES * WS_DISPLAY_TILE_HEIGHT)

Definition at line 46 of file display.h.

◆ WS_DISPLAY_HEIGHT_TILES

#define WS_DISPLAY_HEIGHT_TILES 18

Definition at line 44 of file display.h.

◆ WS_DISPLAY_MONO_PALETTE

#define WS_DISPLAY_MONO_PALETTE	(	c0,
		c1,
		c2,
		c3 )

Value:

((c0) | ((c1) << 4) | ((c2) << 8) | ((c3) << 12))

Define a mono mode palette of four shades (0-7).

Definition at line 165 of file display.h.

◆ ws_display_scroll_screen1_to

#define ws_display_scroll_screen1_to	(		x,
			y )

Value:

ws_display_scroll_screen_to(0, (x), (y))

ws_display_scroll_screen_to

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:329

Scroll screen 1 to a specified location.

Parameters

x	Left corner of area to show, in pixels.
y	Top corner of area to show, in pixels.

Definition at line 339 of file display.h.

◆ ws_display_scroll_screen2_to

#define ws_display_scroll_screen2_to	(		x,
			y )

Value:

ws_display_scroll_screen_to(1, (x), (y))

Scroll screen 2 to a specified location.

Parameters

x	Left corner of area to show, in pixels.
y	Top corner of area to show, in pixels.

Definition at line 347 of file display.h.

◆ ws_display_set_screen1_address

#define ws_display_set_screen1_address ( address )

Value:

ws_display_set_screen_address(0, (address))

ws_display_set_screen_address

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:243

Set the base addresses of screen 1.

Parameters

address Pointer to screen data.

Definition at line 252 of file display.h.

◆ ws_display_set_screen2_address

#define ws_display_set_screen2_address ( address )

Value:

ws_display_set_screen_address(1, (address))

Set the base addresses of screen 2.

Parameters

address Pointer to screen data.

Definition at line 259 of file display.h.

◆ WS_DISPLAY_SHADE_LUT

#define WS_DISPLAY_SHADE_LUT	(	c0,
		c1,
		c2,
		c3,
		c4,
		c5,
		c6,
		c7 )

Value:

(((uint32_t)(c0)) | (((uint32_t)(c1)) << 4) | (((uint32_t)(c2)) << 8) | (((uint32_t)(c3)) << 12) | \

(((uint32_t)(c4)) << 16) | (((uint32_t)(c5)) << 20) | (((uint32_t)(c6)) << 24) | (((uint32_t)(c7)) << 28))

Definition at line 220 of file display.h.

◆ WS_DISPLAY_SHADE_LUT_DEFAULT

#define WS_DISPLAY_SHADE_LUT_DEFAULT WS_DISPLAY_SHADE_LUT(0, 2, 4, 6, 9, 11, 13, 15)

Definition at line 223 of file display.h.

◆ WS_DISPLAY_TILE_HEIGHT

#define WS_DISPLAY_TILE_HEIGHT 8

Definition at line 49 of file display.h.

◆ WS_DISPLAY_TILE_SIZE

#define WS_DISPLAY_TILE_SIZE 16

Tile 2-bit-per-pixel graphic data size, in bytes.

Definition at line 53 of file display.h.

◆ WS_DISPLAY_TILE_SIZE_4BPP

#define WS_DISPLAY_TILE_SIZE_4BPP 32

Tile 4-bit-per-pixel graphic data size, in bytes.

Definition at line 57 of file display.h.

◆ WS_DISPLAY_TILE_WIDTH

#define WS_DISPLAY_TILE_WIDTH 8

Definition at line 48 of file display.h.

◆ WS_DISPLAY_VTOTAL

#define WS_DISPLAY_VTOTAL 159

Number of vertical lines in a frame.

Definition at line 63 of file display.h.

◆ WS_DISPLAY_WIDTH_PIXELS

#define WS_DISPLAY_WIDTH_PIXELS (WS_DISPLAY_WIDTH_TILES * WS_DISPLAY_TILE_WIDTH)

Definition at line 45 of file display.h.

◆ WS_DISPLAY_WIDTH_TILES

#define WS_DISPLAY_WIDTH_TILES 28

Definition at line 43 of file display.h.

◆ WS_RGB

#define WS_RGB	(	r,
		g,
		b )

Value:

(((r) << 8) | ((g) << 4) | (b))

Create an RGB color.

Parameters

r	The red component (0-15).
g	The red component (0-15).
b	The red component (0-15).

Definition at line 160 of file display.h.

◆ WS_SCREEN_ATTR_BANK

#define WS_SCREEN_ATTR_BANK ( x )

Value:

((x) << 13)

Attribute: tile bank (0-1).

Definition at line 89 of file display.h.

◆ WS_SCREEN_ATTR_BANK_MASK

#define WS_SCREEN_ATTR_BANK_MASK (0x2000)

Definition at line 90 of file display.h.

◆ WS_SCREEN_ATTR_FLIP

#define WS_SCREEN_ATTR_FLIP 0xC000

Attribute: flip tile graphic in both axes (180-degree rotation).

Definition at line 108 of file display.h.

◆ WS_SCREEN_ATTR_FLIP_H

#define WS_SCREEN_ATTR_FLIP_H 0x4000

Attribute: flip tile graphic horizontally.

Definition at line 100 of file display.h.

◆ WS_SCREEN_ATTR_FLIP_MASK

#define WS_SCREEN_ATTR_FLIP_MASK 0xC000

Definition at line 109 of file display.h.

◆ WS_SCREEN_ATTR_FLIP_V

#define WS_SCREEN_ATTR_FLIP_V 0x8000

Attribute: flip tile graphic vertically.

Definition at line 104 of file display.h.

◆ WS_SCREEN_ATTR_PALETTE

#define WS_SCREEN_ATTR_PALETTE ( x )

Value:

((x) << 9)

Attribute: palette (0-15).

Definition at line 84 of file display.h.

◆ WS_SCREEN_ATTR_PALETTE_MASK

#define WS_SCREEN_ATTR_PALETTE_MASK (0xF << 9)

Definition at line 85 of file display.h.

◆ WS_SCREEN_ATTR_TILE

#define WS_SCREEN_ATTR_TILE ( x )

Value:

(x)

Attribute: tile index (0-511).

Definition at line 79 of file display.h.

◆ WS_SCREEN_ATTR_TILE_EX

#define WS_SCREEN_ATTR_TILE_EX ( x )

Value:

(((x) & 0x1FF) | (((x) >> 13) << 13))

Attribute: tile index (0-1023). Calculates both bank and index.

Definition at line 94 of file display.h.

◆ WS_SCREEN_ATTR_TILE_EX_MASK

#define WS_SCREEN_ATTR_TILE_EX_MASK (0x21FF)

Definition at line 95 of file display.h.

◆ WS_SCREEN_ATTR_TILE_MASK

#define WS_SCREEN_ATTR_TILE_MASK (0x1FF)

Definition at line 80 of file display.h.

◆ WS_SCREEN_COLOR_MEM

#define WS_SCREEN_COLOR_MEM WS_DISPLAY_COLOR_MEM

Pointer to screen color palette.

Parameters

i	Color palette (0-15).

Definition at line 211 of file display.h.

◆ WS_SCREEN_HEIGHT_PIXELS

#define WS_SCREEN_HEIGHT_PIXELS (WS_SCREEN_HEIGHT_TILES * WS_DISPLAY_TILE_HEIGHT)

Definition at line 114 of file display.h.

◆ WS_SCREEN_HEIGHT_TILES

#define WS_SCREEN_HEIGHT_TILES 32

Definition at line 112 of file display.h.

◆ WS_SCREEN_WIDTH_PIXELS

#define WS_SCREEN_WIDTH_PIXELS (WS_SCREEN_WIDTH_TILES * WS_DISPLAY_TILE_WIDTH)

Definition at line 113 of file display.h.

◆ WS_SCREEN_WIDTH_TILES

#define WS_SCREEN_WIDTH_TILES 32

Definition at line 111 of file display.h.

◆ WS_SPRITE_ATTR_FLIP

#define WS_SPRITE_ATTR_FLIP 0xC000

Attribute: flip tile graphic in both axes (180-degree rotation).

Definition at line 148 of file display.h.

◆ WS_SPRITE_ATTR_FLIP_H

#define WS_SPRITE_ATTR_FLIP_H 0x4000

Attribute: flip tile graphic horizontally.

Definition at line 140 of file display.h.

◆ WS_SPRITE_ATTR_FLIP_MASK

#define WS_SPRITE_ATTR_FLIP_MASK 0xC000

Definition at line 149 of file display.h.

◆ WS_SPRITE_ATTR_FLIP_V

#define WS_SPRITE_ATTR_FLIP_V 0x8000

Attribute: flip tile graphic vertically.

Definition at line 144 of file display.h.

◆ WS_SPRITE_ATTR_OUTSIDE

#define WS_SPRITE_ATTR_OUTSIDE 0x1000

Attribute: draw sprite outside instead of inside window, if window enabled.

Definition at line 132 of file display.h.

◆ WS_SPRITE_ATTR_PALETTE

#define WS_SPRITE_ATTR_PALETTE ( x )

Value:

((x) << 9)

Attribute: palette (0-7; corresponds to screen palettes 8-15).

Definition at line 127 of file display.h.

◆ WS_SPRITE_ATTR_PALETTE_MASK

#define WS_SPRITE_ATTR_PALETTE_MASK (0x7 << 9)

Definition at line 128 of file display.h.

◆ WS_SPRITE_ATTR_PRIORITY

#define WS_SPRITE_ATTR_PRIORITY 0x2000

Attribute: draw sprite in front of instead of behind Screen 2.

Definition at line 136 of file display.h.

◆ WS_SPRITE_COLOR_MEM

#define WS_SPRITE_COLOR_MEM ( i )

Value:

((uint16_t ws_iram *) (0xFF00 + ((i) << 5)))

Pointer to sprite color palette.

Parameters

i	Color palette (0-7).

Definition at line 218 of file display.h.

◆ WS_SPRITE_MAX_COUNT

#define WS_SPRITE_MAX_COUNT 128

Definition at line 151 of file display.h.

◆ WS_TILE_4BPP_BANKED_MEM

#define WS_TILE_4BPP_BANKED_MEM	(		b,
			i )

Value:

((ws_display_tile_4bpp_t ws_iram *) (0x4000 + (!!(b) << 14) + ((i) << 5)))

ws_display_tile_4bpp_t

Definition display.h:71

Pointer to 4bpp, tile, with bank specified separately.

Parameters

b	Tile bank (0-1).
i	Tile index (0-511).

Definition at line 197 of file display.h.

◆ WS_TILE_4BPP_MEM

#define WS_TILE_4BPP_MEM ( i )

Value:

((ws_display_tile_4bpp_t ws_iram *) (0x4000 + ((i) << 5)))

Pointer to 4bpp tile.

Parameters

i	Tile index (0-1023).

Definition at line 181 of file display.h.

◆ WS_TILE_BANKED_MEM

#define WS_TILE_BANKED_MEM	(		b,
			i )

Value:

((ws_display_tile_t ws_iram *) (0x2000 + (!!(b) << 13) + ((i) << 4)))

ws_display_tile_t

Definition display.h:67

Pointer to tile, with bank specified separately.

Parameters

b	Tile bank (0-1).
i	Tile index (0-511).

Definition at line 189 of file display.h.

◆ WS_TILE_MEM

#define WS_TILE_MEM ( i )

Value:

((ws_display_tile_t ws_iram *) (0x2000 + ((i) << 4)))

Pointer to tile.

Parameters

i	Tile index (0-1023).

Definition at line 174 of file display.h.

Function Documentation

◆ ws_display_get_current_line()

uint8_t ws_display_get_current_line ( void )

inlinestatic

Get the line currently being drawn to the line buffer.

This is one higher than the line currently being sent to the LCD display.

Returns: uint8_t Currently drawn line.

Definition at line 365 of file display.h.

◆ ws_display_hide_icons()

void ws_display_hide_icons ( uint8_t mask )

inlinestatic

Hide specified LCD icons.

Parameters

mask	One or more of the LCD icon segments.

See also: WS_LCD_ICON_SLEEP; WS_LCD_ICON_ORIENT_V; WS_LCD_ICON_ORIENT_H; WS_LCD_ICON_AUX1; WS_LCD_ICON_AUX2; WS_LCD_ICON_AUX3

Definition at line 436 of file display.h.

◆ ws_display_scroll_screen1_by()

void ws_display_scroll_screen1_by	(	uint8_t	x,
		uint8_t	y )

inlinestatic

Scroll screen 1 by a specified number of pixels.

Parameters

x	Left corner of area to show, in pixels.
y	Top corner of area to show, in pixels.

Definition at line 375 of file display.h.

◆ ws_display_scroll_screen2_by()

void ws_display_scroll_screen2_by	(	uint8_t	x,
		uint8_t	y )

inlinestatic

Scroll screen 2 by a specified number of pixels.

Parameters

x	Left corner of area to show, in pixels.
y	Top corner of area to show, in pixels.

Definition at line 388 of file display.h.

◆ ws_display_scroll_screen_by()

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.

Parameters

screen	Screen ID (0 - Screen 1; 1 - Screen 2).
x	Pixels to scroll by in the X axis.
y	Pixels to scroll by in the Y axis.

◆ ws_display_scroll_screen_to()

void ws_display_scroll_screen_to	(	uint8_t	screen,
		uint8_t	x,
		uint8_t	y )

inlinestatic

Scroll the specified screen to a specified location.

Parameters

screen	Screen ID (0 - Screen 1; 1 - Screen 2).
x	Left corner of area to show, in pixels.
y	Top corner of area to show, in pixels.

Definition at line 329 of file display.h.

◆ ws_display_set_icons()

void ws_display_set_icons ( uint8_t mask )

inlinestatic

Set the list of displayed LCD icons, clearing any unspecified icons.

Parameters

mask	One or more of the LCD icon segments.

See also: WS_LCD_ICON_SLEEP; WS_LCD_ICON_ORIENT_V; WS_LCD_ICON_ORIENT_H; WS_LCD_ICON_AUX1; WS_LCD_ICON_AUX2; WS_LCD_ICON_AUX3

Definition at line 406 of file display.h.

◆ ws_display_set_screen2_window()

void ws_display_set_screen2_window	(	uint8_t	x,
		uint8_t	y,
		uint8_t	width,
		uint8_t	height )

inlinestatic

Set the position and size of the screen 2 window.

Parameters

x	X position
y	Y position
width	Width
height	Height

Definition at line 278 of file display.h.

◆ ws_display_set_screen2_window_corners()

void ws_display_set_screen2_window_corners	(	uint8_t	left,
		uint8_t	top,
		uint8_t	right,
		uint8_t	bottom )

inlinestatic

Set the corners of the screen 2 window.

Parameters

left	Left corner
top	Top corner
right	Right corner
bottom	Bottom corner

Definition at line 291 of file display.h.

◆ ws_display_set_screen_address()

void ws_display_set_screen_address	(	uint8_t	screen,
		const void __wf_iram *	address )

inlinestatic

Set the base addresses of the specified screen.

Parameters

screen	Screen ID (0 - Screen 1; 1 - Screen 2).
address	Pointer to screen data.

Definition at line 243 of file display.h.

◆ ws_display_set_screen_addresses()

void ws_display_set_screen_addresses	(	const void __wf_iram *	scr1_addr,
		const void __wf_iram *	scr2_addr )

inlinestatic

Set the base addresses of screens 1 and 2.

Parameters

scr1_addr	Pointer to screen 1 data.
scr2_addr	Pointer to screen 2 data.

Definition at line 233 of file display.h.

◆ ws_display_set_shade_lut()

void ws_display_set_shade_lut ( uint32_t lut )

Configure the shade LUT.

To learn more about the shade LUT, see video_pipeline.

Parameters

lut	The shade LUT configuration. Usage of the #GRAY_LUT macro is recommended. A default configuration is provided via #GRAY_LUT_DEFAULT .

◆ ws_display_set_sprite_address()

void ws_display_set_sprite_address ( const void __wf_iram * address )

inlinestatic

Set the base addresses of the sprite table.

Parameters

address Pointer to sprite table data.

Definition at line 266 of file display.h.

◆ ws_display_set_sprite_window()

void ws_display_set_sprite_window	(	uint8_t	x,
		uint8_t	y,
		uint8_t	width,
		uint8_t	height )

inlinestatic

Set the position and size of the sprite window.

Parameters

x	X position
y	Y position
width	Width
height	Height

Definition at line 304 of file display.h.

◆ ws_display_set_sprite_window_corners()

void ws_display_set_sprite_window_corners	(	uint8_t	left,
		uint8_t	top,
		uint8_t	right,
		uint8_t	bottom )

inlinestatic

Set the corners of the sprite window.

Parameters

left	Left corner
top	Top corner
right	Right corner
bottom	Bottom corner

Definition at line 317 of file display.h.

◆ ws_display_show_icons()

void ws_display_show_icons ( uint8_t mask )

inlinestatic

Show specified LCD icons.

Parameters

mask	One or more of the LCD icon segments.

See also: WS_LCD_ICON_SLEEP; WS_LCD_ICON_ORIENT_V; WS_LCD_ICON_ORIENT_H; WS_LCD_ICON_AUX1; WS_LCD_ICON_AUX2; WS_LCD_ICON_AUX3

Definition at line 421 of file display.h.

◆ ws_display_toggle_icons()

void ws_display_toggle_icons ( uint8_t mask )

inlinestatic

Toggle specified LCD icons.

Parameters

mask	One or more of the LCD icon segments.

See also: WS_LCD_ICON_SLEEP; WS_LCD_ICON_ORIENT_V; WS_LCD_ICON_ORIENT_H; WS_LCD_ICON_AUX1; WS_LCD_ICON_AUX2; WS_LCD_ICON_AUX3

Definition at line 451 of file display.h.

◆ ws_screen_fill_tiles()

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.

Parameters

dest	Pointer to the destination screen.
src	The tile to fill the area with.
x	Destination X position, in tiles.
y	Destination Y position, in tiles.
width	Width, in tiles.
height	Height, in tiles.

◆ ws_screen_get_tile()

uint16_t ws_screen_get_tile	(	void ws_iram *	src,
		uint16_t	x,
		uint16_t	y )

inlinestatic

Get a tile on the screen.

Parameters

src	Pointer to the source screen.
x	Destination X position, in tiles.
y	Destination Y position, in tiles.

Definition at line 555 of file display.h.

◆ ws_screen_get_tiles()

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.

Parameters

dest	Pointer to the destination area.
src	Pointer to the source screen.
x	Source X position, in tiles.
y	Source Y position, in tiles.
width	Width, in tiles.
height	Height, in tiles.

◆ ws_screen_modify_tiles()

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.

Parameters

dest	Pointer to the destination screen.
mask	The mask to AND the area with.
value	The value to OR the area with.
x	Destination X position, in tiles.
y	Destination Y position, in tiles.
width	Width, in tiles.
height	Height, in tiles.

◆ ws_screen_put_tile()

void ws_screen_put_tile	(	void ws_iram *	dest,
		uint16_t	src,
		uint16_t	x,
		uint16_t	y )

inlinestatic

Put a tile on the screen.

Parameters

dest	Pointer to the destination screen.
src	The tile to put.
x	Destination X position, in tiles.
y	Destination Y position, in tiles.

Definition at line 544 of file display.h.

◆ ws_screen_put_tiles()

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 )

inlinestatic

Place a map of tiles on the screen.

Parameters

dest	Pointer to the destination screen.
src	Pointer to the source map.
x	Destination X position, in tiles.
y	Destination Y position, in tiles.
width	Destination width, in tiles (1-32).
height	Destination height, in tiles (1-32).

Definition at line 475 of file display.h.

◆ ws_screen_put_tiles_ex()

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 )

inlinestatic

Place a map of tiles on the screen. This varianta llows specifying the source X position, Y position and width.

Parameters

dest	Pointer to the destination screen.
src	Pointer to the source map.
sx	Source X position, in tiles.
sy	Source Y position, in tiles.
pitch	Source width, in tiles.
dx	Destination X position, in tiles.
dy	Destination Y position, in tiles.
width	Destination width, in tiles (1-32).
height	Destination height, in tiles (1-32).

Definition at line 494 of file display.h.

Data Structures

Macros

Functions

Detailed Description

Macro Definition Documentation

◆ WS_DISPLAY_COLOR_MEM

◆ WS_DISPLAY_HEIGHT_PIXELS

◆ WS_DISPLAY_HEIGHT_TILES

◆ WS_DISPLAY_MONO_PALETTE

◆ ws_display_scroll_screen1_to

◆ ws_display_scroll_screen2_to

◆ ws_display_set_screen1_address

◆ ws_display_set_screen2_address

◆ WS_DISPLAY_SHADE_LUT

◆ WS_DISPLAY_SHADE_LUT_DEFAULT

◆ WS_DISPLAY_TILE_HEIGHT

◆ WS_DISPLAY_TILE_SIZE

◆ WS_DISPLAY_TILE_SIZE_4BPP

◆ WS_DISPLAY_TILE_WIDTH

◆ WS_DISPLAY_VTOTAL

◆ WS_DISPLAY_WIDTH_PIXELS

◆ WS_DISPLAY_WIDTH_TILES

◆ WS_RGB

◆ WS_SCREEN_ATTR_BANK

◆ WS_SCREEN_ATTR_BANK_MASK

◆ WS_SCREEN_ATTR_FLIP

◆ WS_SCREEN_ATTR_FLIP_H

◆ WS_SCREEN_ATTR_FLIP_MASK

◆ WS_SCREEN_ATTR_FLIP_V

◆ WS_SCREEN_ATTR_PALETTE

◆ WS_SCREEN_ATTR_PALETTE_MASK

◆ WS_SCREEN_ATTR_TILE

◆ WS_SCREEN_ATTR_TILE_EX

◆ WS_SCREEN_ATTR_TILE_EX_MASK

◆ WS_SCREEN_ATTR_TILE_MASK

◆ WS_SCREEN_COLOR_MEM

◆ WS_SCREEN_HEIGHT_PIXELS

◆ WS_SCREEN_HEIGHT_TILES

◆ WS_SCREEN_WIDTH_PIXELS

◆ WS_SCREEN_WIDTH_TILES

◆ WS_SPRITE_ATTR_FLIP

◆ WS_SPRITE_ATTR_FLIP_H

◆ WS_SPRITE_ATTR_FLIP_MASK

◆ WS_SPRITE_ATTR_FLIP_V

◆ WS_SPRITE_ATTR_OUTSIDE

◆ WS_SPRITE_ATTR_PALETTE

◆ WS_SPRITE_ATTR_PALETTE_MASK

◆ WS_SPRITE_ATTR_PRIORITY

◆ WS_SPRITE_COLOR_MEM

◆ WS_SPRITE_MAX_COUNT

◆ WS_TILE_4BPP_BANKED_MEM

◆ WS_TILE_4BPP_MEM

◆ WS_TILE_BANKED_MEM

◆ WS_TILE_MEM

Function Documentation

◆ ws_display_get_current_line()

◆ ws_display_hide_icons()

◆ ws_display_scroll_screen1_by()

◆ ws_display_scroll_screen2_by()

◆ ws_display_scroll_screen_by()

◆ ws_display_scroll_screen_to()

◆ ws_display_set_icons()

◆ ws_display_set_screen2_window()

◆ ws_display_set_screen2_window_corners()

◆ ws_display_set_screen_address()

◆ ws_display_set_screen_addresses()

◆ ws_display_set_shade_lut()

◆ ws_display_set_sprite_address()

◆ ws_display_set_sprite_window()

◆ ws_display_set_sprite_window_corners()

◆ ws_display_show_icons()

◆ ws_display_toggle_icons()

◆ ws_screen_fill_tiles()

◆ ws_screen_get_tile()

◆ ws_screen_get_tiles()

◆ ws_screen_modify_tiles()

◆ ws_screen_put_tile()

◆ ws_screen_put_tiles()

◆ ws_screen_put_tiles_ex()