XStoreNamedColor()XStoreNamedColor()NameXStoreNamedColor – set RGB values of a read/write colorcell by color
name.
Synopsis
XStoreNamedColor(display, colormap, color, pixel, flags)
Display *display;
Colormap colormap;
char *color;
unsigned long pixel;
int flags;
Arguments
display Specifies a connection to an X server; returned from XOpenDis‐
play().
colormap
Specifies the colormap.
color Specifies the color name string (for example, "red"). This
cannot be in hex format (as used in XParseColor()). Uppercase
or lowercase is not important. The string should be in ISO
LATIN-1 encoding, which means that the first 128 character
codes are ASCII, and the second 128 character codes are for
special characters needed in western languages other than Eng‐
lish.
pixel Specifies the entry in the colormap to store color in.
flags Specifies which red, green, and blue indexes are set.
DescriptionXStoreNamedColor() looks up the named color in the database, with
respect to the screen associated with colormap, then stores the result
in the read/write colorcell of colormap specified by pixel. If the
color name is not in the Host Portable Character Encoding, the result
is implementation-dependent. Uppercase or lowercase in name does not
matter. The flags argument, a bitwise OR of the constants DoRed,
DoGreen, and DoBlue, determines which subfields within the pixel value
in the cell are written.
For more information, see Volume One, Chapter 7, Color.
Errors
BadAccess pixel is unallocated or read-only.
BadColor Invalid colormap.
BadName color is not in server's color database.
BadValue pixel is not a valid index into colormap.
See AlsoXDefaultColormap(), XDisplayCells(), XCopyColormapAndFree(), XCreate‐
Colormap(), XFreeColormap(), XGetStandardColormap(), XInstallCol‐
ormap(), XListInstalledColormaps(), XSetStandardColormap(), XSetWindow‐
Colormap(), XUninstallColormap().
Xlib - Window Manager Hints XStoreNamedColor()
