TYPES

*************

chtype - Datos de carácter y atributos.

attr_t - Datos de atributos.
bool - Tipo booleano que almacena TRUE o FALSE.
WINDOW - Estructura de datos que representa una ventana.

--------------------------------------------------------------------------------

CONSTANTS
*****************

TRUE - Tipo booleano que indica verdadero.

FALSE - Tipo booleano que indica falso.
ERR - Tipo de retorno de algunas funciones que indican algún tipo de error.
LINES - Número de líneas de la ventana.
COLS - Número de columnas de la ventana.

Atributes:
A_NORMAL - Representación normal.
A_STANDOUT - Mejor modo de resaltado.
A_UNDERLINE - Subrayado.
A_REVERSE - Color invertido.
A_BLINK - Parpadeo.
A_DIM - Texto enfatizado.
A_BOLD - Texto en negrita.
A_PROTECT - Modo protegido.
A_INVIS - Modo invisible.
A_ALTCHARSET - Set de caracteres alternado.
A_CHARSET - Máscara de bits para extraer un carácter.
COLOR_PAIR(n) - Par de colores número n.

- Todos los atributos se pueden combinar con el operador |.

Colores:
COLOR_BLACK - 0
COLOR_RED - 1
COLOR_GREEN - 2
COLOR_YELLOW - 3
COLOR_BLUE - 4
COLOR_MAGENTA - 5
COLOR_CYAN - 6
COLOR_WHITE - 7

Caracteres especiales:
ACS_ULCORNER - Esquina superior izquierda.
ACS_LLCORNER - Esquina inferior izquierda.
ACS_URCORNER - Esquina superior derecha.
ACS_LRCORNER - Esquina inferior derecha.
ACS_LTEE - Intersección apuntando a la derecha.
ACS_RTEE - Intersección apuntando a la izquierda.
ACS_BTEE - Intersección apuntando hacia arriba.
ACS_TTEE - Intersección apuntando hacia abajo.
ACS_HLINE - Línea horizontal.
ACS_VLINE - Línea vertical.
ACS_PLUS - Signo más grande o cruze.
ACS_S1 - Scan line 1.
ACS_S3 - Scan line 3.
 ACS_S7 - Scan line 7.
ACS_S9 - Scan line 9.
ACS_DIAMOND - Diamante.
ACS_CKBOARD - Tablero de ajedrez.
ACS_DEGREE - Signo de grados.
ACS_PLMINUS - Signo de más/menos.
ACS_BULLET - Bala.
ACS_LARROW - Paréntesis angular izquierdo.
ACS_RARROW - Paréntesis angular derecho.
ACS_DARROW - Paréntesis angular inferior.
ACS_UARROW - Paréntesis angular superior.
ACS_BOARD - Almohadilla.
ACS_LANTERN - Linterna.
ACS_BLOCK - Almohadilla.
ACS_LEQUAL - Signo menor o igual.
ACS_GEQUAL - Signo mayor o igual.
ACS_PI - Pi.
ACS_NEQUAL - Signo no igual.
ACS_STERLING - Símbolo de la libra.

Teclas de función más usuales:

KEY_UP - Cursor arriba.
KEY_DOWN - Cursor abajo.
KEY_LEFT - Cursor izquierda.
KEY_RIGHT - Cursor derecha.
KEY_F(n) - Teclas F1, F2, F3, ..., Fn.
KEY_BACKSPACE - Tecla Borrar.
KEY_ENTER - Tecla Intro.
KEY_HOME - Tecla Home.
KEY_END - Tecla Fin.
KEY_NPAGE - Tecla AvPág.
KEY_PPAGE - Tecla RePág.
KEY_PRINT - Tecla Imprimir

--------------------------------------------------------------------------------

BASICS
**************

WINDOW* initscr(void)
- Inicializa el sistema curses y asigna memoria para nuestra ventana actual
(stdscr) y otras estructuras de datos.

int wrefresh(WINDOW *win)

- Verifica la ventana win y actualiza sólo la parte que ha sido modificada.

int refresh(void)
- Igual que wrefresh(stdscr).

int endwin(void)
- Libera la memoria ocupada por curses y pone el terminal en modo normal.

int cbreak(void)
- Desactiva el almacenamiento en buffer de línea. Los caracteres tipeados
estan disponibles inmediatamente sin necesidad de esperar al carácter
nueva línea.

