
Cantata(Subform)             Khoros              Cantata(Subform)

     SETTING PROGRAM PARAMETERS

     The pane section (located on the right of the subform) is
     where most actual input of parameter information for a pro-
     cessing program takes place.  When a specific program is
     selected from the guide pane, the corresponding pane section
     appears with required and optional parameters which may be
     entered/changed/selected for that program.

     Text Selections
          "Text selections" are provided for entering string,
          integer, and float values.  Typically these appear as
          narrow rectangular boxes in which the required informa-
          tion is entered by positioning the mouse cursor on the
          box and typing in a number.  Typing in a specific
          number is the same as saying that the parameter that
          you entered will be a constant.  Besides enterning con-
          stants, variables or expressions can be used. See the
          documentation on the expression parser.

     Live Text Selections
          "Live" parameters are indicated by a stylized <cr>
          arrow that appears to the right of the parameter input
          box.  If the `Responsive Execution' mode is turned ON,
          the re-execution of the flow graph is also initiated by
          the user entering the required value and then hitting
          the carriage return.

     Sliders
          For numerical values, optional "sliders" may be used to
          enter a value between predefined limits.  To use, posi-
          tion the mouse cursor on the gray band, hold down the
          middle button and move the mouse horizontally, releas-
          ing when at the desired level.

     Filenames
          Names for input/output files may be typed in or, or
          alternately, selected from a "file browser".  Clicking
          on a filename prompt will bring up a browser window
          containing a list of files in the current directory.  A
          filename may be selected from the browser by clicking
          on the desired name.  A different directory may be
          accessed either by clicking on a subdirectory name (or
          ../ to back up) or by typing it in directly in the
          space at the bottom of the browser.

          Filenames for intermediate results are typically NOT
          typed in, but generated by cantata when the glyphed
          programs are connected into a program flow graph.

     Logicals
          Logical values are distinguished by elliptical buttons
          (if your X server has shape extensions) which toggle
          between two alternate choices when clicked on.  For
          example: "Yes/No", "True/False", "On/Off", etc.

     Optional Selections
          "Optional" parameters are prefaced by a small box.
          When selected, the box is highlighted, meaning the
          parameter value is to be used.

     Toggles and Mutually Exclusive Groups
          Text selections may be grouped together so that only
          ONE of the group may be selected at a time.  For "Tog-
          gles" one and only one of the listed options must be
          selected.  For "Mutually Exclusives" one of the listed
          options may be selected or an alternative typed in.

     Action Buttons
          For most situations, it is necessary for the user to
          enter several text selections before initiating any
          action.  In the gather and execute mode, the user first
          enters all the required parameters, then clicks the
          mouse on an "action button" to register the values and
          perform the desired operation.  The `Execute' and
          `Glyph' buttons are action buttons in cantata.

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

Khoros                    Release: 1.0                          1

