Manual Pages for UNIX Operating System command usage for man XRecolorCursor

XLIB FUNCTIONS                               XRecolorCursor(3x11)



NAME
     XRecolorCursor, XFreeCursor, XQueryBestCursor - manipulate
     cursors

SYNTAX
     cc [ flag... ] file... -lX11 [ library... ]

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

     int XFreeCursor(Display *display, Cursor cursor);

     Status XQueryBestCursor(Display *display, Drawable d,
          unsigned int width, unsigned int height, unsigned int
          *width_return, unsigned int *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 speci-
     fied cursor, and if the cursor is being displayed on a
     screen, the change is visible immediately.  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



X Version 11        Last change: libX11 1.3.5                   1






XLIB FUNCTIONS                               XRecolorCursor(3x11)



     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.  Applica-
     tions 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 Cursor.

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

SEE ALSO
     XCreateColormap(3x11), XCreateFontCursor(3x11),
     XDefineCursor(3x11)
     Xlib - C Language X Interface


ATTRIBUTES
     See attributes(5) for descriptions of the following attri-
     butes:

     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | Availability                | x11/library/libx11          |
    |_____________________________|_____________________________|
    | Interface Stability         | Committed                   |
    |_____________________________|_____________________________|
    | MT-Level                    | See XInitThreads(3X11)      |
    |_____________________________|_____________________________|














X Version 11        Last change: libX11 1.3.5                   2