
Cantata(Edit)                Khoros                 Cantata(Edit)

     CREATING A SUBPROCEDURE

     To create a new procedure (visual procedure) first select
     the set of glyphs that you want grouped and the select the
     `Create Procedure' operation.  You will be prompted for a
     procedure name, this name will be used as the procedure
     glyph label.  (Note that names longer than approximately 10
     characters will probably not fit on the glyph.) Then click
     on the `CREATE' button.  This will bring up a glyphed
     subworkspace with its own Master Form. An empty subworkspace
     is created if there were no glyphs selected prior to creat-
     ing the subprocedure.

     The new procedure workspace is used in the same manner as
     the main workspace. Routines are selected using either the
     subform buttons or the ROUTINES window from the procedure
     workspace Master Form, then connected as usual.  Parameters
     for included routines are selected and modified on the sub-
     form panes in the usual way.

     CONNECTING A PROCEDURE

     Connecting a procedure to external glyphs (or other pro-
     cedure) is accomplished by using the procedure subworkspace.
     Glyphs in the procedure workspace are connected to glyphs in
     the main workspace or another procedure workspace in the
     usual manner (clicking on the output of one glyph and the
     input of the next, or vice versa).  Valid connections are
     permitted to either simple glyphs or other procedures within
     the procedure's "parent" workspace.

     Nesting of procedures (creating procedures inside of pro-
     cedures) is also supported if connections follow a tree
     structure.  In other words, glyphs within a given workspace
     may be connected to simple glyphs within other workspaces if
     the workspace is related as "parent", "child", or a
     "sibling" (another child of the same parent).  Other connec-
     tions can be effected using the MERGE glyph.  For example,
     to connect a glyph from the parent workspace to a procedure
     nested within a child (a grandchild?), connect first to a
     MERGE in the child workspace before connecting to the nested
     procedure.  This will establish the necessary relationship
     to make the connection valid.

     GLYPHING A PROCEDURE

     Clicking the mouse on the GLYPH button of the procedure
     workspace replaces the subworkspace with a special "pro-
     cedure" glyph with a double border. Clicking on the middle
     button of the procedure glyph brings back the procedure
     workspace.  Subprocedures may be executed by including them
     in a processing pipeline to be RUN automatically, or exe-
     cuted individually by using either the action RUN button on
     the procedure workspace or the "ON switch" (right button) of
     the procedure glyph.

     CURRENT RESTRICTION

     When changing connections across procedure workspaces, con-
     nections which have been internally deleted may still appear
     on the screen.  Use the REDRAW action buttons (located on
     the Master Form of each workspace) frequently to keep the
     display current.

     On a QUIT from a subprocedure workspace, cantata does NOT
     prompt if you want to save the procedure.  Be sure to save
     the procedure workspace BEFORE quitting if you wish to keep
     your work!

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

Khoros                    Release: 1.0                          1

