vcmerge − Merge images into a color mapped image

vcmap [if=infile] [of=ofile] [lf=lutfile] -g

Vcmerge Combine two images into a color index file. A common use of this is to annotate a grey-level image with color graphics (ig=). The program maps the if= image into the high half of the index range and the ig file into the lower half of the index range and compresses any existing lut file (by discarding every second value until it fits. Lut files are expected to have 256 elements. The resulting file is always a color index file. The program is based on vop(1) and can add an annotation file to a set of image files.

The default action is to read a lutfile (default "split"). If the -l option is specified then existing luts in the files (gray scale luts for byte files will be created) are merged.

If a specified lutfile cannot be found in the current directory the VisionX standard etc directory is checked with the specified name and a .lut extension.

Input images must be byte images or color-index images

if=file

This is the first input image and will be mapped to the high (128) color index values. if=file This is the second input image (usually the annotation image and will be mapped to the low (128) color index values.

lf=file

This option specifies a color map file, The resulting image will be encoded with the given color map.

-l

do not read or default a lut file, the LUT files will be obtained from the input files.

fm=

Use a multiplier for a (byte) if= input file default is 1.0 (default for -g is 0.7). Should not be used with color index input files

gm=

Use a multiplier for a (byte) ig= input file; default is 1.0. Should not be used with color index input files

-g

Create a image with only a grey-value lut. This is most useful when adding a single graphic to a grey level image for a grey level (non-color) document. By default fm is set to 0.7 in this case so the the graphic (with value 255) will be clearly visible. The lf= parameter will be ignored.

A. P. Reeves