
Editimage(Image Utils)       Khoros        Editimage(Image Utils)

     Input/Output

     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.

     Environment - Global Input and Output Directories

          Often it is nice to have a particular directory that
          holds plot files, images, etc, and then to have editim-
          age 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 edi-
          timage 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.

     1)  Global Input Directory
          Under the "Input Path" parameter of the Environment
          pane, specify the pathname of the directory which con-
          tains the input files you wish to use.  The input path
          is set when you hit the <cr> key.  Once the path is
          set, editimage 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.

     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
          editimage. The output path is set when you hit the <cr>
          key.  Once the path is set, editimage 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.

     Input of a New Image

     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 multi-
          band images, the 0th (first) band is displayed by
          default.  The CHANGE BANDS option on the "Display Util-
          ities" 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 currently
          displayed image.

     Other Available Input Features

     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 new colormap
          is the one that will be saved with the image.

     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.

     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 "disap-
          pear", 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 con-
          verted 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.

          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), editimage will become incredibly slow
          as the X server has to do much additional work in order
          to map the image to the window.

          WARNING: this feature will only work on X servers that
          support X11 R4!

     7) Overlays- Khoros image file to act as OVERLAY
          If desired, a bit image may be specified to be over-
          layed 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 over-
          laid is not of type bit, it will be internally con-
          verted 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 over-
          lay of NULL indicates that the current overlay is no
          longer to be used.

     Output of An Image

     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 hit-
          ting the <cr> key.

          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 COM-
          BINE ANNOTATIONS button on the IMAGE UTILITIES pulldown
          menu in order to incorporate the annotations into the
          image.

          ALSO NOTE: if you have added overlays to your image
          using either this subform or the OVERLAY IMAGE(S) but-
          ton 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.

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

Khoros                    Release: 1.0                          1

