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 executed

[-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 routines, 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 running, they are shown in reverse video. Additional language features include the use of programming control structures, an expression parser, and a hierarchy of workspaces (macros).

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 executed
    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.