.LP
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 functions 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.
.LP
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.
.LP
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.  
.SH
Subforms
.RS
.IP Plot 15
Used to create and display plots.
.IP Options 15
Used to customize a plot.
.IP Annotation 15
Used to annotatate a plot.
.IP Output 15
Used to print or save a plot to a printer of VIFF file.
.IP "Answer Files" 15
Used to read and write xprism3 answer files.
.RE
.LP
In addition, each "subform" 
contains a number of "panes" that allow the user to enter information
appropriate to a desired plot.
.LP
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. 
.SH
Action Buttons
.RS
.IP "PLOT INFO" 15
Used to get statistics about a plot.
.IP REFRESH 15
Used to redraw the workspace.
.IP CLEAR 15
Used to completely clear the workspace.
.IP HIDE 15
Used to hide one or more plots.
.IP DELETE 15
Used to delete one or more plots.
.IP PERSPECTIVE 15
Used to change the view perspective
.IP RESET AXES 15
Used to reset the axes to the global minimum and maximum
.IP HELP 15
Displays this documentation.
.IP QUIT 15
Exit from Xprism3.
.RE
.LP
For more detailed information on each of these operations, see the HELP
that is pertinent to the operation that is desired.
.SH 
USE WITH KHOROS
.LP
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 interpreted 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. 
.SH
RESTRICTIONS
.LP
Xprism3 has a few minor problems. The following list describes the
known problems with xprism3:
.IP 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.
.IP 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.
.IP 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.
