GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  SHOW_MOUSE (3)

NAME

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

CONTENTS

Synopsis
Description
See Also

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 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)
Search for    or go to Top of page |  Section 3 |  Main Index


Allegro SHOW_MOUSE (3) version 4.4.2

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.