| caca_display(3caca) | libcaca | caca_display(3caca) |
caca_display - libcaca display functions
libcaca event handling
__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.
These functions provide the basic libcaca routines for display initialisation, system information retrieval and configuration.
Create a graphical context using device-dependent features (ncurses for terminals, an X11 window, a DOS command window...) that attaches to a libcaca canvas. Everything that gets drawn in the libcaca canvas can then be displayed by the libcaca driver.
If no caca canvas is provided, a new one is created. Its handle can be retrieved using caca_get_canvas() and it is automatically destroyed when caca_free_display() is called.
Note that in order to achieve maximum Unicode compatibility, the driver initialisation code may temporarily change the program’s global LC_CTYPE locale using setlocale(). It is advised not to call LC_CTYPE-dependent functions from other threads during the call to caca_create_display(). The locale settings are restored when the function returns.
See also caca_create_display_with_driver().
If an error occurs, NULL is returned and errno is set accordingly:
Parameters
Returns
References caca_create_display_with_driver().
Create a graphical context using device-dependent features (ncurses for terminals, an X11 window, a DOS command window...) that attaches to a libcaca canvas. Everything that gets drawn in the libcaca canvas can then be displayed by the libcaca driver.
If no caca canvas is provided, a new one is created. Its handle can be retrieved using caca_get_canvas() and it is automatically destroyed when caca_free_display() is called.
If no driver name is provided, libcaca will try to autodetect the best output driver it can.
See also caca_create_display().
If an error occurs, NULL is returned and errno is set accordingly:
Parameters
Returns
References caca_create_canvas(), caca_free_canvas(), caca_manage_canvas(), and caca_unmanage_canvas().
Referenced by caca_create_display().
Return a list of available display drivers. The list is a NULL-terminated array of strings, interleaving a string containing the internal value for the display driver, and a string containing the natural language description for that driver.
This function never fails.
Returns
Return the given display's current output driver.
This function never fails.
Parameters
Returns
Dynamically change the given display's output driver.
FIXME: decide what to do in case of failure
Parameters
Returns
Detach a graphical context from its caca backend and destroy it. The libcaca canvas continues to exist and other graphical contexts can be attached to it afterwards.
If the caca canvas was automatically created by caca_create_display(), it is automatically destroyed and any handle to it becomes invalid.
This function never fails.
Parameters
Returns
References caca_free_canvas(), and caca_unmanage_canvas().
Return a handle on the caca_canvas_t object that was either attached or created by caca_create_display().
This function never fails.
Parameters
Returns
Flush all graphical operations and print them to the display device. Nothing will show on the screen until this function is called.
If caca_set_display_time() was called with a non-zero value, caca_refresh_display() will use that value to achieve constant framerate: if two consecutive calls to caca_refresh_display() are within a time range shorter than the value set with caca_set_display_time(), the second call will be delayed before performing the screen refresh.
This function never fails.
Parameters
Returns
References caca_clear_dirty_rect_list().
Set the refresh delay in microseconds. The refresh delay is used by caca_refresh_display() to achieve constant framerate. See the caca_refresh_display() documentation for more details.
If the argument is zero, constant framerate is disabled. This is the default behaviour.
If an error occurs, -1 is returned and errno is set accordingly:
Parameters
Returns
Get the average rendering time, which is the average measured time between two caca_refresh_display() calls, in microseconds. If constant framerate was activated by calling caca_set_display_time(), the average rendering time will be close to the requested delay even if the real rendering time was shorter.
This function never fails.
Parameters
Returns
If libcaca runs in a window, get the usable window width. This value can be used for aspect ratio calculation. If libcaca does not run in a window or if there is no way to know the font size, most drivers will assume a 6x10 font is being used. Note that the units are not necessarily pixels.
This function never fails.
Parameters
Returns
If libcaca runs in a window, get the usable window height. This value can be used for aspect ratio calculation. If libcaca does not run in a window or if there is no way to know the font size, assume a 6x10 font is being used. Note that the units are not necessarily pixels.
This function never fails.
Parameters
Returns
If libcaca runs in a window, try to change its title. This works with the ncurses, S-Lang, OpenGL, X11 and Win32 drivers.
If an error occurs, -1 is returned and errno is set accordingly:
Parameters
Returns
Show or hide the mouse pointer. This function works with the ncurses, S-Lang and X11 drivers.
If an error occurs, -1 is returned and errno is set accordingly:
Parameters
Returns
Show or hide the cursor, for devices that support such a feature.
If an error occurs, -1 is returned and errno is set accordingly:
Parameters
Returns
Generated automatically by Doxygen for libcaca from the source code.
| Tue Jul 12 2022 | Version 0.99.beta20 |