# dklibs 1.23.1

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

## LaTeX encodings

- Overview
- Data tables for the dkle module
- Example
- Please share your data tables

### Overview

The dkle module (used i.e. by the ``text2lat'' and ``fig2vect'') can convert 32-bit character texts into the appropriate LaTeX sequences.
Conversion data tables are needed containing the LaTeX encodings for the 32-bit characters/glyphs are needed.
To find the encoding for character 0x000000E4 (german umlaut ae) the table basedir/00/00/00.dat is read and searched for an entry 0xE4.
The first subdirectory name ``00'' is the hexadecimal representation of the most significant 8 bits in the character, the second ``00'' in the name represents the next 8 bits, the ``00'' in ``00.dat'' represents the next 8 bits.

### Data tables for the dkle module

Each data file contains up to 256 encodings. Data files are read line by line. Each line can be either a comment line (first non-whitespace is ``#'') or a data line.
A data line consists of a mode descriptor, the least significant 8 bits in the character/glyph and the LaTeX encoding. Spaces and tabulators can be used as separators.
The mode descriptor can be either ``*'' (encoding can be used in both text and math mode), ``t'' (encoding can be used in text mode only) or ``m'' (encoding can be used in math mode only).
The least significant 8 bits of the character can be specified in hexadecimal notation started by ``0x'' or in decimal notation (without leading ``0x''). For 00/00/00.dat the character can be specified directly enclosed in single quotes.

### Example

The example below is an excerpt from .../00/00/00.dat:

    *	0x25    \%

    t	0x2A    \textasteriskcentered{}
    m	0x2A    *

### Please share your data tables

I afraid my lifetime is too short to find out the LaTeX encodings for all 2^32 characters/glyphs. So I decided for myself to provide encoding tables for 0x00000000 to 0x000001FF only because I never needed characters/glyphs from outside this range.
Data tables for characters/glyphs above 0x000001FF can only come from contributions. If you are willing to share data tables you created under terms of a BSD-style license, please use the ``Patches'', ``Feature Requests'' or ``Bugs'' trackers on the dklibs project page http://sourceforge.net/projects/dklibs on the ``Trackers'' page.