# dklibs 1.27.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
- DK libraries for Java

## tracecc GUI

- Overview
- Starting Tracecc GUI
- Start on Linux/Unix systems
- Start on Windows systems
- Startup problems on some Linux systems
- Using the application
- Choose a directory
- Set options
- Opening the "Tracecc Options" dialog box
- Options in the dialog box
- Run conversions
- Exit the application
- Adjusting GUI settings
- Getting help
- Show version and license information
- Local help
- Web help

### 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. The directory choosen above is inspected, source files (*.ctr, *.cpt, *.mtr, *.jtr, *.jl) are converted into the appropriate destination files (*.c, *.cpp, *.m, *.java). The *.mtr and *.m files are Objective C, not Mathlab or GNU Octave.

### Starting Tracecc GUI

#### Start on Linux/Unix systems

On Linux or UNIX systems use the

    tracecc-gui

script to start the application.

#### Start on Windows systems

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 item 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 "tracecc-gui" 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.

### Using the application

#### Choose a directory

Use the "File => Directory" menu item or the "Choose directory to process" button to choose a directory.

The dialog box to choose a directory appears. Navigate to the directory containing your source files and confirm your choice.
The new directory is shown in the main window.

#### Set options

##### Opening the "Tracecc Options" dialog box

Use the "File => Options" menu item or the "Set conversion options" button to set conversion options.

The "Tracecc 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

- Make mode
  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.
- .ctr
  enables the conversion of *.ctr files to *.c.
- .cpt
  enables the conversion of *.cpt files to *.cpp.
- .mtr
  enables the conversion of *.mtr files to *.m.
  Note: *.m files are Objective-C files, not mathematics-related files.
- .jtr
  enables the conversion of *.jtr files to *.java.
- .jl
  enables the jlayout program to merge *.jl files into *.java files.
- Write "#line..."
  writes "#line..." preprocessor directives into *.c and *.cpp files.
- C++ style comments
  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.
- Debug output
  enables the insertion of debug instructions into output.
- Debug output to standard output
  changes debug instructions to write debug output to stdout instead of stderr.
- IDE:
  changes debug instructions to print debug output in style of other programs known by editors and programming IDEs.
  Choose the program to imitate in the combo box beside.
- Timestamp
  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).
- "trace" keyword
  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 item 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 file currently processed is shown. The menu und the button bar are disabled.

After the conversions are finished the status text changes back to "Ready" and the text color changes back to green. Menu and button bar are enabled.

### Exit the application

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

#### Adjusting GUI settings

The "Setup -> GUI" menu item 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).
- Space between components
  Empty space between GUI components in pixels.
- Require 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 ... by ...
  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.
- Font Information
  Click this button to see the fonts currently used.
- Save settings as:
  Here you can choose the programs using these GUI settings:
  - Application settings
    The settings are used for the current application.
  - Application and application group settings
    The settings are used for the current application and all applications in the same group which are not yet configured individually.
  - Application and group settings and general defaults
    The settings are used for the current application and all applications which are not yet configured individually.
- Attempt to save settings system-wide
  attempts to save the settings for all users (only administrators can do this).
  By default the settings are user-specific.

After confirming changes in this dialog box ("OK" button) you should exit the application and restart it to apply the changes.

### Getting help

#### Show version and license information

Use the "? => Version and License" menu item to show version and license information..

#### Local help

Use the "? => Manual" menu item to show a help text.

#### Web help

Use the "? => Web site" menu item to visit this web page.