hpux man page for xrecolorcursor

XRecolorCursor()														  XRecolorCursor()

Name
  XRecolorCursor - change the color of a cursor.

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

Arguments
  display   Specifies a connection to an X server; returned from XOpenDisplay().

  cursor    Specifies the cursor ID.

  foreground_color
	    Specifies the red, green, and blue (RGB) values for the foreground.

  background_color
	    Specifies the red, green, and blue (RGB) values for the background.

Description
  XRecolorCursor() applies a foreground and background color to a cursor.  Cursors are normally created using a single plane pixmap, composed
  of 0's and 1's, with one pixel value assigned to 1's and another assigned to 0's.  XRecolorCursor() changes these  pixel  values.   If  the
  cursor  is  being  displayed	on a screen, the change is visible immediately.  On some servers, these color selections are read/write cells
  from the colormap, and can't be shared by applications.

Structures
     typedef struct {
	 unsigned long pixel;
	 unsigned short red, green, blue;
	 char flags;	/* DoRed, DoGreen, DoBlue */
	 char pad;
     } XColor;

Errors
  BadCursor

See Also
  XCreateFontCursor(), XCreateGlyphCursor(), XCreatePixmapCursor(),  XDefineCursor(),  XFreeCursor(),  XQueryBestCursor(),  XQueryBestSize(),
  XUndefineCursor().

Xlib - Cursors															  XRecolorCursor()