XStoreColor()XStoreColor()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
display Specifies a connection to an X server; returned from
XOpenDisplay().
cmap Specifies the colormap.
colorcell_def
Specifies a pixel value and the desired RGB values.
DescriptionXStoreColor() 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
BadAccess A specified pixel is unallocated or read-only.
BadColor Invalid colormap.
BadValue pixel not valid index into cmap.
See AlsoXBlackPixel(), XWhitePixel(), XAllocColor(), XAllocColorCells(), XAl‐
locColorPlanes(), XAllocNamedColor(), XFreeColors(), XLookupColor(),
XParseColor(), XQueryColor(), XQueryColors(), XStoreColors(), XStore‐
NamedColor().
Xlib - Color Cells XStoreColor()