
VIEWIMAGE(help)              Khoros               VIEWIMAGE(help)

     VIEWIMAGE -- Introduction

     DESCRIPTION

     Viewimage is an interactive imagery/elevation display pack-
     age; it is a new application that combines capabilities of
     the xprism3 plotting package and the editimage display pack-
     age.  The main purpose of viewimage is to take a Khoros VIFF
     file and use its image data as the imagery.  This data pro-
     vides the "picture" that is displayed, draped over the
     elevation data that is provided via another Khoros VIFF
     file.  It is very important that the VIFF file used for the
     imagery and the VIFF file used for the elevation data be of
     the same size - that is, they must have the same number of
     rows and the same number of columns.

     Viewimage accepts any Khoros VIFF file as its imagery input,
     and will convert the data type of the input image when
     necessary. Currently, viewimage can utilize a maximum of 256
     colors.  Any image that has more than this number of colors
     is converted to fit into the available number of colors with
     the vgamut program.  Note that this conversion will normal-
     ize the image to the total number of colors that are avail-
     able to be displayed on the workstation being used.  For the
     elevation data, viewimage will accept Khoros VIFF files of
     type Byte, Short, Integer, Float, and Double.  Note that the
     same VIFF file may be used as both the imagery data and the
     elevation data;  in this case, only the -i option flag is
     used.

     Viewimage provides all of the same plot types for represent-
     ing elevation data that xprism3 does: 3D, Scatter, Impulse,
     Wireframe, Mesh, Horizon, Surface, 3D Contour, 2D Contour,
     and Color Mesh.  However, when the elevation data is
     displayed as Color Mesh or Surface, the imagery data is used
     to fill in the plot rather than the colors that are used in
     xprism3.  If the display of colors is desired instead, the
     "Use Imagery" option on the "Attributes" subform may be
     turned off.

     Viewimage provides three of the same display utilities that
     are available with editimage;  all of these work with
     respect to the RGB, CMY, HSV, HLS, UVW, XYZ, YIQ, and GREY
     color spaces.  In order to fully understand the information
     imparted by the display utilities of viewimage, it is impor-
     tant for you to have an understanding of the operation of
     each of these color spaces, as well as a feeling for how
     each of the available colorspaces relates to the others.
     For this reason, a brief explanation of each is provided
     under "Colorspaces"; however, a full understanding can only
     be accomplished by the study of appropriate texts, and by
     university courses taken in the field of image processing.
     Viewimage was written with the assumption that the user has
     the knowledge necessary to correctly interpret visual
     results generated and to recognize when those results are
     not valid.  Invalid results can be generated when the
     colorspace of the imagery does not match the colorspace of
     the display;  however, viewimage follows the philosophy that
     it is better to allow the uneducated user to generate
     incorrect results than to limit the experimenting researcher
     with rigid errorchecking.

     RUNNING VIEWIMAGE

     Viewimage can be executed from within cantata, or directly
     from the command line. When using the command line inter-
     face, the imagery data contained in an input VIFF image may
     be specified at the time of execution, or it may be speci-
     fied once the viewimage program is already started. To input
     the imagery data directly from the command line, use the -i
     option flag; to input the elevation data directly from the
     command line, use the -e option flag (see "Options" for
     additional command line options). Alternatively, you may
     start viewimage with no initial images, and use the
     "Input/Output" pane, which is available from the "Image
     Utilities" pulldown menu, to input the desired data.  The
     minimum syntax specification to run viewimage from the com-
     mand line is:

     % viewimage

     Place the viewimage master form with your window manager
     (your window manager may use automatic placement).  The
     viewimage graphical user interface has the same layout as
     that of editimage; it has a workspace attached beneath it,
     in which the elevation data provided as input will immedi-
     ately be plotted as a three dimensional wireframe;  eleva-
     tion data may also be viewed as a 3D plot, a scatter plot,
     an impulse plot, a mesh plot, a horizon plot, a 3D contour
     plot, or a 2D contour plot.  To see the imagery data draped
     over the elevation data, you must use the "Attributes" pane
     of the "VIEW UTILITIES" pull-down menu to change the plot
     type to either a surface plot or a color mesh plot.

     The viewimage master form has two pulldown menus, one
     labeled "DISPLAY UTILITIES", and the other labeled "VIEW
     UTILITIES".

     DISPLAY UTILITIES
          By clicking on "DISPLAY UTILITIES", you can access the
          LUT, Pseudo Color, and Windowing/Threshold subforms,
          from which one can take advantage of these display
          utilities that are identical to those offered by edi-
          timage. From the "DISPLAY UTILITIES" pulldown menu, one
          can also change the image band that is displayed (for
          multiband images).  The "HELP" selection on this pull-
          down menu provides access to online help which gives a
          much more detailed explanation of these features.

     VIEW UTILITIES
          The second pulldown menu, labeled "VIEW UTILITIES",
          provides access to the Input/Output File, Perspective,
          Colormap Conversion, and Attributes features. Again, a
          "HELP" selection on the "VIEW UTILITIES" pulldown menu
          will offer more extensive online help for each of these
          features.

     GLYPH

     Clicking on the "Glyph" button that appears on the upper
     left hand corner of the viewimage master form will cause the
     master form and any displayed subforms to be compacted into
     a small box labeled "Edit".  This allows the user to reduce
     clutter on the screen. The glyphed viewimage program can be
     recovered by clicking the left mouse button inside the
     glyph.

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

Version: 0                 Release: 1                           1

