caca.h.3caca man page

caca.h — The libcaca public header.  

Synopsis

Data Structures

struct caca_event
Handling of user events.
struct caca_option
Option parsing.
struct caca_conio_text_info
DOS text area information.

Macros

#define CACA_API_VERSION_1
#define CACA_MAGIC_FULLWIDTH   0x000ffffe

Typedefs

typedef struct caca_canvas caca_canvas_t
typedef struct caca_dither caca_dither_t
typedef struct caca_charfont caca_charfont_t
typedef struct caca_font caca_font_t
typedef struct caca_file caca_file_t
typedef struct caca_display caca_display_t
typedef struct caca_event caca_event_t

Enumerations

enum caca_color { CACA_BLACK = 0x00, CACA_BLUE = 0x01, CACA_GREEN = 0x02, CACA_CYAN = 0x03, CACA_RED = 0x04, CACA_MAGENTA = 0x05, CACA_BROWN = 0x06, CACA_LIGHTGRAY = 0x07, CACA_DARKGRAY = 0x08, CACA_LIGHTBLUE = 0x09, CACA_LIGHTGREEN = 0x0a, CACA_LIGHTCYAN = 0x0b, CACA_LIGHTRED = 0x0c, CACA_LIGHTMAGENTA = 0x0d, CACA_YELLOW = 0x0e, CACA_WHITE = 0x0f, CACA_DEFAULT = 0x10, CACA_TRANSPARENT = 0x20 }
enum caca_style { CACA_BOLD = 0x01, CACA_ITALICS = 0x02, CACA_UNDERLINE = 0x04, CACA_BLINK = 0x08 }
enum caca_event_type { CACA_EVENT_NONE = 0x0000, CACA_EVENT_KEY_PRESS = 0x0001, CACA_EVENT_KEY_RELEASE = 0x0002, CACA_EVENT_MOUSE_PRESS = 0x0004, CACA_EVENT_MOUSE_RELEASE = 0x0008, CACA_EVENT_MOUSE_MOTION = 0x0010, CACA_EVENT_RESIZE = 0x0020, CACA_EVENT_QUIT = 0x0040, CACA_EVENT_ANY = 0xffff } User event type enumeration. "
enum caca_key { CACA_KEY_UNKNOWN = 0x00, CACA_KEY_CTRL_A = 0x01, CACA_KEY_CTRL_B = 0x02, CACA_KEY_CTRL_C = 0x03, CACA_KEY_CTRL_D = 0x04, CACA_KEY_CTRL_E = 0x05, CACA_KEY_CTRL_F = 0x06, CACA_KEY_CTRL_G = 0x07, CACA_KEY_BACKSPACE = 0x08, CACA_KEY_TAB = 0x09, CACA_KEY_CTRL_J = 0x0a, CACA_KEY_CTRL_K = 0x0b, CACA_KEY_CTRL_L = 0x0c, CACA_KEY_RETURN = 0x0d, CACA_KEY_CTRL_N = 0x0e, CACA_KEY_CTRL_O = 0x0f, CACA_KEY_CTRL_P = 0x10, CACA_KEY_CTRL_Q = 0x11, CACA_KEY_CTRL_R = 0x12, CACA_KEY_PAUSE = 0x13, CACA_KEY_CTRL_T = 0x14, CACA_KEY_CTRL_U = 0x15, CACA_KEY_CTRL_V = 0x16, CACA_KEY_CTRL_W = 0x17, CACA_KEY_CTRL_X = 0x18, CACA_KEY_CTRL_Y = 0x19, CACA_KEY_CTRL_Z = 0x1a, CACA_KEY_ESCAPE = 0x1b, CACA_KEY_DELETE = 0x7f, CACA_KEY_UP = 0x111, CACA_KEY_DOWN = 0x112, CACA_KEY_LEFT = 0x113, CACA_KEY_RIGHT = 0x114, CACA_KEY_INSERT = 0x115, CACA_KEY_HOME = 0x116, CACA_KEY_END = 0x117, CACA_KEY_PAGEUP = 0x118, CACA_KEY_PAGEDOWN = 0x119, CACA_KEY_F1 = 0x11a, CACA_KEY_F2 = 0x11b, CACA_KEY_F3 = 0x11c, CACA_KEY_F4 = 0x11d, CACA_KEY_F5 = 0x11e, CACA_KEY_F6 = 0x11f, CACA_KEY_F7 = 0x120, CACA_KEY_F8 = 0x121, CACA_KEY_F9 = 0x122, CACA_KEY_F10 = 0x123, CACA_KEY_F11 = 0x124, CACA_KEY_F12 = 0x125, CACA_KEY_F13 = 0x126, CACA_KEY_F14 = 0x127, CACA_KEY_F15 = 0x128 } Special key values. "
enum CACA_CONIO_COLORS { CACA_CONIO_BLINK = 128, CACA_CONIO_BLACK = 0, CACA_CONIO_BLUE = 1, CACA_CONIO_GREEN = 2, CACA_CONIO_CYAN = 3, CACA_CONIO_RED = 4, CACA_CONIO_MAGENTA = 5, CACA_CONIO_BROWN = 6, CACA_CONIO_LIGHTGRAY = 7, CACA_CONIO_DARKGRAY = 8, CACA_CONIO_LIGHTBLUE = 9, CACA_CONIO_LIGHTGREEN = 10, CACA_CONIO_LIGHTCYAN = 11, CACA_CONIO_LIGHTRED = 12, CACA_CONIO_LIGHTMAGENTA = 13, CACA_CONIO_YELLOW = 14, CACA_CONIO_WHITE = 15 } DOS colours. "
enum CACA_CONIO_CURSOR { CACA_CONIO__NOCURSOR = 0, CACA_CONIO__SOLIDCURSOR = 1, CACA_CONIO__NORMALCURSOR = 2 } DOS cursor modes. "
enum CACA_CONIO_MODE { CACA_CONIO_LASTMODE = -1, CACA_CONIO_BW40 = 0, CACA_CONIO_C40 = 1, CACA_CONIO_BW80 = 2, CACA_CONIO_C80 = 3, CACA_CONIO_MONO = 7, CACA_CONIO_C4350 = 64 } DOS video modes. "

