NAME

XStoreColor − set or change the RGB values of a read/write colormap entry to the closest possible hardware color. 

Synopsis

XStoreColor(display, cmap, colorcell_def)
Display *display;
Colormap cmap;
XColor *colorcell_def;

Arguments

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

cmapSpecifies the colormap. 

colorcell_def
Specifies a pixel value and the desired RGB values.

Description

XStoreColor() changes the RGB values of a colormap entry specified by colorcell_def.pixel to the closest values possible on the hardware.  This pixel value must be a read/write cell and a valid index into cmap.  XStoreColor() changes the red, green, and/or blue color components in the cell according to the colorcell_def.flags member, which you set by ORing the constants DoRed, DoGreen, and/or DoBlue.  If the colormap is an installed map for its screen, the changes are visible immediately.  For more information, see Volume One, Chapter 7, Color. 

Structures

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

Errors

BadAccessA specified pixel is unallocated or read-only. 

BadColorInvalid colormap. 

BadValuepixel not valid index into cmap. 

See Also

BlackPixel(), WhitePixel(), XAllocColor(), XAllocColorCells(), XAllocColorPlanes(), XFreeColors(), XLookupColor(), XParseColor(), XQueryColor(), XQueryColors(), XStoreColors(),

Copyright O’Reilly & Assoc.  —