
XPRISM3(INPUT_FILE)          Khoros           XPRISM3(INPUT_FILE)

     OVERVIEW

     Plots are input and displayed using the "Input File" pane of
     the "Plot" subform.  The first plot to be created and
     displayed causes the graphics workspace to be created. The
     plot is drawn in the Black workspace area.

     More than one plot may be displayed in the same window;
     each time the user fills in the "filename" parameter and
     clicks on "Plot File", the new plot will be added to the
     graphics workspace. Plots may be hidden using the "HIDE"
     action button on the guide pane of the main Xprism3 form, or
     deleted using the "DELETE" action button.  Until the graph-
     ics workspace is destroyed using the "CLEAR" action button,
     each new plot will continue to be added to the existing
     graphics workspace.

     Twenty (20) plots may be displayed in a workspace; however,
     for readability, five (5) is the recommended limit.  If one
     has access to a color workstation, it is much easier to dis-
     tinguish plots from each other than if one is working on a
     monochrome workstation.

     The following list describes the options available on the
     "Input File" pane.

     Filename
          The file to be plotted must be specified in the
          Filename boxed area.  To use the file browser to
          find/select a file, click the mouse in the word
          "Filename" on the pane.  The following file types may
          be used as input:

          VIFF Image Files    image files created by KHOROS

          Ascii Files         3D data points entered into an
                              Ascii File.

          Raw Data Files      raw data files created from a pro-
                              gram or application.

          Functions           function definitions stored in an
                              Ascii File.

     Points to Be Displayed

          The option, "points to be displayed", allows the user
          to window on a specified portion of the data. Along
          with windowing the user can subsample the data to be
          displayed. Note, All data is read in when the "Plot
          File" button is clicked with the mouse. The "points to
          be displayed" works on the data read in. The window and
          subsampling parameter may be changed for each plot on
          the "Attributes" subform. The "points to be displayed"
          option has three item that can be changed. The follow-
          ing explains these options:

          Step Size
               This "Step Size" option specifies how the data
               should be subsampled between the begin point and
               the end point. The default value is 1, every
               point.

          Begin Point
               The "Begin Point" specifies the begin point of the
               data to plot. That is what data point number to
               begin with. If the "Begin Point" is set to 0, then
               the "end point" is ignored and all data points are
               used.

          End Point
               The "End Point" specifies the end point of the
               data to plot. That is what data point number to
               end with. If the "End Point" is set to 0, then the
               last data point in the file is used as the end
               point.

     Plot Type

          Each plot that is input will be displayed as the plot
          type that is indicated by the "plot type" toggle in the
          "Input File" pane.  Thus, by changing the plot type
          before each new plot is displayed, any of the five plot
          types may be displayed simultaneously in the graphics
          workspace.

     Data Format

          Data format is only used when the input file is an
          Ascii data file or a Raw data file. Two formats can be
          specified, XYZ triplets or Z Only. In the case of Z
          Only data, the X and Y values are generated starting at
          0.

     Raw Data Type

          Raw Data Type is only used with raw data files. This
          specifies the data type of how the data is stored.

     Raw Data Machine Type

          Raw Data Machine Type specifies the machine type that
          the data was originally created on. If the byte order-
          ing of the data is different than the machine running
          Xprism3 on, the data will be converted.

     See the associated HELP for each of the file types for more
     detailed information.

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

Khoros                    Release: 1.0                          1

