.LP
The "Input/Output" pane is an area where the user can specify 
colormap files and input and output directory paths and filenames. 
The use of these functions are described below.
.SH
Environment - Global Input and Output Directories
.IP
Often it is nice to have a particular directory that holds
plot files, images, etc, and then to have \fBeditimage\fP go directly to that
directory to look for or place files.  In addition, if the plot
files/image files are not in one's local directory, one must type the
entire correct path into a menu selection to specify a file.  Typing
long strings may become tedious; once the correct pathnames are specified, 
only the name of a file in that directory is necessary to fill in any 
\fBeditimage\fP parameter which calls for an input file. In addition, if one
utilizes the file browser, the browser will now display
files found in the specified input directory. 
.sp
.IP "1)  Global Input Directory"
Under the "Input Path" parameter of the Environment pane, specify the
pathname of the directory which contains the input files you wish to use.
The input path is set when you hit the <cr> key.
Once the path is set, \fBeditimage\fP
assumes that all input files will be in this directory 
unless the (differing) full pathname is specified in response
to a prompt for an input file.  The default is the local "." directory.
.sp
.IP "2)  Global Output Directory"
Under the "Output Path" parameter of the Environment pane, specify the
pathname of the directory to which the user desires to write any output 
files created with \fBeditimage\fP. 
The output path is set when you hit the <cr> key.
Once the path is set, \fBeditimage\fP assumes that all output 
files are to be written to this directory unless the (differing) 
full pathname is specified in response to a prompt for an output 
file.  The default is the local "."  NOTE: It is important that
this directory be -> writable by the user. An error will occur if the 
Global Output Directory is protected against the user.
.sp
.SH
Input of a New Image
.IP
.IP "3)  Input - Khoros Image File as INPUT"
New images may be input and displayed using the "Input/Output" subform.
Each time the user fills in the "Khoros Image File as Input" 
parameter and hits the <cr> key, the new image will be displayed.
With multiband images, the 0th (first) band is displayed by default.  The
CHANGE BANDS option on the "Display Utilities" pull-down menu can be used
to display other bands if desired.  Note that if any new colormap has been
previously input (see below), it will be over-written at this time by the
colormap of the new input image.  The latest image to be input is referred
to throughout this documentation as the \fIcurrently displayed image\fP.
.sp
.SH
Other Available Input Features
.IP
.IP "4)  Colormap - Khoros Image File with COLORMAP to be Used"
This feature allows one to assign a different colormap 
to the image being displayed.
This is useful if the user has developed a colormap using "LUT", 
"PSEUDO", or some other method, and wishes install it on other images.
The function expects an image as the colormap input file, and replaces the
displayed image's colormap with that of the specified image.
Each time the user fills in the "Colormap as Input" and hits the <cr> key,
the new colormap is installed for the current image.  To restore the original
colormap, the original image must be entered as "Colormap as Input".
When an image is saved after colormap manipulations, the \fInew\fP colormap 
is the one that will be saved with the image.
.sp
.IP "5) Clip Mask - Khoros Image File used to CLIP Window"
If desired, an image may be input and used as a clip mask.
When an image is used as a clip mask for the currently displayed image,
the only part of the current image that will appear normally
is that part defined by the pixels in the clip mask image that have a value
of (1). All other parts of the current image will appear in the background
color of the image window. Note that ONLY images of data type bit can be 
used as clips masks; if the input image to be used as a clip mask is not
of type bit, it will be internally converted to type bit, without prompting
or warning, before it is used.  Note that this conversion will not affect 
the original file in any way.  If a clip mask currently being used is no
longer desired, simply blank out the filename and hit <cr>. Inputting a
clip mask of NULL indicates that the current clip mask is no longer to be
used.
.sp
.IP "6)  Shape Mask - Khoros Image File used to SHAPE Window" 
If desired, an image may be input and used as a shape mask.
When an image is used as a shape mask for the currently displayed image, 
the only part of the current image that will be visible
is that part defined by the pixels in the shape mask image that have a value
of (1).  All other parts of the current image will "disappear", and the
background (the part of the screen behind the image display window) will 
show through.  Note that ONLY images of data type bit can be used as shape 
masks;  if the input image to be used as a shape mask is not
of type bit, it will be internally converted to type bit, without prompting
or warning, before it is used.  Note that this conversion will not affect
the original file in any way. If a shape mask currently being used is no
longer desired, simply blank out the filename and hit <cr>. Inputting a
shape mask of NULL indicates that the current shape mask is no longer to be
used.
.IP
WARNING: ONLY VERY SIMPLE BIT IMAGES SHOULD BE USED AS SHAPE MASKS.  For
example, the bit image "ball.bit" KHOROS_HOME/data/masks in is a good shape 
mask.  As more complicated images are used (images with many "holes" in them),
\fBeditimage\fP will become incredibly slow as the X server has to do much 
additional work in order to map the image to the window.
.IP
WARNING: this feature will only work on X servers that support X11 R4! 
.sp
.IP "7) Overlays- Khoros image file to act as OVERLAY"
If desired, a bit image may be specified to be overlayed onto the currently
displayed image.
When an image is overlaid, the overlay image is used as an overlay mask;
the overlay mask is used to indicate which part of the overlay image is
transferred onto the currently displayed image.  All pixels of the overlay
mask that have a value of 1 cause the corresponding pixels of the overlay
image to be transferred onto the currently displayed image.  All pixels of the
overlay mask that have a value of 0 indicate that pixels of the currently
displayed image at those locations will appear normally.
Note that ONLY images of data type bit can be used as overlays;
If the image to be overlaid is not of type bit, it will be internally
converted to type bit, without prompting or warning, before it is overlaid.
Note that this conversion will not affect the original file in any way.
If an overlay image currently being used is no longer desired, simply blank 
out the filename and hit <cr>. Inputting an overlay of NULL indicates that 
the current overlay is no longer to be used.
.SH
Output of An Image
.IP "8)  Output -  Output an Image"
The image being displayed along with any changes that have been made can
be saved using the Output pane of the Input/Output subform.
This can be done by entering a filename  in the "Output an Image" 
parameter and hitting the <cr> key.  
.IP
NOTE: if you have made annotations on your image using the "Annotations" 
subform that you wish to be saved as part of the output image, you must 
first use the COMBINE ANNOTATIONS button on the IMAGE UTILITIES pulldown 
menu in order to incorporate the annotations into the image. 
.IP
ALSO NOTE: if you have added overlays to your image using either this 
subform or the OVERLAY IMAGE(S) button on the DISPLAY UTILITIES pulldown
menu that you wish to be saved as part of the output image, you must
first use the COMBINE OVERLAY(S)  button on the DISPLAY UTILITIES pulldown
menu in order to incorporate the overlays into the image.
