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

displaySpecifies a connection to an X server; returned from XOpenDisplay(). 

cursorSpecifies 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(). 

Copyright O’Reilly & Assoc.  —