XRecolorCursor(3X11)	       XLIB FUNCTIONS		 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 specified cursor, and
  if the cursor is being displayed on a screen, the change is visible immedi-
  ately.  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 XQueryBestCur-
  sor function provides a way to find out what size cursors are actually pos-
  sible 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 Cursor.

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

SEE ALSO
  XCreateColormap(3X11), XCreateFontCursor(3X11), XDefineCusor(3X11)
  Xlib - C Language X Interface