hpux man page for xstorecolob

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 XOpenDisplay().

  colormap
	   Specifies the colormap.

  color    Specifies an array of color definition structures.

  ncolors  Specifies 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 pix-
  els 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 Also
  XBlackPixel(),  XWhitePixel(),  XAllocColor(),  XAllocColorCells(), XAllocColorPlanes(), XAllocNamedColor(), XFreeColors(), XLookupColor(),
  XParseColor(), XQueryColor(), XQueryColors(), XStoreColor(), XStoreNamedColor().

Xlib - Color Cells														    XStoreColors()