This function has been superseded by XGetRGBColormaps().


Status XGetStandardColormap(display, w, colormap_return, property)
      Display *display;
      Window w;
      XStandardColormap *colormap_return;
      Atom property;	/* RGB_BEST_MAP, etc. */


display Specifies the connection to the X server.
w Specifies the window.
colormap_return Returns the colormap associated with the specified atom.
property Specifies the property name.


The XGetStandardColormap() function returns the colormap definition associated with the atom supplied as the property argument. XGetStandardColormap() returns a nonzero status if successful and zero otherwise. For example, to fetch the standard GrayScale colormap for a display, you use XGetStandardColormap() with the following syntax:
XGetStandardColormap(dpy, DefaultRootWindow(dpy), &cmap, XA_RGB_GRAY_MAP);
See section "Standard Colormaps" for the semantics of standard colormaps.

XGetStandardColormap() can generate BadAtom and BadWindow errors.


BadAtom A value for an Atom argument does not name a defined Atom.
BadWindow A value for a Window argument does not name a defined Window.

See also

"Compatibility Functions".
Christophe Tronche, ch@tronche.com