HPlogo Using the X Window System > Chapter 8 Using the X Clients

Initializing the Colormap with `xinitcolormap'

» 

Technical documentation

Complete book in PDF

 » Table of Contents

 » Glossary

 » Index

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 man page.

© 1995 Hewlett-Packard Development Company, L.P.