.SH 
DESCRIPTION
.PP
\fBEditimage\fP is an interactive image display, examination, and manipulation 
tool.  \fBEditimage\fP 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. Output images are of type BYTE.  Currently, \fBeditimage\fP
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.
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.
.PP
\fBEditimage\fP 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 \fBeditimage\fP, it is important 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 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.  \fBEditimage\fP 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 image does not match the colorspace of
the display;  however, \fBeditimage\fP 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.
.PP
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, \fBeditimage\fP 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.
.sp
.SH 
RUNNING EDITIMAGE
.PP
\fBEditimage\fP can be executed from within \fBcantata\fP, or directly from 
the command line. When using the command line interface, an image may 
be specified at the time of execution, or the image may be input once the
\fBeditimage\fP 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 \fBeditimage\fP
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 \fBeditimage\fP from the command 
line is:
.sp
\f(CW
% editimage 
\fP
.PP
Place the \fBeditimage\fP master form with your window manager (your window 
manager may use automatic placement).
The \fBeditimage\fP 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 \fBeditimage\fP must use a "closest color" representation for
that pixel,  a "*" will appear after the Z value to inform you of this.
.PP
The \fBeditimage\fP master form has 2 pulldown menus, one labeled "DISPLAY UTILITIES",
and the other labeled "IMAGE UTILITIES".  
.sp
.IP "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 combine overlays.  The "HELP" selection on this pulldown menu provides 
access to online help which gives a much more detailed explanation of all 
these features.
.sp
.IP "IMAGE UTILITIES"
The second pulldown menu, labeled "IMAGE UTILITIES", provides access to the
Input/Output File, Colormap Conversion, Region of Interest, and Image Header
Modification features.  From this pulldown menu, the Annotations 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.
.sp
.SH
GLYPH
.PP
Clicking on the "Glyph" button that appears on the upper left hand corner 
of the \fBeditimage\fP 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 \fBeditimage\fP program can be recovered by clicking the left mouse 
button inside the glyph.
