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:
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.
The command line option [-f colormapfile].
.Colormap default value.
The xcolormap file in
/usr/lib/X11.
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 man page.