Functions

__extern caca_canvas_t * caca_create_canvas (int, int)
Initialise a libcaca canvas.
__extern int caca_manage_canvas (caca_canvas_t *, int(*)(void *), void *)
Manage a canvas.
__extern int caca_unmanage_canvas (caca_canvas_t *, int(*)(void *), void *)
unmanage a canvas.
__extern int caca_set_canvas_size (caca_canvas_t *, int, int)
Resize a canvas.
__extern int caca_get_canvas_width (caca_canvas_t const *)
Get the canvas width.
__extern int caca_get_canvas_height (caca_canvas_t const *)
Get the canvas height.
__extern uint32_t const  * caca_get_canvas_chars (caca_canvas_t const *)
Get the canvas character array.
__extern uint32_t const  * caca_get_canvas_attrs (caca_canvas_t const *)
Get the canvas attribute array.
__extern int caca_free_canvas (caca_canvas_t *)
Free a libcaca canvas.
__extern int caca_rand (int, int)
__extern char const  * caca_get_version (void)
Return the libcaca version.
__extern int caca_gotoxy (caca_canvas_t *, int, int)
Set cursor position.
__extern int caca_wherex (caca_canvas_t const *)
Get X cursor position.
__extern int caca_wherey (caca_canvas_t const *)
Get Y cursor position.
__extern int caca_put_char (caca_canvas_t *, int, int, uint32_t)
Print an ASCII or Unicode character.
__extern uint32_t caca_get_char (caca_canvas_t const *, int, int)
Get the Unicode character at the given coordinates.
__extern int caca_put_str (caca_canvas_t *, int, int, char const *)
Print a string.
__extern int caca_printf (caca_canvas_t *, int, int, char const *,...)
Print a formated string.
__extern int caca_vprintf (caca_canvas_t *, int, int, char const *, va_list)
Print a formated string (va_list version).
__extern int caca_clear_canvas (caca_canvas_t *)
Clear the canvas.
__extern int caca_set_canvas_handle (caca_canvas_t *, int, int)
Set cursor handle.
__extern int caca_get_canvas_handle_x (caca_canvas_t const *)
Get X handle position.
__extern int caca_get_canvas_handle_y (caca_canvas_t const *)
Get Y handle position.
__extern int caca_blit (caca_canvas_t *, int, int, caca_canvas_t const *, caca_canvas_t const *)
Blit a canvas onto another one.
__extern int caca_set_canvas_boundaries (caca_canvas_t *, int, int, int, int)
Set a canvas' new boundaries.
__extern int caca_disable_dirty_rect (caca_canvas_t *)
Disable dirty rectangles.
__extern int caca_enable_dirty_rect (caca_canvas_t *)
Enable dirty rectangles.
__extern int caca_get_dirty_rect_count (caca_canvas_t *)
Get the number of dirty rectangles in the canvas.
__extern int caca_get_dirty_rect (caca_canvas_t *, int, int *, int *, int *, int *)
Get a canvas's dirty rectangle.
__extern int caca_add_dirty_rect (caca_canvas_t *, int, int, int, int)
Add an area to the canvas's dirty rectangle list.
__extern int caca_remove_dirty_rect (caca_canvas_t *, int, int, int, int)
Remove an area from the dirty rectangle list.
__extern int caca_clear_dirty_rect_list (caca_canvas_t *)
Clear a canvas's dirty rectangle list.
__extern int caca_invert (caca_canvas_t *)
Invert a canvas' colours.
__extern int caca_flip (caca_canvas_t *)
Flip a canvas horizontally.
__extern int caca_flop (caca_canvas_t *)
Flip a canvas vertically.
__extern int caca_rotate_180 (caca_canvas_t *)
Rotate a canvas.
__extern int caca_rotate_left (caca_canvas_t *)
Rotate a canvas, 90 degrees counterclockwise.
__extern int caca_rotate_right (caca_canvas_t *)
Rotate a canvas, 90 degrees counterclockwise.
__extern int caca_stretch_left (caca_canvas_t *)
Rotate and stretch a canvas, 90 degrees counterclockwise.
__extern int caca_stretch_right (caca_canvas_t *)
Rotate and stretch a canvas, 90 degrees clockwise.
__extern uint32_t caca_get_attr (caca_canvas_t const *, int, int)
Get the text attribute at the given coordinates.
__extern int caca_set_attr (caca_canvas_t *, uint32_t)
Set the default character attribute.
__extern int caca_unset_attr (caca_canvas_t *, uint32_t)
Unset flags in the default character attribute.
__extern int caca_toggle_attr (caca_canvas_t *, uint32_t)
Toggle flags in the default character attribute.
__extern int caca_put_attr (caca_canvas_t *, int, int, uint32_t)
Set the character attribute at the given coordinates.
__extern int caca_set_color_ansi (caca_canvas_t *, uint8_t, uint8_t)
Set the default colour pair for text (ANSI version).
__extern int caca_set_color_argb (caca_canvas_t *, uint16_t, uint16_t)
Set the default colour pair for text (truecolor version).
__extern uint8_t caca_attr_to_ansi (uint32_t)
Get DOS ANSI information from attribute.
__extern uint8_t caca_attr_to_ansi_fg (uint32_t)
Get ANSI foreground information from attribute.
__extern uint8_t caca_attr_to_ansi_bg (uint32_t)
Get ANSI background information from attribute.
__extern uint16_t caca_attr_to_rgb12_fg (uint32_t)
Get 12-bit RGB foreground information from attribute.
__extern uint16_t caca_attr_to_rgb12_bg (uint32_t)
Get 12-bit RGB background information from attribute.
__extern void caca_attr_to_argb64 (uint32_t, uint8_t[8])
Get 64-bit ARGB information from attribute.
__extern uint32_t caca_utf8_to_utf32 (char const *, size_t *)
Convert a UTF-8 character to UTF-32.
__extern size_t caca_utf32_to_utf8 (char *, uint32_t)
Convert a UTF-32 character to UTF-8.
__extern uint8_t caca_utf32_to_cp437 (uint32_t)
Convert a UTF-32 character to CP437.
__extern uint32_t caca_cp437_to_utf32 (uint8_t)
Convert a CP437 character to UTF-32.
__extern char caca_utf32_to_ascii (uint32_t)
Convert a UTF-32 character to ASCII.
__extern int caca_utf32_is_fullwidth (uint32_t)
Tell whether a UTF-32 character is fullwidth.
__extern int caca_draw_line (caca_canvas_t *, int, int, int, int, uint32_t)
Draw a line on the canvas using the given character.
__extern int caca_draw_polyline (caca_canvas_t *, int const x[], int const y[], int, uint32_t)
Draw a polyline.
__extern int caca_draw_thin_line (caca_canvas_t *, int, int, int, int)
Draw a thin line on the canvas, using ASCII art.
__extern int caca_draw_thin_polyline (caca_canvas_t *, int const x[], int const y[], int)
Draw an ASCII art thin polyline.
__extern int caca_draw_circle (caca_canvas_t *, int, int, int, uint32_t)
Draw a circle on the canvas using the given character.
__extern int caca_draw_ellipse (caca_canvas_t *, int, int, int, int, uint32_t)
Draw an ellipse on the canvas using the given character.
__extern int caca_draw_thin_ellipse (caca_canvas_t *, int, int, int, int)
Draw a thin ellipse on the canvas.
__extern int caca_fill_ellipse (caca_canvas_t *, int, int, int, int, uint32_t)
Fill an ellipse on the canvas using the given character.
__extern int caca_draw_box (caca_canvas_t *, int, int, int, int, uint32_t)
Draw a box on the canvas using the given character.
__extern int caca_draw_thin_box (caca_canvas_t *, int, int, int, int)
Draw a thin box on the canvas.
__extern int caca_draw_cp437_box (caca_canvas_t *, int, int, int, int)
Draw a box on the canvas using CP437 characters.
__extern int caca_fill_box (caca_canvas_t *, int, int, int, int, uint32_t)
Fill a box on the canvas using the given character.
__extern int caca_draw_triangle (caca_canvas_t *, int, int, int, int, int, int, uint32_t)
Draw a triangle on the canvas using the given character.
__extern int caca_draw_thin_triangle (caca_canvas_t *, int, int, int, int, int, int)
Draw a thin triangle on the canvas.
__extern int caca_fill_triangle (caca_canvas_t *, int, int, int, int, int, int, uint32_t)
Fill a triangle on the canvas using the given character.
__extern int caca_fill_triangle_textured (caca_canvas_t *cv, int coords[6], caca_canvas_t *tex, float uv[6])
Fill a triangle on the canvas using an arbitrary-sized texture.
__extern int caca_get_frame_count (caca_canvas_t const *)
Get the number of frames in a canvas.
__extern int caca_set_frame (caca_canvas_t *, int)
Activate a given canvas frame.
__extern char const  * caca_get_frame_name (caca_canvas_t const *)
Get the current frame's name.
__extern int caca_set_frame_name (caca_canvas_t *, char const *)
Set the current frame's name.
__extern int caca_create_frame (caca_canvas_t *, int)
Add a frame to a canvas.
__extern int caca_free_frame (caca_canvas_t *, int)
Remove a frame from a canvas.
__extern caca_dither_t * caca_create_dither (int, int, int, int, uint32_t, uint32_t, uint32_t, uint32_t)
Create an internal dither object.
__extern int caca_set_dither_palette (caca_dither_t *, uint32_t r[], uint32_t g[], uint32_t b[], uint32_t a[])
Set the palette of an 8bpp dither object.
__extern int caca_set_dither_brightness (caca_dither_t *, float)
Set the brightness of a dither object.
__extern float caca_get_dither_brightness (caca_dither_t const *)
Get the brightness of a dither object.
__extern int caca_set_dither_gamma (caca_dither_t *, float)
Set the gamma of a dither object.
__extern float caca_get_dither_gamma (caca_dither_t const *)
Get the gamma of a dither object.
__extern int caca_set_dither_contrast (caca_dither_t *, float)
Set the contrast of a dither object.
__extern float caca_get_dither_contrast (caca_dither_t const *)
Get the contrast of a dither object.
__extern int caca_set_dither_antialias (caca_dither_t *, char const *)
Set dither antialiasing.
__extern char const  *const  * caca_get_dither_antialias_list (caca_dither_t const *)
Get available antialiasing methods.
__extern char const  * caca_get_dither_antialias (caca_dither_t const *)
Get current antialiasing method.
__extern int caca_set_dither_color (caca_dither_t *, char const *)
Choose colours used for dithering.
__extern char const  *const  * caca_get_dither_color_list (caca_dither_t const *)
Get available colour modes.
__extern char const  * caca_get_dither_color (caca_dither_t const *)
Get current colour mode.
__extern int caca_set_dither_charset (caca_dither_t *, char const *)
Choose characters used for dithering.
__extern char const  *const  * caca_get_dither_charset_list (caca_dither_t const *)
Get available dither character sets.
__extern char const  * caca_get_dither_charset (caca_dither_t const *)
Get current character set.
__extern int caca_set_dither_algorithm (caca_dither_t *, char const *)
Set dithering algorithm.
__extern char const  *const  * caca_get_dither_algorithm_list (caca_dither_t const *)
Get dithering algorithms.
__extern char const  * caca_get_dither_algorithm (caca_dither_t const *)
Get current dithering algorithm.
__extern int caca_dither_bitmap (caca_canvas_t *, int, int, int, int, caca_dither_t const *, void const *)
Dither a bitmap on the canvas.
__extern int caca_free_dither (caca_dither_t *)
Free the memory associated with a dither.
__extern caca_charfont_t * caca_load_charfont (void const *, size_t)
__extern int caca_free_charfont (caca_charfont_t *)
__extern caca_font_t * caca_load_font (void const *, size_t)
Load a font from memory for future use.
__extern char const  *const  * caca_get_font_list (void)
Get available builtin fonts.
__extern int caca_get_font_width (caca_font_t const *)
Get a font's standard glyph width.
__extern int caca_get_font_height (caca_font_t const *)
Get a font's standard glyph height.
__extern uint32_t const  * caca_get_font_blocks (caca_font_t const *)
Get a font's list of supported glyphs.
__extern int caca_render_canvas (caca_canvas_t const *, caca_font_t const *, void *, int, int, int)
Render the canvas onto an image buffer.
__extern int caca_free_font (caca_font_t *)
Free a font structure.
__extern int caca_canvas_set_figfont (caca_canvas_t *, char const *)
load a figfont and attach it to a canvas
__extern int caca_set_figfont_smush (caca_canvas_t *, char const *)
set the smushing mode of the figfont rendering
__extern int caca_set_figfont_width (caca_canvas_t *, int)
set the width of the figfont rendering
__extern int caca_put_figchar (caca_canvas_t *, uint32_t)
paste a character using the current figfont
__extern int caca_flush_figlet (caca_canvas_t *)
flush the figlet context
__extern caca_file_t * caca_file_open (char const *, const char *)
Open a file for reading or writing.
__extern int caca_file_close (caca_file_t *)
Close a file handle.
__extern uint64_t caca_file_tell (caca_file_t *)
Return the position in a file handle.
__extern size_t caca_file_read (caca_file_t *, void *, size_t)
Read data from a file handle.
__extern size_t caca_file_write (caca_file_t *, const void *, size_t)
Write data to a file handle.
__extern char * caca_file_gets (caca_file_t *, char *, int)
Read a line from a file handle.
__extern int caca_file_eof (caca_file_t *)
Tell whether a file handle reached end of file.
__extern ssize_t caca_import_canvas_from_memory (caca_canvas_t *, void const *, size_t, char const *)
Import a memory buffer into a canvas.
__extern ssize_t caca_import_canvas_from_file (caca_canvas_t *, char const *, char const *)
Import a file into a canvas.
__extern ssize_t caca_import_area_from_memory (caca_canvas_t *, int, int, void const *, size_t, char const *)
Import a memory buffer into a canvas area.
__extern ssize_t caca_import_area_from_file (caca_canvas_t *, int, int, char const *, char const *)
Import a file into a canvas area.
__extern char const  *const  * caca_get_import_list (void)
Get available import formats.
__extern void * caca_export_canvas_to_memory (caca_canvas_t const *, char const *, size_t *)
Export a canvas into a foreign format.
__extern void * caca_export_area_to_memory (caca_canvas_t const *, int, int, int, int, char const *, size_t *)
Export a canvas portion into a foreign format.
__extern char const  *const  * caca_get_export_list (void)
Get available export formats.
__extern caca_display_t * caca_create_display (caca_canvas_t *)
Attach a caca graphical context to a caca canvas.
__extern caca_display_t * caca_create_display_with_driver (caca_canvas_t *, char const *)
Attach a specific caca graphical context to a caca canvas.
__extern char const  *const  * caca_get_display_driver_list (void)
Get available display drivers.
__extern char const  * caca_get_display_driver (caca_display_t *)
Return a caca graphical context's current output driver.
__extern int caca_set_display_driver (caca_display_t *, char const *)
Set the output driver.
__extern int caca_free_display (caca_display_t *)
Detach a caca graphical context from a caca backend context.
__extern caca_canvas_t * caca_get_canvas (caca_display_t *)
Get the canvas attached to a caca graphical context.
__extern int caca_refresh_display (caca_display_t *)
Flush pending changes and redraw the screen.
__extern int caca_set_display_time (caca_display_t *, int)
Set the refresh delay.
__extern int caca_get_display_time (caca_display_t const *)
Get the display's average rendering time.
__extern int caca_get_display_width (caca_display_t const *)
Get the display width.
__extern int caca_get_display_height (caca_display_t const *)
Get the display height.
__extern int caca_set_display_title (caca_display_t *, char const *)
Set the display title.
__extern int caca_set_mouse (caca_display_t *, int)
Show or hide the mouse pointer.
__extern int caca_set_cursor (caca_display_t *, int)
Show or hide the cursor.
__extern int caca_get_event (caca_display_t *, int, caca_event_t *, int)
Get the next mouse or keyboard input event.
__extern int caca_get_mouse_x (caca_display_t const *)
Return the X mouse coordinate.
__extern int caca_get_mouse_y (caca_display_t const *)
Return the Y mouse coordinate.
__extern enum caca_event_type caca_get_event_type (caca_event_t const *)
Return an event's type.
__extern int caca_get_event_key_ch (caca_event_t const *)
Return a key press or key release event's value.
__extern uint32_t caca_get_event_key_utf32 (caca_event_t const *)
Return a key press or key release event's Unicode value.
__extern int caca_get_event_key_utf8 (caca_event_t const *, char *)
Return a key press or key release event's UTF-8 value.
__extern int caca_get_event_mouse_button (caca_event_t const *)
Return a mouse press or mouse release event's button.
__extern int caca_get_event_mouse_x (caca_event_t const *)
Return a mouse motion event's X coordinate.
__extern int caca_get_event_mouse_y (caca_event_t const *)
Return a mouse motion event's Y coordinate.
__extern int caca_get_event_resize_width (caca_event_t const *)
Return a resize event's display width value.
__extern int caca_get_event_resize_height (caca_event_t const *)
Return a resize event's display height value.
__extern int caca_getopt (int, char *const [], char const *, struct caca_option const *, int *)
__extern char * caca_conio_cgets (char *str)
DOS conio.h cgets() equivalent.
__extern void caca_conio_clreol (void)
DOS conio.h clreol() equivalent.
__extern void caca_conio_clrscr (void)
DOS conio.h clrscr() equivalent.
__extern int caca_conio_cprintf (const char *format,...)
DOS conio.h cprintf() equivalent.
__extern int caca_conio_cputs (const char *str)
DOS conio.h cputs() equivalent.
__extern int caca_conio_cscanf (char *format,...)
DOS stdio.h cscanf() equivalent.
__extern void caca_conio_delay (unsigned int)
DOS dos.h delay() equivalent.
__extern void caca_conio_delline (void)
DOS conio.h delline() equivalent.
__extern int caca_conio_getch (void)
DOS conio.h getch() equivalent.
__extern int caca_conio_getche (void)
DOS conio.h getche() equivalent.
__extern char * caca_conio_getpass (const char *prompt)
DOS conio.h getpass() equivalent.
__extern int caca_conio_gettext (int left, int top, int right, int bottom, void *destin)
DOS conio.h gettext() equivalent.
__extern void caca_conio_gettextinfo (struct caca_conio_text_info *r)
DOS conio.h gettextinfo() equivalent.
__extern void caca_conio_gotoxy (int x, int y)
DOS conio.h gotoxy() equivalent.
__extern void caca_conio_highvideo (void)
DOS conio.h highvideo() equivalent.
__extern void caca_conio_insline (void)
DOS conio.h insline() equivalent.
__extern int caca_conio_kbhit (void)
DOS conio.h kbhit() equivalent.
__extern void caca_conio_lowvideo (void)
DOS conio.h lowvideo() equivalent.
__extern int caca_conio_movetext (int left, int top, int right, int bottom, int destleft, int desttop)
DOS conio.h movetext() equivalent.
__extern void caca_conio_normvideo (void)
DOS conio.h normvideo() equivalent.
__extern void caca_conio_nosound (void)
DOS dos.h nosound() equivalent.
__extern int caca_conio_printf (const char *format,...)
DOS stdio.h printf() equivalent.
__extern int caca_conio_putch (int ch)
DOS conio.h putch() equivalent.
__extern int caca_conio_puttext (int left, int top, int right, int bottom, void *destin)
DOS conio.h puttext() equivalent.
__extern void caca_conio__setcursortype (int cur_t)
DOS conio.h _setcursortype() equivalent.
__extern void caca_conio_sleep (unsigned int)
DOS dos.h sleep() equivalent.
__extern void caca_conio_sound (unsigned int)
DOS dos.h sound() equivalent.
__extern void caca_conio_textattr (int newattr)
DOS conio.h textattr() equivalent.
__extern void caca_conio_textbackground (int newcolor)
DOS conio.h textbackground() equivalent.
__extern void caca_conio_textcolor (int newcolor)
DOS conio.h textcolor() equivalent.
__extern void caca_conio_textmode (int newmode)
DOS conio.h textmode() equivalent.
__extern int caca_conio_ungetch (int ch)
DOS conio.h ungetch() equivalent.
__extern int caca_conio_wherex (void)
DOS conio.h wherex() equivalent.
__extern int caca_conio_wherey (void)
DOS conio.h wherey() equivalent.
__extern void caca_conio_window (int left, int top, int right, int bottom)
DOS conio.h window() equivalent.

