Provided by: allegro5-doc_5.2.8.0+dfsg-1_all bug

NAME

       al_set_system_mouse_cursor - Allegro 5 API

SYNOPSIS

              #include <allegro5/allegro.h>

              bool al_set_system_mouse_cursor(ALLEGRO_DISPLAY *display,
                 ALLEGRO_SYSTEM_MOUSE_CURSOR cursor_id)

DESCRIPTION

       Set  the  given  system mouse cursor to be the current mouse cursor for the given display.
       If the cursor is currently `shown' (as opposed to  `hidden')  the  change  is  immediately
       visible.

       If  the  cursor  doesn’t  exist on the current platform another cursor will be silently be
       substituted.

       The cursors are:

       • ALLEGRO_SYSTEM_MOUSE_CURSOR_DEFAULT

       • ALLEGRO_SYSTEM_MOUSE_CURSOR_ARROW

       • ALLEGRO_SYSTEM_MOUSE_CURSOR_BUSY

       • ALLEGRO_SYSTEM_MOUSE_CURSOR_QUESTION

       • ALLEGRO_SYSTEM_MOUSE_CURSOR_EDIT

       • ALLEGRO_SYSTEM_MOUSE_CURSOR_MOVE

       • ALLEGRO_SYSTEM_MOUSE_CURSOR_RESIZE_N

       • ALLEGRO_SYSTEM_MOUSE_CURSOR_RESIZE_W

       • ALLEGRO_SYSTEM_MOUSE_CURSOR_RESIZE_S

       • ALLEGRO_SYSTEM_MOUSE_CURSOR_RESIZE_E

       • ALLEGRO_SYSTEM_MOUSE_CURSOR_RESIZE_NW

       • ALLEGRO_SYSTEM_MOUSE_CURSOR_RESIZE_SW

       • ALLEGRO_SYSTEM_MOUSE_CURSOR_RESIZE_SE

       • ALLEGRO_SYSTEM_MOUSE_CURSOR_RESIZE_NE

       • ALLEGRO_SYSTEM_MOUSE_CURSOR_PROGRESS

       • ALLEGRO_SYSTEM_MOUSE_CURSOR_PRECISION

       • ALLEGRO_SYSTEM_MOUSE_CURSOR_LINK

       • ALLEGRO_SYSTEM_MOUSE_CURSOR_ALT_SELECT

       • ALLEGRO_SYSTEM_MOUSE_CURSOR_UNAVAILABLE

       Returns true on success, false on failure.

SEE ALSO

       al_set_mouse_cursor(3alleg5), al_show_mouse_cursor(3alleg5), al_hide_mouse_cursor(3alleg5)