int nocbreak(void)
- Vuelve a habilitar el almacenamiento de buffer en línea.
int nodelay(WINDOW *win, bool bf)
- Si bf es TRUE, convierte a getch en una llamada no bloqueante en la
ventana win. Si bf es FALSE, getch actúa normalmente (espera hasta que se
presione una tecla).

int raw(void)
- Igual que cbreak() pero, además desactiva la señal de los caracteres de
control como suspender, interrumpir o salir y pasan al programa como
cualquier otro carácter.

int noraw(void)
- Sale del modo raw().

int echo(void)
- Activa el eco de los caracteres escritos por el usuario.

int noecho(void)
- Desactiva el eco de los caracteres escritos por el usuario.

int keypad(WINDOW *win, bool bf)

- Si bf es TRUE permite la lectura en la ventana win de las teclas de
función como F1, F2, cursores, etc. Si bf es FALSE no la permite.

int halfdelay(int tn)

- Activa el modo de medio retraso, que es similar al modo cbreak() pero
espera tn décimas de segundo en la entrada y luego devuelve ERR si no hay
nada disponible.

int wmove(WINDOW *win, int y, int x)

- Sitúa el cursor en la ventana win en las coordenadas (y,x).

int move(int y, int x)

- Igual que wmove(stdscr, y, x).

void getyx(WINDOW *win, int y, int x)

- Establece las variables (y,x) con la posición actual del cursor en la
ventana win.

void getparyx(WINDOW *win, int y, int x)

- Si win es una subventana, establece las variables (y,x) con la posición
donde empieza win en relación a la ventana primaria.

void getbegyx(WINDOW *win, int y, int x)

- Establece las variables (y,x) con la posición donde empieza win en
relación a la pantalla.

void getmaxyx(WINDOW *win, int y, int x)

- Establece las variables (y,x) con el número de columnas y filas de win.

int werase(WINDOW *win)

- Borra la ventana win.

int erase(void)
- Igual que werase(stdscr).

int wclear(WINDOW *win)

- Borra la ventana win pero no es visible hasta que no se llama a wrefresh.
int clear(void)
- Igual que wclear(stdscr).

int wclrtobot(WINDOW *win)

- Borra desde el cursor hasta el final de la ventana win.

int clrtobot(void)
- Igual que wclrtobot(stdscr).

int wclrtoeol(WINDOW *win)

- Borra desde el cursor hasta el final de la línea actual en la ventana win.

int clrtoeol(void)
- Igual que wclrtoeol(stdscr).

int curs_set(int visibility)

- Establece la visibilidad del cursor.
0 - invisible
1 - normal
2 - muy visible

int def_prog_mode(void)
- Almacena el estado de curses para, con una posterior llamada a endwin,
poder salir al modo normal de la tty.

int reset_prog_mode(void)
- Devuelve a la tty al estado almacenado por def_prog_mode para, con una
posterior llamada a refresh, poder volver al estado curses.

--------------------------------------------------------------------------------

OUTPUT
**************

int waddch(WINDOW *win, const chtype ch)

- Pone el carácter ch en la posición actual del cursor de la ventana win y
avanza su posición.

int addch(const chtype ch)

- Igual que waddch(stdscr, ch).

int mvwaddch(WINDOW *win, int y, int x, const chtype ch)

- Pone el carácter ch en la posición (y,x) de la ventana win y avanza su
posición.

int mvaddch(int y, int x, const chtype ch)

- Igual que mvwaddch(stdscr, y, x, ch).

int waddstr(WINDOW *win, const char *str)

- Pone la cadena str en la posición actual del cursor de la ventana win.

int addstr(const char *str)

- Igual que waddstr(stdscr, str).

int mvwaddstr(WINDOW *win, int y, int x, const char *str)

- Pone la cadena str en la posición (y,x) de la ventana win.

int mvaddstr(int y, int x, const char *str)

- Igual que mvwaddstr(stdscr, y, x, str).
int waddnstr(WINDOW *win, const char *str, int n)
- Pone n caracteres de la cadena str en la posición actual del cursor de la
ventana win. Si n es negativo se añade toda la cadena.

int addnstr(const char *str, int n)

- Igual que waddnstr(stdscr, str, n).

int mvwaddnstr(WINDOW *win, int y, int x, const char *str, int n)

