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  -  SELECT_MOUSE_CURSOR (3)

NAME

select_mouse_cursor - Tells Allegro to select software or hardware cursor drawing.

CONTENTS

Synopsis
Description
See Also

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_SYSTEM_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(3), show_mouse(3), set_mouse_sprite(3), gfx_capabilities(3), enable_hardware_cursor(3), set_mouse_cursor_bitmap(3), show_os_cursor(3), exsyscur(3)
Search for    or go to Top of page |  Section 3 |  Main Index


Allegro SELECT_MOUSE_CURSOR (3) version 4.4.2

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