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.
       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



X Version 11               Release 6.4                          1