Basic operations. More...

Functions
void	tte_set_context (TTC *tc)
	Set the master context pointer.

INLINE TTC *	tte_get_context (void)
	Get the master text-system.

INLINE uint	tte_get_glyph_id (int ch)
	Get the glyph index of character ch.

INLINE int	tte_get_glyph_width (uint gid)
	Get the width of glyph id.

INLINE int	tte_get_glyph_height (uint gid)
	Get the height of glyph id.

INLINE const void *	tte_get_glyph_data (uint gid)
	Get the glyph data of glyph id.

void	tte_set_color (eint type, u16 clr)
	Set color attribute of type to cattr.

void	tte_set_colors (const u16 colors[])
	Load important color data.

void	tte_set_color_attr (eint type, u16 cattr)
	Set color attribute of type to cattr.

void	tte_set_color_attrs (const u16 cattrs[])
	Load important color attribute data.

char *	tte_cmd_default (const char *str)
	Text command handler.

int	tte_putc (int ch)
	Plot a single character; does wrapping too.

int	tte_write (const char *text)
	Render a string.

int	tte_write_ex (int x, int y, const char text, const u16 clrlut)
	Extended string writer, with positional and color info.

void	tte_erase_rect (int left, int top, int right, int bottom)
	Erase a porttion of the screen (ignores margins)

void	tte_erase_screen (void)
	Erase the screen (within the margins).

void	tte_erase_line (void)
	Erase the whole line (within the margins).

POINT16	tte_get_text_size (const char *str)
	Get the size taken up by a string.

void	tte_init_base (const TFont *font, fnDrawg drawProc, fnErase eraseProc)
	Base initializer of a TTC.

Detailed Description

Basic operations.

This covers most of the things you can actually use TTE for, like writing the text, getting information about a glyph and setting color attributes.

Function Documentation

◆ tte_cmd_default()

char * tte_cmd_default ( const char * str )

Text command handler.

Takes commands formatted as "#{[cmd]:[opt];[[cmd]:[opt];...]} and deals with them. Command list: - P Set cursor to margin top-left. - Ps Save cursor position - Pr Restore cursor position. - P:\#x,\#y Set cursorX/Y to \e x, \e y. - X Set cursorX to margin left. - X:\#x Set cursorX to \e x. - Y Set cursorY to margin top. - Y:\#y Set cursorX to \e y. - c[ispx]:\#val Set ink/shadow/paper/special color to \e val. - e[slbfr] Erase screen/line/backward/forward/rect - m:\#l,\#t,\#r,\#b Set all margins - m[ltrb]:\#val Set margin to \e val. - p:\#x,\#y Move cursorX/Y by \e x, \e y. - w:\#val Wait \e val frame. - x:\#x Move cursorX by \e x. - y:\#y Move cursorX by \e y. Examples: - #{X:32} Move to \e x = 32; - #{ci:0x7FFF} Set ink color to white. - #{w:120;es;P} Wait 120 frames, clear screen, return to top of screen. @param str Start of command. Assumes the initial "\{" is lobbed off already.

Returns: pointer to after the parsed command.

Note: Routine does text wrapping. Make sure margins are set.; This function involves heavy (yet necessary) switching. Leave your sanity at the door before viewing.

Todo:

Scrolling and variables ?

Restructure for safety checks.

References TTC::cattr, TFont::charH, TTC::cursorX, TTC::cursorY, TTC::font, TTC::fontTable, TTC::stringTable, tte_cmd_next(), tte_erase_line(), tte_erase_rect(), tte_erase_screen(), tte_get_context(), tte_write(), and VBlankIntrDelay().