NAME

scmapc -- Convert an SAOimage colormap file to an image.

USAGE

scmapc saocmap cmapimg

DESCRIPTION

This task converts an SAOimage colormap file to an image. This image may then be passed to the vdisplay.celco task to replicate colors displayed by SAOimage in a color photograph produced with the Celco film recorder. An SAOimage colormap file is a text file containing a functional representation of the colormap used by SAOimage. The data represent "nodes" in graphs of the input pixel value versus output intensity for each color. An optional "gamma" value may be present to modify the linear functional relationship. The output colormap is a standard IRAF image. The rows in this 256 x 3 image represent the red, green, and blue maps, respectively, containing floating point data values scaled to the range zero to one.

PARAMETERS

saocmap = "STDIN" [file name]

The colormap file (produced by SAOimage). This represents "nodes" in graphs of the input pixel value versus output intensity for each color, optionally modified by a "gamma" value.

cmapimg = "cmap.hhh" [file name]

The filename of the output colormap image. The rows in this 256 x 3 image represent the red, green, and blue maps, respectively. The floating point data values are scaled to the range zero to one.

(fullrange = no) [boolean]

Apply the SAOimage colormap to the full intensity range?

If this is set to "no", then use only the entries 1:200 for gray level values. This is useful for ensuring correct rendition of an image dumped directly from the display window, in which only 200 color values are reserved for the image pixel values. The remainder are either overlay graphics colors or reserved for the other windows on the screen.

(listmap = no) [boolean]

Write the map values to STDOUT?

If listmap = yes, print the color map to the standard output (the terminal), one group of red, green, and blue values per line.

(debug = 0) [integer, min = 0, max = 3]

Write additional output to standard error (STDERR). The higher the number, the more information is printed, up to each token parsed from the input file.

EXAMPLES

1. Assume that the file bwgam.scm contains the following:

# SAOimage color table
# dev$pix - m51  B  600s
# Wed Feb 26 15:06:25 1992
PSEUDOCOLOR
RED: gamma 1.5
(0.000,0.000)(1.000,1.000)
GREEN: gamma 1.5
(0.000,0.000)(1.000,1.000)
BLUE: gamma 1.5
(0.000,0.000)(1.000,1.000)

pl> scmapc bwgam.scm bwgam.hhh

SEE ALSO

dstoim, saodump