
VIEWIMAGE(help)              Khoros               VIEWIMAGE(help)

     COMMAND LINE OPTIONS

     The full syntax for executing viewimage from the command
     line is as follows:

     viewimage

             -i  input image filename  (infile)

             [-e]  image with alternate elevation coordinates
     (infile) [null]
             [-x]  x value of upper-left corner of image
     (integer, -1 to 1000) [-1]
             [-y]  y value of upper-left corner of image
     (integer, -1 to 1000) [-1]
             [-update]  initial update time (float, > 0.0) [2]
             [-display]  host:display.screen (string) [null]
             [-cmap_image]  image with alternate colormap
     filename (infile) [null]
             [-use_cmap]  use colormap? (boolean) [true]
             [-prop]  use proportional plotting (makes the data
     be a unit cube) (boolean) [true]

             [-V] Gives the version for viewimage
             [-U] Gives the usage for viewimage
             [-P] Prompts for command line options
             [-A [file1]] Creates the answer file called
     viewimage.ans or file1
             [-a [file1]] Uses viewimage.ans or file1 as the
     answer file

     -i {input image filename}
          This is the input image that will provide the imagery
          to be displayed with viewimage.  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 viewimage, 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.

     [-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.

     [-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.

     [-update {update time}]
          Suppose that while you are using a particular VIFF
          image as the imagery data with viewimage, the VIFF file
          is over-written.  When the [-update] flag is specified
          as some number greater than zero (the default), this
          indicates to viewimage that it should automatically
          register the fact that the input file has been changed,
          and update the currently displayed imagery data accord-
          ingly.  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),
          viewimage will NOT check the input file for modifica-
          tions.

     [-display host:display]
          You may execute viewimage on one workstation, but
          display it on another.  If you wish to do this, you
          must specify the display on which viewimage will
          appear.  It must be specified as "-display
          host:screen".

     [-cmap_image {image with alternate colormap}]
          If desired, another image may be input, and its color-
          map 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 pro-
          vided is a Khoros VIFF file with the desired colormap;
          the image data in this file will be ignored.

     [-use_cmap {t/f, 0/1}]
          While the default action of viewimage is to use the
          colormap associated with the imagery data file, no
          colormap is required to be used.  If the colormap asso-
          ciated 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 viewimage
          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.

     [-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 "Propor-
          tional Plotting" to FALSE.

     Version
          The "-V" argument will print out the current version of
          viewimage.

     Usage
          The "-U" argument will print out the usage for viewim-
          age, in much less detail than is given here.

     Interactive Prompting
          The "-P" argument will give interactive prompting for
          each of the arguments listed above.

     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 argu-
          ments listed above.  Note: the "-A" argument is usually
          used in conjunction with the "-P" argument.

     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.  Edi-
          timage 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.

          Copyright 1991, University of New Mexico. All rights
          reserved.

Version: 0                 Release: 1                           1

