1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
<!--Converted with LaTeX2HTML 98.1p1 release (March 2nd, 1998)
originally by Nikos Drakos (nikos@cbl.leeds.ac.uk), CBLU, University of Leeds
* revised and updated by: Marcus Hennecke, Ross Moore, Herb Swan
* with significant contributions from:
Jens Lippmann, Marek Rouchal, Martin Wilck and others -->
<HTML>
<HEAD>
<TITLE>Tips for the Tcl/Tk Interface in DsTool</TITLE>
<META NAME="description" CONTENT="Tips for the Tcl/Tk Interface in DsTool">
<META NAME="keywords" CONTENT="userman">
<META NAME="resource-type" CONTENT="document">
<META NAME="distribution" CONTENT="global">
<META HTTP-EQUIV="Content-Type" CONTENT="text/html; charset=iso-8859-1">
<LINK REL="STYLESHEET" HREF="userman.css">
<LINK REL="previous" HREF="node44.html">
<LINK REL="up" HREF="node43.html">
<LINK REL="next" HREF="node46.html">
</HEAD>
<BODY >
<!--Navigation Panel-->
<A NAME="tex2html1089"
HREF="node46.html">
<IMG WIDTH="37" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="next"
SRC="/usr/lib/latex2html/icons.gif/next_motif.gif"></A>
<A NAME="tex2html1086"
HREF="node43.html">
<IMG WIDTH="26" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="up"
SRC="/usr/lib/latex2html/icons.gif/up_motif.gif"></A>
<A NAME="tex2html1082"
HREF="node44.html">
<IMG WIDTH="63" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="previous"
SRC="/usr/lib/latex2html/icons.gif/previous_motif.gif"></A>
<A NAME="tex2html1088"
HREF="node1.html">
<IMG WIDTH="65" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="contents"
SRC="/usr/lib/latex2html/icons.gif/contents_motif.gif"></A>
<BR>
<B> Next:</B> <A NAME="tex2html1090"
HREF="node46.html">Colors in DsTool</A>
<B> Up:</B> <A NAME="tex2html1087"
HREF="node43.html">Hints and Suggestions for</A>
<B> Previous:</B> <A NAME="tex2html1083"
HREF="node44.html">Tips for Using Geomview</A>
<BR>
<BR>
<!--End of Navigation Panel-->
<H2><A NAME="SECTION00522000000000000000"> </A><A NAME="1861"> </A>
<BR>
Tips for the Tcl/Tk Interface in DsTool
</H2>
<P>
DsTool's interface is written in Tcl/Tk. In addition to providing
an easy-to-use graphics interface framework, Tcl/Tk
is a scripting language, and you can run DsTool entirely by entering
commands at the prompt %DsTool. Some other useful tips follow:
<DL COMPACT>
<DT>1.
<DD>Enter the command end_wait if DsTool grabs the input and
does not relinquish it. Typically, during computations, DsTool
disables mouse input and returns control to the mouse when
the computation is finished. If an unexpected error occurs
in the computation,
control might not be properly restored. The command end_wait
typed at the DsTool command prompt should return control to
the mouse.<A NAME="1866"> </A><A NAME="1867"> </A>
<DT>2.
<DD>You can modify the default window colors and fonts
in DsTool by following the instructions for
adding custom Tcl/Tk code to your own version of DsTool. See the
accompanying documentation in $DSTOOL/my_dstool/README<A NAME="1869"> </A>
for more information. The procedure essentially
involves adding one line of code, and compiling your own
version of DsTool.
<DT>3.
<DD>While you can run DsTool entirely from the keyboard, it is not
recommended that you do so. Typically, a button press will call
``tcl_to_pm'' to update the Postmaster, then ``pm EXEC'' to
perform the computation by calling a C routine, and finally ``pm_to_tcl''
to update the interface. However, it may perform
other tasks as well. For example, the ``Forwards'' button on the
Continuation window checks to see if the number of active parameters
selected is the correct number before proceeding. If you insist on
running DsTool by typing from the prompt, you should use the procedures
that Tcl/Tk calls when a button is pressed, instead of calling the
Postmaster routines directly.
For example, to replicate a press of the ``Forwards'' button on the Orbits
window, instead of typing pm EXEC Flow.Forwards, type
orbits(forwards).
In addition, if you change an entry in a field, you should follow it with
a call of ``tcl_to_pm'' to update the Postmaster. Similarly, if you
change a Postmaster entry,
you should follow it with a call of ``pm_to_tcl'', to update the interface.
<DT>4.
<DD>One efficient way to automate long calculations is by writing Tcl
scripts<A NAME="1872"> </A>. You can run scripts by entering the command
``source <EM>filename</EM>'' at the prompt. As with the previous note,
you should be careful when writing scripts to make sure that you are
computing the quantities that you wish to compute.
</DL><HR>
<!--Navigation Panel-->
<A NAME="tex2html1089"
HREF="node46.html">
<IMG WIDTH="37" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="next"
SRC="/usr/lib/latex2html/icons.gif/next_motif.gif"></A>
<A NAME="tex2html1086"
HREF="node43.html">
<IMG WIDTH="26" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="up"
SRC="/usr/lib/latex2html/icons.gif/up_motif.gif"></A>
<A NAME="tex2html1082"
HREF="node44.html">
<IMG WIDTH="63" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="previous"
SRC="/usr/lib/latex2html/icons.gif/previous_motif.gif"></A>
<A NAME="tex2html1088"
HREF="node1.html">
<IMG WIDTH="65" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="contents"
SRC="/usr/lib/latex2html/icons.gif/contents_motif.gif"></A>
<BR>
<B> Next:</B> <A NAME="tex2html1090"
HREF="node46.html">Colors in DsTool</A>
<B> Up:</B> <A NAME="tex2html1087"
HREF="node43.html">Hints and Suggestions for</A>
<B> Previous:</B> <A NAME="tex2html1083"
HREF="node44.html">Tips for Using Geomview</A>
<!--End of Navigation Panel-->
<ADDRESS>
<I>John Lapeyre</I>
<BR><I>1998-09-04</I>
</ADDRESS>
</BODY>
</HTML>
|
