hpux man page for xstorecoloa

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.

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
  BadAccess A specified pixel is unallocated or read-only.

  BadColor  Invalid colormap.

  BadValue  pixel not valid index into cmap.

See Also
  XBlackPixel(),  XWhitePixel(),  XAllocColor(),  XAllocColorCells(), XAllocColorPlanes(), XAllocNamedColor(), XFreeColors(), XLookupColor(),
  XParseColor(), XQueryColor(), XQueryColors(), XStoreColors(), XStoreNamedColor().

Xlib - Color Cells														     XStoreColor()