show_mouse(3alleg4) [freebsd man page]
show_mouse(3alleg4) Allegro manual show_mouse(3alleg4) 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 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(3alleg4), install_timer(3alleg4), set_mouse_sprite(3alleg4), scare_mouse(3alleg4), freeze_mouse_flag(3alleg4), show_os_cur- sor(3alleg4), exmouse(3alleg4), expal(3alleg4), exshade(3alleg4), exspline(3alleg4), exsyscur(3alleg4) Allegro version 4.4.2 show_mouse(3alleg4)
Check Out this Related Man Page
exmouse(3alleg4) Allegro manual exmouse(3alleg4) NAME
exmouse - Getting input from the mouse. Allegro game programming library. SYNOPSIS
#include <allegro.h> Example exmouse DESCRIPTION
This program demonstrates how to get mouse input. The first part of the test retrieves the raw mouse input data and displays it on the screen without using any mouse cursor. When you press a key the standard arrow-like mouse cursor appears. You are not restricted to this shape, and a second key press modifies the cursor to be several concentric colored circles. They are not joined together, so you can still see bits of what's behind when you move the cursor over the printed text message. SEE ALSO
BITMAP(3alleg4), END_OF_MAIN(3alleg4), SCREEN_H(3alleg4), SCREEN_W(3alleg4), acquire_screen(3alleg4), allegro_error(3alleg4), alle- gro_init(3alleg4), allegro_message(3alleg4), bitmap_mask_color(3alleg4), circle(3alleg4), clear_keybuf(3alleg4), clear_to_color(3alleg4), create_bitmap(3alleg4), desktop_palette(3alleg4), destroy_bitmap(3alleg4), font(3alleg4), get_mouse_mickeys(3alleg4), install_key- board(3alleg4), install_mouse(3alleg4), install_timer(3alleg4), key(3alleg4), keypressed(3alleg4), makecol(3alleg4), mouse_b(3alleg4), mouse_w(3alleg4), mouse_x(3alleg4), mouse_y(3alleg4), mouse_z(3alleg4), palette_color(3alleg4), poll_mouse(3alleg4), readkey(3alleg4), release_screen(3alleg4), screen(3alleg4), set_gfx_mode(3alleg4), set_mouse_sprite(3alleg4), set_mouse_sprite_focus(3alleg4), set_pal- ette(3alleg4), show_mouse(3alleg4), textout_centre_ex(3alleg4), textout_ex(3alleg4), textprintf_centre_ex(3alleg4), textprintf_ex(3alleg4), textprintf_right_ex(3alleg4), vsync(3alleg4) Allegro version 4.4.2 exmouse(3alleg4)