Nevar pievienot vairāk kā 25 tēmas Tēmai ir jāsākas ar burtu vai ciparu, tā var saturēt domu zīmes ('-') un var būt līdz 35 simboliem gara.
 
 
 
 
 
 

729 rindas
32 KiB

  1. /*
  2. * libcaca Colour ASCII-Art library
  3. * Copyright (c) 2002-2009 Sam Hocevar <sam@hocevar.net>
  4. * All Rights Reserved
  5. *
  6. * $Id$
  7. *
  8. * This library is free software. It comes without any warranty, to
  9. * the extent permitted by applicable law. You can redistribute it
  10. * and/or modify it under the terms of the Do What The Fuck You Want
  11. * To Public License, Version 2, as published by Sam Hocevar. See
  12. * http://sam.zoy.org/wtfpl/COPYING for more details.
  13. */
  14. /** \file caca.h
  15. * \version \$Id$
  16. * \author Sam Hocevar <sam@hocevar.net>
  17. * \brief The \e libcaca public header.
  18. *
  19. * This header contains the public types and functions that applications
  20. * using \e libcaca may use.
  21. */
  22. #ifndef __CACA_H__
  23. #define __CACA_H__
  24. #include <caca_types.h>
  25. #if !defined(__KERNEL__)
  26. # include <stdarg.h>
  27. #endif
  28. #undef __extern
  29. #if defined(_DOXYGEN_SKIP_ME)
  30. #elif defined(_WIN32) && defined(__LIBCACA__)
  31. # define __extern extern __declspec(dllexport)
  32. #else
  33. # define __extern extern
  34. #endif
  35. /** libcaca API version */
  36. #define CACA_API_VERSION_1
  37. #ifdef __cplusplus
  38. extern "C"
  39. {
  40. #endif
  41. /** \e libcaca canvas */
  42. typedef struct caca_canvas caca_canvas_t;
  43. /** dither structure */
  44. typedef struct caca_dither caca_dither_t;
  45. /** font structure */
  46. typedef struct caca_font caca_font_t;
  47. /** file handle structure */
  48. typedef struct caca_file caca_file_t;
  49. /** \e libcaca display context */
  50. typedef struct caca_display caca_display_t;
  51. /** \e libcaca event structure */
  52. typedef struct caca_event caca_event_t;
  53. /** \defgroup caca_attr libcaca attribute definitions
  54. *
  55. * Colours and styles that can be used with caca_set_attr().
  56. *
  57. * @{ */
  58. #define CACA_BLACK 0x00 /**< The colour index for black. */
  59. #define CACA_BLUE 0x01 /**< The colour index for blue. */
  60. #define CACA_GREEN 0x02 /**< The colour index for green. */
  61. #define CACA_CYAN 0x03 /**< The colour index for cyan. */
  62. #define CACA_RED 0x04 /**< The colour index for red. */
  63. #define CACA_MAGENTA 0x05 /**< The colour index for magenta. */
  64. #define CACA_BROWN 0x06 /**< The colour index for brown. */
  65. #define CACA_LIGHTGRAY 0x07 /**< The colour index for light gray. */
  66. #define CACA_DARKGRAY 0x08 /**< The colour index for dark gray. */
  67. #define CACA_LIGHTBLUE 0x09 /**< The colour index for blue. */
  68. #define CACA_LIGHTGREEN 0x0a /**< The colour index for light green. */
  69. #define CACA_LIGHTCYAN 0x0b /**< The colour index for light cyan. */
  70. #define CACA_LIGHTRED 0x0c /**< The colour index for light red. */
  71. #define CACA_LIGHTMAGENTA 0x0d /**< The colour index for light magenta. */
  72. #define CACA_YELLOW 0x0e /**< The colour index for yellow. */
  73. #define CACA_WHITE 0x0f /**< The colour index for white. */
  74. #define CACA_DEFAULT 0x10 /**< The output driver's default colour. */
  75. #define CACA_TRANSPARENT 0x20 /**< The transparent colour. */
  76. #define CACA_BOLD 0x01 /**< The style mask for bold. */
  77. #define CACA_ITALICS 0x02 /**< The style mask for italics. */
  78. #define CACA_UNDERLINE 0x04 /**< The style mask for underline. */
  79. #define CACA_BLINK 0x08 /**< The style mask for blink. */
  80. /* @} */
  81. /** \brief User event type enumeration.
  82. *
  83. * This enum serves two purposes:
  84. * - Build listening masks for caca_get_event().
  85. * - Define the type of a \e caca_event_t.
  86. */
  87. enum caca_event_type
  88. {
  89. CACA_EVENT_NONE = 0x0000, /**< No event. */
  90. CACA_EVENT_KEY_PRESS = 0x0001, /**< A key was pressed. */
  91. CACA_EVENT_KEY_RELEASE = 0x0002, /**< A key was released. */
  92. CACA_EVENT_MOUSE_PRESS = 0x0004, /**< A mouse button was pressed. */
  93. CACA_EVENT_MOUSE_RELEASE = 0x0008, /**< A mouse button was released. */
  94. CACA_EVENT_MOUSE_MOTION = 0x0010, /**< The mouse was moved. */
  95. CACA_EVENT_RESIZE = 0x0020, /**< The window was resized. */
  96. CACA_EVENT_QUIT = 0x0040, /**< The user requested to quit. */
  97. CACA_EVENT_ANY = 0xffff /**< Bitmask for any event. */
  98. };
  99. /** \brief Handling of user events.
  100. *
  101. * This structure is filled by caca_get_event() when an event is received.
  102. * It is an opaque structure that should only be accessed through
  103. * caca_event_get_type() and similar functions. The struct members may no
  104. * longer be directly accessible in future versions.
  105. */
  106. struct caca_event
  107. {
  108. enum caca_event_type type;
  109. union
  110. {
  111. struct { int x, y, button; } mouse;
  112. struct { int w, h; } resize;
  113. struct { int ch; uint32_t utf32; char utf8[8]; } key;
  114. } data;
  115. uint8_t padding[16];
  116. };
  117. /** \brief Special key values.
  118. *
  119. * Special key values returned by caca_get_event() for which there is no
  120. * printable ASCII equivalent.
  121. */
  122. enum caca_key
  123. {
  124. CACA_KEY_UNKNOWN = 0x00, /**< Unknown key. */
  125. /* The following keys have ASCII equivalents */
  126. CACA_KEY_CTRL_A = 0x01, /**< The Ctrl-A key. */
  127. CACA_KEY_CTRL_B = 0x02, /**< The Ctrl-B key. */
  128. CACA_KEY_CTRL_C = 0x03, /**< The Ctrl-C key. */
  129. CACA_KEY_CTRL_D = 0x04, /**< The Ctrl-D key. */
  130. CACA_KEY_CTRL_E = 0x05, /**< The Ctrl-E key. */
  131. CACA_KEY_CTRL_F = 0x06, /**< The Ctrl-F key. */
  132. CACA_KEY_CTRL_G = 0x07, /**< The Ctrl-G key. */
  133. CACA_KEY_BACKSPACE = 0x08, /**< The backspace key. */
  134. CACA_KEY_TAB = 0x09, /**< The tabulation key. */
  135. CACA_KEY_CTRL_J = 0x0a, /**< The Ctrl-J key. */
  136. CACA_KEY_CTRL_K = 0x0b, /**< The Ctrl-K key. */
  137. CACA_KEY_CTRL_L = 0x0c, /**< The Ctrl-L key. */
  138. CACA_KEY_RETURN = 0x0d, /**< The return key. */
  139. CACA_KEY_CTRL_N = 0x0e, /**< The Ctrl-N key. */
  140. CACA_KEY_CTRL_O = 0x0f, /**< The Ctrl-O key. */
  141. CACA_KEY_CTRL_P = 0x10, /**< The Ctrl-P key. */
  142. CACA_KEY_CTRL_Q = 0x11, /**< The Ctrl-Q key. */
  143. CACA_KEY_CTRL_R = 0x12, /**< The Ctrl-R key. */
  144. CACA_KEY_PAUSE = 0x13, /**< The pause key. */
  145. CACA_KEY_CTRL_T = 0x14, /**< The Ctrl-T key. */
  146. CACA_KEY_CTRL_U = 0x15, /**< The Ctrl-U key. */
  147. CACA_KEY_CTRL_V = 0x16, /**< The Ctrl-V key. */
  148. CACA_KEY_CTRL_W = 0x17, /**< The Ctrl-W key. */
  149. CACA_KEY_CTRL_X = 0x18, /**< The Ctrl-X key. */
  150. CACA_KEY_CTRL_Y = 0x19, /**< The Ctrl-Y key. */
  151. CACA_KEY_CTRL_Z = 0x1a, /**< The Ctrl-Z key. */
  152. CACA_KEY_ESCAPE = 0x1b, /**< The escape key. */
  153. CACA_KEY_DELETE = 0x7f, /**< The delete key. */
  154. /* The following keys do not have ASCII equivalents but have been
  155. * chosen to match the SDL equivalents */
  156. CACA_KEY_UP = 0x111, /**< The up arrow key. */
  157. CACA_KEY_DOWN = 0x112, /**< The down arrow key. */
  158. CACA_KEY_LEFT = 0x113, /**< The left arrow key. */
  159. CACA_KEY_RIGHT = 0x114, /**< The right arrow key. */
  160. CACA_KEY_INSERT = 0x115, /**< The insert key. */
  161. CACA_KEY_HOME = 0x116, /**< The home key. */
  162. CACA_KEY_END = 0x117, /**< The end key. */
  163. CACA_KEY_PAGEUP = 0x118, /**< The page up key. */
  164. CACA_KEY_PAGEDOWN = 0x119, /**< The page down key. */
  165. CACA_KEY_F1 = 0x11a, /**< The F1 key. */
  166. CACA_KEY_F2 = 0x11b, /**< The F2 key. */
  167. CACA_KEY_F3 = 0x11c, /**< The F3 key. */
  168. CACA_KEY_F4 = 0x11d, /**< The F4 key. */
  169. CACA_KEY_F5 = 0x11e, /**< The F5 key. */
  170. CACA_KEY_F6 = 0x11f, /**< The F6 key. */
  171. CACA_KEY_F7 = 0x120, /**< The F7 key. */
  172. CACA_KEY_F8 = 0x121, /**< The F8 key. */
  173. CACA_KEY_F9 = 0x122, /**< The F9 key. */
  174. CACA_KEY_F10 = 0x123, /**< The F10 key. */
  175. CACA_KEY_F11 = 0x124, /**< The F11 key. */
  176. CACA_KEY_F12 = 0x125, /**< The F12 key. */
  177. CACA_KEY_F13 = 0x126, /**< The F13 key. */
  178. CACA_KEY_F14 = 0x127, /**< The F14 key. */
  179. CACA_KEY_F15 = 0x128 /**< The F15 key. */
  180. };
  181. /** \defgroup libcaca libcaca basic functions
  182. *
  183. * These functions provide the basic \e libcaca routines for library
  184. * initialisation, system information retrieval and configuration.
  185. *
  186. * @{ */
  187. __extern caca_canvas_t * caca_create_canvas(int, int);
  188. __extern int caca_manage_canvas(caca_canvas_t *, int (*)(void *), void *);
  189. __extern int caca_unmanage_canvas(caca_canvas_t *, int (*)(void *), void *);
  190. __extern int caca_set_canvas_size(caca_canvas_t *, int, int);
  191. __extern int caca_get_canvas_width(caca_canvas_t const *);
  192. __extern int caca_get_canvas_height(caca_canvas_t const *);
  193. __extern uint8_t const * caca_get_canvas_chars(caca_canvas_t const *);
  194. __extern uint8_t const * caca_get_canvas_attrs(caca_canvas_t const *);
  195. __extern int caca_free_canvas(caca_canvas_t *);
  196. __extern int caca_rand(int, int);
  197. __extern char const * caca_get_version(void);
  198. /* @} */
  199. /** \defgroup caca_canvas libcaca canvas drawing
  200. *
  201. * These functions provide low-level character printing routines and
  202. * higher level graphics functions.
  203. *
  204. * @{ */
  205. #define CACA_MAGIC_FULLWIDTH 0x000ffffe /**< Used to indicate that the previous character was a fullwidth glyph. */
  206. __extern int caca_gotoxy(caca_canvas_t *, int, int);
  207. __extern int caca_get_cursor_x(caca_canvas_t const *);
  208. __extern int caca_get_cursor_y(caca_canvas_t const *);
  209. __extern int caca_put_char(caca_canvas_t *, int, int, uint32_t);
  210. __extern uint32_t caca_get_char(caca_canvas_t const *, int, int);
  211. __extern int caca_put_str(caca_canvas_t *, int, int, char const *);
  212. __extern int caca_printf(caca_canvas_t *, int, int, char const *, ...);
  213. __extern int caca_vprintf(caca_canvas_t *, int, int, char const *, va_list);
  214. __extern int caca_clear_canvas(caca_canvas_t *);
  215. __extern int caca_set_canvas_handle(caca_canvas_t *, int, int);
  216. __extern int caca_get_canvas_handle_x(caca_canvas_t const *);
  217. __extern int caca_get_canvas_handle_y(caca_canvas_t const *);
  218. __extern int caca_blit(caca_canvas_t *, int, int, caca_canvas_t const *,
  219. caca_canvas_t const *);
  220. __extern int caca_set_canvas_boundaries(caca_canvas_t *, int, int, int, int);
  221. /* @} */
  222. /** \defgroup caca_dirty libcaca dirty rectangle manipulation
  223. *
  224. * These functions manipulate dirty rectangles for optimised blitting.
  225. * @{ */
  226. __extern int caca_disable_dirty_rect(caca_canvas_t *);
  227. __extern int caca_enable_dirty_rect(caca_canvas_t *);
  228. __extern int caca_get_dirty_rect_count(caca_canvas_t *);
  229. __extern int caca_get_dirty_rect(caca_canvas_t *, int, int *, int *,
  230. int *, int *);
  231. __extern int caca_add_dirty_rect(caca_canvas_t *, int, int, int, int);
  232. __extern int caca_remove_dirty_rect(caca_canvas_t *, int, int, int, int);
  233. __extern int caca_clear_dirty_rect_list(caca_canvas_t *);
  234. /* @} */
  235. /** \defgroup caca_transform libcaca canvas transformation
  236. *
  237. * These functions perform horizontal and vertical canvas flipping.
  238. *
  239. * @{ */
  240. __extern int caca_invert(caca_canvas_t *);
  241. __extern int caca_flip(caca_canvas_t *);
  242. __extern int caca_flop(caca_canvas_t *);
  243. __extern int caca_rotate_180(caca_canvas_t *);
  244. __extern int caca_rotate_left(caca_canvas_t *);
  245. __extern int caca_rotate_right(caca_canvas_t *);
  246. __extern int caca_stretch_left(caca_canvas_t *);
  247. __extern int caca_stretch_right(caca_canvas_t *);
  248. /* @} */
  249. /** \defgroup caca_attributes libcaca attribute conversions
  250. *
  251. * These functions perform conversions between attribute values.
  252. *
  253. * @{ */
  254. __extern uint32_t caca_get_attr(caca_canvas_t const *, int, int);
  255. __extern int caca_set_attr(caca_canvas_t *, uint32_t);
  256. __extern int caca_put_attr(caca_canvas_t *, int, int, uint32_t);
  257. __extern int caca_set_color_ansi(caca_canvas_t *, uint8_t, uint8_t);
  258. __extern int caca_set_color_argb(caca_canvas_t *, uint16_t, uint16_t);
  259. __extern uint8_t caca_attr_to_ansi(uint32_t);
  260. __extern uint8_t caca_attr_to_ansi_fg(uint32_t);
  261. __extern uint8_t caca_attr_to_ansi_bg(uint32_t);
  262. __extern uint16_t caca_attr_to_rgb12_fg(uint32_t);
  263. __extern uint16_t caca_attr_to_rgb12_bg(uint32_t);
  264. __extern void caca_attr_to_argb64(uint32_t, uint8_t[8]);
  265. /* @} */
  266. /** \defgroup caca_charset libcaca character set conversions
  267. *
  268. * These functions perform conversions between usual character sets.
  269. *
  270. * @{ */
  271. __extern uint32_t caca_utf8_to_utf32(char const *, size_t *);
  272. __extern size_t caca_utf32_to_utf8(char *, uint32_t);
  273. __extern uint8_t caca_utf32_to_cp437(uint32_t);
  274. __extern uint32_t caca_cp437_to_utf32(uint8_t);
  275. __extern char caca_utf32_to_ascii(uint32_t);
  276. __extern int caca_utf32_is_fullwidth(uint32_t);
  277. /* @} */
  278. /** \defgroup caca_primitives libcaca primitives drawing
  279. *
  280. * These functions provide routines for primitive drawing, such as lines,
  281. * boxes, triangles and ellipses.
  282. *
  283. * @{ */
  284. __extern int caca_draw_line(caca_canvas_t *, int, int, int, int, uint32_t);
  285. __extern int caca_draw_polyline(caca_canvas_t *, int const x[],
  286. int const y[], int, uint32_t);
  287. __extern int caca_draw_thin_line(caca_canvas_t *, int, int, int, int);
  288. __extern int caca_draw_thin_polyline(caca_canvas_t *, int const x[],
  289. int const y[], int);
  290. __extern int caca_draw_circle(caca_canvas_t *, int, int, int, uint32_t);
  291. __extern int caca_draw_ellipse(caca_canvas_t *, int, int, int, int, uint32_t);
  292. __extern int caca_draw_thin_ellipse(caca_canvas_t *, int, int, int, int);
  293. __extern int caca_fill_ellipse(caca_canvas_t *, int, int, int, int, uint32_t);
  294. __extern int caca_draw_box(caca_canvas_t *, int, int, int, int, uint32_t);
  295. __extern int caca_draw_thin_box(caca_canvas_t *, int, int, int, int);
  296. __extern int caca_draw_cp437_box(caca_canvas_t *, int, int, int, int);
  297. __extern int caca_fill_box(caca_canvas_t *, int, int, int, int, uint32_t);
  298. __extern int caca_draw_triangle(caca_canvas_t *, int, int, int, int, int,
  299. int, uint32_t);
  300. __extern int caca_draw_thin_triangle(caca_canvas_t *, int, int, int, int,
  301. int, int);
  302. __extern int caca_fill_triangle(caca_canvas_t *, int, int, int, int, int,
  303. int, uint32_t);
  304. /* @} */
  305. /** \defgroup caca_frame libcaca canvas frame handling
  306. *
  307. * These functions provide high level routines for canvas frame insertion,
  308. * removal, copying etc.
  309. *
  310. * @{ */
  311. __extern int caca_get_frame_count(caca_canvas_t const *);
  312. __extern int caca_set_frame(caca_canvas_t *, int);
  313. __extern char const *caca_get_frame_name(caca_canvas_t const *);
  314. __extern int caca_set_frame_name(caca_canvas_t *, char const *);
  315. __extern int caca_create_frame(caca_canvas_t *, int);
  316. __extern int caca_free_frame(caca_canvas_t *, int);
  317. /* @} */
  318. /** \defgroup caca_dither libcaca bitmap dithering
  319. *
  320. * These functions provide high level routines for dither allocation and
  321. * rendering.
  322. *
  323. * @{ */
  324. __extern caca_dither_t *caca_create_dither(int, int, int, int,
  325. uint32_t, uint32_t,
  326. uint32_t, uint32_t);
  327. __extern int caca_set_dither_palette(caca_dither_t *,
  328. uint32_t r[], uint32_t g[],
  329. uint32_t b[], uint32_t a[]);
  330. __extern int caca_set_dither_brightness(caca_dither_t *, float);
  331. __extern float caca_get_dither_brightness(caca_dither_t const *);
  332. __extern int caca_set_dither_gamma(caca_dither_t *, float);
  333. __extern float caca_get_dither_gamma(caca_dither_t const *);
  334. __extern int caca_set_dither_contrast(caca_dither_t *, float);
  335. __extern float caca_get_dither_contrast(caca_dither_t const *);
  336. __extern int caca_set_dither_antialias(caca_dither_t *, char const *);
  337. __extern char const * const * caca_get_dither_antialias_list(caca_dither_t
  338. const *);
  339. __extern char const * caca_get_dither_antialias(caca_dither_t const *);
  340. __extern int caca_set_dither_color(caca_dither_t *, char const *);
  341. __extern char const * const * caca_get_dither_color_list(caca_dither_t
  342. const *);
  343. __extern char const * caca_get_dither_color(caca_dither_t const *);
  344. __extern int caca_set_dither_charset(caca_dither_t *, char const *);
  345. __extern char const * const * caca_get_dither_charset_list(caca_dither_t
  346. const *);
  347. __extern char const * caca_get_dither_charset(caca_dither_t const *);
  348. __extern int caca_set_dither_algorithm(caca_dither_t *, char const *);
  349. __extern char const * const * caca_get_dither_algorithm_list(caca_dither_t
  350. const *);
  351. __extern char const * caca_get_dither_algorithm(caca_dither_t const *);
  352. __extern int caca_dither_bitmap(caca_canvas_t *, int, int, int, int,
  353. caca_dither_t const *, void *);
  354. __extern int caca_free_dither(caca_dither_t *);
  355. /* @} */
  356. /** \defgroup caca_font libcaca font handling
  357. *
  358. * These functions provide font handling routines and high quality
  359. * canvas to bitmap rendering.
  360. *
  361. * @{ */
  362. __extern caca_font_t *caca_load_font(void const *, size_t);
  363. __extern char const * const * caca_get_font_list(void);
  364. __extern int caca_get_font_width(caca_font_t const *);
  365. __extern int caca_get_font_height(caca_font_t const *);
  366. __extern uint32_t const *caca_get_font_blocks(caca_font_t const *);
  367. __extern int caca_render_canvas(caca_canvas_t const *, caca_font_t const *,
  368. void *, int, int, int);
  369. __extern int caca_free_font(caca_font_t *);
  370. /* @} */
  371. /** \defgroup caca_figfont libcaca FIGfont handling
  372. *
  373. * These functions provide FIGlet and TOIlet font handling routines.
  374. *
  375. * @{ */
  376. __extern int caca_canvas_set_figfont(caca_canvas_t *, char const *);
  377. __extern int caca_put_figchar(caca_canvas_t *, uint32_t);
  378. __extern int caca_flush_figlet(caca_canvas_t *);
  379. /* @} */
  380. /** \defgroup caca_file libcaca file IO
  381. *
  382. * These functions allow to read and write files in a platform-independent
  383. * way.
  384. * @{ */
  385. __extern caca_file_t *caca_file_open(char const *, const char *);
  386. __extern int caca_file_close(caca_file_t *);
  387. __extern uint64_t caca_file_tell(caca_file_t *);
  388. __extern size_t caca_file_read(caca_file_t *, void *, size_t);
  389. __extern size_t caca_file_write(caca_file_t *, const void *, size_t);
  390. __extern char * caca_file_gets(caca_file_t *, char *, int);
  391. __extern int caca_file_eof(caca_file_t *);
  392. /* @} */
  393. /** \defgroup caca_importexport libcaca importers/exporters from/to various
  394. * formats
  395. *
  396. * These functions import various file formats into a new canvas, or export
  397. * the current canvas to various text formats.
  398. *
  399. * @{ */
  400. __extern ssize_t caca_import_canvas_from_memory(caca_canvas_t *, void const *,
  401. size_t, char const *);
  402. __extern ssize_t caca_import_canvas_from_file(caca_canvas_t *, char const *,
  403. char const *);
  404. __extern ssize_t caca_import_area_from_memory(caca_canvas_t *, int, int,
  405. void const *, size_t,
  406. char const *);
  407. __extern ssize_t caca_import_area_from_file(caca_canvas_t *, int, int,
  408. char const *, char const *);
  409. __extern char const * const * caca_get_import_list(void);
  410. __extern void *caca_export_canvas_to_memory(caca_canvas_t const *,
  411. char const *, size_t *);
  412. __extern void *caca_export_area_to_memory(caca_canvas_t const *, int, int,
  413. int, int, char const *, size_t *);
  414. __extern char const * const * caca_get_export_list(void);
  415. /* @} */
  416. /** \defgroup caca_display libcaca display functions
  417. *
  418. * These functions provide the basic \e libcaca routines for display
  419. * initialisation, system information retrieval and configuration.
  420. *
  421. * @{ */
  422. __extern caca_display_t * caca_create_display(caca_canvas_t *);
  423. __extern caca_display_t * caca_create_display_with_driver(caca_canvas_t *,
  424. char const *);
  425. __extern char const * const * caca_get_display_driver_list(void);
  426. __extern char const * caca_get_display_driver(caca_display_t *);
  427. __extern int caca_set_display_driver(caca_display_t *, char const *);
  428. __extern int caca_free_display(caca_display_t *);
  429. __extern caca_canvas_t * caca_get_canvas(caca_display_t *);
  430. __extern int caca_refresh_display(caca_display_t *);
  431. __extern int caca_set_display_time(caca_display_t *, int);
  432. __extern int caca_get_display_time(caca_display_t const *);
  433. __extern int caca_get_display_width(caca_display_t const *);
  434. __extern int caca_get_display_height(caca_display_t const *);
  435. __extern int caca_set_display_title(caca_display_t *, char const *);
  436. __extern int caca_set_mouse(caca_display_t *, int);
  437. __extern int caca_set_cursor(caca_display_t *, int);
  438. /* @} */
  439. /** \defgroup caca_event libcaca event handling
  440. *
  441. * These functions handle user events such as keyboard input and mouse
  442. * clicks.
  443. *
  444. * @{ */
  445. __extern int caca_get_event(caca_display_t *, int, caca_event_t *, int);
  446. __extern int caca_get_mouse_x(caca_display_t const *);
  447. __extern int caca_get_mouse_y(caca_display_t const *);
  448. __extern enum caca_event_type caca_get_event_type(caca_event_t const *);
  449. __extern int caca_get_event_key_ch(caca_event_t const *);
  450. __extern uint32_t caca_get_event_key_utf32(caca_event_t const *);
  451. __extern int caca_get_event_key_utf8(caca_event_t const *, char *);
  452. __extern int caca_get_event_mouse_button(caca_event_t const *);
  453. __extern int caca_get_event_mouse_x(caca_event_t const *);
  454. __extern int caca_get_event_mouse_y(caca_event_t const *);
  455. __extern int caca_get_event_resize_width(caca_event_t const *);
  456. __extern int caca_get_event_resize_height(caca_event_t const *);
  457. /* @} */
  458. #if !defined(_DOXYGEN_SKIP_ME)
  459. /* Legacy stuff from beta versions, will probably disappear in 1.0 */
  460. typedef struct cucul_buffer cucul_buffer_t;
  461. # if defined __GNUC__ && __GNUC__ >= 3
  462. # define CACA_DEPRECATED __attribute__ ((__deprecated__))
  463. # define CACA_ALIAS(x) __attribute__ ((weak, alias(#x)))
  464. # else
  465. # define CACA_DEPRECATED
  466. # define CACA_ALIAS(x)
  467. # endif
  468. /* Aliases from old libcucul functions */
  469. __extern int cucul_putchar(caca_canvas_t *, int, int,
  470. unsigned long int) CACA_DEPRECATED;
  471. __extern unsigned long int cucul_getchar(caca_canvas_t *,
  472. int, int) CACA_DEPRECATED;
  473. __extern int cucul_putstr(caca_canvas_t *, int, int,
  474. char const *) CACA_DEPRECATED;
  475. __extern int cucul_set_color(caca_canvas_t *, unsigned char,
  476. unsigned char) CACA_DEPRECATED;
  477. __extern int cucul_set_truecolor(caca_canvas_t *, unsigned int,
  478. unsigned int) CACA_DEPRECATED;
  479. __extern unsigned int cucul_get_canvas_frame_count(caca_canvas_t *)
  480. CACA_DEPRECATED;
  481. __extern int cucul_set_canvas_frame(caca_canvas_t *,
  482. unsigned int) CACA_DEPRECATED;
  483. __extern int cucul_create_canvas_frame(caca_canvas_t *,
  484. unsigned int) CACA_DEPRECATED;
  485. __extern int cucul_free_canvas_frame(caca_canvas_t *,
  486. unsigned int) CACA_DEPRECATED;
  487. __extern cucul_buffer_t *cucul_load_memory(void *,
  488. unsigned long int) CACA_DEPRECATED;
  489. __extern cucul_buffer_t *cucul_load_file(char const *) CACA_DEPRECATED;
  490. __extern unsigned long int cucul_get_buffer_size(cucul_buffer_t *)
  491. CACA_DEPRECATED;
  492. __extern void * cucul_get_buffer_data(cucul_buffer_t *) CACA_DEPRECATED;
  493. __extern int cucul_free_buffer(cucul_buffer_t *) CACA_DEPRECATED;
  494. __extern cucul_buffer_t * cucul_export_canvas(caca_canvas_t *,
  495. char const *) CACA_DEPRECATED;
  496. __extern caca_canvas_t * cucul_import_canvas(cucul_buffer_t *,
  497. char const *) CACA_DEPRECATED;
  498. __extern ssize_t caca_import_memory(caca_canvas_t *, void const *, size_t,
  499. char const *) CACA_DEPRECATED;
  500. __extern ssize_t caca_import_file(caca_canvas_t *, char const *,
  501. char const *) CACA_DEPRECATED;
  502. __extern void *caca_export_memory(caca_canvas_t const *, char const *,
  503. size_t *) CACA_DEPRECATED;
  504. __extern int cucul_rotate(caca_canvas_t *) CACA_DEPRECATED;
  505. __extern int cucul_set_dither_invert(caca_dither_t *, int) CACA_DEPRECATED;
  506. __extern int cucul_set_dither_mode(caca_dither_t *,
  507. char const *) CACA_DEPRECATED;
  508. __extern char const * const * cucul_get_dither_mode_list(caca_dither_t const *)
  509. CACA_DEPRECATED;
  510. # define CUCUL_COLOR_BLACK CACA_BLACK
  511. # define CUCUL_COLOR_BLUE CACA_BLUE
  512. # define CUCUL_COLOR_GREEN CACA_GREEN
  513. # define CUCUL_COLOR_CYAN CACA_CYAN
  514. # define CUCUL_COLOR_RED CACA_RED
  515. # define CUCUL_COLOR_MAGENTA CACA_MAGENTA
  516. # define CUCUL_COLOR_BROWN CACA_BROWN
  517. # define CUCUL_COLOR_LIGHTGRAY CACA_LIGHTGRAY
  518. # define CUCUL_COLOR_DARKGRAY CACA_DARKGRAY
  519. # define CUCUL_COLOR_LIGHTBLUE CACA_LIGHTBLUE
  520. # define CUCUL_COLOR_LIGHTGREEN CACA_LIGHTGREEN
  521. # define CUCUL_COLOR_LIGHTCYAN CACA_LIGHTCYAN
  522. # define CUCUL_COLOR_LIGHTRED CACA_LIGHTRED
  523. # define CUCUL_COLOR_LIGHTMAGENTA CACA_LIGHTMAGENTA
  524. # define CUCUL_COLOR_YELLOW CACA_YELLOW
  525. # define CUCUL_COLOR_WHITE CACA_YELLOW
  526. # define CUCUL_COLOR_DEFAULT CACA_DEFAULT
  527. # define CUCUL_COLOR_TRANSPARENT CACA_TRANSPARENT
  528. /* Aliases from the libcucul/libcaca merge */
  529. # define cucul_canvas_t caca_canvas_t
  530. # define cucul_dither_t caca_dither_t
  531. # define cucul_font_t caca_font_t
  532. # define cucul_file_t caca_file_t
  533. # define cucul_display_t caca_display_t
  534. # define cucul_event_t caca_event_t
  535. # define CUCUL_BLACK CACA_BLACK
  536. # define CUCUL_BLUE CACA_BLUE
  537. # define CUCUL_GREEN CACA_GREEN
  538. # define CUCUL_CYAN CACA_CYAN
  539. # define CUCUL_RED CACA_RED
  540. # define CUCUL_MAGENTA CACA_MAGENTA
  541. # define CUCUL_BROWN CACA_BROWN
  542. # define CUCUL_LIGHTGRAY CACA_LIGHTGRAY
  543. # define CUCUL_DARKGRAY CACA_DARKGRAY
  544. # define CUCUL_LIGHTBLUE CACA_LIGHTBLUE
  545. # define CUCUL_LIGHTGREEN CACA_LIGHTGREEN
  546. # define CUCUL_LIGHTCYAN CACA_LIGHTCYAN
  547. # define CUCUL_LIGHTRED CACA_LIGHTRED
  548. # define CUCUL_LIGHTMAGENTA CACA_LIGHTMAGENTA
  549. # define CUCUL_YELLOW CACA_YELLOW
  550. # define CUCUL_WHITE CACA_YELLOW
  551. # define CUCUL_DEFAULT CACA_DEFAULT
  552. # define CUCUL_TRANSPARENT CACA_TRANSPARENT
  553. # define CUCUL_BOLD CACA_BOLD
  554. # define CUCUL_ITALICS CACA_ITALICS
  555. # define CUCUL_UNDERLINE CACA_UNDERLINE
  556. # define CUCUL_BLINK CACA_BLINK
  557. # if !defined __LIBCACA__
  558. # define cucul_draw_triangle caca_draw_triangle
  559. # define cucul_draw_thin_triangle caca_draw_thin_triangle
  560. # define cucul_fill_triangle caca_fill_triangle
  561. # define cucul_load_font caca_load_font
  562. # define cucul_get_font_list caca_get_font_list
  563. # define cucul_get_font_width caca_get_font_width
  564. # define cucul_get_font_height caca_get_font_height
  565. # define cucul_get_font_blocks caca_get_font_blocks
  566. # define cucul_render_canvas caca_render_canvas
  567. # define cucul_free_font caca_free_font
  568. # define cucul_gotoxy caca_gotoxy
  569. # define cucul_get_cursor_x caca_get_cursor_x
  570. # define cucul_get_cursor_y caca_get_cursor_y
  571. # define cucul_put_char caca_put_char
  572. # define cucul_get_char caca_get_char
  573. # define cucul_put_str caca_put_str
  574. # define cucul_printf caca_printf
  575. # define cucul_clear_canvas caca_clear_canvas
  576. # define cucul_set_canvas_handle caca_set_canvas_handle
  577. # define cucul_get_canvas_handle_x caca_get_canvas_handle_x
  578. # define cucul_get_canvas_handle_y caca_get_canvas_handle_y
  579. # define cucul_blit caca_blit
  580. # define cucul_set_canvas_boundaries caca_set_canvas_boundaries
  581. # define cucul_import_memory caca_import_memory
  582. # define cucul_import_file caca_import_file
  583. # define cucul_get_import_list caca_get_import_list
  584. # define cucul_create_canvas caca_create_canvas
  585. # define cucul_manage_canvas caca_manage_canvas
  586. # define cucul_unmanage_canvas caca_unmanage_canvas
  587. # define cucul_set_canvas_size caca_set_canvas_size
  588. # define cucul_get_canvas_width caca_get_canvas_width
  589. # define cucul_get_canvas_height caca_get_canvas_height
  590. # define cucul_get_canvas_chars caca_get_canvas_chars
  591. # define cucul_get_canvas_attrs caca_get_canvas_attrs
  592. # define cucul_free_canvas caca_free_canvas
  593. # define cucul_rand caca_rand
  594. # define cucul_export_memory caca_export_memory
  595. # define cucul_get_export_list caca_get_export_list
  596. # define cucul_get_version caca_get_version
  597. # define cucul_utf8_to_utf32 caca_utf8_to_utf32
  598. # define cucul_utf32_to_utf8 caca_utf32_to_utf8
  599. # define cucul_utf32_to_cp437 caca_utf32_to_cp437
  600. # define cucul_cp437_to_utf32 caca_cp437_to_utf32
  601. # define cucul_utf32_to_ascii caca_utf32_to_ascii
  602. # define cucul_utf32_is_fullwidth caca_utf32_is_fullwidth
  603. # define cucul_draw_circle caca_draw_circle
  604. # define cucul_draw_ellipse caca_draw_ellipse
  605. # define cucul_draw_thin_ellipse caca_draw_thin_ellipse
  606. # define cucul_fill_ellipse caca_fill_ellipse
  607. # define cucul_canvas_set_figfont caca_canvas_set_figfont
  608. # define cucul_put_figchar caca_put_figchar
  609. # define cucul_flush_figlet caca_flush_figlet
  610. # define cucul_putchar caca_putchar
  611. # define cucul_getchar caca_getchar
  612. # define cucul_get_attr caca_get_attr
  613. # define cucul_set_attr caca_set_attr
  614. # define cucul_put_attr caca_put_attr
  615. # define cucul_set_color_ansi caca_set_color_ansi
  616. # define cucul_set_color_argb caca_set_color_argb
  617. # define cucul_attr_to_ansi caca_attr_to_ansi
  618. # define cucul_attr_to_ansi_fg caca_attr_to_ansi_fg
  619. # define cucul_attr_to_ansi_bg caca_attr_to_ansi_bg
  620. # define cucul_attr_to_rgb12_fg caca_attr_to_rgb12_fg
  621. # define cucul_attr_to_rgb12_bg caca_attr_to_rgb12_bg
  622. # define cucul_attr_to_argb64 caca_attr_to_argb64
  623. # define cucul_invert caca_invert
  624. # define cucul_flip caca_flip
  625. # define cucul_flop caca_flop
  626. # define cucul_rotate_180 caca_rotate_180
  627. # define cucul_rotate_left caca_rotate_left
  628. # define cucul_rotate_right caca_rotate_right
  629. # define cucul_stretch_left caca_stretch_left
  630. # define cucul_stretch_right caca_stretch_right
  631. # define cucul_file_open caca_file_open
  632. # define cucul_file_close caca_file_close
  633. # define cucul_file_tell caca_file_tell
  634. # define cucul_file_read caca_file_read
  635. # define cucul_file_write caca_file_write
  636. # define cucul_file_gets caca_file_gets
  637. # define cucul_file_eof caca_file_eof
  638. # define cucul_create_dither caca_create_dither
  639. # define cucul_set_dither_palette caca_set_dither_palette
  640. # define cucul_set_dither_brightness caca_set_dither_brightness
  641. # define cucul_get_dither_brightness caca_get_dither_brightness
  642. # define cucul_set_dither_gamma caca_set_dither_gamma
  643. # define cucul_get_dither_gamma caca_get_dither_gamma
  644. # define cucul_set_dither_contrast caca_set_dither_contrast
  645. # define cucul_get_dither_contrast caca_get_dither_contrast
  646. # define cucul_set_dither_antialias caca_set_dither_antialias
  647. # define cucul_get_dither_antialias_list caca_get_dither_antialias_list
  648. # define cucul_get_dither_antialias caca_get_dither_antialias
  649. # define cucul_set_dither_color caca_set_dither_color
  650. # define cucul_get_dither_color_list caca_get_dither_color_list
  651. # define cucul_get_dither_color caca_get_dither_color
  652. # define cucul_set_dither_charset caca_set_dither_charset
  653. # define cucul_get_dither_charset_list caca_get_dither_charset_list
  654. # define cucul_get_dither_charset caca_get_dither_charset
  655. # define cucul_set_dither_algorithm caca_set_dither_algorithm
  656. # define cucul_get_dither_algorithm_list caca_get_dither_algorithm_list
  657. # define cucul_get_dither_algorithm caca_get_dither_algorithm
  658. # define cucul_dither_bitmap caca_dither_bitmap
  659. # define cucul_free_dither caca_free_dither
  660. # define cucul_draw_line caca_draw_line
  661. # define cucul_draw_polyline caca_draw_polyline
  662. # define cucul_draw_thin_line caca_draw_thin_line
  663. # define cucul_draw_thin_polyline caca_draw_thin_polyline
  664. # define cucul_draw_box caca_draw_box
  665. # define cucul_draw_thin_box caca_draw_thin_box
  666. # define cucul_draw_cp437_box caca_draw_cp437_box
  667. # define cucul_fill_box caca_fill_box
  668. # define cucul_get_frame_count caca_get_frame_count
  669. # define cucul_set_frame caca_set_frame
  670. # define cucul_get_frame_name caca_get_frame_name
  671. # define cucul_set_frame_name caca_set_frame_name
  672. # define cucul_create_frame caca_create_frame
  673. # define cucul_free_frame caca_free_frame
  674. # endif
  675. #endif
  676. #ifdef __cplusplus
  677. }
  678. #endif
  679. #undef __extern
  680. #endif /* __CACA_H__ */