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

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

colormapSpecifies the colormap. 

colorSpecifies an array of color definition structures. 

ncolorsSpecifies the number of XColor structures in color. 

Description

XStoreColors() 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

BadAccessA specified pixel is unallocated or read-only. 

BadColorInvalid colormap. 

BadValueA specified pixel is not a valid entry into colormap. 

See Also

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

Copyright O’Reilly & Assoc.  —