Re: [AD] OS cursor followup

[Evert Glebbeek <eglebbk@xxxxxxxxxx>]

On Wednesday 29 December 2004 11:08, Evert Glebbeek wrote:
> Commited the attached, very slightly modified, patch. Still lacks 
> documentation.

Documentation attached.

Evert

Index: docs/src/allegro._tx
===================================================================
RCS file: /cvsroot/alleg/allegro/docs/src/allegro._tx,v
retrieving revision 1.286
diff -u -r1.286 allegro._tx
--- docs/src/allegro._tx	4 Jan 2005 17:09:10 -0000	1.286
+++ docs/src/allegro._tx	5 Jan 2005 21:58:09 -0000
@@ -2456,7 +2456,7 @@
    reliable results again.
 
 @@void @select_mouse_cursor(int cursor);
-@domain.hid install_mouse, show_mouse, set_mouse_sprite, gfx_capabilities, enable_hardware_cursor
+@xref install_mouse, show_mouse, set_mouse_sprite, gfx_capabilities, enable_hardware_cursor, set_mouse_cursor_bitmap
 @shortdesc Tells Allegro to select software or hardware cursor drawing.
    With this function, you can instruct Allegro to use the native system 
    cursors rather than Allegro's custom cursor. You will need to enable this
@@ -2503,6 +2503,13 @@
    select_mouse_cursor(MOUSE_CURSOR_ARROW);
 <endblock>
 
+@@void @set_mouse_cursor_bitmap(int cursor, BITMAP *bmp);
+@xref install_mouse, show_mouse, set_mouse_sprite, gfx_capabilities, enable_hardware_cursor
+@shortdesc Changes the image Allegro uses for mouse cursors.
+   This function changes the cursor image Allegro uses if select_mouse_cursor()
+   is called but no native OS cursor can be used, for instance because you
+   did not call enable_hardware_cursor().
+
 @@extern volatile int @mouse_x;
 @@extern volatile int @mouse_y;
 @@extern volatile int @mouse_z;