Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

show_mouse(3alleg4) [v7 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

select_mouse_cursor(3alleg4)                                      Allegro manual                                      select_mouse_cursor(3alleg4)

NAME
select_mouse_cursor - Tells Allegro to select software or hardware cursor drawing. SYNOPSIS
#include <allegro.h> void select_mouse_cursor(int cursor); DESCRIPTION
This function allows you to use the operating system's native mouse cursors rather than some custom cursor. You will need to enable this functionality by calling enable_hardware_cursor() beforehand. If the operating system does not support this functionality, or if it has not been enabled, then Allegro will substitute its own cursor images. You can change these substitute images using set_mouse_cursor_bitmap(). Note that the effects of this function are not apparent until show_mouse() is called. To know whether the operating system's native cursor is being used, or if Allegro has made a substitution, you can check the GFX_SYS- TEM_CURSOR flag in gfx_capabilities after calling show_mouse(). The cursor argument selects the type of cursor to be displayed: MOUSE_CURSOR_NONE Selects an invisible mouse cursor. In that sense, it is similar to calling show_mouse(NULL); MOUSE_CURSOR_ALLEGRO Selects the custom Allegro cursor, i.e. the one that you set with set_mouse_sprite(). MOUSE_CURSOR_ARROW The operating system default arrow cursor. MOUSE_CURSOR_BUSY The operating system default `busy' cursor (hourglass). MOUSE_CURSOR_QUESTION The operating system default `question' cursor (arrow with question mark). MOUSE_CURSOR_EDIT The operating system default `edit' cursor (vertical bar). Example: /* initialize mouse sub-system */ install_mouse(); enable_hardware_cursor(); /* Set busy pointer */ select_mouse_cursor(MOUSE_CURSOR_BUSY); show_mouse(screen); /* Initialize stuff */ ... /* Set normal arrow pointer */ select_mouse_cursor(MOUSE_CURSOR_ARROW); SEE ALSO
install_mouse(3alleg4), show_mouse(3alleg4), set_mouse_sprite(3alleg4), gfx_capabilities(3alleg4), enable_hardware_cursor(3alleg4), set_mouse_cursor_bitmap(3alleg4), show_os_cursor(3alleg4), exsyscur(3alleg4) Allegro version 4.4.2 select_mouse_cursor(3alleg4)
Man Page