SETCMAP

NAME
SYNOPSIS
OPTIONS
DESCRIPTION
STANDARD COLOR TABLE
AUTHOR
LIMITATIONS
SEE ALSO
DIAGNOSTICS

NAME

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

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.

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