Variables

__extern int caca_optind
__extern char * caca_optarg
__extern int caca_conio_directvideo
DOS direct video control.
__extern int caca_conio__wscroll
DOS scrolling control.

Detailed Description

Author:

Sam Hocevar sam@hocevar.net This header contains the public types and functions that applications using libcaca may use.

Macro Definition Documentation

#define CACA_API_VERSION_1

libcaca API version

Typedef Documentation

typedef struct caca_canvas caca_canvas_t

libcaca canvas

typedef struct caca_dither caca_dither_t

dither structure

typedef struct caca_charfont caca_charfont_t

character font structure

typedef struct caca_font caca_font_t

bitmap font structure

typedef struct caca_file caca_file_t

file handle structure

typedef struct caca_display caca_display_t

libcaca display context

typedef struct caca_event caca_event_t

libcaca event structure

Enumeration Type Documentation

enum caca_event_type

This enum serves two purposes:

  • Build listening masks for caca_get_event().
  • Define the type of a caca_event_t.

Enumerator

CACA_EVENT_NONE

No event.

CACA_EVENT_KEY_PRESS

A key was pressed.

CACA_EVENT_KEY_RELEASE

A key was released.

CACA_EVENT_MOUSE_PRESS

A mouse button was pressed.

CACA_EVENT_MOUSE_RELEASE

