
cantata(1)                   Khoros                    cantata(1)

PROGRAM
     cantata - visual programming environment for accessing the
     Khoros library of routines

SYNTAX
     cantata

     [-form]        file for ipl and cantata form definition

     [-restore]     file for restoring cantata workspace

     [-log]         log file: where each khoros command is logged

     [-dir]         directory for I/O files

     [-verbose]     verbose mode: prints out any option not used

     [-echo]        echos the command line for each routine exe-
                    cuted

     [-grid]        displays grid in the workspace for placing
                    glyphs

     [-display]     host:display.screen

     [-x]           x value of upper-left corner of workspace

     [-y]           y value of upper-left corner of workspace

     [-V]           Gives the version for cantata

     [-U]           Gives the usage for cantata

     [-P]           Prompts for command line options

     [-A [file1]]   Creates the answer file called cantata.ans or
                    file1

     [-a [file1]]   Uses cantata.ans or file1 as the answer file

DESCRIPTION
     cantata provides a visual programming environment for the
     rapid prototyping of information processing programs based
     on the Khoros library of routines.  To create a program, the
     user connects together iconified representations of the rou-
     tines, called glyphs, into a pipeline showing the flow of
     data between routines.

     Interactions with the user are controlled by the cantata
     master form.  Processing routines are grouped together on
     subforms which are accessed by the subform buttons located
     along the top of the master form.  Parameters for a routine
     are entered on it's corresponding subform pane.

     Glyphs can be connected by selecting one glyph's output
     arrow and another glyph's input arrow.  Lighter arrows
     denote optional input connections.  A temporary filename is
     created when a connection is established which is used to
     store the intermediate output results to be used by the next
     routine.  These temporary files will be deleted at the end
     of a session unless specifically saved.  The upper three
     buttons on a glyph will kill the glyph (left), return to the
     corresponding subform (middle), or exeute the routine
     (right), respectively.  The entire flowgraph may be executed
     using the master action RUN button.  When glyphs are run-
     ning, they are shown in reverse video.  Additional language
     features include the use of programming control structures,
     an expression parser, and a hierarchy of workspaces (mac-
     ros).

     For much more detailed information on cantata, see Chapter 2
     of the Khoros User's Manual.

REQUIRED ARGUMENTS
     none

OPTIONAL ARGUMENTS
     -form  type: infile
            desc: file for ipl and cantata form definition

     -restore
            type: infile
            desc: file for restoring cantata workspace

     -log   type: string
            desc: log file: where each khoros command is logged
            default: null

     -dir   type: string
            desc: directory for I/O files
            default: null

     -verbose
            type: boolean
            desc: verbose mode: prints out any option not used
            default: false

     -echo  type: boolean
            desc: echos the command line for each routine exe-
            cuted
            default: true

     -grid  type: boolean
            desc: displays grid in the workspace for placing
            glyphs
            default: true

     -display
            type: string
            desc: host:display.screen
            default: null

     -x     type: integer
            desc: x value of upper-left corner of workspace
            default: 0
            bounds: 0 < [-x] < 9999

     -y     type: integer
            desc: y value of upper-left corner of workspace
            default: 0
            bounds: 0 < [-y] < 9999

EXAMPLES
     % cantata

SEE ALSO
     intro(1), verror(3), vgparms(3), vutils(3), lcantata(3)

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

Khoros                    Release: 1.0                          1