- Pone n caracteres de la cadena str en la posición (y,x) de la ventana win.
Si n es negativo se añade toda la cadena.

int mvaddnstr(int y, int x, const char *str, int n)

- Igual que mvwaddnstr(stdscr, y, x, str, n).

int wprintw(WINDOW *win, const char *fmt, ...)

- Imprime texto formateado en la posición actual del cursor de la ventana
win.

int printw(const char *fmt, ...)

- Igual que wprintw(stdscr, fmt).

int mvwprintw(WINDOW *win, int y, int x, const char *fmt, ...)

- Imprime texto formateado en la posición (y,x) de la ventana win.

int mvprintw(int y, int x, const char *fmt, ...)

- Igual que mvwprintw(stdscr, y, x, fmt).

int vwprintw(WINDOW *win, const char *fmt, va_list varglist)

- Imprime un número variable de argumentos en la posición actual del cursor
de la ventana win.

--------------------------------------------------------------------------------

INPUT
*************

int wgetch(WINDOW *win)

- Lee un carácter desde la ventana win.

int getch(void)
- Igual que wgetch(stdscr).

int wgetstr(WINDOW *win, char *str)

- Lee una cadena desde la ventana win y es apuntada por str.

int getstr(char *str)

- Igual que wgetstr(stdscr, str).

int wgetnstr(WINDOW *win, char *str, int n)

- Lee una cadena de n caracteres desde la ventana win y es apuntada por str.

int getnstr(char *str, int n)

- Igual que wgetnstr(stdscr, str, n).

int wscanw(WINDOW *win, char *fmt, ...)

- Escanea una línea de la entrada desde win y la formatea al tipo o tipos de
datos que le pasen como argumento.
int scanw(char *fmt, ...)
- Igual que wscanw(stdscr, fmt).

int mvwscanw(WINDOW *win, int y, int x, char *fmt, ...)

- Sitúa el cursor en la posición (y,x) de la ventana win y scanea la línea
de esa posición.

int mvscanw(int y, int x, char *fmt, ...)

- Igual que mvwscanw(sdtscr, y, x, fmt).

int vwscanw(WINDOW *win, char *fmt, va_list varglist)

- Scanea una línea de la entrada desde win con un número variable de
argumentos.

--------------------------------------------------------------------------------

ATRIBUTES
*****************

int wattron(WINDOW *win, int attrs)

- Establece los atributos attrs en la posición actual del cursor de la
ventana win.

int attron(int attrs)

- Igual que wattron(stdscr, attrs).

int wattroff(WINDOW *win, int attrs)

- Deshabilita los atributos attrs en la posición actual del cursor de la
ventana win.

int attroff(int attrs)

- Igual que wattroff(stdscr, attrs).

int wattrset(WINDOW *win, int attrs)

- Establece los atributos attrs en la ventana win.

int attrset(int attrs)

- Igual que wattrset(stdscr, attrs).

int wattr_get(WINDOW *win, attr_t *attrs, short *pair, void *opts)

- Establece attrs con los atributos de la ventana win y pair con los pares
de color. El argumento opts suele ser NULL.

int attr_get(attr_t *attrs, short *pair, void *opts)

- Igual que wattr_get(stcscr, attrs, pair, opts).

int wattr_set(WINDOW *win, attr_t attrs, short pair, void *opts)

- Establece los atributos attrs y los pares de color pair en la ventana win.

int attr_set(attr_t attrs, short pair, void *opts)

- Igual que wattr_set(stdscr, attrs, pair, opts).

int wchgat(WINDOW *win, int n, attr_t attr, short pair, const void *opts)
- Cambia los atributos attr y los pares de color pair de n caracteres a
partir de la posición del cursor en la ventana win. El argumento opts
suele ser NULL.

int chgat(int n, attr_t attr, short pair, const void *opts)

- Igual que wchgat(stdscr, n, attr, pair, opts).
int wstandend(WINDOW *win)
- Equivalente a wattrset(win, A_NORMAL).

int standend(void)
- Equivalente a attrset(A_NORMAL).

int wstandout(WINDOW *win)

- Equivalente a wattrset(win, A_STANDOUT).

int standout(void)
- Equivalente a attrset(A_STANDOUT).

--------------------------------------------------------------------------------

COLORS
**************

int start_color(void)
- Inicializa todos los colores soportados por el terminal.

