1set_mouse_cursor_bitmap(3) Allegro manual set_mouse_cursor_bitmap(3)
2
3
4
6 set_mouse_cursor_bitmap - Changes the image Allegro uses for mouse cur‐
7 sors.
8
10 #include <allegro.h>
11
12
13 void set_mouse_cursor_bitmap(int cursor, BITMAP *bmp);
14
16 This function changes the cursor image Allegro uses if
17 select_mouse_cursor() is called but no native operating system cursor
18 can be used, e.g. because you did not call enable_hardware_cursor().
19
20 The cursor argument can be one of:
21
22 MOUSE_CURSOR_ALLEGRO MOUSE_CURSOR_ARROW MOUSE_CURSOR_BUSY MOUSE_CUR‐
23 SOR_QUESTION MOUSE_CURSOR_EDIT
24
25 but not MOUSE_CURSOR_NONE.
26
27 The bmp argument can either point to a valid bitmap or it can be NULL.
28 Passing a bitmap makes Allegro use that image in place of its own
29 default substitution (should the operating system's native cursor be
30 unavailable). The bitmap must remain available for the duration in
31 which it could be used. Passing NULL lets Allegro revert to its default
32 substitutions.
33
34 The effect of this function will not be apparent until show_mouse() is
35 called.
36
37
39 install_mouse(3), show_mouse(3), set_mouse_sprite(3), gfx_capabili‐
40 ties(3), enable_hardware_cursor(3), show_os_cursor(3)
41
42
43
44Allegro version 4.2.2 set_mouse_cursor_bitmap(3)