.SH
OVERVIEW
.LP
The \fBcantata\fP visual programming environment is used to access the
programs contained in the Khoros libraries via a graphical user interface.
The \fImaster form\fP which appears on the screen when \fBcantata\fP
is executed provides the user with a programming workspace
which consists of the following components:  \fIaction
buttons\fP, \fIpull-down menus\fP that provide access to \fIsubforms\fP
and \fIaction selections\fP, \fIsubform buttons\fP, and a \fIworkspace\fP.
(Note: the default \fBcantata\fP master form does not use
subform buttons to access programs but instead uses a menu of
\fIsubform selections\fP.)
.SH
ON-LINE DOCUMENTATION
.LP
Local, on-line information is provided by clicking on `HELP' buttons.
These may be in the form of a single window, or a window with a menu 
of help options at the top.
Clicking on an option brings up additional documentation on that
topic.  This user's manual is a compilation of the on-line help.
.SH
CANTATA MASTER FORM
.LP
The master form is used to initiate the user's top level 
interaction with \fBcantata\fP.  The following description summarizes 
the different types of buttons located on the master form and 
their use.
.SH
MASTER FORM ACTION BUTTONS
.LP
Action buttons are located along the left side of the master
form.  These actions provide the basic operations needed for the creation 
of and execution of processing flow graphs.
.RS
.IP "RUN" 11
Executes the entire flow graph of glyphs.
.IP "RESET" 11
Resets all glyphs so that the entire flow graph will be re-executed
the next time the workspace is `RUN'.
.IP "REDRAW" 11
Refreshes the lines and glyphs of the flow graph.
.IP "ROUTINES" 11
Gives the user access to Khoros programs by name instead of using
the menus along the top of the master form.
.IP "HELP" 11
Displays master form documentation.
.IP "QUIT" 11
Exit from \fBcantata\fP.
.RE
.SH
PROGRAM SUBFORMS
.LP
The subform buttons and subform menu buttons
located along the top of the master form are
used to access the processing routines currently available in Khoros.
See "Subforms" for help on using the subform buttons.
.SH
INTERACTION SUBFORMS
.LP
These subform buttons, located on the top-left and left side of the 
master form, allow the user to interact with certain features within the 
\fBcantata\fP environment.  They are accessed by clicking the mouse on the
desired selection.  A complete description is given under the documentation 
for each individual subform menu.   They include:
.RS
.IP "Edit" 11
Gives the user access to the various functions of the interactive visual 
editor of \fBcantata\fP.  Many of the editing functions are the same as 
those that you would expect in a very simple draw program.  In addition, 
you can save programs (groups of glyphs) and create subprocedures.
.IP "Workspace" 11
Allows the user to interact with the \fBcantata\fP workspace, selecting
visible attributes, execution modes, saving and restoring \fBcantata\fP 
programs and subprocedures, setting default directories, 
saving individual files, etc.
.IP "Variables" 11
Used to define variables and evaluate expressions.
.RE
