
EDITIMAGE(help)              Khoros               EDITIMAGE(help)

     EDITIMAGE -- Introduction

     DESCRIPTION

     Editimage is an interactive image display, examination, and
     manipulation tool.  Editimage accepts any VIFF image as
     input; it uses only VIFF images of data type BIT or BYTE,
     however, and will convert the data type when necessary. Out-
     put images are of type BYTE.  Currently, editimage can util-
     ize 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.  Note that this conversion will normalize
     the image to the total number of colors that are available
     to be displayed on the workstation being used.

     Editimage provides several display utilities;  most 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 editimage,
     it is important for you to have an understanding of the
     operation of each of these color spaces, as well as a feel-
     ing for how each of the available colorspaces relate to the
     others.  For this reason, a brief explanation of each is
     provided under the section for "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.  Editimage was written with the
     assumption that the user has the knowledge necessary to
     correctly interpret visual results generated and to recog-
     nize when those results are not valid.  Invalid results can
     be generated when the colorspace of the image does not match
     the colorspace of the display;  however, editimage follows
     the philosophy that it is better to allow the uneducated
     user to generate incorrect results than to limit the experi-
     menting researcher with rigid errorchecking.

     Often, in real-life applications, an image may be larger
     than the screen on which it is displayed.  This implies that
     only a portion of the total image can be visible at any
     time.  When an image is input that is larger than the
     screen, editimage will create a small "pan" window which
     will appear on the upper left hand corner of the screen.  A
     miniature copy of the entire image will appear in this pan
     window.  A rectangle is drawn around the portion of the
     image that is currently visible on the screen.  With the
     mouse, you can drag this rectangle around the panning image;
     the portion of the image that is displayed on the screen
     will be updated accordingly. Alternatively, you may click on
     a portion of the currently displayed image, and, keeping the
     mouse button down, "push" or "pull" the image around the
     screen, thus changing the visible portion of the displayed
     image;  when this method is used, the rectangle in panning
     window will be updated accordingly. If the image window size
     is reduced to be smaller than the original image size, the
     pan window will also be displayed.

     RUNNING EDITIMAGE

     Editimage can be executed from within cantata, or directly
     from the command line. When using the command line inter-
     face, an image may be specified at the time of execution, or
     the image may be input once the editimage program is already
     started.  To input the image directly from the command line,
     use the -i option flag (see "Options" for additional command
     line options). Alternatively, you may start editimage with
     no initial image, and use the "Input/Output" pane, which is
     available from the "Image Utilities" pulldown menu, to input
     the desired image. The minimum syntax specification to run
     editimage from the command line is:

     % editimage

     Place the editimage master form with your window manager
     (your window manager may use automatic placement).  The edi-
     timage master form will have a workspace attached beneath
     it, in which the image provided as input will be displayed.
     To the lower left of the image display is a cursor position
     information box, which will read [X x Y = Z], where X is the
     image row of the cursor position, Y is the image column of
     the cursor position, and Z is the pixel value of that (x,y)
     location.  If the exact color of a particular pixel cannot
     be displayed, and editimage must use a "closest color"
     representation for that pixel,  a "*" will appear after the
     Z value to inform you of this.

     The editimage master form has 2 pulldown menus, one labeled
     "DISPLAY UTILITIES", and the other labeled "IMAGE UTILI-
     TIES".

     DISPLAY UTILITIES
          By clicking on "DISPLAY UTILITIES", one can access the
          Zoom, Pixel Values, LUT, Pseudo Color, and
          Windowing/Threshold subforms, from which one can take
          advantage of these display utilities.  From the
          "DISPLAY UTILITIES" pulldown menu, one can also change
          the image band that is displayed (for multiband
          images), or overlay bit images. If annotations have
          been added to the image, or other images have been
          overlaid on top of it and you wish to save the image
          with the overlays and/or annotations, the "DISPLAY
          UTILITIES" pulldown menu also offers an option to com-
          bine overlays.  The "HELP" selection on this pulldown
          menu provides access to online help which gives a much
          more detailed explanation of all these features.

     IMAGE UTILITIES
          The second pulldown menu, labeled "IMAGE UTILITIES",
          provides access to the Input/Output File, Colormap
          Conversion, Region of Interest, and Image Header Modif-
          ication features.  From this pulldown menu, the Annota-
          tions subform is also available.  Again, a "HELP"
          selection on the "IMAGE 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 editimage 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 editimage program can be
     recovered by clicking the left mouse button inside the
     glyph.

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

Khoros                    Release: 1.0                          1

