* Merged caca_show_cursor() and caca_hide_cursor() into caca_set_mouse() so
that we have one function less.
* Fixed coding style.
* Removed FUCKING TABS. ____.------.___
_______.----'`` ``` `` ``` ``-.
_.--' ` ```` ` ` ` ``` `` `` ``.
_.-' ' ` `` ``` `` ` `' `. _
.-'' ` H A H A H A `' M A I S \/.)
. . .-' / ` ` ` `` ||
|`-.(``-. ` ` ` ' ` ` ``` |\
`. '\```\ `` ` V I E U X ' ' `` `-`` -|\\
`/''````) `` ` - - ````` ' '.' |\_)
|`'_._` ``` ''` P O R C . . ```` /
// @) \ ` `` ''' . ``` '/
/''''' | ` \).`.'-. ''' _ _ .`` ` '/
.''''- `-'`. . // )-- '/,,',,' ,,,,''__,._`' ' /
.' ` `- ` ' .' / ' /,;;;, ,___.---' \ '' / \
(`. .'` __',`''''.--'/ ' /'-----' | ' / ))
`'-'/ `'''_.---' \;;|- '/ ,,, | ''|`- |
`'--'---' |;| / ,,,,;;;;;;;;;;,,,,, |-' /` |
|;|-'| ,;;;;;;;;;;;;;;;; ;;;/ /|`'''
''',,,''',,,,,,,,,,,,,,,' /,,'''
''''
18 jaren geleden * Merged caca_show_cursor() and caca_hide_cursor() into caca_set_mouse() so
that we have one function less.
* Fixed coding style.
* Removed FUCKING TABS. ____.------.___
_______.----'`` ``` `` ``` ``-.
_.--' ` ```` ` ` ` ``` `` `` ``.
_.-' ' ` `` ``` `` ` `' `. _
.-'' ` H A H A H A `' M A I S \/.)
. . .-' / ` ` ` `` ||
|`-.(``-. ` ` ` ' ` ` ``` |\
`. '\```\ `` ` V I E U X ' ' `` `-`` -|\\
`/''````) `` ` - - ````` ' '.' |\_)
|`'_._` ``` ''` P O R C . . ```` /
// @) \ ` `` ''' . ``` '/
/''''' | ` \).`.'-. ''' _ _ .`` ` '/
.''''- `-'`. . // )-- '/,,',,' ,,,,''__,._`' ' /
.' ` `- ` ' .' / ' /,;;;, ,___.---' \ '' / \
(`. .'` __',`''''.--'/ ' /'-----' | ' / ))
`'-'/ `'''_.---' \;;|- '/ ,,, | ''|`- |
`'--'---' |;| / ,,,,;;;;;;;;;;,,,,, |-' /` |
|;|-'| ,;;;;;;;;;;;;;;;; ;;;/ /|`'''
''',,,''',,,,,,,,,,,,,,,' /,,'''
''''
18 jaren geleden |
123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289 |
- /*
- * libcaca Colour ASCII-Art library
- * Copyright (c) 2002-2009 Sam Hocevar <sam@hocevar.net>
- * All Rights Reserved
- *
- * $Id$
- *
- * This library is free software. It comes without any warranty, to
- * the extent permitted by applicable law. You can redistribute it
- * and/or modify it under the terms of the Do What The Fuck You Want
- * To Public License, Version 2, as published by Sam Hocevar. See
- * http://sam.zoy.org/wtfpl/COPYING for more details.
- */
-
- /*
- * This file contains character and string drawing functions.
- */
-
- #include "config.h"
-
- #if !defined(__KERNEL__)
- # include <stdio.h>
- # include <stdlib.h>
- # include <string.h>
- #endif
-
- #include "caca.h"
- #include "caca_internals.h"
-
- /** \brief Set the display title.
- *
- * 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 \b errno is set accordingly:
- * - \c ENOSYS Display driver does not support setting the window title.
- *
- * \param dp The libcaca display context.
- * \param title The desired display title.
- * \return 0 upon success, -1 if an error occurred.
- */
- int caca_set_display_title(caca_display_t *dp, char const *title)
- {
- int ret = dp->drv.set_display_title(dp, title);
-
- if(ret)
- seterrno(ENOSYS);
-
- return ret;
- }
-
- /** \brief Get the display width.
- *
- * 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.
- *
- * \param dp The libcaca display context.
- * \return The display width.
- */
- int caca_get_display_width(caca_display_t const *dp)
- {
- return dp->drv.get_display_width(dp);
- }
-
- /** \brief Get the display height.
- *
- * 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.
- *
- * \param dp The libcaca display context.
- * \return The display height.
- */
- int caca_get_display_height(caca_display_t const *dp)
- {
- return dp->drv.get_display_height(dp);
- }
-
- /** \brief Set the refresh delay.
- *
- * 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 \b errno is set accordingly:
- * - \c EINVAL Refresh delay value is invalid.
- *
- * \param dp The libcaca display context.
- * \param usec The refresh delay in microseconds.
- * \return 0 upon success, -1 if an error occurred.
- */
- int caca_set_display_time(caca_display_t *dp, int usec)
- {
- if(usec < 0)
- {
- seterrno(EINVAL);
- return -1;
- }
-
- dp->delay = usec;
- return 0;
- }
-
- /** \brief Get the display's average rendering time.
- *
- * 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.
- *
- * \param dp The libcaca display context.
- * \return The render time in microseconds.
- */
- int caca_get_display_time(caca_display_t const *dp)
- {
- return dp->rendertime;
- }
-
- /** \brief Flush pending changes and redraw the screen.
- *
- * 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.
- *
- * \param dp The libcaca display context.
- * \return This function always returns 0.
- */
- int caca_refresh_display(caca_display_t *dp)
- {
- #if defined PROF
- caca_timer_t proftimer = { 0, 0 };
- #endif
- #if !defined(_DOXYGEN_SKIP_ME)
- # define IDLE_USEC 5000
- #endif
- int ticks = dp->lastticks + _caca_getticks(&dp->timer);
-
- #if defined PROF
- _caca_getticks(&proftimer);
- #endif
- dp->drv.display(dp);
- #if defined PROF
- STAT_IADD(&dp->display_stat, _caca_getticks(&proftimer));
- #endif
-
- /* Invalidate the dirty rectangle */
- caca_clear_dirty_rect_list(dp->cv);
-
- /* Once the display is finished, we can ack resizes */
- if(dp->resize.resized)
- {
- dp->resize.resized = 0;
- _caca_handle_resize(dp);
- }
-
- #if defined PROF
- _caca_getticks(&proftimer);
- #endif
- /* Wait until dp->delay + time of last call */
- ticks += _caca_getticks(&dp->timer);
- for(ticks += _caca_getticks(&dp->timer);
- ticks + IDLE_USEC < (int)dp->delay;
- ticks += _caca_getticks(&dp->timer))
- {
- _caca_sleep(IDLE_USEC);
- }
- #if defined PROF
- STAT_IADD(&dp->wait_stat, _caca_getticks(&proftimer));
- #endif
-
- /* Update the render time */
- dp->rendertime = ticks;
-
- dp->lastticks = ticks - dp->delay;
-
- /* If we drifted too much, it's bad, bad, bad. */
- if(dp->lastticks > (int)dp->delay)
- dp->lastticks = 0;
-
- #if defined PROF
- _caca_dump_stats();
- #endif
-
- return 0;
- }
-
- /** \brief Show or hide the cursor.
- *
- * Show or hide the cursor, for devices that support such a feature.
- *
- * If an error occurs, -1 is returned and \b errno is set accordingly:
- * - \c ENOSYS Display driver does not support showing the cursor.
- *
- * \param dp The libcaca display context.
- * \param flag 0 hides the cursor, 1 shows the system's default cursor
- * (usually a white rectangle). Other values are reserved for
- * future use.
- * \return 0 upon success, -1 if an error occurred.
- */
- int caca_set_cursor(caca_display_t *dp, int flag)
- {
- if(!dp->drv.set_cursor)
- {
- seterrno(ENOSYS);
- return -1;
- }
-
- dp->drv.set_cursor(dp, flag);
- return 0;
- }
-
- /** \brief Show or hide the mouse pointer.
- *
- * 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 \b errno is set accordingly:
- * - \c ENOSYS Display driver does not support hiding the mouse pointer.
- *
- * \param dp The libcaca display context.
- * \param flag 0 hides the pointer, 1 shows the system's default pointer
- * (usually an arrow). Other values are reserved for future use.
- * \return 0 upon success, -1 if an error occurred.
- */
- int caca_set_mouse(caca_display_t *dp, int flag)
- {
- if(!dp->drv.set_mouse)
- {
- seterrno(ENOSYS);
- return -1;
- }
-
- dp->drv.set_mouse(dp, flag);
- return 0;
- }
-
- /*
- * XXX: following functions are local
- */
-
- void _caca_handle_resize(caca_display_t *dp)
- {
- dp->drv.handle_resize(dp);
-
- /* Tell libcaca we changed size */
- if(dp->resize.w != caca_get_canvas_width(dp->cv)
- || dp->resize.h != caca_get_canvas_height(dp->cv))
- {
- dp->resize.allow = 1;
- caca_set_canvas_size(dp->cv, dp->resize.w, dp->resize.h);
- dp->resize.allow = 0;
- }
- }
-
- void _caca_set_term_title(char const *str)
- {
- #if defined(HAVE_GETENV)
- char *term;
-
- term = getenv("TERM");
-
- if(!term || !strcmp(term, "linux"))
- return;
- #endif
-
- fprintf(stdout, "\033]0;%s\007", str);
- fflush(stdout);
- }
-
|