XRecolorCursor(XS)       X Version 11 (Release 5)         XRecolorCursor(XS)
                                6 January 1993


 Name

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


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

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

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

    widthreturn
    heightreturn  Return the best width and height that is closest to the
                   specified width and height.

 Description

    The XRecolorCursor function changes the color of the specified cursor,
    and if the cursor is being displayed on a screen, the change is visible
    immediately.  Note that the pixel members 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 cursor 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 XQuer-
    yBestCursor 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.  Applications should be prepared to use smaller cursors on
    displays that cannot support large ones.

    XQueryBestCursor can generate a ``BadDrawable'' error.

 Diagnostics


    ``BadCursor''  A value for a Cursor argument does not name a defined Cur-
                   sor.

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

 See also

    XCreateColormap(XS), XCreateFontCursor(XS), XDefineCursor(XS)
    Xlib - C Language X Interface