Panel-scoped output

Drawing text into a panel.

Output is retained: what is printed into a panel stays there, and is shown again every frame, until it is overwritten or cleared. The cursor and attribute persist too. Only the parts of the screen that change are redrawn.

Everything here is clipped to the panel’s content area, whatever its depth in the tree. Only panels without children hold content; output to a panel that has been split is ignored. Resizing a panel keeps the part of its content that still fits, anchored at the top left.

Functions

Return	Name	Description
void	term_panel_move	Moves the panel’s cursor.
void	term_panel_set_attr	Sets the attribute for the text printed next: TERM_ATTR_NORMAL, or any of the other TERM_ATTR_* combined with \|.
void	term_panel_set_colors	Sets the panel’s colors (TERM_COLOR_*, or any palette index).
void	term_panel_wrap	Wrap at the right edge instead of clipping (the default).
void	term_panel_putc	Prints one character. ‘\n’ starts a new line, and ‘\t’ moves to the next tab stop (every 4 columns) without painting over what’s there.
void	term_panel_print	Prints a string at the cursor.
void	term_panel_printf	Prints formatted text at the cursor.
int	term_snprintf	Formats into buf like snprintf(), with term_panel_printf()’s formatting, for titles, list items and labels.
int	term_vsnprintf	term_snprintf() with a va_list, for your own formatting functions.
void	term_panel_repeat	Prints ccount times.
void	term_panel_clear	Blanks the panel’s content area and moves the cursor to 0,0.

---

term_panel_move

void term_panel_move(term_panel_t * panel, int col, int row)

Defined in src/titrm.h:412

Moves the panel’s cursor.

---

term_panel_set_attr

void term_panel_set_attr(term_panel_t * panel, uint8_t attr)

Defined in src/titrm.h:421

Sets the attribute for the text printed next: TERM_ATTR_NORMAL, or any of the other TERM_ATTR_* combined with |.

Box-drawing characters and blocks (0xB3-0xDF) ignore the styles, so lines still join.

---

term_panel_set_colors

void term_panel_set_colors(term_panel_t * panel, uint8_t fg, uint8_t bg)

Defined in src/titrm.h:431

Sets the panel’s colors (TERM_COLOR_*, or any palette index).

Like the attribute, they apply to what is printed next, and clearing fills the panel with the background. Widgets, the border and the title are drawn in them, and a panel with children fills its area with its background. Panels split from this one start with its colors. White on black by default.

---

term_panel_wrap

void term_panel_wrap(term_panel_t * panel, bool wrap)

Defined in src/titrm.h:434

Wrap at the right edge instead of clipping (the default).

---

term_panel_putc

void term_panel_putc(term_panel_t * panel, char c)

Defined in src/titrm.h:440

Prints one character. ‘\n’ starts a new line, and ‘\t’ moves to the next tab stop (every 4 columns) without painting over what’s there.

---

term_panel_print

void term_panel_print(term_panel_t * panel, const char * str)

Defined in src/titrm.h:443

Prints a string at the cursor.

---

term_panel_printf

void term_panel_printf(term_panel_t * panel, const char * fmt, ...)

Defined in src/titrm.h:453

Prints formatted text at the cursor.

A small printf of titrmlib’s own, so programs don’t link the toolchain’s (about 7 KB). It supports d u x X c s %%, the l modifier and a width with the - and 0 flags, e.g. %-10s, %05ld, %02X. Other specifiers (floats, precision, p) are printed as written.

---

term_snprintf

int term_snprintf(char * buf, size_t size, const char * fmt, ...)

Defined in src/titrm.h:464

Formats into buf like snprintf(), with term_panel_printf()’s formatting, for titles, list items and labels.

Writes at most size - 1 characters and a terminator (nothing if size is 0, when buf may be NULL). Returns the length the whole text would have, so a result of size or more means it was cut short. Use it instead of snprintf(), which links the toolchain’s printf.

---

term_vsnprintf

int term_vsnprintf(char * buf, size_t size, const char * fmt, va_list args)

Defined in src/titrm.h:467

term_snprintf() with a va_list, for your own formatting functions.

---

term_panel_repeat

void term_panel_repeat(term_panel_t * panel, char c, int count)

Defined in src/titrm.h:470

Prints ccount times.

---

term_panel_clear

void term_panel_clear(term_panel_t * panel)

Defined in src/titrm.h:473

Blanks the panel’s content area and moves the cursor to 0,0.