tracecc GUI
The Tracecc GUI program provides a GUI to the tracecc and jlayout
programs.
Using Tracecc GUI you can perform the following tasks:
- Choose the directory containing your source files.
- Set conversion options.
- Run a conversion.
On Linux or UNIX systems use the
tracecc-gui
script to start the application.
On Windows systems run
javaw -jar c:\programme\krause\bin\tracegui.jar
to start the program. If you installed the binary package dklibs-win32 there
is a start menu entry to start the application.
After a while (starting Java may take some time) the application main window appears.
If you encounter problems when using the ``tracegui'' script, run
java -jar /usr/local/bin/tracegui.jar
manually, correct the path if necessary.
If you see messages about a segmentation violation, attempt to run
java -jar -splash:none /usr/local/bin/tracegui.jar
instead.
If this works, provide the option ``-splash:none'' to the tracegui script
or modify the script and enter this option to the command line used in the
script.
Use the "File => Directory" menu entry or the "Choose directory" button
to choose a directory.
The windows dialog box to choose a directory appears. Navigate to the directory containing
your source files and confirm your choice.

The new directory is shown abbreviated in the main window. If you move the mouse
over the text a tool tip shows the full path of the directory.
Use the "File => Directory" menu entry or the "Choose directory" button
to choose a directory.
The windows dialog box to choose a directory appears. Navigate to the directory containing
your source files and confirm your choice.
The new directory is shown abbreviated in the main window. If you move the mouse
over the text a tool tip shows the full path of the directory.
Use the "File => Options" menu entry or the "Set options" button to
set conversion options.
The "Tracecc GUI options" dialog box appears.
Set the conversion options and use the "OK" button to confirm your
settings and close the dialog box.
- Check modification timestamps
Enable this option to check modification timestamps of source and destination
files to run a conversion only if necessary.
Note: The jlayout program to merge *.jl file contents into *.java
files is always run, the "Check modification timestamps" setting
is ignored for *.jl files.
- Always show log ouput
Normally log output is shown only if there is a reason to do so.
Enable this option to show log output on success too (may be you want to
inspect which commands were run).
- .ctr => .c
enables the conversion of *.ctr files to *.c.
- .cpt => .cpp
enables the conversion of *.cpt files to *.cpp.
- .mtr => .m
enables the conversion of *.mtr files to *.m.
Note: *.m files are Objective-C files, not mathematics-related files.
- .jtr => .java
enables the conversion of *.jtr files to *.java.
- .jl => .java
enables the jlayout program to merge *.jl files into *.java files.
- Write "#line..." information
writes "#line..." preprocessor directives into *.c and *.cpp files.
- Allow C++ style comments in C output
enables the transfer of C++ style comments from *.ctr files into *.c files.
By default C++ style comments are converted into C style comments.
- Comment box width
Specifiy the comment box width (number of columns used for comment boxes).
I suggest to use numbers 75...78.
- Produce debug output
enables the insertion of debug instructions into output.
- Write debug output to stdout
changes debug instructions to write debug output to stdout instead of stderr.
- Prepare ouput for IDE
changes debug instructions to print debug output in style of other
programs known by editors and programming IDEs.
- Include timestamp in debug output
changes debug instructions to print a timestamp before printing debug
information. This is useful to debug programs running for a longer time
(i.e. daemons).
- Include "trace" keyword in debug output
changes debug instructions to print the "trace" keyword in debug
output. This is useful to separate normal output from debug output using
programs like grep.
Use the "File => Run" menu entry or the "Run conversion"
button to run conversions.
As long as conversions are running the status text color is changed
to red, information about the current action is shown.
After the conversions are finished the status text changes back
to "Ready" and the text color changes back to green.
Use the "File => Exit" menu entry or the "Exit the application"
button to exit the application.
The "Setup -> GUI" menu entry can be used to set up the GUI.
- Look-and-feel
The look-and-feel can be set to "System look-and-feel" (the program attempts
to look and behave like any other program on the desktop) or
"No specific look-and-feel" (the program uses Java-internal default settings
for styles).
- Component border
Empty space between GUI components.
- Minimum font size
Set the minimum font size here. At program startup all styles are inspected,
the font size is corrected if necessary.
- Replace font family
For some look-and-feels on some systems not all styles are corrected to use
the fonts set up for the system (i.e. there are still some component
styles using Dialog font when using the system look-and-feel). This option
can be used to replace font family Dialog by the font family used in the
system settings.
- Original fonts / Fonts in use
Here the program shows the fonts as configured by the look-and-feel and the
fonts used after font size correction and font family substitution.
- Use settings for all applications
Here you can decide to use the settings from the dialog box not only in
the Bmeps GUI but also in other applications using Dirk Krause's
GUI controller class (i.e. the Tracecc GUI) having the GUI not yet configured.
After confirming changes in this dialog box ("OK" button) you should
exit the application and restart it to apply the changes.
Use the "Help => Local help" menu entry to show this help text.
Use the "Help => Web site" menu entry to open the help web site
in your web browser.
Use the "Help => About Tracecc GUI" menu entry to show version
and license information.
A dialog box showing version and license information is shown.
Click the "OK" button to get rid of the dialog box.