show_os_cursor(3alleg4) [linux man page]

show_os_cursor(3alleg4) 					  Allegro manual					   show_os_cursor(3alleg4)

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_CUR-
       SOR_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)

Allegro 							   version 4.4.2					   show_os_cursor(3alleg4)

select_mouse_cursor(3alleg4)					  Allegro manual				      select_mouse_cursor(3alleg4)

NAME

       select_mouse_cursor - Tells Allegro to select software or hardware cursor drawing.

SYNOPSIS

       #include <allegro.h>

       void select_mouse_cursor(int cursor);

DESCRIPTION

       This  function  allows  you to use the operating system's native mouse cursors rather than some custom cursor. You will need to enable this
       functionality by calling enable_hardware_cursor() beforehand. If the operating system does not support this functionality, or if it has not
       been enabled, then Allegro will substitute its own cursor images.  You can change these substitute images using set_mouse_cursor_bitmap().

       Note that the effects of this function are not apparent until show_mouse() is called.

       To  know  whether  the  operating  system's  native cursor is being used, or if Allegro has made a substitution, you can check the GFX_SYS-
       TEM_CURSOR flag in gfx_capabilities after calling show_mouse().

       The cursor argument selects the type of cursor to be displayed:

       MOUSE_CURSOR_NONE Selects an invisible mouse cursor. In that sense, it is similar to calling show_mouse(NULL);

       MOUSE_CURSOR_ALLEGRO Selects the custom Allegro cursor, i.e. the one that you set with set_mouse_sprite().

       MOUSE_CURSOR_ARROW The operating system default arrow cursor.

       MOUSE_CURSOR_BUSY The operating system default `busy' cursor (hourglass).

       MOUSE_CURSOR_QUESTION The operating system default `question' cursor (arrow with question mark).

       MOUSE_CURSOR_EDIT The operating system default `edit' cursor (vertical bar).

       Example:

	  /* initialize mouse sub-system */
	  install_mouse();
	  enable_hardware_cursor();

	  /* Set busy pointer */
	  select_mouse_cursor(MOUSE_CURSOR_BUSY);
	  show_mouse(screen);

	  /* Initialize stuff */
	  ...

	  /* Set normal arrow pointer */
	  select_mouse_cursor(MOUSE_CURSOR_ARROW);

SEE ALSO

       install_mouse(3alleg4),	 show_mouse(3alleg4),	set_mouse_sprite(3alleg4),   gfx_capabilities(3alleg4),   enable_hardware_cursor(3alleg4),
       set_mouse_cursor_bitmap(3alleg4), show_os_cursor(3alleg4), exsyscur(3alleg4)

Allegro 							   version 4.4.2				      select_mouse_cursor(3alleg4)