XStoreColors()XStoreColors()Name
XStoreColors – set or change the RGB values of read/write colorcells to
the closest possible hardware colors.
Synopsis
XStoreColors(display, colormap, color, ncolors)
Display *display;
Colormap colormap;
XColor color[ncolors];
int ncolors;
Arguments
display Specifies a connection to an X server; returned from XOpenDis‐
play().
colormap
Specifies the colormap.
color Specifies an array of color definition structures.
ncolors Specifies the number of XColor structures in color.
DescriptionXStoreColors() changes the RGB values of each colormap entry specified
by color[].pixel to the closest possible hardware colors. Each pixel
value must be a read/write cell and a valid index into colormap.
XStoreColors() changes the red, green, and/or blue color components in
each cell according to the color[].flags member, which you set by ORing
the constants DoRed, DoGreen, and/or DoBlue. The specified pixels are
changed if they are writable by any client, even if one or more pixels
generates an error.
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 A specified pixel is not a valid entry into colormap.
See AlsoXBlackPixel(), XWhitePixel(), XAllocColor(), XAllocColorCells(), XAl‐
locColorPlanes(), XAllocNamedColor(), XFreeColors(), XLookupColor(),
XParseColor(), XQueryColor(), XQueryColors(), XStoreColor(), XStore‐
NamedColor().
Xlib - Color Cells XStoreColors()