A mouse button was released.

CACA_EVENT_MOUSE_MOTION

The mouse was moved.

CACA_EVENT_RESIZE

The window was resized.

CACA_EVENT_QUIT

The user requested to quit.

CACA_EVENT_ANY

Bitmask for any event.

enum caca_key

Special key values returned by caca_get_event() for which there is no printable ASCII equivalent.

Enumerator

CACA_KEY_UNKNOWN

Unknown key.

CACA_KEY_CTRL_A

The Ctrl-A key.

CACA_KEY_CTRL_B

The Ctrl-B key.

CACA_KEY_CTRL_C

The Ctrl-C key.

CACA_KEY_CTRL_D

The Ctrl-D key.

CACA_KEY_CTRL_E

The Ctrl-E key.

CACA_KEY_CTRL_F

The Ctrl-F key.

CACA_KEY_CTRL_G

The Ctrl-G key.

CACA_KEY_BACKSPACE

The backspace key.

CACA_KEY_TAB

The tabulation key.

CACA_KEY_CTRL_J

The Ctrl-J key.

CACA_KEY_CTRL_K

The Ctrl-K key.

CACA_KEY_CTRL_L

The Ctrl-L key.

CACA_KEY_RETURN

The return key.

CACA_KEY_CTRL_N

The Ctrl-N key.

