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 vis-
       ible, a mouse movement interrupt	could occur  in	 the  middle  of  your
       drawing	operation.  If	this  happens the mouse	buffering and graphics
       drawing code will get confused and will	leave  'mouse  droppings'  all
       over  the  screen. To prevent 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	cursor.

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

NAME | SYNOPSIS | DESCRIPTION | SEE ALSO

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

home | help