SETCMAP(1ICD)

NAME
setcmap - define the standard ICD CACD colormap on a X Window 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.

-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 CACD colormap on a X window 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.

AUTHOR
P. Bingley

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.