dtk - Tk user interface to DRAMA
Function
Tk user interface to DRAMA
Description
This program is used to set up graphical user interface to DRAMA
based on the Tcl command language and Tk widget set.
The -t option should be used to specify a Tcl script which defines
the graphical user interface. The user interface events can be used to
invoke actions in Drama tasks by sending messages to them.
It extends Tcl to provide commands to send obey, kick and parameter
set and get messages to tasks, and to allow building of SDS argument
structures.
DTK is itself a DRAMA task and has an action
DTCL_COMMAND which
allows a command to be invoked in its Tcl interpreter.
Synopsis
dtk [options]
Command options
- -b size
- Size is the total message buffer size.
Default 15000. It is automatically increased such that
at least one reply buffer of the size specified by -m will
be accepted. You will only have to use this option if you will
be communicating with more then one task.
- -m n1:n2:n3
- Sets message buffer sizes for connections to other tasks.
n1 = Messages bytes allowed for message to be sent
n2 = Messages bytes allowed for return messages
n3 = Number of return messages which may occur
Default is 8000:800:10 which should be sufficient for
most tasks
- -n name
- The name this task should register itself as. Default
is DTCL. This option may be required if you intend
to have several versions of this program outstanding
at one time.
- -t file
- Filename of a Tcl script to be invoked on intialization.
- -logging
- Enable logging of DRAMA messages
- -mayload
- This program may load other programs directly. Normally,
the DRAMA master task must be running.
- -display name
- Specify X display
- -geometry value
- Specify initial window geometry.
- -sync
- Run with X Synchronize enabled
- -stdin
- If a script is specified, accept commands from stdin after
reading the script. By default, we don't use stdin
if a script is specified.
- -globalnames
- Force DRAMA names to be placed in the global
namespace. For Tcl 8.0+ only. For prior versions
of TCL, DRAMA names are always placed in the global
namespace.
- -noglobalnames
- Force DRAMA names to not be placed in the global
namespace. For Tcl 8.0+ only. For prior versions
of TCL, DRAMA names are always placed in the global
namespace.
Language
C
See Also
DTCL manual, dtcl(1), Dtcl_Init(3), wish(1), DtclTkAppMainLoop(3),
DitsAppInit(3), Dits Specification.
Support
Jeremy Bailey, AAO
Limitations
Currently not avaliable under VxWorks
Click here for the DRAMA home page and
here for the AAO home page.
For more information, contact tony.farrell@mq.edu.au