# dklibs 1.26.0

- Overview
- Download
- Download / Installation
- Installation from source on Windows systems
- Usage
- FAQ
- Change log
- Other projects
- Tutorial
- Developer docu
- stc
- tracecc and trana
- tracecc GUI
- tracecc PDF man.
- API: sort and search
- API: Generic I/O
- Preferences
- File search
- Font configuration
- LaTeX encodings
- Security

## tracecc GUI

- Overview
- Starting Tracecc GUI
- Startup problems on some Linux systems
- Choose a directory
- Set options
- The Tracecc GUI options dialog box
- Options in the dialog box
- Run conversions
- Exit the application
- Adjusting GUI settings
- Getting help
- Showing the help text
- Visit the web site
- Show version and license information

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

### Startup problems on some Linux systems

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.

### 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

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.

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

#### Adjusting GUI settings

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.

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