1show_mouse(3)                   Allegro manual                   show_mouse(3)
2
3
4

NAME

6       show_mouse - Tells Allegro to display a mouse pointer on the screen.
7

SYNOPSIS

9       #include <allegro.h>
10
11
12       void show_mouse(BITMAP *bmp);
13

DESCRIPTION

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

SEE ALSO

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.2.3                   show_mouse(3)
Impressum