Tracecc GUI - A GUI for tracecc and jlayout
Overview
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.
Starting Tracecc GUI
On Linux or UNIX systems use the
tracecc-gui
script to start the application.
On Windows systems run
javaw -cp c:\programme\krause\bin\dklibsj.jar;c:\programme\krause\bin\tracegui.jar traceccgui.TraceccMainProgram
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.
Choose a 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.

Set options
The Tracecc GUI options dialog box
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.
Options in 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.
Run conversions
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.

Exit the application
Use the "File => Exit" menu entry or the "Exit the application"
button to exit the application.

Setting GUI defaults
Show the "GUI options" dialog box
Use the "Setup => GUI" menu entry to change the GUI.

The "GUI options" dialog box appears.

Settings in the GUI options dialog box
- Look-and-feel
By default the application loads the system look-and-feel to look like
the majority of applications on the current desktop.
You can choose to load no explicit look-and-feel to use the Java
built-in look and feel (Metal or Ocean theme).
- Component border
Specify the space between components in pixels.
I recommend numbers in the range 5...10.
- Minimum font size
Enable this checkbox and specify a minimum font size in pixels to enforce
a minimum font size.
- Replace font family ... by ...
Sometimes loading a look-and-feel does not affect all fonts used by Java's
user interface manager. Here you can specify additional font family
substitutions.
The "Original fonts:" and "Fonts in use:" texts show
font names before and after enforcing minimum font size and font family
replacements.
- Use settings for all applications
Enable this checkbox to use the current settings not only in the Tracecc GUI
but also as default values for all applications not explicitly configured.
Changes in this dialog box will not affect the appearance of the
application immediately, you need to exit and restart the application.
Getting help
Showing the help text
Use the "Help => Local help" menu entry to show this help text.

Visit the web site
Use the "Help => Web site" menu entry to open the help web site
in your web browser.

Show version and license information
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.