
ANIMATE(help)                Khoros                 ANIMATE(help)

     DESCRIPTION

     The "Input" subform allows you to input new VIFF files to be
     used with animate.

     1. Image
          This field allow the use to input a new image for
          sequencing. The new input image may be either typed in
          or be set by the file browser. The file browser is
          activated by clicking the left mouse button on the
          "Image" label. If the browser is used to enter the
          filename, simply wait for the initial image to be read
          in.  If manually entering the filename into the parame-
          ter box next to the "Image" label, hit <cr> when the
          file appears correctly.  Remember that an input image
          to animate must be a multiband VIFF image.

     2. Basename
          If you do not have a multiband image for input to ani-
          mate, you may instead provide a basename that specifies
          a group of single band images that can be used with
          animate.  Note that images will be taken in alphabeti-
          cal order, so if you have a group of images named, for
          example, image.x where x is the sequence order, you
          will have to make sure that x starts with "01" through
          "09".  This is because alphabetically, image.1 will be
          followed by image.10 and image.100 unless you follow
          the preceeding zero naming convention.

     3. Clip Mask
          If desired, a bit 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
          animated data 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 frame
          will appear in the background color of the image win-
          dow. Images work best as clip masks when they are the
          same size as the input data.  $KHOROS_HOME/data/masks/
          contains two images that make good clip masks. To get a
          clip mask to go away, NULL out the "Clip Mask" parame-
          ter, and hit <cr>.

     4. Shape Mask
          If desired, a bit image may be provided to act as a
          shape mask. When an image is used as a shape mask for
          the currently displayed image, the only part of the
          currently displayed 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 currently
          displayed image will "disappear", and the background
          (the part of the screen behind the image  display win-
          dow) will show through.

          Images work best as shape masks when they are the same
          size as the input data. $KHOROS_HOME/data/masks/ con-
          tains two images that make good shape masks.  To get a
          shape mask to go away, NULL out the "Shape Mask" param-
          eter, and hit <cr>.  You may have to hit the <cr> key
          twice.  WARNING: ONLY VERY SIMPLE BIT IMAGES SHOULD BE
          USED AS SHAPE MASKS. For example, the bit image
          "smball.bit" in KHOROS_HOME/data/masks is a good shape
          mask. As more complicated images are used (images with
          many "holes" in them), animate 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.

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

Version: 0                 Release: 1                           1

