66 lines
2.3 KiB
Groff
66 lines
2.3 KiB
Groff
|
.\" Manpage for BTUI.
|
||
|
|
.\" Contact bruce@bruce-hill.com to correct errors or typos.
|
||
|
|
.TH man 1 "16 May 2021" "5" "BTUI manual page"
|
||
|
|
.SH NAME
|
||
|
|
BTUI \- Bruce's Terminal User Interface library
|
||
|
|
.SH SYNOPSIS
|
||
|
|
.LP
|
||
|
|
.nf
|
||
|
|
.ft B
|
||
|
|
#include <btui.h>
|
||
|
|
.ft
|
||
|
|
.fi
|
||
|
|
.LP
|
||
|
|
.nf
|
||
|
|
|
||
|
|
\fIint \fBbtui_clear(\fIbtui_t *bt, int mode\fB)
|
||
|
|
\fIvoid \fBbtui_disable(\fIbtui_t *bt\fB)
|
||
|
|
\fIvoid \fBbtui_draw_linebox(\fIbtui_t *bt, int x, int y, int w, int h\fB)
|
||
|
|
\fIvoid \fBbtui_draw_shadow(\fIbtui_t *bt, int x, int y, int w, int h\fB)
|
||
|
|
\fIbtui_t* \fBbtui_create(\fIbtui_mode_t mode\fB)
|
||
|
|
\fI#define \fBbtui_enable(\fI) btui_create(BTUI_MODE_TUI\fB)
|
||
|
|
\fIvoid \fBbtui_fill_box(\fIbtui_t *bt, int x, int y, int w, int h\fB)
|
||
|
|
\fIint \fBbtui_flush(\fIbtui_t *bt\fB)
|
||
|
|
\fIint \fBbtui_getkey(\fIbtui_t *bt, int timeout, int *mouse_x, int *mouse_y\fB)
|
||
|
|
\fIint \fBbtui_hide_cursor(\fIbtui_t *bt\fB)
|
||
|
|
\fIchar \fB*btui_keyname(\fIint key, char *buf\fB)
|
||
|
|
\fIint \fBbtui_keynamed(\fIconst char *name\fB)
|
||
|
|
\fIint \fBbtui_move_cursor(\fIbtui_t *bt, int x, int y\fB)
|
||
|
|
\fI#define \fBbtui_printf(\fIbt, ...\fB) fprintf((bt)->out, __VA_ARGS__)
|
||
|
|
\fIint \fBbtui_puts(\fIbtui_t *bt, const char *s\fB)
|
||
|
|
\fIint \fBbtui_scroll(\fIbtui_t *bt, int firstline, int lastline, int scroll_amount\fB)
|
||
|
|
\fIint \fBbtui_set_attributes(\fIbtui_t *bt, attr_t attrs\fB)
|
||
|
|
\fIint \fBbtui_set_bg(\fIbtui_t *bt, unsigned char r, unsigned char g, unsigned char b\fB)
|
||
|
|
\fIint \fBbtui_set_bg_hex(\fIbtui_t *bt, int hex\fB)
|
||
|
|
\fIint \fBbtui_set_cursor(\fIbtui_t *bt, cursor_t cur\fB)
|
||
|
|
\fIint \fBbtui_set_fg(\fIbtui_t *bt, unsigned char r, unsigned char g, unsigned char b\fB)
|
||
|
|
\fIint \fBbtui_set_fg_hex(\fIbtui_t *bt, int hex\fB)
|
||
|
|
\fIint \fBbtui_show_cursor(\fIbtui_t *bt\fB)
|
||
|
|
\fIint \fBbtui_suspend(\fIbtui_t *bt\fB)
|
||
|
|
|
||
|
|
.SH DESCRIPTION
|
||
|
|
\fBBTUI\fR is a compact text-user-interface library that can serve as a
|
||
|
|
minimalist alternative to ncurses.
|
||
|
|
|
||
|
|
.SH EXAMPLES
|
||
|
|
.TP
|
||
|
|
.ft
|
||
|
|
.fi
|
||
|
|
.LP
|
||
|
|
.nf
|
||
|
|
btui_t *bt = btui_create(BTUI_MODE_TUI);
|
||
|
|
char name[100];
|
||
|
|
int key = -1;
|
||
|
|
do {
|
||
|
|
btui_clear(bt, BTUI_CLEAR_SCREEN);
|
||
|
|
btui_move_cursor(bt, bt->width/2, bt->height/2);
|
||
|
|
btui_keyname(key, name);
|
||
|
|
btui_printf(bt, "You pressed: %s", name);
|
||
|
|
btui_flush(bt);
|
||
|
|
do key = btui_getkey(bt, 0, NULL, NULL);
|
||
|
|
while (key == -1);
|
||
|
|
} while (key != KEY_CTRL_C && key != 'q');
|
||
|
|
|
||
|
|
.SH AUTHOR
|
||
|
|
Bruce Hill (bruce@bruce-hill.com)
|