Uso básico

Inicialización

Al principio del programa invocar la función:

int nivel_gui_inicializar(void);

Obtención del tamaño del mapa

Dado que la biblioteca utiliza toda la pantalla, los límites del mapa los podrá conocer mediante la función:

int nivel_gui_get_area_nivel(int * cols, int * rows);

Actualización de la pantalla

Cada vez que se modifique algo en la pantalla y necesite su actualización, deberá invocar:

int nivel_gui_dibujar(NIVEL* nivel);

Esta función recibe una estructura nivel, que contiene un nombre y una lista de items. Se puede revisar más información sobre sus operaciones posibles aquí

Finalización

Antes de cerrar el proceso, para liberar los recursos se debe invocar a:

int nivel_gui_terminar(void);

Manejo de errores

Todas las funciones devuelven NGUI_SUCCESS si hubo éxito o un valor distinto de NGUI_SUCCESS si ocurrió un error. Para consultar una breve descripción del error en formato string se deberá invocar:

char* nivel_gui_string_error(int errnum);

Para ver una descripción detallada de cada función y los errores que puede retornar, revisar nivel-gui.h.