SETCMAP

setcmap - define the standard colormap on an X Windows graphics display

SYNOPSIS

setcmap [options]

OPTIONS

The following options can be specified:

-help

Print usage.

-display host:dpy[.screen]

Specifies the display to set the colormap of. The value of the environment variable DISPLAY is taken as default.

	-cf colorfile		Do not use the internal list of 32 colors, but this list. Note that the order of the colors is very important. The first 8 colors are normally Black, Red, Green, Yellow, Blue, Magenta, Cyan and White. At least 8 colors must be specified. It is possible to specify a maximum of 128 different colors. If you use a set of 16 colors, you get one more "white" plane if 5 or 7 bitplanes are used.
	-rgb rgbfile		Different RGB-values may be specified for the used colors. A file in the format like X11 "rgb.txt". Normally the "rgb.txt" file on the server is used for RGB-values. Be careful, the library routines can not use this new rgbfile, and are using another to map colornames to RGB-values. If there are too big differences in the RGB-values, wrong colormap entries may be used!
	-3		Set a 3 bit plane colormap instead of the maximum available. The last occurrence of -3, -5 and -7 overrides previous bit plane specifications.
	-5		Set a 5 bit plane colormap instead of the maximum available. The last occurrence of -3, -5 and -7 overrides previous bit plane specifications.
	-7		Set a 7 bit plane colormap instead of the maximum available. The last occurrence of -3, -5 and -7 overrides previous bit plane specifications.
	-f		Replace the colormap with a new one if it already exists. Without this option nothing happens if the colormap already exists.
	-p		Print the current CACD colormap.
	-r		Remove the current CACD colormap.
	-s		Run in silent mode; no informative messages are printed.
	-v		Run in verbose mode; print additional status information.

DESCRIPTION

Setcmap sets, replaces, removes or prints the Nelsis ICD CACD colormap on an X Windows graphics display. Its normal behaviour is to set the CACD colormap with the largest number of bitplanes supported by the display, unless the CACD colormap already existed then it just returns. This behaviour can be changed using the options described above.

STANDARD COLOR TABLE

The following standard set of 32 color names is used by the program: Black, Red, Green, Yellow, Blue, Magenta, Cyan, White, Grey, Khaki, Coral, Sienna, Firebrick, Orange, VioletRed, Navy, LightGrey, CadetBlue, Violet, Gold, Goldenrod, Maroon, Orchid, Pink, Plum, Salmon, Tan, Thistle, Turquoise, Brown, Aquamarine and DarkGreen.

AUTHOR

P. Bingley S. de Graaf (V4.0)

LIMITATIONS

Currently setcmap can only set 3, 5 or 7 bitplane colormaps.

SEE ALSO

cmapintro(5ICD),

DIAGNOSTICS

Setcmap tells the user what's happening, unless -s is specified. If the program runs successfully it exits with exit status zero, otherwise the exit status is non-zero.