CACA_KEY_CTRL_O

The Ctrl-O key.

CACA_KEY_CTRL_P

The Ctrl-P key.

CACA_KEY_CTRL_Q

The Ctrl-Q key.

CACA_KEY_CTRL_R

The Ctrl-R key.

CACA_KEY_PAUSE

The pause key.

CACA_KEY_CTRL_T

The Ctrl-T key.

CACA_KEY_CTRL_U

The Ctrl-U key.

CACA_KEY_CTRL_V

The Ctrl-V key.

CACA_KEY_CTRL_W

The Ctrl-W key.

CACA_KEY_CTRL_X

The Ctrl-X key.

CACA_KEY_CTRL_Y

The Ctrl-Y key.

CACA_KEY_CTRL_Z

The Ctrl-Z key.

CACA_KEY_ESCAPE

The escape key.

CACA_KEY_DELETE

The delete key.

CACA_KEY_UP

The up arrow key.

CACA_KEY_DOWN

The down arrow key.

CACA_KEY_LEFT

The left arrow key.

CACA_KEY_RIGHT

The right arrow key.

CACA_KEY_INSERT

The insert key.

CACA_KEY_HOME

The home key.

CACA_KEY_END

The end key.

CACA_KEY_PAGEUP

The page up key.

CACA_KEY_PAGEDOWN

