Level 2 Help for CONVIM

NAME

The symbolic name of the tape drive from which the data is to 
be read.  Must be the same name used in the TAE MOUNT command.

Example:
	TAE>ALLOC MTA0 TAPE
	TAE>MOUNT TAPE
	TAE>CONVIM TAPE A


OUT

The names of the VICAR2 files to which the tape data sets are to 
be written.  There must be at least as many output file names 
given as input data sets to be read.  Any additional file names
will be ignored.

Example:  FILES=(4,5,6) OUT=(RED,GREEN,BLUE) 

would copy file number 4 to RED, file number 5 to GREEN,
and file number 6 to BLUE.


FILES

Each number indicates the files to be read from the tape.

For example, FILES=(4,6,8) would read the fourth, sixth, and eighth
files from the input tape.  There must be a corresponding number of
outputs. 


WINDOW

A window into the input file which is to be written to the output
file.  WINDOW is in the standard size field format,

	WINDOW=(SL,SS,NL,NS) where

	SL is the starting line to read for output
	SS is the starting sample to read for output
	NL is the number of lines to be written
	NS is the number of samples to be written.

To default a field in WINDOW, it may be left out or set to 0.
For example, WINDOW=(5,1,0,10) would default the number of lines
in the window to the true number of lines in the image.
WINDOW=(5,5) would default both NL and NS.
The defaults are

	SL -- 1
	SS -- 1
	NL -- Total NL in input
	NS -- NS from the label if labeled input, logical record
              length if unlabeled.  See defaults for RECLEN.


NL

Number of lines to be used unconditionally for every image read
from the tape.  If the actual number of lines is less than NL, 
only the actual number will be read.  If the actual number is 
larger than NL, then only NL lines will be read.  

NL's primary purpose is to provide an image size for unlabeled images.
It provides information about the input image only, and does not
provide a window into the input.


RECLEN

The number of bytes (NOT samples!) per line to be used unconditionally
as the logical record length of each input file.  RECLEN is used to 
unblock blocked tapes, not to determine the image size.

The defaults for RECLEN are as follows:

    For a labeled input:  NS from the label

    For an unlabeled input:  The physical block size on the tape

If the logical record length of the tape is different from the 
line length of the input image, RECLEN MUST be given in order for 
the data to come out correct.


FORMAT

FORMAT is used to specify a pixel format to be used unconditionally
for every image to be read.  The valid values are:

	BYTE		1 byte unsigned integer
	HALF		2 byte signed integer
	FULL		4 byte signed integer
	REAL		4 byte floating point
	REAL8		8 byte floating point (Not yet available)
	COMPLEX		2 4 byte floating points

For labeled inputs, the default format is taken from the label.
For unlabeled inputs, the default format is BYTE.


LABEL

The keyword LABEL is used to force all input files to have image
labels on output, whether or not they had one on input.  

For unblocked images, if NL, RECLEN, or FORMAT are not specified,
the system information is taken from the block format of the tape,
assuming one record per block.