xfreecolormap(3) [hpux man page]

XFreeColormap() 														   XFreeColormap()

Name
  XFreeColormap - delete a colormap and install the default colormap.

Synopsis
  XFreeColormap(display, colormap)
	Display *display;
	Colormap colormap;

Arguments
  display   Specifies a connection to an X server; returned from XOpenDisplay().

  colormap  Specifies the colormap to delete.

Description
  XFreeColormap()  destroys the specified colormap, unless it is the default colormap for a screen.  That is, it not only uninstalls colormap
  from the hardware colormap if it is installed, but also frees the associated memory including the colormap ID.

  XFreeColormap() performs the following processing:

  o  If colormap is an installed map for a screen, it uninstalls the colormap (see XUninstallColormap()).

  o  If colormap is defined as the colormap attribute for a window (by XCreateWindow() or XChangeWindowAttributes()), it changes the colormap
     attribute	for  the  window to the constant None, generates a ColormapNotify event, and frees the colormap.  The colors displayed with a
     colormap of None are server-dependent, since the default colormap is normally used.

  For more information, see Volume One, Chapter 7, Color.

Errors
  BadColor  Invalid colormap.

See Also
  XDefaultColormap(), XDisplayCells(), XCopyColormapAndFree(), XCreateColormap(), XGetStandardColormap(), XInstallColormap(), XListInstalled-
  Colormaps(), XSetStandardColormap(), XSetWindowColormap(), XUninstallColormap().

Xlib - Colormaps														   XFreeColormap()

XGetStandardColormap()													    XGetStandardColormap()

Name
  XGetStandardColormap - get the standard colormap property.

Synopsis
  Status XGetStandardColormap(display, w, cmap_info_return, property)
	Display *display;
	Window w;
	XStandardColormap *colormap_return;
	Atom property;

Arguments
  display   Specifies a connection to an X server; returned from XOpenDisplay().

  w	    Specifies the ID of the window on which the property is set.  This is normally the root window.

  colormap_return
	    Returns the filled colormap information structure.

  property  Specifies  the atom indicating the type of standard colormap desired. The predefined standard colormap atoms are XA_RGB_BEST_MAP,
	    XA_RGB_RED_MAP, XA_RGB_GREEN_MAP, XA_RGB_BLUE_MAP, XA_RGB_DEFAULT_MAP, and XA_RGB_GRAY_MAP.

Returns
  Zero on failure, non-zero on success.

Description
  XGetStandardColormap() is superseded by XGetRGBColormaps() in Release 4.  XGetStandardColormap() gets a property on the  root  window  that
  describes a standard colormap.  XGetStandardColormap() returns zero if it fails, or non-zero if it succeeds.

  See Volume One, Chapter 7, Color, for a complete description of standard colormaps.

Structures
     typedef struct {
	 Colormap colormap;   /* ID of colormap created by XCreateColormap */
	 unsigned long red_max;
	 unsigned long red_mult;
	 unsigned long green_max;
	 unsigned long green_mult;
	 unsigned long blue_max;
	 unsigned long blue_mult;
	 unsigned long base_pixel;
	 VisualID visualid;
	 XID killid;
     } XStandardColormap;

Errors
  BadAtom
  BadWindow

See Also
  XDefaultColormap(),  XDisplayCells(),  XCopyColormapAndFree(),  XCreateColormap(),  XFreeColormap(), XInstallColormap(), XListInstalledCol-
  ormaps(), XSetStandardColormap(), XSetWindowColormap(), XUninstallColormap().

Xlib - Colormaps													    XGetStandardColormap()