GFX Mono Font Library

This modules provides functionality for outputting a monochrome font to a display.

API Overview

Modules
	System font
	The system font objects are globally available for a graphical application.

Data Structures
struct	font
	Storage structure for font meta data. More...

Enumerations
enum	font_data_type { FONT_LOC_PROGMEM }
	Valid storage locations for font data. More...

Strings and characters located in RAM
void	gfx_mono_draw_char (const char c, const gfx_coord_t x, const gfx_coord_t y, const struct font *font)
	Draws a character to the display. More...
void	gfx_mono_draw_string (const char *str, const gfx_coord_t x, const gfx_coord_t y, const struct font *font)
	Draws a string to the display. More...
void	gfx_mono_get_string_bounding_box (char const *str, const struct font *font, gfx_coord_t *width, gfx_coord_t *height)
	Computes the bounding box of a string. More...

Strings located in flash
void	gfx_mono_draw_progmem_string (char PROGMEM_PTR_T str, gfx_coord_t x, gfx_coord_t y, const struct font *font)
	Draws a string located in program memory to the display. More...
void	gfx_mono_get_progmem_string_bounding_box (char PROGMEM_PTR_T str, const struct font *font, gfx_coord_t *width, gfx_coord_t *height)
	Computes the bounding box of a string located in program memory. More...

enum font_data_type

Valid storage locations for font data.

Add support for fonts in regular ram

Enumerator
FONT_LOC_PROGMEM	Font data stored in program/flash memory.

void gfx_mono_draw_char	(	const char	c,
		const gfx_coord_t	x,
		const gfx_coord_t	y,
		const struct font *	font
	)

Draws a character to the display.

Parameters

[in]	c	Character to be drawn
[in]	x	X coordinate on screen.
[in]	y	Y coordinate on screen.
[in]	font	Font to draw character in

References Assert, FONT_LOC_PROGMEM, gfx_mono_draw_char_hugemem(), gfx_mono_draw_char_progmem(), gfx_mono_draw_filled_rect, GFX_PIXEL_CLR, font::height, font::type, and font::width.

Referenced by gfx_mono_draw_progmem_string(), and gfx_mono_draw_string().

void gfx_mono_draw_progmem_string	(	char PROGMEM_PTR_T	str,
		gfx_coord_t	x,
		gfx_coord_t	y,
		const struct font *	font
	)

Draws a string located in program memory to the display.

This function will draw a string located in program memory to the display, this differs from gfx_mono_draw_string() by using constant string data from the program memory instead of string data in RAM.

Using program memory for constant strings will reduce the applications need for RAM, and thus lower the overall size footprint.

Parameters

[in]	str	Pointer to string located in program memory
[in]	x	X coordinate on screen.
[in]	y	Y coordinate on screen.
[in]	font	Font to draw string in

References Assert, gfx_mono_draw_char(), font::height, PROGMEM_PTR_T, PROGMEM_READ_BYTE, and font::width.

void gfx_mono_draw_string	(	const char *	str,
		gfx_coord_t	x,
		gfx_coord_t	y,
		const struct font *	font
	)

Draws a string to the display.

This function will draw a string located in memory to the display.

Parameters

[in]	str	Pointer to string
[in]	x	X coordinate on screen.
[in]	y	Y coordinate on screen.
[in]	font	Font to draw string in

References Assert, gfx_mono_draw_char(), font::height, and font::width.

Referenced by init_display(), main(), and setup_board().

void gfx_mono_get_progmem_string_bounding_box	(	char PROGMEM_PTR_T	str,
		const struct font *	font,
		gfx_coord_t *	width,
		gfx_coord_t *	height
	)

Computes the bounding box of a string located in program memory.

Note

If string is empty the returned width will be 1 pixel and the height equal to the font height.

Parameters

[in]	str	String in program memory to calculate bounding box for
[in]	font	Font used
[in]	width	Pointer to width result
[in]	height	Pointer to height result

References Assert, font::height, PROGMEM_PTR_T, PROGMEM_READ_BYTE, and font::width.

void gfx_mono_get_string_bounding_box	(	const char *	str,
		const struct font *	font,
		gfx_coord_t *	width,
		gfx_coord_t *	height
	)

Computes the bounding box of a string.

Note

If string is empty the returned width will be 1 pixel and the height equal to the font height.

Parameters

[in]	str	String to calculate bounding box for
[in]	font	Font used
[in]	width	Pointer to width result
[in]	height	Pointer to height result

References Assert, font::height, and font::width.