Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
show_mouse(3)			 Allegro manual 		   show_mouse(3)

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

SYNOPSIS
     #include <allegro.h>

     void show_mouse(BITMAP *bmp);

DESCRIPTION
     Tells Allegro to display a mouse pointer on the screen. This will only work
     if  the  timer  module  has been installed. The mouse pointer will be drawn
     onto the specified bitmap, which should normally be `screen' (see later for
     information   about   bitmaps).   To   hide   the	 mouse	 pointer,   call
     show_mouse(NULL).

     Warning: if you draw anything onto the screen while the pointer is visible,
     a mouse movement interrupt could occur in the middle of your drawing opera-
     tion.  If	this  happens the mouse buffering and graphics drawing code will
     get confused and will leave 'mouse droppings' all over the screen. To  pre-
     vent  this,  you must make sure you turn off the mouse pointer whenever you
     draw onto the screen. This is not needed if you are using a  hardware  cur-
     sor.

     Note:  you must not be showing a mouse pointer on a bitmap at the time that
     the bitmap is destroyed with destroy_bitmap(), e.g. call  show_mouse(NULL);
     before  destroying  the  bitmap.  This does not apply to `screen' since you
     never destroy `screen' with destroy_bitmap().

SEE ALSO
     install_mouse(3),	install_timer(3),  set_mouse_sprite(3),  scare_mouse(3),
     freeze_mouse_flag(3),  show_os_cursor(3), exmouse(3), expal(3), exshade(3),
     exspline(3), exsyscur(3)

Allegro 			  version 4.4.3 		   show_mouse(3)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=show_mouse&sektion=3&manpath=FreeBSD+Ports+15.1.quarterly>

home | help