defcursor(3G)

NAME
     defcursor - defines a cursor glyph

C SPECIFICATION
     void defcursor(n, curs)
     short n;
     unsigned short *curs;

PARAMETERS
     n      expects the constant you want to assign as a cursor name. By
            default, an arrow is defined as cursor 0 and cannot be redefined.

     curs   expects the bitmap for the cursor you want to define.  The bitmap
            can be 16x16 or 32x32 and either one or two layers deep. This
            parameter is ignored for cross-hair cursors.

DESCRIPTION
     defcursor defines a cursor glyph with the specified name and bitmap. Call
     curstype prior to calling defcursor to set the type and size of cursor it
     defines.  The name parameter n is used to identify the cursor glyph to
     other cursor routines.  A subsequent call to defcursor with the same
     value of n will replace the current definition of the cursor with the new
     one.

     By default, the cursor origin of a bitmap cursor is at (0,0), its lower-
     left corner, and the cursor origin of a cross-hair cursor is at (15,15),
     the intersection of its two lines.  Use curorigin to set the cursor
     origin to somewhere else.  The cursor origin is the position controlled
     by valuators attached to the cursor, and is also the position pick uses
     for the picking region.

SEE ALSO
     curorigin, curstype, getcursor, getgdesc, pick, setcursor

NOTES
     This routine is available only in immediate mode.

     Some models do not support two-layer cursor bitmaps.  Use the getgdesc
     inquiry GD_BITS_CURSOR to determine how many layers are supported.