1show_mouse(3) Allegro manual show_mouse(3)
2
3
4
6 show_mouse - Tells Allegro to display a mouse pointer on the screen.
7
9 #include <allegro.h>
10
11
12 void show_mouse(BITMAP *bmp);
13
15 Tells Allegro to display a mouse pointer on the screen. This will only
16 work if the timer module has been installed. The mouse pointer will be
17 drawn onto the specified bitmap, which should normally be `screen' (see
18 later for information about bitmaps). To hide the mouse pointer, call
19 show_mouse(NULL).
20
21 Warning: if you draw anything onto the screen while the pointer is vis‐
22 ible, a mouse movement interrupt could occur in the middle of your
23 drawing operation. If this happens the mouse buffering and graphics
24 drawing code will get confused and will leave 'mouse droppings' all
25 over the screen. To prevent this, you must make sure you turn off the
26 mouse pointer whenever you draw onto the screen. This is not needed if
27 you are using a hardware cursor.
28
29 Note: you must not be showing a mouse pointer on a bitmap at the time
30 that the bitmap is destroyed with destroy_bitmap(), e.g. call
31 show_mouse(NULL); before destroying the bitmap. This does not apply to
32 `screen' since you never destroy `screen' with destroy_bitmap().
33
34
36 install_mouse(3), install_timer(3), set_mouse_sprite(3),
37 scare_mouse(3), freeze_mouse_flag(3), show_os_cursor(3), exmouse(3),
38 expal(3), exshade(3), exspline(3), exsyscur(3)
39
40
41
42Allegro version 4.4.3 show_mouse(3)