NAME¶
show_os_cursor - Low level function to display the operating system cursor.
Allegro game programming library.
SYNOPSIS¶
#include <allegro.h>
int show_os_cursor(int cursor);
DESCRIPTION¶
In case you do not need Allegro's mouse cursor API, which automatically emulates
a cursor in software if no other cursor is available, you can use this low
level function to try to display or hide the system cursor directly. The
cursor parameter takes the same values as select_mouse_cursor. This function
is very similar to calling enable_hardware_cursor, select_mouse_cursor and
show_mouse, but will not try to do anything if no system cursor is available.
The most common use for this function is to just call it once at the beginning
of the program to tell it to display the system cursor inside the Allegro
window. The return value can be used to see if this succeeded or not. On some
systems (e.g. DirectX fullscreen) this is not supported and the function will
always fail, and in other cases only some of the cursors will work, or in the
case of MOUSE_CURSOR_ALLEGRO, only certain bitmap sizes may be supported.
You never should use show_os_cursor together with the function show_mouse and
other functions affecting it (select_mouse_cursor, enable_hardware_cursor,
disable_hardware_cursor, scare_mouse, unscare_mouse). They implement the
standard high level mouse API, and don't work together with this low level
function.
RETURN VALUE¶
Returns 0 if a system cursor is being displayed after the function returns, or
-1 otherwise.
SEE ALSO¶
show_mouse(3alleg4),
set_mouse_cursor_bitmap(3alleg4),
select_mouse_cursor(3alleg4)