xallocstandardcolormap(3) hpux man page | unix.com

XAllocStandardColormap()												  XAllocStandardColormap()

Name
  XAllocStandardColormap - allocate an XStandardColormap structure.

Synopsis
  XStandardColormap *XAllocStandardColormap( )

Returns
  The allocated structure.

Availability
  Release 4 and later.

Description
  XAllocStandardColormap() allocates and returns a pointer to an XStandardColormap structure for use in calling XGetRGBColormaps() or XSetRG-
  BColormaps().  Note that all fields in the XStandardColormap structure are initially set to zero.  If  insufficient  memory  is  available,
  XAllocStandardColormap() returns NULL.  To free the memory allocated to this structure, use XFree().

  The  purpose	of  this function is to avoid compiled-in structure sizes, so that object files will be binary compatible with later releases
  that may have new members added to structures.

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

Structures
  /* value for killed field */
  #define     ReleaseByFreeingColormap	 ( (XID) 1L)

  typedef struct {
       Colormap colormap;
       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;

See Also
  XGetRGBColormaps(), XSetRGBColormaps().

Xlib - Window Manager Hints												  XAllocStandardColormap()