bool has_colors(void)
- Devuelve TRUE si el terminal soporta colores o FALSE si no los soporta.

bool can_change_color(void)
- Devuelve TRUE si el terminal tiene la capacidad de cambiar el contenido de
color o FALSE si no la tiene.

int init_pair(short pair, short f, short b)

- Define un número de par pair, un color de texto f y un color de fondo b.

int init_color(short color, short r, short g, short b)

- Cambia los valores RGB de color definidos inicialmente por curses.

int color_content(short color, short *r, short *g, short *b)

- Establece las variables r, g y b con los valores actuales de color.

int pair_content(short pair, short *f, short *b)

- Establece las variables f y b con el par de color actual de pair.

int COLOR_PAIR(int n)
- Esta función se utiliza como atributo para habilitar o deshabilitar un par
de colores. El argumento n es el número de par.

--------------------------------------------------------------------------------

WINDOWS
***************

WINDOW* newwin(int nlines, int ncols, int begin_y, int begin_x)

- Reserva memoria para una ventana de tamaño (nlines x ncols) en la posición
(begin_y, begin_x).

int delwin(WINDOW *win)

- Libera la memoria utilizada por win.

int wborder(WINDOW *win, chtype ls, chtype rs, chtype ts, chtype bs, chtype tl,
chtype tr, chtype bl, chtype br)
- Dibuja un borde alrededor de la ventana win con los caracteres ls, rs, ts
 y bs para los cuatro lados, y tl, tr, bl y br para las cuatro esquinas.

int border(chtype ls, chtype rs, chtype ts, chtype bs, chtype tl, chtype tr,
chtype bl, chtype br)
- Igual que wborder(stdscr, ls, rs, ts, bs, tl, tr, bl, br).

int box(WINDOW *win, chtype verch, chtype horch)

- Dibuja un borde alrededor de win con los caracteres verch y horch. Es
equivalente a wborder(win, verch, verch, horch, horch, 0, 0, 0, 0).

int whline(WINDOW *win, chtype ch, int n)

- Dibuja una línea horizontal, a partir de la posición actual del cursor, de
n caracteres ch en la ventana win.

int wvline(WINDOW *win, chtype ch, int n)

- Dibuja una línea vertical, a partir de la posición actual del cursor, de
n caracteres ch en la ventana win.

int hline(chtype ch, int n)

- Igual que whline(stdscr, ch, n).

int vline(chtype ch, int n)

- Igual que wvline(stdscr, ch, n).

int mvwhline(WINDOW *win, int y, int x, chtype ch, int n)

- Sitúa el cursor en la posición (y,x) de la ventana win y dibuja una línea
horizontal de n caracteres ch.

int mvwvline(WINDOW *win, int y, int x, chtype ch, int n)

- Sitúa el cursor en la posición (y,x) de la ventana win y dibuja una línea
vertical de n caracteres ch.

int mvhline(int y, int x, chtype ch, int n)

- Igual que mvwhline(stdscr, y, x, ch, n).

int mvvline(int y, int x, chtype ch, int n)

- Igual que mvwvline(stdscr, y, x, ch, n).

int putwin(WINDOW *win, FILE *filep)

- Vuelca el contenido de win en el archivo filep.

WINDOW* getwin(FILE *filep)

- Recupera el estado de la ventana desde filep.

int overlay(const WINDOW *scrwin, WINDOW *dstwin)

- Copia la ventana scrwin en dstwin. La copia no es destructiva (los blancos
no son copiados).

int overwrite(const WINDOW *scrwin, WINDOW *dstwin)

- Copia la ventana scrwin en dstwin. La copia es destructiva (los blancos
son copiados).

int copywin(const WINDOW *scrwin, WINDOW *dstwin, int sminrow, int smincol,
int dminrow, int dmincol, int dmaxrow, int dmaxcol, int overlay)
- Copia desde la posición (sminrow,smincol) hasta el final de la ventana
scrwin a la posición (dminrow,dmincol) hasta la posición (dmaxrow,dmaxcol)
de la ventana dstwin. Si overlay es TRUE la copia no es destructiva.

--------------------------------------------------------------------------------
 SCREEN
**************

int scr_dump(const char *filename)

- Vuelca el contenido de la pantalla al archive filename.

int scr_restore(const char *filename)

- Recupera el contenido de la pantalla del archivo filename.