XRecolorCursor(3X11)

NAME
       XRecolorCursor, XFreeCursor, XQueryBestCursor - manipulate
       cursors

SYNTAX
       XRecolorCursor(display, cursor, foreground_color,
       background_color)
             Display *display;
             Cursor cursor;
             XColor *foreground_color, *background_color;

       XFreeCursor(display, cursor)
             Display *display;
             Cursor cursor;

       Status XQueryBestCursor(display, d, width, height,
       width_return, height_return)
             Display *display;
             Drawable d;
             unsigned int width, height;
             unsigned int *width_return, *height_return;

ARGUMENTS
       background_color
                 Specifies the RGB values for the background of
                 the source.

       cursor    Specifies the cursor.

       d         Specifies the drawable, which indicates the
                 screen.

       display   Specifies the connection to the X server.

       foreground_color
                 Specifies the RGB values for the foreground of
                 the source.

       width
       height    Specify the width and heightof the cursor that
                 you want the size information for.

       width_return
       height_return
                 Return the best width and height that is closest
                 to the specified width and height.

DESCRIPTION
       The XRecolorCursor function changes the color of the spec-
       ified cursor, and if the cursor is being displayed on a
       screen, the change is visible immediately.  The pixel mem-
       bers of the XColor structures are ignored; only the RGB
       values are used.

       XRecolorCursor can generate a BadCursor error.

       The XFreeCursor function deletes the association between
       the cursor resource ID and the specified cursor.  The cur-
       sor storage is freed when no other resource references it.
       The specified cursor ID should not be referred to again.

       XFreeCursor can generate a BadCursor error.

       Some displays allow larger cursors than other displays.
       The XQueryBestCursor function provides a way to find out
       what size cursors are actually possible on the display.
       It returns the largest size that can be displayed.  Appli-
       cations should be prepared to use smaller cursors on dis-
       plays that cannot support large ones.

       XQueryBestCursor can generate a BadDrawable error.

DIAGNOSTICS
       BadCursor A value for a Cursor argument does not name a
                 defined Cursor.

       BadDrawable
                 A value for a Drawable argument does not name a
                 defined Window or Pixmap.

SEE ALSO
       XCreateColormap(3X11) XCreateFontCursor(3X11) XDefineCu- 
       sor(3X11) 
       Xlib - C Language X Interface