Initializing the Colormap with xinitcolormap

The xinitcolormap client initializes the X colormap. Specific X colormap entries (pixel values) are made to correspond to specified colors. An initialized colormap is required by applications that assume a predefined colormap (for example, many applications that use Starbase graphics).

xinitcolormap has the following syntax: xinitcolormap [<options>]

where the <options> are:

-f <colormapfile>

Specifies a file containing a colormap. -display <display>

Specifies the server to connect to. -c <count>

Only the first count colors from the colormap file will be used if this parameter is specified. -k or -kill

Deallocate any colormap entries that were allocated by a previous run of xinitcolormap.

xinitcolormap choses a colormap file in the order shown below. Once one is found, then the other sources aren't searched.

1.The command line option [-f <colormapfile>].

2.

.Colormap default value.

3.The xcolormap file in /usr/lib/X11.

4.If no colormap file is found, this default colormap specification is assumed - black (colormap entry 0), white, red yellow, green, cyan, blue, magenta (colormap entry 7).

xinitcolormap should be the first client program run at the start of a session in order to assure that colormap entries have the color associations specified in the colormap file. Sometimes you may encounter this X toolkit warning:

X Toolkit Warning: cannot allocate colormap entry for 94c4d0

where "94c4d0" is a color specified in the application running. If this occurs, it means that you have probably reached the limit of colors for your graphics card/display combination. Executing xinitcolormap may solve the problem.

For more information about xinitcolormap, refer to its reference page.

Page 87

Graphics Administration Guide for HP-UX 10.20