The page down key.

CACA_KEY_F1

The F1 key.

CACA_KEY_F2

The F2 key.

CACA_KEY_F3

The F3 key.

CACA_KEY_F4

The F4 key.

CACA_KEY_F5

The F5 key.

CACA_KEY_F6

The F6 key.

CACA_KEY_F7

The F7 key.

CACA_KEY_F8

The F8 key.

CACA_KEY_F9

The F9 key.

CACA_KEY_F10

The F10 key.

CACA_KEY_F11

The F11 key.

CACA_KEY_F12

The F12 key.

CACA_KEY_F13

The F13 key.

CACA_KEY_F14

The F14 key.

CACA_KEY_F15

The F15 key.

enum CACA_CONIO_COLORS

This enum lists the colour values for the DOS conio.h compatibility layer.

enum CACA_CONIO_CURSOR

This enum lists the cursor mode values for the DOS conio.h compatibility layer.

enum CACA_CONIO_MODE

This enum lists the video mode values for the DOS conio.h compatibility layer.

Author

Generated automatically by Doxygen for libcaca from the source code.

Referenced By

The man pages CACA_API_VERSION_1.3caca(3), caca_canvas_set_figfont.3caca(3), caca_canvas_t.3caca(3), caca_charfont_t.3caca(3), caca_conio_cgets.3caca(3), caca_conio_clreol.3caca(3), caca_conio_clrscr.3caca(3), CACA_CONIO_COLORS.3caca(3), caca_conio_cprintf.3caca(3), caca_conio_cputs.3caca(3), caca_conio_cscanf.3caca(3), CACA_CONIO_CURSOR.3caca(3), caca_conio_delay.3caca(3), caca_conio_delline.3caca(3), caca_conio_directvideo.3caca(3), caca_conio_getch.3caca(3), caca_conio_getche.3caca(3), caca_conio_getpass.3caca(3), caca_conio_gettext.3caca(3), caca_conio_gettextinfo.3caca(3), caca_conio_gotoxy.3caca(3), caca_conio_highvideo.3caca(3), caca_conio_insline.3caca(3), caca_conio_kbhit.3caca(3), caca_conio_lowvideo.3caca(3), CACA_CONIO_MODE.3caca(3), caca_conio_movetext.3caca(3), caca_conio_normvideo.3caca(3), caca_conio_nosound.3caca(3), caca_conio_printf.3caca(3), caca_conio_putch.3caca(3), caca_conio_puttext.3caca(3), caca_conio__setcursortype.3caca(3), caca_conio_sleep.3caca(3), caca_conio_sound.3caca(3), caca_conio_textattr.3caca(3), caca_conio_textbackground.3caca(3), caca_conio_textcolor.3caca(3), caca_conio_textmode.3caca(3), caca_conio_ungetch.3caca(3), caca_conio_wherex.3caca(3), caca_conio_wherey.3caca(3), caca_conio_window.3caca(3), caca_conio__wscroll.3caca(3), caca_display_t.3caca(3), caca_dither_t.3caca(3), CACA_EVENT_ANY.3caca(3), CACA_EVENT_KEY_PRESS.3caca(3), CACA_EVENT_KEY_RELEASE.3caca(3), CACA_EVENT_MOUSE_MOTION.3caca(3), CACA_EVENT_MOUSE_PRESS.3caca(3), CACA_EVENT_MOUSE_RELEASE.3caca(3), CACA_EVENT_NONE.3caca(3), CACA_EVENT_QUIT.3caca(3), CACA_EVENT_RESIZE.3caca(3), caca_event_t.3caca(3), caca_event_type.3caca(3), caca_file_t.3caca(3), caca_flush_figlet.3caca(3), caca_font_t.3caca(3), caca_free_charfont.3caca(3), caca_getopt.3caca(3), caca_key.3caca(3), CACA_KEY_BACKSPACE.3caca(3), CACA_KEY_CTRL_A.3caca(3), CACA_KEY_CTRL_B.3caca(3), CACA_KEY_CTRL_C.3caca(3), CACA_KEY_CTRL_D.3caca(3), CACA_KEY_CTRL_E.3caca(3), CACA_KEY_CTRL_F.3caca(3), CACA_KEY_CTRL_G.3caca(3), CACA_KEY_CTRL_J.3caca(3), CACA_KEY_CTRL_K.3caca(3), CACA_KEY_CTRL_L.3caca(3), CACA_KEY_CTRL_N.3caca(3), CACA_KEY_CTRL_O.3caca(3), CACA_KEY_CTRL_P.3caca(3), CACA_KEY_CTRL_Q.3caca(3), CACA_KEY_CTRL_R.3caca(3), CACA_KEY_CTRL_T.3caca(3), CACA_KEY_CTRL_U.3caca(3), CACA_KEY_CTRL_V.3caca(3), CACA_KEY_CTRL_W.3caca(3), CACA_KEY_CTRL_X.3caca(3), CACA_KEY_CTRL_Y.3caca(3), CACA_KEY_CTRL_Z.3caca(3), CACA_KEY_DELETE.3caca(3), CACA_KEY_DOWN.3caca(3), CACA_KEY_END.3caca(3), CACA_KEY_ESCAPE.3caca(3), CACA_KEY_F10.3caca(3), CACA_KEY_F11.3caca(3), CACA_KEY_F12.3caca(3), CACA_KEY_F13.3caca(3), CACA_KEY_F1.3caca(3), CACA_KEY_F14.3caca(3), CACA_KEY_F15.3caca(3), CACA_KEY_F2.3caca(3), CACA_KEY_F3.3caca(3), CACA_KEY_F4.3caca(3), CACA_KEY_F5.3caca(3), CACA_KEY_F6.3caca(3), CACA_KEY_F7.3caca(3), CACA_KEY_F8.3caca(3), CACA_KEY_F9.3caca(3), CACA_KEY_HOME.3caca(3), CACA_KEY_INSERT.3caca(3), CACA_KEY_LEFT.3caca(3), CACA_KEY_PAGEDOWN.3caca(3), CACA_KEY_PAGEUP.3caca(3), CACA_KEY_PAUSE.3caca(3), CACA_KEY_RETURN.3caca(3), CACA_KEY_RIGHT.3caca(3), CACA_KEY_TAB.3caca(3), CACA_KEY_UNKNOWN.3caca(3), CACA_KEY_UP.3caca(3), caca_load_charfont.3caca(3), caca_optarg.3caca(3), caca_optind.3caca(3), caca_put_figchar.3caca(3), caca_rand.3caca(3), caca_set_figfont_smush.3caca(3) and caca_set_figfont_width.3caca(3) are aliases of caca.h.3caca(3).

Sat Feb 11 2017 Version 0.99.beta19 libcaca