.PP
The full syntax for executing \fBviewimage\fP from the command line 
is as follows:
.sp
viewimage
.sp
        -i  input image filename  (infile)
.sp
        [-e]  image with alternate elevation coordinates (infile) [null]
.br
        [-x]  x value of upper-left corner of image (integer, -1 to 1000) [-1]
.br
        [-y]  y value of upper-left corner of image (integer, -1 to 1000) [-1]
.br
        [-update]  initial update time (float, > 0.0) [2]
.br
        [-display]  host:display.screen (string) [null]
.br
        [-cmap_image]  image with alternate colormap filename (infile) [null]
.br
        [-use_cmap]  use colormap? (boolean) [true]
.br
        [-prop]  use proportional plotting (makes the data be a unit cube) (boolean) [true]
.sp
        [-V] Gives the version for viewimage
.br
        [-U] Gives the usage for viewimage
.br
        [-P] Prompts for command line options
.br
        [-A [file1]] Creates the answer file called viewimage.ans or file1
.br
        [-a [file1]] Uses viewimage.ans or file1 as the answer file
.sp 2
.IP "-i {input image filename}":
This is the input image that will provide the imagery to be displayed with
\fBviewimage\fP.  It must be specified as "-i filename", where the file
provided is a Khoros VIFF file.  The VIFF file may be of any data type
except complex. The data in this file is referred to as "imagery" in the
context of \fBviewimage\fP, as it provides the image that is draped on top of
the elevation data specified with the [-e] option.  If the [-e] option is not
used, the image data in this input image is used as both the imagery and the
elevation data.
.IP "[-e {image with alternate elevation coordinates}]":
This is the input image that provides the elevation data over which the imagery
is to be draped.  It must be specified as "-e filename", where the file
provided is a Khoros VIFF file of type Byte, Short, Integer, Float, or Double.  
When this argument is not specified, the input image specified with "-i 
filename" (see above) is used as both the imagery and the elevation data.
.IP "[-x {x value}, -y {y value}]"
In the event that manual placement of the graphical user interface is not
used, these (x,y) coordinates specify the location where the graphical user
interface is to be placed.
.IP "[-update {update time}]"
Suppose that while you are using a particular VIFF image as the imagery data
with \fBviewimage\fP, the VIFF file is over-written.  When the [-update] flag
is specified as some number greater than zero (the default), this indicates
to \fBviewimage\fP that it should automatically register the fact that the 
input file has been changed, and update the currently displayed imagery data 
accordingly.
The value of the [-update] flag specifies (in seconds) how often the input file
is to be checked for any potential modifications.    It should be specified
"-update floatvalue", where floatvalue is a floating point value which is
greater than zero.  When the value of the [-update] flag is zero (the default
value), \fBviewimage\fP will NOT check the input file for modifications.
.IP "[-display host:display]"
You may execute \fBviewimage\fP on one workstation, but display it on another.
If you wish to do this, you must specify the display on which \fBviewimage\fP 
will appear.  It must be specified as "-display host:screen".
.IP "[-cmap_image {image with alternate colormap}]"
If desired, another image may be input, and its colormap will be used with the
imagery data, instead of the input imagery data VIFF file's colormap.
It must be specified as "-cmap_image filename" where the file provided
is a Khoros VIFF file with the desired colormap; the image data in this file
will be ignored.
.IP "[-use_cmap {t/f, 0/1}]"
While the default action of \fBviewimage\fP is to use the colormap associated 
with the imagery data file, no colormap is required to be used.
If the colormap associated with the imagery data is not wanted,
AND the "-cmap_image filename" is not used, specify "-use_cmap 0", or
"-use_cmap false".  In this case, the default colormap associated with the
screen on which \fBviewimage\fP is being run will be used. NOTE:  when "Use
Colormap" is specified as false, the "-cmap_image filename" option detailed
above WILL NOT TAKE EFFECT.
.IP "[-prop {t/f, 0/1}]"
This option causes the elevation data to be mapped to a unit cube;  that is, 
it normalizes the X, Y, and Z information to be equidistant values.  
The default value is TRUE.  Remember that if you want the actual X, Y, and 
Z values of your elevation data, you must specify this option as FALSE, or
use the "Attributes" pane of the "VIEW UTILITIES" pull-down menu to set
"Proportional Plotting" to FALSE. 
.IP "Version"
The "-V" argument will print out the current version of \fBviewimage\fP.
.IP "Usage"
The "-U" argument will print out the usage for \fBviewimage\fP, in much less
detail than is given here.
.IP "Interactive Prompting"
The "-P" argument will give interactive prompting for each of the arguments
listed above.
.IP "Creating an Answer file"
The "-A [filename]" argument will create an answer file named "filename" if
the filename option is specified, or named "viewimage.ans" if no filename
is given.  An answer file stores the values specified of all arguments listed
above.  Note: the "-A" argument is usually used in conjunction with the "-P"
argument.
.IP "Using an Answer file"
The "-a [filename]" argument will use the answer file named "filename"
if the filename option is specified, or named "viewimage.ans" if no filename
is given.  Editimage will use the answer file to get values for all
arguments listed above.  No other arguments should be necessary when the "-a"
argument is used.
