
XPRISM3(HELP)                Khoros                 XPRISM3(HELP)

     OVERVIEW

     Xprism3 is a 3D plotting package for use independently or
     with other parts of Khoros.  It features 3D, Scatter,
     Impulse, Mesh, Horizon, Surface, 2D and 3D Contours and
     Color Mesh plots.  There are many ways to input data --
     image files, files with functions or data points, and func-
     tions entered from the keyboard.  The data format may be
     represented as XYZ triplets or as Z data only.  For Raw data
     files, the standard data types of Byte, Short, Integer, or
     Float may be selected.  In addition, the Machine Type may be
     selected to indicate the data ordering from the machine on
     which the data was created.  This allows the user to make
     use of raw data files created on a variety of other
     machines.

     Displayed plots can be scaled, rotated, and translated.
     Fonts, colors, axes, marker types, line types, plot types,
     and titles can be changed. Plot information can be saved
     implicitly or explicitly in Image File Format. Output may be
     sent to Postscript, Imagen, or LNO3 laser printers, or to an
     HPGL plotter.

     The user interface is broken down into a "master" form and
     five "subforms".  Each "subform" represents a group of
     operations that may be accessed by selecting the desired
     "subform" button.

     Subforms

          Plot           Used to create and display plots.

          Options        Used to customize a plot.

          Annotation     Used to annotatate a plot.

          Output         Used to print or save a plot to a
                         printer of VIFF file.

          Answer Files   Used to read and write xprism3 answer
                         files.

     In addition, each "subform" contains a number of "panes"
     that allow the user to enter information appropriate to a
     desired plot.

     There are also nine "action" buttons located on the left
     side of the "master" form, which allow the user to obtain
     information about the plot and to perform certain operations
     on the workspace.

     Action Buttons

          PLOT INFO      Used to get statistics about a plot.

          REFRESH        Used to redraw the workspace.

          CLEAR          Used to completely clear the workspace.

          HIDE           Used to hide one or more plots.

          DELETE         Used to delete one or more plots.

          PERSPECTIVE    Used to change the view perspective

          RESET          Used to reset the axes to the global
                         minimum and maximum

          HELP           Displays this documentation.

          QUIT           Exit from Xprism3.

     For more detailed information on each of these operations,
     see the HELP that is pertinent to the operation that is
     desired.

     USE WITH KHOROS

     Among other uses of the plotting routines, you can get a
     graphical representation of an image by plotting the image
     file with xprism3. Image files can be represented as 2D or
     3D graphs. In 3D, each row and column of the image is inter-
     preted as lying on the X Y plane, so that rows are set
     sequentially end to end, and the grey level of each pixel is
     interpreted as the z value at that point.  In addition,
     plots created can be saved as image files, and later used
     with editimage.

     RESTRICTIONS

     Xprism3 has a few minor problems. The following list
     describes the known problems with xprism3:

     1    The function parser may not trap arithmetic errors such
          as overflows, underflows and divide by zero. These
          arithmetic errors will cause xprism3 to core dump.

     2    If you are using annotations, it may be necessary to
          redraw the plot periodically. After moving, rasing or
          lowering and annotation it is best to press the
          "REFRESH" button on the left side of the xprism mast
          form.

     3    The output of annotations to an impress printer does
          not work. It is best to avoid annotating a plot if your
          output device is an impress printer.

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

Version: 0                 Release: 1                           1

