The DarkMod Wiki - User contributions [en]

I18N - Charset

2026-06-28T20:00:06Z

Geep: /* Priority Early-On: the "Top 50" */ Add Show/Hide to table, hide by default

== Introduction ==

The D3 code that handles the GUI bitmap font can only load a specific range of bytes as characters. To get the most out of the available entries, special charsets are used. The fonts (Carleton for the menu f.i.) are build/patched so that the right characters appear in the right place.

== LANG File Encodings ==

=== all.lang ===

This file is in '''UTF-8''', and converted with the help of either the script '''devel/gen_lang.pl''':

perl devel/gen_lang.pl

or, more recently, the Windows C++ utility program '''gen_lang_plus'''. [[Gen_Lang_Programs]] has details of these.

This process ensures that the generated language files are in their proper encodings (see below).

=== All other language files ===

Language-specific files (f.i. '''german.lang''') provide string dictionaries. A system-wide set is provided in tdm_base01.pk4/strings/. A deployed FM may offer similar files in its /strings/ folder... at the very least '''english.lang'''. All such files are expected to be in the following 8-bit encodings:

* '''Czech, Hungarian, Slovak, Polish:''' [https://secure.wikimedia.org/wikipedia/en/wiki/ISO/IEC_8859-2 ISO-8859-2] ('''not WIN-1250!)
* '''Russian:''' [https://secure.wikimedia.org/wikipedia/en/wiki/Win-1251 WIN-1251]
* '''French:''' [https://secure.wikimedia.org/wikipedia/en/wiki/ISO/IEC_8859-15 ISO-8859-15]
* '''Romanian:''' [https://secure.wikimedia.org/wikipedia/en/wiki/ISO/IEC_8859-16 ISO-8859-16]
* '''Turkish:''' [https://secure.wikimedia.org/wikipedia/en/wiki/ISO/IEC_8859-9 ISO-8859-9]
* '''All other languages:''' [https://secure.wikimedia.org/wikipedia/en/wiki/ISO/IEC_8859-1 ISO-8859-1]. This covers TDM-supported languages English, German, Italian, Spanish, Portuguese, Swedish, Danish, Dutch, and Catalan.

{{infobox|The core dictionaries are automatically generated in the right encoding, but make sure that you use the right encoding for the FM dictionary, too!}}
Be aware that among these languages, there is considerable variation in the actual depth of support. See [[I18N Status]] for more about that.

== Character Remapping ==

The characters are remapped upon loading the dictionary/readable, from their native encoding to the two special ones (respectively for Latin and Cyrillic) that TDM uses and that are described next. Responsible for the remapping are [[I18N - Character mapping|mapping files]], f.i. "strings/czech.map". If a map file for a specific language is not found in "tdm_base01.pk4/strings" (and there is no "default.map" there, which is the case these days), then no remapping takes place. Generally, ISO-8859-1 languages do not require remapping. The map files for the four ISO-8859-2 languages have identical content.

See '''[[I18N - Character mapping|Character mapping]]''' for more information.

== Font Encoding for European Languages ==

This TDM-specific 8-bit encoding applies to all TDM fonts for English/European languages, that is, everything except the Cyrillic-based Russian. This encoding controls the ordering within a font's binary DAT file.

Note that the double accented characters in Hungarian '''Ő, ő, Ű and ű''' look a bit different from '''Ö, ö, Ü and ü'''!

In the table below, the original ISO 8859-1 characters are given in ''()'' below the TDM character. In addition, printable characters in the range 0x80-0x9f, shown in light or dark green, are also TDM characters, replacing ISO-8859 control characters (not shown).

'''Color code:'''

{{box|#f0d0d0|Character not usable by TDM|Unusable}}{{box|#d0e0d0|Character not yet used in TDM|Unused}}{{box|#c0ffc0|Character displayed in v1.08 or newer|Usable in v1.08}}{{box|#80f080|Character displayed in v2.03 or newer|Usable in v2.03}}{{box|#d0d0f0|Changed from the ISO-8859-1 default, usable by TDM 1.0 or newer|Changed from ISO 8859-1}}

{|class="wikitable" border=1 style="border-collapse: collapse; font-size: 95%" cellspacing=0 cellpadding=2 width=100%

|-
!
!…0
!…1
!…2
!…3
!…4
!…5
!…6
!…7
!…8
!…9
!…A
!…B
!…C
!…D
!…E
!…F

|-
!0…
|align='center' style='background: #f0d0d0'|00 '''–'''
|align='center' style='background: #f0d0d0'|01 '''–'''
|align='center' style='background: #f0d0d0'|02 '''–'''
|align='center' style='background: #f0d0d0'|03 '''–'''
|align='center' style='background: #f0d0d0'|04 '''–'''
|align='center' style='background: #f0d0d0'|05 '''–'''
|align='center' style='background: #f0d0d0'|06 '''–'''
|align='center' style='background: #f0d0d0'|07 '''–'''
|align='center' style='background: #f0d0d0'|08 '''–'''
|align='center' style='background: #f0d0d0'|09 '''–'''
|align='center' style='background: #f0d0d0'|0A '''–'''
|align='center' style='background: #f0d0d0'|0B '''–'''
|align='center' style='background: #f0d0d0'|0C '''–'''
|align='center' style='background: #f0d0d0'|0D '''–'''
|align='center' style='background: #f0d0d0'|0E '''–'''
|align='center' style='background: #f0d0d0'|0F '''–'''

|-
!1…
|align='center' style='background: #f0d0d0'|10 '''–'''
|align='center' style='background: #f0d0d0'|11 '''–'''
|align='center' style='background: #f0d0d0'|12 '''–'''
|align='center' style='background: #f0d0d0'|13 '''–'''
|align='center' style='background: #f0d0d0'|14 '''–'''
|align='center' style='background: #f0d0d0'|15 '''–'''
|align='center' style='background: #f0d0d0'|16 '''–'''
|align='center' style='background: #f0d0d0'|17 '''–'''
|align='center' style='background: #f0d0d0'|18 '''–'''
|align='center' style='background: #f0d0d0'|19 '''–'''
|align='center' style='background: #f0d0d0'|1A '''–'''
|align='center' style='background: #f0d0d0'|1B '''–'''
|align='center' style='background: #f0d0d0'|1C '''–'''
|align='center' style='background: #f0d0d0'|1D '''–'''
|align='center' style='background: #f0d0d0'|1E '''–'''
|align='center' style='background: #f0d0d0'|1F '''–'''

|-
!2…
|align='center'|20 ''' '''
|align='center'|21 '''!'''
|align='center'|22 '''"'''
|align='center'|23 '''#'''
|align='center'|24 '''$'''
|align='center'|25 '''%'''
|align='center'|26 '''&'''
|align='center'|27 '''''''
|align='center'|28 '''('''
|align='center'|29 ''')'''
|align='center'|2A '''*'''
|align='center'|2B '''+'''
|align='center'|2C ''','''
|align='center'|2D '''-'''
|align='center'|2E '''.'''
|align='center'|2F '''/'''

|-
!3…
|align='center'|30 '''0'''
|align='center'|31 '''1'''
|align='center'|32 '''2'''
|align='center'|33 '''3'''
|align='center'|34 '''4'''
|align='center'|35 '''5'''
|align='center'|36 '''6'''
|align='center'|37 '''7'''
|align='center'|38 '''8'''
|align='center'|39 '''9'''
|align='center'|3A ''':'''
|align='center'|3B ''';'''
|align='center'|3C '''<'''
|align='center'|3D '''='''
|align='center'|3E '''>'''
|align='center'|3F '''?'''

|-
!4…
|align='center'|40 '''@'''
|align='center'|41 '''A'''
|align='center'|42 '''B'''
|align='center'|43 '''C'''
|align='center'|44 '''D'''
|align='center'|45 '''E'''
|align='center'|46 '''F'''
|align='center'|47 '''G'''
|align='center'|48 '''H'''
|align='center'|49 '''I'''
|align='center'|4A '''J'''
|align='center'|4B '''K'''
|align='center'|4C '''L'''
|align='center'|4D '''M'''
|align='center'|4E '''N'''
|align='center'|4F '''O'''

|-
!5…
|align='center'|50 '''P'''
|align='center'|51 '''Q'''
|align='center'|52 '''R'''
|align='center'|53 '''S'''
|align='center'|54 '''T'''
|align='center'|55 '''U'''
|align='center'|56 '''V'''
|align='center'|57 '''W'''
|align='center'|58 '''X'''
|align='center'|59 '''Y'''
|align='center'|5A '''Z'''
|align='center'|5B '''['''
|align='center'|5C '''\'''
|align='center'|5D ''']'''
|align='center'|5E '''^'''
|align='center'|5F '''_'''

|-
!6…
|align='center'|60 '''`'''
|align='center'|61 '''a'''
|align='center'|62 '''b'''
|align='center'|63 '''c'''
|align='center'|64 '''d'''
|align='center'|65 '''e'''
|align='center'|66 '''f'''
|align='center'|67 '''g'''
|align='center'|68 '''h'''
|align='center'|69 '''i'''
|align='center'|6A '''j'''
|align='center'|6B '''k'''
|align='center'|6C '''l'''
|align='center'|6D '''m'''
|align='center'|6E '''n'''
|align='center'|6F '''o'''

|-
!7…
|align='center'|70 '''p'''
|align='center'|71 '''q'''
|align='center'|72 '''r'''
|align='center'|73 '''s'''
|align='center'|74 '''t'''
|align='center'|75 '''u'''
|align='center'|76 '''v'''
|align='center'|77 '''w'''
|align='center'|78 '''x'''
|align='center'|79 '''y'''
|align='center'|7A '''z'''
|align='center'|7B '''{'''
|align='center'|7C '''|'''
|align='center'|7D '''}'''
|align='center'|7E '''~'''
|align='center' style='background: #d0e0d0'|7F '''�'''

|-
!8…
|align='center' style='background: #c0ffc0'|80 '''Ň'''
|align='center' style='background: #c0ffc0'|81 '''Ś'''
|align='center' style='background: #c0ffc0'|82 '''Ć'''
|align='center' style='background: #c0ffc0'|83 '''Ż'''
|align='center' style='background: #c0ffc0'|84 '''Ź'''
|align='center' style='background: #c0ffc0'|85 '''Ŝ'''
|align='center' style='background: #c0ffc0'|86 '''Ĉ'''
|align='center' style='background: #c0ffc0'|87 '''Ẑ'''
|align='center' style='background: #c0ffc0'|88 '''Ô''' [1]
|align='center' style='background: #c0ffc0'|89 '''Ŕ'''
|align='center' style='background: #c0ffc0'|8A '''Ǔ'''
|align='center' style='background: #c0ffc0'|8B '''Ă'''
|align='center' style='background: #c0ffc0'|8C '''Ń'''
|align='center' style='background: #80f080'|8D '''Ș'''
|align='center' style='background: #80f080'|8E '''Ț'''
|align='center' style='background: #d0e0d0'|8F '''�'''

|-
!9…
|align='center' style='background: #80f080'|90 '''đ'''
|align='center' style='background: #c0ffc0'|91 '''ś'''
|align='center' style='background: #c0ffc0'|92 '''ć'''
|align='center' style='background: #c0ffc0'|93 '''ż'''
|align='center' style='background: #c0ffc0'|94 '''ź'''
|align='center' style='background: #c0ffc0'|95 '''ŝ'''
|align='center' style='background: #c0ffc0'|96 '''ĉ'''
|align='center' style='background: #c0ffc0'|97 '''ẑ'''
|align='center' style='background: #c0ffc0'|98 '''ô''' [1]
|align='center' style='background: #c0ffc0'|99 '''ŕ'''
|align='center' style='background: #c0ffc0'|9A '''ǔ'''
|align='center' style='background: #c0ffc0'|9B '''ă'''
|align='center' style='background: #c0ffc0'|9C '''ń'''
|align='center' style='background: #80f080'|9D '''ș'''
|align='center' style='background: #80f080'|9E '''ț'''
|align='center' style='background: #d0e0d0'|9F '''�'''

|-
!A…
|align='center'|A0 '''[https://secure.wikimedia.org/wikipedia/en/wiki/Non-breaking_space NBSP]''' [2]
|align='center' style='background: #d0d0f0'|A1 '''ň''' (¡)'''
|align='center' style='background: #d0d0f0'|A2 '''Ű''' (¢)'''
|align='center' style='background: #d0d0f0'|A3 '''ě''' (£)'''
|align='center' style='background: #d0d0f0'|A4 '''ű''' (¤)'''
|align='center' style='background: #d0d0f0'|A5 '''Ě''' (¥)'''
|align='center' style='background: #d0d0f0'|A6 '''Š''' (¦)'''
|align='center'|A7 '''§'''
|align='center' style='background: #d0d0f0'|A8 '''š''' (¨)'''
|align='center' style='background: #d0d0f0'|A9 '''Ů''' (©)'''
|align='center' style='background: #d0d0f0'|AA '''Ą''' (ª)'''
|align='center' style='background: #d0d0f0'|AB '''Ę''' («)'''
|align='center' style='background: #d0d0f0'|AC '''Č''' (¬)'''
|align='center'|AD '''[https://secure.wikimedia.org/wikipedia/en/wiki/Soft_hyphen SHY]''' [2]
|align='center' style='background: #d0d0f0'|AE '''č''' (®)'''
|align='center' style='background: #d0d0f0'|AF '''ů''' (¯)'''

|-
!B…
|align='center' style='background: #d0d0f0'|B0 '''Ő''' (°)'''
|align='center' style='background: #d0d0f0'|B1 '''Ł''' (±)'''
|align='center' style='background: #d0d0f0'|B2 '''Ť''' (²)'''
|align='center' style='background: #d0d0f0'|B3 '''Ď''' (³)'''
|align='center' style='background: #d0d0f0'|B4 '''Ž''' (´)'''
|align='center' style='background: #d0d0f0'|B5 '''ł''' (µ)'''
|align='center' style='background: #d0d0f0'|B6 '''ť''' (¶)'''
|align='center' style='background: #d0d0f0'|B7 '''ď''' (·)'''
|align='center' style='background: #d0d0f0'|B8 '''ž''' (¸)'''
|align='center' style='background: #d0d0f0'|B9 '''ő''' (¹)'''
|align='center' style='background: #d0d0f0'|BA '''ą''' (º)'''
|align='center' style='background: #d0d0f0'|BB '''ę''' (»)'''
|align='center' style='background: #d0d0f0'|BC '''Œ''' (¼)'''
|align='center' style='background: #d0d0f0'|BD '''œ''' (½)'''
|align='center' style='background: #d0d0f0'|BE '''Ÿ''' (¾)'''
|align='center'|BF '''¿'''

|-
!C…
|align='center'|C0 '''À'''
|align='center'|C1 '''Á'''
|align='center'|C2 '''Â'''
|align='center'|C3 '''Ã'''
|align='center'|C4 '''Ä'''
|align='center'|C5 '''Å'''
|align='center'|C6 '''Æ'''
|align='center'|C7 '''Ç'''
|align='center'|C8 '''È'''
|align='center'|C9 '''É'''
|align='center'|CA '''Ê'''
|align='center'|CB '''Ë'''
|align='center'|CC '''Ì'''
|align='center'|CD '''Í'''
|align='center'|CE '''Î'''
|align='center'|CF '''Ï'''

|-
!D…
|align='center'|D0 '''Ð'''
|align='center'|D1 '''Ñ'''
|align='center'|D2 '''Ò'''
|align='center'|D3 '''Ó'''
|align='center'|D4 '''Ô'''
|align='center'|D5 '''Õ'''
|align='center'|D6 '''Ö'''
|align='center' style='background: #d0d0f0'|D7 '''Ř''' (×)'''
|align='center'|D8 '''Ø'''
|align='center'|D9 '''Ù'''
|align='center'|DA '''Ú'''
|align='center'|DB '''Û'''
|align='center'|DC '''Ü'''
|align='center'|DD '''Ý'''
|align='center'|DE '''Þ'''
|align='center'|DF '''ß'''

|-
!E…
|align='center'|E0 '''à'''
|align='center'|E1 '''á'''
|align='center'|E2 '''â'''
|align='center'|E3 '''ã'''
|align='center'|E4 '''ä'''
|align='center'|E5 '''å'''
|align='center'|E6 '''æ'''
|align='center'|E7 '''ç'''
|align='center'|E8 '''è'''
|align='center'|E9 '''é'''
|align='center'|EA '''ê'''
|align='center'|EB '''ë'''
|align='center'|EC '''ì'''
|align='center'|ED '''í'''
|align='center'|EE '''î'''
|align='center'|EF '''ï'''

|-
!F…
|align='center'|F0 '''ð'''
|align='center'|F1 '''ñ'''
|align='center'|F2 '''ò'''
|align='center'|F3 '''ó'''
|align='center'|F4 '''ô'''
|align='center'|F5 '''õ'''
|align='center'|F6 '''ö'''
|align='center' style='background: #d0d0f0'|F7 '''ř''' (÷)'''
|align='center'|F8 '''ø'''
|align='center'|F9 '''ù'''
|align='center'|FA '''ú'''
|align='center'|FB '''û'''
|align='center'|FC '''ü'''
|align='center'|FD '''ý'''
|align='center'|FE '''þ'''
|align='center'|FF '''ÿ'''

|}

==== Table Notes ====

'''[1]''' As discussed [https://forums.thedarkmod.com/index.php?/topic/22427-analysis-of-212-tdm-fonts/&do=findComment&comment=494855 here], the TDM char set has a redundant treatment of 2 characters:

* Ô appears at 0x88 and 0xD4
* ô appears at 0x98 and 0xF4

Starting with TDM 2.13, the redundancy can be removed and these new characters (from ISO-8859-3) introduced:

* Ğ appears at 0x88
* ğ appears at 0x98

'''[2]''' Avoid using the non-breaking space (NBSP, 0xA0) and the soft hyphen (SHY, 0xAD) in your strings. The TDM engine has no code to respect these during word wrap. Font maintainers: probably map NBSP to the <space> glyph, SHY to undefined/hollow box or zero-sized box.

==== Corresponding Unicode ====

For a mapping of these 256 codepoints to Unicode U+NNNN values and formal names, download 'TDM 8859-Style Font Map to Unicode-16.txt':

* [https://drive.google.com/file/d/1wLEtuFvnrZ-WHK8ign8i3diIXZdriZ4F/view?usp=sharing for TDM 2.13]
* [https://drive.google.com/file/d/1UAz9jSZpT_j33STP3So_Re8JWa8QuAmz/view?usp=sharing for TDM 2.12 and earlier]

Each of these files (by Geep, 2024) is in a standardized format so that it can also be imported into font design programs like FontForge as a custom 256-position map. In the comments, there is additional information about:
* ISO 8859-x sourcing of each character.
* alternative representations of some European and control characters.

==== Access to TDM Characters from Various Languages ====
See [[Multilanguage Display]], which includes an itemized table of characters across TDM/ISO codemaps. This discusses which characters (assuming the font implements them) the translator can...
* enter directly
* enter by tricks
* not currently access.

==== Fonts with Special Characters ====
Certain fonts have a few codepoints that purposefully diverge from the table entry.

* Carleton font (regular, bold, glow) uses codepoint 0x23, ordinarily "#", to represent "superscript #", which is used in the main menu system to indicate FMs for which a translation pack is available.
* Treasure Map font has characters for "pirate skull and crossbones" and "bottle of booze (or poison)".

== European Character Implementation ==
=== Priority Early-On: the "Top 50" ===

Some of the special characters are used more often than others. Here is a statistic over the entire string set of the TDM core, from TDM v1.08, showing the top 50 most-used characters, exclusive of ASCII (e.g., a-z, 0-9) and Russian characters:

{|class="wikitable mw-collapsible mw-collapsed" border=1 style="border-collapse: collapse; font-size: 85%" cellspacing=0 cellpadding=2 data-expandtext="Show" data-collapsetext="Hide"

|-
|Rank
|Occurances
|Letter
|Remarks
|Rank
|Occurances
|Letter
|Remarks .

|-
|1
|í
|715
|
|25
|ć
|67
|

|-
|2
|é
|674
|
|26
|è
|65
|

|-
|3
|á
|524
|
|27
|ú
|56
|

|-
|4
|ø
|303
|Danish
|28
|ê
|52
|

|-
|5
|č
|288
|
|29
|ö
|48
|German

|-
|6
|ó
|283
|
|30
|É
|46
|

|-
|7
|ü
|270
|German
|31
|ñ
|37
|

|-
|8
|ł
|203
|Polish
|32
|õ
|32
|

|-
|9
|æ
|200
|Danish
|33
|ń
|26
|

|-
|10
|ě
|182
|
|34
|Ł
|24
|

|-
|11
|ř
|175
|Czech
|35
|Š
|21
|

|-
|12
|ã
|168
|
|36
|â
|21
|

|-
|13
|ž
|148
|Czech
|37
|ź
|20
|

|-
|14
|ý
|142
|
|38
|ß
|18
|German

|-
|15
|ę
|141
|
|39
|Ó
|18
|

|-
|16
|ą
|140
|
|40
|ň
|15
|

|-
|17
|ż
|119
|
|41
|Ú
|15
|

|-
|18
|å
|109
|Danish
|42
|Á
|13
|

|-
|19
|š
|99
|
|43
|î
|12
|

|-
|20
|ś
|97
|
|44
|ť
|11
|

|-
|21
|ç
|91
|
|45
|ô
|9
|

|-
|22
|ä
|86
|German
|46
|Ž
|8
|

|-
|23
|à
|83
|
|47
|Ż
|7
|

|-
|24
|ů
|77
|
|48
|Č
|7
|

|-
|25
|ć
|67
|
|49
|ù
|6
|

|}

Although ö, ä and ü do not appear that often, with only these and Ü, Ö, Ä and ß, the entire German language works. So adding these letters to the fonts is quite important.

Preferably, all foreign letters would be added to the fonts (see [[Font Patcher]] or [[Refont]]). However, if time permits only adding a few, '''í''' would be more important than, say, '''ô'''.

It is commonplace for missing accented letters to be redirected in the .dat file to the corresponding unaccented base letter.

=== Coverage Expansion & Remaining Limitations ===

By 2014, all the system (e.g., main menu) fonts (Carleton, Carleton_condensed, Stone in sizes 24pt and 48pt; Mason and Mason_glow in 48pt) had good coverage of the "Top 50" and beyond, although not all 256 codepoints.
This was confirmed more specifically in 2024, as part of an [https://forums.thedarkmod.com/index.php?/topic/22427-analysis-of-212-tdm-fonts/ Analysis of 2.12 Fonts]. This analysis indicated that, unlike the system fonts, the FM fonts generally did not provide specific glyphs beyond ASCII.

In 2024, Stone 24pt, important for subtitles and a number of readables, was further extended to cover all 256 codepoints. This was tested with TDM 2.13[betas] and released with 2.14.

In 2026, English/European Carleton 24pt, widely used in the main menu and also some readables, was improved to:
* extend coverage to all codepoints
* replace sloppy hand-drawn Latin-1 glyphs with fresh glyphs, most of them generated from TTF then edge-darkened
* for simplicity, re-implement the red "glow" effect as if a drop-shadow.

Testing of this is planned with TDM 2.15 betas.

Stone 48pt improvements are under consideration for TDM 2.15.

== Font Encoding for Russian Cyrillic ==

Characters conform to the [https://en.wikipedia.org/wiki/Win-1251 WIN-1251 native encoding, shown in the Wikipedia article]. Exception: the character '''0xFF''' (я) is mapped to '''0xB6''' upon loading. Therefore any Russian font must contain я at the place 0xB6. (This was to overcome a historical Doom3 bug that is now fixed. But to date "the remapping for Russian is still in place, tho, to avoid having to patch all the russian fonts", says bug report [https://bugs.thedarkmod.com/view.php?id=2812 "0002812: Character 0xFF does not work in fonts"]).

=== Cyrillic Character Implementation ===
Within any given font, character coverage may be incomplete.

In 2025, the Russian Mason 48pt font was improved and extended to cover all TDM Russian codepoints, and included in TDM 2.14.

== Possible Future Extensions ==
=== To Additional Latin and Cyrillic Languages? ===
TDM's core all.lang file has #str_ for the names of a few additional languages, not yet supported or exposed in the game interface, that could be built out:

==== Latin Alphabet ====
* Croatian / Hrvatski
* Norse / Norsk
* Finnish / Suomi
* Slovenian (differs from Slovak; for southern Slovenia) / Slovenšcina

==== Cyrillic Alphabet ====
* Bulgarian / Bugarian / Български
* Serbian / Srpski / Српски
* Ukrainian (regional) / Українська

There are no doubt other languages that could be supported by TDM's existing suite of 8-bit encodings.
=== To Unicode? ===
It is possible to visualize a transition to a DAT format (and engine code) that supported UCS (16-bit) Unicode, allowing the existing fonts to then be expanded to cover more characters. Then perhaps all.lang would be the only .lang needed.
=== To Asian Languages (Korean, Chinese, Japanese)? ===
The original D3 had support for Asian languages, so it might be possible to add them to TDM, too, but with a heavy burden on font development and translation. Also, writing from right-to-left (Hebrew) or top-down (Japanese) might be tricky or outright impossible in our GUI without more work in the C++ code. Plus, these languages use more than 256 different characters, and an 8 bit table will not hold these.

[[Category:Fonts]]

{{i18n}}

I18N - Charset

2026-06-28T19:34:55Z

Geep: /* All other language files */ note variation in depth of support, with link

== Introduction ==

The D3 code that handles the GUI bitmap font can only load a specific range of bytes as characters. To get the most out of the available entries, special charsets are used. The fonts (Carleton for the menu f.i.) are build/patched so that the right characters appear in the right place.

== LANG File Encodings ==

=== all.lang ===

This file is in '''UTF-8''', and converted with the help of either the script '''devel/gen_lang.pl''':

perl devel/gen_lang.pl

or, more recently, the Windows C++ utility program '''gen_lang_plus'''. [[Gen_Lang_Programs]] has details of these.

This process ensures that the generated language files are in their proper encodings (see below).

=== All other language files ===

Language-specific files (f.i. '''german.lang''') provide string dictionaries. A system-wide set is provided in tdm_base01.pk4/strings/. A deployed FM may offer similar files in its /strings/ folder... at the very least '''english.lang'''. All such files are expected to be in the following 8-bit encodings:

* '''Czech, Hungarian, Slovak, Polish:''' [https://secure.wikimedia.org/wikipedia/en/wiki/ISO/IEC_8859-2 ISO-8859-2] ('''not WIN-1250!)
* '''Russian:''' [https://secure.wikimedia.org/wikipedia/en/wiki/Win-1251 WIN-1251]
* '''French:''' [https://secure.wikimedia.org/wikipedia/en/wiki/ISO/IEC_8859-15 ISO-8859-15]
* '''Romanian:''' [https://secure.wikimedia.org/wikipedia/en/wiki/ISO/IEC_8859-16 ISO-8859-16]
* '''Turkish:''' [https://secure.wikimedia.org/wikipedia/en/wiki/ISO/IEC_8859-9 ISO-8859-9]
* '''All other languages:''' [https://secure.wikimedia.org/wikipedia/en/wiki/ISO/IEC_8859-1 ISO-8859-1]. This covers TDM-supported languages English, German, Italian, Spanish, Portuguese, Swedish, Danish, Dutch, and Catalan.

{{infobox|The core dictionaries are automatically generated in the right encoding, but make sure that you use the right encoding for the FM dictionary, too!}}
Be aware that among these languages, there is considerable variation in the actual depth of support. See [[I18N Status]] for more about that.

== Character Remapping ==

The characters are remapped upon loading the dictionary/readable, from their native encoding to the two special ones (respectively for Latin and Cyrillic) that TDM uses and that are described next. Responsible for the remapping are [[I18N - Character mapping|mapping files]], f.i. "strings/czech.map". If a map file for a specific language is not found in "tdm_base01.pk4/strings" (and there is no "default.map" there, which is the case these days), then no remapping takes place. Generally, ISO-8859-1 languages do not require remapping. The map files for the four ISO-8859-2 languages have identical content.

See '''[[I18N - Character mapping|Character mapping]]''' for more information.

== Font Encoding for European Languages ==

This TDM-specific 8-bit encoding applies to all TDM fonts for English/European languages, that is, everything except the Cyrillic-based Russian. This encoding controls the ordering within a font's binary DAT file.

Note that the double accented characters in Hungarian '''Ő, ő, Ű and ű''' look a bit different from '''Ö, ö, Ü and ü'''!

In the table below, the original ISO 8859-1 characters are given in ''()'' below the TDM character. In addition, printable characters in the range 0x80-0x9f, shown in light or dark green, are also TDM characters, replacing ISO-8859 control characters (not shown).

'''Color code:'''

{{box|#f0d0d0|Character not usable by TDM|Unusable}}{{box|#d0e0d0|Character not yet used in TDM|Unused}}{{box|#c0ffc0|Character displayed in v1.08 or newer|Usable in v1.08}}{{box|#80f080|Character displayed in v2.03 or newer|Usable in v2.03}}{{box|#d0d0f0|Changed from the ISO-8859-1 default, usable by TDM 1.0 or newer|Changed from ISO 8859-1}}

{|class="wikitable" border=1 style="border-collapse: collapse; font-size: 95%" cellspacing=0 cellpadding=2 width=100%

|-
!
!…0
!…1
!…2
!…3
!…4
!…5
!…6
!…7
!…8
!…9
!…A
!…B
!…C
!…D
!…E
!…F

|-
!0…
|align='center' style='background: #f0d0d0'|00 '''–'''
|align='center' style='background: #f0d0d0'|01 '''–'''
|align='center' style='background: #f0d0d0'|02 '''–'''
|align='center' style='background: #f0d0d0'|03 '''–'''
|align='center' style='background: #f0d0d0'|04 '''–'''
|align='center' style='background: #f0d0d0'|05 '''–'''
|align='center' style='background: #f0d0d0'|06 '''–'''
|align='center' style='background: #f0d0d0'|07 '''–'''
|align='center' style='background: #f0d0d0'|08 '''–'''
|align='center' style='background: #f0d0d0'|09 '''–'''
|align='center' style='background: #f0d0d0'|0A '''–'''
|align='center' style='background: #f0d0d0'|0B '''–'''
|align='center' style='background: #f0d0d0'|0C '''–'''
|align='center' style='background: #f0d0d0'|0D '''–'''
|align='center' style='background: #f0d0d0'|0E '''–'''
|align='center' style='background: #f0d0d0'|0F '''–'''

|-
!1…
|align='center' style='background: #f0d0d0'|10 '''–'''
|align='center' style='background: #f0d0d0'|11 '''–'''
|align='center' style='background: #f0d0d0'|12 '''–'''
|align='center' style='background: #f0d0d0'|13 '''–'''
|align='center' style='background: #f0d0d0'|14 '''–'''
|align='center' style='background: #f0d0d0'|15 '''–'''
|align='center' style='background: #f0d0d0'|16 '''–'''
|align='center' style='background: #f0d0d0'|17 '''–'''
|align='center' style='background: #f0d0d0'|18 '''–'''
|align='center' style='background: #f0d0d0'|19 '''–'''
|align='center' style='background: #f0d0d0'|1A '''–'''
|align='center' style='background: #f0d0d0'|1B '''–'''
|align='center' style='background: #f0d0d0'|1C '''–'''
|align='center' style='background: #f0d0d0'|1D '''–'''
|align='center' style='background: #f0d0d0'|1E '''–'''
|align='center' style='background: #f0d0d0'|1F '''–'''

|-
!2…
|align='center'|20 ''' '''
|align='center'|21 '''!'''
|align='center'|22 '''"'''
|align='center'|23 '''#'''
|align='center'|24 '''$'''
|align='center'|25 '''%'''
|align='center'|26 '''&'''
|align='center'|27 '''''''
|align='center'|28 '''('''
|align='center'|29 ''')'''
|align='center'|2A '''*'''
|align='center'|2B '''+'''
|align='center'|2C ''','''
|align='center'|2D '''-'''
|align='center'|2E '''.'''
|align='center'|2F '''/'''

|-
!3…
|align='center'|30 '''0'''
|align='center'|31 '''1'''
|align='center'|32 '''2'''
|align='center'|33 '''3'''
|align='center'|34 '''4'''
|align='center'|35 '''5'''
|align='center'|36 '''6'''
|align='center'|37 '''7'''
|align='center'|38 '''8'''
|align='center'|39 '''9'''
|align='center'|3A ''':'''
|align='center'|3B ''';'''
|align='center'|3C '''<'''
|align='center'|3D '''='''
|align='center'|3E '''>'''
|align='center'|3F '''?'''

|-
!4…
|align='center'|40 '''@'''
|align='center'|41 '''A'''
|align='center'|42 '''B'''
|align='center'|43 '''C'''
|align='center'|44 '''D'''
|align='center'|45 '''E'''
|align='center'|46 '''F'''
|align='center'|47 '''G'''
|align='center'|48 '''H'''
|align='center'|49 '''I'''
|align='center'|4A '''J'''
|align='center'|4B '''K'''
|align='center'|4C '''L'''
|align='center'|4D '''M'''
|align='center'|4E '''N'''
|align='center'|4F '''O'''

|-
!5…
|align='center'|50 '''P'''
|align='center'|51 '''Q'''
|align='center'|52 '''R'''
|align='center'|53 '''S'''
|align='center'|54 '''T'''
|align='center'|55 '''U'''
|align='center'|56 '''V'''
|align='center'|57 '''W'''
|align='center'|58 '''X'''
|align='center'|59 '''Y'''
|align='center'|5A '''Z'''
|align='center'|5B '''['''
|align='center'|5C '''\'''
|align='center'|5D ''']'''
|align='center'|5E '''^'''
|align='center'|5F '''_'''

|-
!6…
|align='center'|60 '''`'''
|align='center'|61 '''a'''
|align='center'|62 '''b'''
|align='center'|63 '''c'''
|align='center'|64 '''d'''
|align='center'|65 '''e'''
|align='center'|66 '''f'''
|align='center'|67 '''g'''
|align='center'|68 '''h'''
|align='center'|69 '''i'''
|align='center'|6A '''j'''
|align='center'|6B '''k'''
|align='center'|6C '''l'''
|align='center'|6D '''m'''
|align='center'|6E '''n'''
|align='center'|6F '''o'''

|-
!7…
|align='center'|70 '''p'''
|align='center'|71 '''q'''
|align='center'|72 '''r'''
|align='center'|73 '''s'''
|align='center'|74 '''t'''
|align='center'|75 '''u'''
|align='center'|76 '''v'''
|align='center'|77 '''w'''
|align='center'|78 '''x'''
|align='center'|79 '''y'''
|align='center'|7A '''z'''
|align='center'|7B '''{'''
|align='center'|7C '''|'''
|align='center'|7D '''}'''
|align='center'|7E '''~'''
|align='center' style='background: #d0e0d0'|7F '''�'''

|-
!8…
|align='center' style='background: #c0ffc0'|80 '''Ň'''
|align='center' style='background: #c0ffc0'|81 '''Ś'''
|align='center' style='background: #c0ffc0'|82 '''Ć'''
|align='center' style='background: #c0ffc0'|83 '''Ż'''
|align='center' style='background: #c0ffc0'|84 '''Ź'''
|align='center' style='background: #c0ffc0'|85 '''Ŝ'''
|align='center' style='background: #c0ffc0'|86 '''Ĉ'''
|align='center' style='background: #c0ffc0'|87 '''Ẑ'''
|align='center' style='background: #c0ffc0'|88 '''Ô''' [1]
|align='center' style='background: #c0ffc0'|89 '''Ŕ'''
|align='center' style='background: #c0ffc0'|8A '''Ǔ'''
|align='center' style='background: #c0ffc0'|8B '''Ă'''
|align='center' style='background: #c0ffc0'|8C '''Ń'''
|align='center' style='background: #80f080'|8D '''Ș'''
|align='center' style='background: #80f080'|8E '''Ț'''
|align='center' style='background: #d0e0d0'|8F '''�'''

|-
!9…
|align='center' style='background: #80f080'|90 '''đ'''
|align='center' style='background: #c0ffc0'|91 '''ś'''
|align='center' style='background: #c0ffc0'|92 '''ć'''
|align='center' style='background: #c0ffc0'|93 '''ż'''
|align='center' style='background: #c0ffc0'|94 '''ź'''
|align='center' style='background: #c0ffc0'|95 '''ŝ'''
|align='center' style='background: #c0ffc0'|96 '''ĉ'''
|align='center' style='background: #c0ffc0'|97 '''ẑ'''
|align='center' style='background: #c0ffc0'|98 '''ô''' [1]
|align='center' style='background: #c0ffc0'|99 '''ŕ'''
|align='center' style='background: #c0ffc0'|9A '''ǔ'''
|align='center' style='background: #c0ffc0'|9B '''ă'''
|align='center' style='background: #c0ffc0'|9C '''ń'''
|align='center' style='background: #80f080'|9D '''ș'''
|align='center' style='background: #80f080'|9E '''ț'''
|align='center' style='background: #d0e0d0'|9F '''�'''

|-
!A…
|align='center'|A0 '''[https://secure.wikimedia.org/wikipedia/en/wiki/Non-breaking_space NBSP]''' [2]
|align='center' style='background: #d0d0f0'|A1 '''ň''' (¡)'''
|align='center' style='background: #d0d0f0'|A2 '''Ű''' (¢)'''
|align='center' style='background: #d0d0f0'|A3 '''ě''' (£)'''
|align='center' style='background: #d0d0f0'|A4 '''ű''' (¤)'''
|align='center' style='background: #d0d0f0'|A5 '''Ě''' (¥)'''
|align='center' style='background: #d0d0f0'|A6 '''Š''' (¦)'''
|align='center'|A7 '''§'''
|align='center' style='background: #d0d0f0'|A8 '''š''' (¨)'''
|align='center' style='background: #d0d0f0'|A9 '''Ů''' (©)'''
|align='center' style='background: #d0d0f0'|AA '''Ą''' (ª)'''
|align='center' style='background: #d0d0f0'|AB '''Ę''' («)'''
|align='center' style='background: #d0d0f0'|AC '''Č''' (¬)'''
|align='center'|AD '''[https://secure.wikimedia.org/wikipedia/en/wiki/Soft_hyphen SHY]''' [2]
|align='center' style='background: #d0d0f0'|AE '''č''' (®)'''
|align='center' style='background: #d0d0f0'|AF '''ů''' (¯)'''

|-
!B…
|align='center' style='background: #d0d0f0'|B0 '''Ő''' (°)'''
|align='center' style='background: #d0d0f0'|B1 '''Ł''' (±)'''
|align='center' style='background: #d0d0f0'|B2 '''Ť''' (²)'''
|align='center' style='background: #d0d0f0'|B3 '''Ď''' (³)'''
|align='center' style='background: #d0d0f0'|B4 '''Ž''' (´)'''
|align='center' style='background: #d0d0f0'|B5 '''ł''' (µ)'''
|align='center' style='background: #d0d0f0'|B6 '''ť''' (¶)'''
|align='center' style='background: #d0d0f0'|B7 '''ď''' (·)'''
|align='center' style='background: #d0d0f0'|B8 '''ž''' (¸)'''
|align='center' style='background: #d0d0f0'|B9 '''ő''' (¹)'''
|align='center' style='background: #d0d0f0'|BA '''ą''' (º)'''
|align='center' style='background: #d0d0f0'|BB '''ę''' (»)'''
|align='center' style='background: #d0d0f0'|BC '''Œ''' (¼)'''
|align='center' style='background: #d0d0f0'|BD '''œ''' (½)'''
|align='center' style='background: #d0d0f0'|BE '''Ÿ''' (¾)'''
|align='center'|BF '''¿'''

|-
!C…
|align='center'|C0 '''À'''
|align='center'|C1 '''Á'''
|align='center'|C2 '''Â'''
|align='center'|C3 '''Ã'''
|align='center'|C4 '''Ä'''
|align='center'|C5 '''Å'''
|align='center'|C6 '''Æ'''
|align='center'|C7 '''Ç'''
|align='center'|C8 '''È'''
|align='center'|C9 '''É'''
|align='center'|CA '''Ê'''
|align='center'|CB '''Ë'''
|align='center'|CC '''Ì'''
|align='center'|CD '''Í'''
|align='center'|CE '''Î'''
|align='center'|CF '''Ï'''

|-
!D…
|align='center'|D0 '''Ð'''
|align='center'|D1 '''Ñ'''
|align='center'|D2 '''Ò'''
|align='center'|D3 '''Ó'''
|align='center'|D4 '''Ô'''
|align='center'|D5 '''Õ'''
|align='center'|D6 '''Ö'''
|align='center' style='background: #d0d0f0'|D7 '''Ř''' (×)'''
|align='center'|D8 '''Ø'''
|align='center'|D9 '''Ù'''
|align='center'|DA '''Ú'''
|align='center'|DB '''Û'''
|align='center'|DC '''Ü'''
|align='center'|DD '''Ý'''
|align='center'|DE '''Þ'''
|align='center'|DF '''ß'''

|-
!E…
|align='center'|E0 '''à'''
|align='center'|E1 '''á'''
|align='center'|E2 '''â'''
|align='center'|E3 '''ã'''
|align='center'|E4 '''ä'''
|align='center'|E5 '''å'''
|align='center'|E6 '''æ'''
|align='center'|E7 '''ç'''
|align='center'|E8 '''è'''
|align='center'|E9 '''é'''
|align='center'|EA '''ê'''
|align='center'|EB '''ë'''
|align='center'|EC '''ì'''
|align='center'|ED '''í'''
|align='center'|EE '''î'''
|align='center'|EF '''ï'''

|-
!F…
|align='center'|F0 '''ð'''
|align='center'|F1 '''ñ'''
|align='center'|F2 '''ò'''
|align='center'|F3 '''ó'''
|align='center'|F4 '''ô'''
|align='center'|F5 '''õ'''
|align='center'|F6 '''ö'''
|align='center' style='background: #d0d0f0'|F7 '''ř''' (÷)'''
|align='center'|F8 '''ø'''
|align='center'|F9 '''ù'''
|align='center'|FA '''ú'''
|align='center'|FB '''û'''
|align='center'|FC '''ü'''
|align='center'|FD '''ý'''
|align='center'|FE '''þ'''
|align='center'|FF '''ÿ'''

|}

==== Table Notes ====

'''[1]''' As discussed [https://forums.thedarkmod.com/index.php?/topic/22427-analysis-of-212-tdm-fonts/&do=findComment&comment=494855 here], the TDM char set has a redundant treatment of 2 characters:

* Ô appears at 0x88 and 0xD4
* ô appears at 0x98 and 0xF4

Starting with TDM 2.13, the redundancy can be removed and these new characters (from ISO-8859-3) introduced:

* Ğ appears at 0x88
* ğ appears at 0x98

'''[2]''' Avoid using the non-breaking space (NBSP, 0xA0) and the soft hyphen (SHY, 0xAD) in your strings. The TDM engine has no code to respect these during word wrap. Font maintainers: probably map NBSP to the <space> glyph, SHY to undefined/hollow box or zero-sized box.

==== Corresponding Unicode ====

For a mapping of these 256 codepoints to Unicode U+NNNN values and formal names, download 'TDM 8859-Style Font Map to Unicode-16.txt':

* [https://drive.google.com/file/d/1wLEtuFvnrZ-WHK8ign8i3diIXZdriZ4F/view?usp=sharing for TDM 2.13]
* [https://drive.google.com/file/d/1UAz9jSZpT_j33STP3So_Re8JWa8QuAmz/view?usp=sharing for TDM 2.12 and earlier]

Each of these files (by Geep, 2024) is in a standardized format so that it can also be imported into font design programs like FontForge as a custom 256-position map. In the comments, there is additional information about:
* ISO 8859-x sourcing of each character.
* alternative representations of some European and control characters.

==== Access to TDM Characters from Various Languages ====
See [[Multilanguage Display]], which includes an itemized table of characters across TDM/ISO codemaps. This discusses which characters (assuming the font implements them) the translator can...
* enter directly
* enter by tricks
* not currently access.

==== Fonts with Special Characters ====
Certain fonts have a few codepoints that purposefully diverge from the table entry.

* Carleton font (regular, bold, glow) uses codepoint 0x23, ordinarily "#", to represent "superscript #", which is used in the main menu system to indicate FMs for which a translation pack is available.
* Treasure Map font has characters for "pirate skull and crossbones" and "bottle of booze (or poison)".

== European Character Implementation ==
=== Priority Early-On - the "Top 50" ===

Some of the special characters are used more often than others. Here is a statistic over the entire string set of the TDM core, from TDM v1.08, showing the top 50 most-used characters (excluding a-z, 0-9 and russian characters):

{|class="wikitable" border=1 style="border-collapse: collapse; font-size: 85%" cellspacing=0 cellpadding=2

|-
|Rank
|Occurances
|Letter
|Remarks
|Rank
|Occurances
|Letter
|Remarks

|-
|1
|í
|715
|
|25
|ć
|67
|

|-
|2
|é
|674
|
|26
|è
|65
|

|-
|3
|á
|524
|
|27
|ú
|56
|

|-
|4
|ø
|303
|Danish
|28
|ê
|52
|

|-
|5
|č
|288
|
|29
|ö
|48
|German

|-
|6
|ó
|283
|
|30
|É
|46
|

|-
|7
|ü
|270
|German
|31
|ñ
|37
|

|-
|8
|ł
|203
|Polish
|32
|õ
|32
|

|-
|9
|æ
|200
|Danish
|33
|ń
|26
|

|-
|10
|ě
|182
|
|34
|Ł
|24
|

|-
|11
|ř
|175
|Czech
|35
|Š
|21
|

|-
|12
|ã
|168
|
|36
|â
|21
|

|-
|13
|ž
|148
|Czech
|37
|ź
|20
|

|-
|14
|ý
|142
|
|38
|ß
|18
|German

|-
|15
|ę
|141
|
|39
|Ó
|18
|

|-
|16
|ą
|140
|
|40
|ň
|15
|

|-
|17
|ż
|119
|
|41
|Ú
|15
|

|-
|18
|å
|109
|Danish
|42
|Á
|13
|

|-
|19
|š
|99
|
|43
|î
|12
|

|-
|20
|ś
|97
|
|44
|ť
|11
|

|-
|21
|ç
|91
|
|45
|ô
|9
|

|-
|22
|ä
|86
|German
|46
|Ž
|8
|

|-
|23
|à
|83
|
|47
|Ż
|7
|

|-
|24
|ů
|77
|
|48
|Č
|7
|

|-
|25
|ć
|67
|
|49
|ù
|6
|

|}

Although ö, ä and ü do not appear that often, with only these and Ü, Ö, Ä and ß, the entire German language works. So adding these letters to the fonts is quite important.

Preferably, all foreign letters would be added to the fonts (see [[Font Patcher]] or [[Refont]]). However, if time permits only adding a few, '''í''' would be more important than, say, '''ô'''.

It is commonplace for missing accented letters to be redirected in the .dat file to the corresponding unaccented base letter.

=== Coverage Expansion & Remaining Limitations ===

By 2014, all the system (e.g., main menu) fonts (Carleton, Carleton_condensed, Stone in sizes 24pt and 48pt; Mason and Mason_glow in 48pt) had good coverage of the "Top 50" and beyond, although not all 256 codepoints.
This was confirmed more specifically in 2024, as part of an [https://forums.thedarkmod.com/index.php?/topic/22427-analysis-of-212-tdm-fonts/ Analysis of 2.12 Fonts]. This analysis indicated that, unlike the system fonts, the FM fonts generally did not provide specific glyphs beyond ASCII.

In 2024, Stone 24pt, important for subtitles and a number of readables, was further extended to cover all 256 codepoints. This was tested with TDM 2.13[betas] and released with 2.14.

In 2026, English/European Carleton 24pt, widely used in the main menu and also some readables, was improved to:
* extend coverage to all codepoints
* replace sloppy hand-drawn Latin-1 glyphs with fresh glyphs, most of them generated from TTF then edge-darkened
* for simplicity, re-implement the red "glow" effect as if a drop-shadow.

Testing of this is planned with TDM 2.15 betas.

Stone 48pt improvements are under consideration for TDM 2.15.

== Font Encoding for Russian Cyrillic ==

Characters conform to the [https://en.wikipedia.org/wiki/Win-1251 WIN-1251 native encoding, shown in the Wikipedia article]. Exception: the character '''0xFF''' (я) is mapped to '''0xB6''' upon loading. Therefore any Russian font must contain я at the place 0xB6. (This was to overcome a historical Doom3 bug that is now fixed. But to date "the remapping for Russian is still in place, tho, to avoid having to patch all the russian fonts", says bug report [https://bugs.thedarkmod.com/view.php?id=2812 "0002812: Character 0xFF does not work in fonts"]).

=== Cyrillic Character Implementation ===
Within any given font, character coverage may be incomplete.

In 2025, the Russian Mason 48pt font was improved and extended to cover all TDM Russian codepoints, and included in TDM 2.14.

== Possible Future Extensions ==
=== To Additional Latin and Cyrillic Languages? ===
TDM's core all.lang file has #str_ for the names of a few additional languages, not yet supported or exposed in the game interface, that could be built out:

==== Latin Alphabet ====
* Croatian / Hrvatski
* Norse / Norsk
* Finnish / Suomi
* Slovenian (differs from Slovak; for southern Slovenia) / Slovenšcina

==== Cyrillic Alphabet ====
* Bulgarian / Bugarian / Български
* Serbian / Srpski / Српски
* Ukrainian (regional) / Українська

There are no doubt other languages that could be supported by TDM's existing suite of 8-bit encodings.
=== To Unicode? ===
It is possible to visualize a transition to a DAT format (and engine code) that supported UCS (16-bit) Unicode, allowing the existing fonts to then be expanded to cover more characters. Then perhaps all.lang would be the only .lang needed.
=== To Asian Languages (Korean, Chinese, Japanese)? ===
The original D3 had support for Asian languages, so it might be possible to add them to TDM, too, but with a heavy burden on font development and translation. Also, writing from right-to-left (Hebrew) or top-down (Japanese) might be tricky or outright impossible in our GUI without more work in the C++ code. Plus, these languages use more than 256 different characters, and an 8 bit table will not hold these.

[[Category:Fonts]]

{{i18n}}

I18N - Charset

2026-06-28T19:24:32Z

Geep: /* Future Extensions to Unicode and/or Asian Languages (Korean, Chinese, Japanese)? */ Restructure, list other languages

== Introduction ==

The D3 code that handles the GUI bitmap font can only load a specific range of bytes as characters. To get the most out of the available entries, special charsets are used. The fonts (Carleton for the menu f.i.) are build/patched so that the right characters appear in the right place.

== LANG File Encodings ==

=== all.lang ===

This file is in '''UTF-8''', and converted with the help of either the script '''devel/gen_lang.pl''':

perl devel/gen_lang.pl

or, more recently, the Windows C++ utility program '''gen_lang_plus'''. [[Gen_Lang_Programs]] has details of these.

This process ensures that the generated language files are in their proper encodings (see below).

=== All other language files ===

Language-specific files (f.i. '''german.lang''') provide string dictionaries. A system-wide set is provided in tdm_base01.pk4/strings/. A deployed FM may offer similar files in its /strings/ folder... at the very least '''english.lang'''. All such files are expected to be in the following 8-bit encodings:

* '''Czech, Hungarian, Slovak, Polish:''' [https://secure.wikimedia.org/wikipedia/en/wiki/ISO/IEC_8859-2 ISO-8859-2] ('''not WIN-1250!)
* '''Russian:''' [https://secure.wikimedia.org/wikipedia/en/wiki/Win-1251 WIN-1251]
* '''French:''' [https://secure.wikimedia.org/wikipedia/en/wiki/ISO/IEC_8859-15 ISO-8859-15]
* '''Romanian:''' [https://secure.wikimedia.org/wikipedia/en/wiki/ISO/IEC_8859-16 ISO-8859-16]
* '''Turkish:''' [https://secure.wikimedia.org/wikipedia/en/wiki/ISO/IEC_8859-9 ISO-8859-9]
* '''All other languages:''' [https://secure.wikimedia.org/wikipedia/en/wiki/ISO/IEC_8859-1 ISO-8859-1]. This covers TDM-supported languages English, German, Italian, Spanish, Portuguese, Swedish, Danish, Dutch, and Catalan.

{{infobox|The core dictionaries are automatically generated in the right encoding, but make sure that you use the right encoding for the FM dictionary, too!}}

== Character Remapping ==

The characters are remapped upon loading the dictionary/readable, from their native encoding to the two special ones (respectively for Latin and Cyrillic) that TDM uses and that are described next. Responsible for the remapping are [[I18N - Character mapping|mapping files]], f.i. "strings/czech.map". If a map file for a specific language is not found in "tdm_base01.pk4/strings" (and there is no "default.map" there, which is the case these days), then no remapping takes place. Generally, ISO-8859-1 languages do not require remapping. The map files for the four ISO-8859-2 languages have identical content.

See '''[[I18N - Character mapping|Character mapping]]''' for more information.

== Font Encoding for European Languages ==

This TDM-specific 8-bit encoding applies to all TDM fonts for English/European languages, that is, everything except the Cyrillic-based Russian. This encoding controls the ordering within a font's binary DAT file.

Note that the double accented characters in Hungarian '''Ő, ő, Ű and ű''' look a bit different from '''Ö, ö, Ü and ü'''!

In the table below, the original ISO 8859-1 characters are given in ''()'' below the TDM character. In addition, printable characters in the range 0x80-0x9f, shown in light or dark green, are also TDM characters, replacing ISO-8859 control characters (not shown).

'''Color code:'''

{{box|#f0d0d0|Character not usable by TDM|Unusable}}{{box|#d0e0d0|Character not yet used in TDM|Unused}}{{box|#c0ffc0|Character displayed in v1.08 or newer|Usable in v1.08}}{{box|#80f080|Character displayed in v2.03 or newer|Usable in v2.03}}{{box|#d0d0f0|Changed from the ISO-8859-1 default, usable by TDM 1.0 or newer|Changed from ISO 8859-1}}

{|class="wikitable" border=1 style="border-collapse: collapse; font-size: 95%" cellspacing=0 cellpadding=2 width=100%

|-
!
!…0
!…1
!…2
!…3
!…4
!…5
!…6
!…7
!…8
!…9
!…A
!…B
!…C
!…D
!…E
!…F

|-
!0…
|align='center' style='background: #f0d0d0'|00 '''–'''
|align='center' style='background: #f0d0d0'|01 '''–'''
|align='center' style='background: #f0d0d0'|02 '''–'''
|align='center' style='background: #f0d0d0'|03 '''–'''
|align='center' style='background: #f0d0d0'|04 '''–'''
|align='center' style='background: #f0d0d0'|05 '''–'''
|align='center' style='background: #f0d0d0'|06 '''–'''
|align='center' style='background: #f0d0d0'|07 '''–'''
|align='center' style='background: #f0d0d0'|08 '''–'''
|align='center' style='background: #f0d0d0'|09 '''–'''
|align='center' style='background: #f0d0d0'|0A '''–'''
|align='center' style='background: #f0d0d0'|0B '''–'''
|align='center' style='background: #f0d0d0'|0C '''–'''
|align='center' style='background: #f0d0d0'|0D '''–'''
|align='center' style='background: #f0d0d0'|0E '''–'''
|align='center' style='background: #f0d0d0'|0F '''–'''

|-
!1…
|align='center' style='background: #f0d0d0'|10 '''–'''
|align='center' style='background: #f0d0d0'|11 '''–'''
|align='center' style='background: #f0d0d0'|12 '''–'''
|align='center' style='background: #f0d0d0'|13 '''–'''
|align='center' style='background: #f0d0d0'|14 '''–'''
|align='center' style='background: #f0d0d0'|15 '''–'''
|align='center' style='background: #f0d0d0'|16 '''–'''
|align='center' style='background: #f0d0d0'|17 '''–'''
|align='center' style='background: #f0d0d0'|18 '''–'''
|align='center' style='background: #f0d0d0'|19 '''–'''
|align='center' style='background: #f0d0d0'|1A '''–'''
|align='center' style='background: #f0d0d0'|1B '''–'''
|align='center' style='background: #f0d0d0'|1C '''–'''
|align='center' style='background: #f0d0d0'|1D '''–'''
|align='center' style='background: #f0d0d0'|1E '''–'''
|align='center' style='background: #f0d0d0'|1F '''–'''

|-
!2…
|align='center'|20 ''' '''
|align='center'|21 '''!'''
|align='center'|22 '''"'''
|align='center'|23 '''#'''
|align='center'|24 '''$'''
|align='center'|25 '''%'''
|align='center'|26 '''&'''
|align='center'|27 '''''''
|align='center'|28 '''('''
|align='center'|29 ''')'''
|align='center'|2A '''*'''
|align='center'|2B '''+'''
|align='center'|2C ''','''
|align='center'|2D '''-'''
|align='center'|2E '''.'''
|align='center'|2F '''/'''

|-
!3…
|align='center'|30 '''0'''
|align='center'|31 '''1'''
|align='center'|32 '''2'''
|align='center'|33 '''3'''
|align='center'|34 '''4'''
|align='center'|35 '''5'''
|align='center'|36 '''6'''
|align='center'|37 '''7'''
|align='center'|38 '''8'''
|align='center'|39 '''9'''
|align='center'|3A ''':'''
|align='center'|3B ''';'''
|align='center'|3C '''<'''
|align='center'|3D '''='''
|align='center'|3E '''>'''
|align='center'|3F '''?'''

|-
!4…
|align='center'|40 '''@'''
|align='center'|41 '''A'''
|align='center'|42 '''B'''
|align='center'|43 '''C'''
|align='center'|44 '''D'''
|align='center'|45 '''E'''
|align='center'|46 '''F'''
|align='center'|47 '''G'''
|align='center'|48 '''H'''
|align='center'|49 '''I'''
|align='center'|4A '''J'''
|align='center'|4B '''K'''
|align='center'|4C '''L'''
|align='center'|4D '''M'''
|align='center'|4E '''N'''
|align='center'|4F '''O'''

|-
!5…
|align='center'|50 '''P'''
|align='center'|51 '''Q'''
|align='center'|52 '''R'''
|align='center'|53 '''S'''
|align='center'|54 '''T'''
|align='center'|55 '''U'''
|align='center'|56 '''V'''
|align='center'|57 '''W'''
|align='center'|58 '''X'''
|align='center'|59 '''Y'''
|align='center'|5A '''Z'''
|align='center'|5B '''['''
|align='center'|5C '''\'''
|align='center'|5D ''']'''
|align='center'|5E '''^'''
|align='center'|5F '''_'''

|-
!6…
|align='center'|60 '''`'''
|align='center'|61 '''a'''
|align='center'|62 '''b'''
|align='center'|63 '''c'''
|align='center'|64 '''d'''
|align='center'|65 '''e'''
|align='center'|66 '''f'''
|align='center'|67 '''g'''
|align='center'|68 '''h'''
|align='center'|69 '''i'''
|align='center'|6A '''j'''
|align='center'|6B '''k'''
|align='center'|6C '''l'''
|align='center'|6D '''m'''
|align='center'|6E '''n'''
|align='center'|6F '''o'''

|-
!7…
|align='center'|70 '''p'''
|align='center'|71 '''q'''
|align='center'|72 '''r'''
|align='center'|73 '''s'''
|align='center'|74 '''t'''
|align='center'|75 '''u'''
|align='center'|76 '''v'''
|align='center'|77 '''w'''
|align='center'|78 '''x'''
|align='center'|79 '''y'''
|align='center'|7A '''z'''
|align='center'|7B '''{'''
|align='center'|7C '''|'''
|align='center'|7D '''}'''
|align='center'|7E '''~'''
|align='center' style='background: #d0e0d0'|7F '''�'''

|-
!8…
|align='center' style='background: #c0ffc0'|80 '''Ň'''
|align='center' style='background: #c0ffc0'|81 '''Ś'''
|align='center' style='background: #c0ffc0'|82 '''Ć'''
|align='center' style='background: #c0ffc0'|83 '''Ż'''
|align='center' style='background: #c0ffc0'|84 '''Ź'''
|align='center' style='background: #c0ffc0'|85 '''Ŝ'''
|align='center' style='background: #c0ffc0'|86 '''Ĉ'''
|align='center' style='background: #c0ffc0'|87 '''Ẑ'''
|align='center' style='background: #c0ffc0'|88 '''Ô''' [1]
|align='center' style='background: #c0ffc0'|89 '''Ŕ'''
|align='center' style='background: #c0ffc0'|8A '''Ǔ'''
|align='center' style='background: #c0ffc0'|8B '''Ă'''
|align='center' style='background: #c0ffc0'|8C '''Ń'''
|align='center' style='background: #80f080'|8D '''Ș'''
|align='center' style='background: #80f080'|8E '''Ț'''
|align='center' style='background: #d0e0d0'|8F '''�'''

|-
!9…
|align='center' style='background: #80f080'|90 '''đ'''
|align='center' style='background: #c0ffc0'|91 '''ś'''
|align='center' style='background: #c0ffc0'|92 '''ć'''
|align='center' style='background: #c0ffc0'|93 '''ż'''
|align='center' style='background: #c0ffc0'|94 '''ź'''
|align='center' style='background: #c0ffc0'|95 '''ŝ'''
|align='center' style='background: #c0ffc0'|96 '''ĉ'''
|align='center' style='background: #c0ffc0'|97 '''ẑ'''
|align='center' style='background: #c0ffc0'|98 '''ô''' [1]
|align='center' style='background: #c0ffc0'|99 '''ŕ'''
|align='center' style='background: #c0ffc0'|9A '''ǔ'''
|align='center' style='background: #c0ffc0'|9B '''ă'''
|align='center' style='background: #c0ffc0'|9C '''ń'''
|align='center' style='background: #80f080'|9D '''ș'''
|align='center' style='background: #80f080'|9E '''ț'''
|align='center' style='background: #d0e0d0'|9F '''�'''

|-
!A…
|align='center'|A0 '''[https://secure.wikimedia.org/wikipedia/en/wiki/Non-breaking_space NBSP]''' [2]
|align='center' style='background: #d0d0f0'|A1 '''ň''' (¡)'''
|align='center' style='background: #d0d0f0'|A2 '''Ű''' (¢)'''
|align='center' style='background: #d0d0f0'|A3 '''ě''' (£)'''
|align='center' style='background: #d0d0f0'|A4 '''ű''' (¤)'''
|align='center' style='background: #d0d0f0'|A5 '''Ě''' (¥)'''
|align='center' style='background: #d0d0f0'|A6 '''Š''' (¦)'''
|align='center'|A7 '''§'''
|align='center' style='background: #d0d0f0'|A8 '''š''' (¨)'''
|align='center' style='background: #d0d0f0'|A9 '''Ů''' (©)'''
|align='center' style='background: #d0d0f0'|AA '''Ą''' (ª)'''
|align='center' style='background: #d0d0f0'|AB '''Ę''' («)'''
|align='center' style='background: #d0d0f0'|AC '''Č''' (¬)'''
|align='center'|AD '''[https://secure.wikimedia.org/wikipedia/en/wiki/Soft_hyphen SHY]''' [2]
|align='center' style='background: #d0d0f0'|AE '''č''' (®)'''
|align='center' style='background: #d0d0f0'|AF '''ů''' (¯)'''

|-
!B…
|align='center' style='background: #d0d0f0'|B0 '''Ő''' (°)'''
|align='center' style='background: #d0d0f0'|B1 '''Ł''' (±)'''
|align='center' style='background: #d0d0f0'|B2 '''Ť''' (²)'''
|align='center' style='background: #d0d0f0'|B3 '''Ď''' (³)'''
|align='center' style='background: #d0d0f0'|B4 '''Ž''' (´)'''
|align='center' style='background: #d0d0f0'|B5 '''ł''' (µ)'''
|align='center' style='background: #d0d0f0'|B6 '''ť''' (¶)'''
|align='center' style='background: #d0d0f0'|B7 '''ď''' (·)'''
|align='center' style='background: #d0d0f0'|B8 '''ž''' (¸)'''
|align='center' style='background: #d0d0f0'|B9 '''ő''' (¹)'''
|align='center' style='background: #d0d0f0'|BA '''ą''' (º)'''
|align='center' style='background: #d0d0f0'|BB '''ę''' (»)'''
|align='center' style='background: #d0d0f0'|BC '''Œ''' (¼)'''
|align='center' style='background: #d0d0f0'|BD '''œ''' (½)'''
|align='center' style='background: #d0d0f0'|BE '''Ÿ''' (¾)'''
|align='center'|BF '''¿'''

|-
!C…
|align='center'|C0 '''À'''
|align='center'|C1 '''Á'''
|align='center'|C2 '''Â'''
|align='center'|C3 '''Ã'''
|align='center'|C4 '''Ä'''
|align='center'|C5 '''Å'''
|align='center'|C6 '''Æ'''
|align='center'|C7 '''Ç'''
|align='center'|C8 '''È'''
|align='center'|C9 '''É'''
|align='center'|CA '''Ê'''
|align='center'|CB '''Ë'''
|align='center'|CC '''Ì'''
|align='center'|CD '''Í'''
|align='center'|CE '''Î'''
|align='center'|CF '''Ï'''

|-
!D…
|align='center'|D0 '''Ð'''
|align='center'|D1 '''Ñ'''
|align='center'|D2 '''Ò'''
|align='center'|D3 '''Ó'''
|align='center'|D4 '''Ô'''
|align='center'|D5 '''Õ'''
|align='center'|D6 '''Ö'''
|align='center' style='background: #d0d0f0'|D7 '''Ř''' (×)'''
|align='center'|D8 '''Ø'''
|align='center'|D9 '''Ù'''
|align='center'|DA '''Ú'''
|align='center'|DB '''Û'''
|align='center'|DC '''Ü'''
|align='center'|DD '''Ý'''
|align='center'|DE '''Þ'''
|align='center'|DF '''ß'''

|-
!E…
|align='center'|E0 '''à'''
|align='center'|E1 '''á'''
|align='center'|E2 '''â'''
|align='center'|E3 '''ã'''
|align='center'|E4 '''ä'''
|align='center'|E5 '''å'''
|align='center'|E6 '''æ'''
|align='center'|E7 '''ç'''
|align='center'|E8 '''è'''
|align='center'|E9 '''é'''
|align='center'|EA '''ê'''
|align='center'|EB '''ë'''
|align='center'|EC '''ì'''
|align='center'|ED '''í'''
|align='center'|EE '''î'''
|align='center'|EF '''ï'''

|-
!F…
|align='center'|F0 '''ð'''
|align='center'|F1 '''ñ'''
|align='center'|F2 '''ò'''
|align='center'|F3 '''ó'''
|align='center'|F4 '''ô'''
|align='center'|F5 '''õ'''
|align='center'|F6 '''ö'''
|align='center' style='background: #d0d0f0'|F7 '''ř''' (÷)'''
|align='center'|F8 '''ø'''
|align='center'|F9 '''ù'''
|align='center'|FA '''ú'''
|align='center'|FB '''û'''
|align='center'|FC '''ü'''
|align='center'|FD '''ý'''
|align='center'|FE '''þ'''
|align='center'|FF '''ÿ'''

|}

==== Table Notes ====

'''[1]''' As discussed [https://forums.thedarkmod.com/index.php?/topic/22427-analysis-of-212-tdm-fonts/&do=findComment&comment=494855 here], the TDM char set has a redundant treatment of 2 characters:

* Ô appears at 0x88 and 0xD4
* ô appears at 0x98 and 0xF4

Starting with TDM 2.13, the redundancy can be removed and these new characters (from ISO-8859-3) introduced:

* Ğ appears at 0x88
* ğ appears at 0x98

'''[2]''' Avoid using the non-breaking space (NBSP, 0xA0) and the soft hyphen (SHY, 0xAD) in your strings. The TDM engine has no code to respect these during word wrap. Font maintainers: probably map NBSP to the <space> glyph, SHY to undefined/hollow box or zero-sized box.

==== Corresponding Unicode ====

For a mapping of these 256 codepoints to Unicode U+NNNN values and formal names, download 'TDM 8859-Style Font Map to Unicode-16.txt':

* [https://drive.google.com/file/d/1wLEtuFvnrZ-WHK8ign8i3diIXZdriZ4F/view?usp=sharing for TDM 2.13]
* [https://drive.google.com/file/d/1UAz9jSZpT_j33STP3So_Re8JWa8QuAmz/view?usp=sharing for TDM 2.12 and earlier]

Each of these files (by Geep, 2024) is in a standardized format so that it can also be imported into font design programs like FontForge as a custom 256-position map. In the comments, there is additional information about:
* ISO 8859-x sourcing of each character.
* alternative representations of some European and control characters.

==== Access to TDM Characters from Various Languages ====
See [[Multilanguage Display]], which includes an itemized table of characters across TDM/ISO codemaps. This discusses which characters (assuming the font implements them) the translator can...
* enter directly
* enter by tricks
* not currently access.

==== Fonts with Special Characters ====
Certain fonts have a few codepoints that purposefully diverge from the table entry.

* Carleton font (regular, bold, glow) uses codepoint 0x23, ordinarily "#", to represent "superscript #", which is used in the main menu system to indicate FMs for which a translation pack is available.
* Treasure Map font has characters for "pirate skull and crossbones" and "bottle of booze (or poison)".

== European Character Implementation ==
=== Priority Early-On - the "Top 50" ===

Some of the special characters are used more often than others. Here is a statistic over the entire string set of the TDM core, from TDM v1.08, showing the top 50 most-used characters (excluding a-z, 0-9 and russian characters):

{|class="wikitable" border=1 style="border-collapse: collapse; font-size: 85%" cellspacing=0 cellpadding=2

|-
|Rank
|Occurances
|Letter
|Remarks
|Rank
|Occurances
|Letter
|Remarks

|-
|1
|í
|715
|
|25
|ć
|67
|

|-
|2
|é
|674
|
|26
|è
|65
|

|-
|3
|á
|524
|
|27
|ú
|56
|

|-
|4
|ø
|303
|Danish
|28
|ê
|52
|

|-
|5
|č
|288
|
|29
|ö
|48
|German

|-
|6
|ó
|283
|
|30
|É
|46
|

|-
|7
|ü
|270
|German
|31
|ñ
|37
|

|-
|8
|ł
|203
|Polish
|32
|õ
|32
|

|-
|9
|æ
|200
|Danish
|33
|ń
|26
|

|-
|10
|ě
|182
|
|34
|Ł
|24
|

|-
|11
|ř
|175
|Czech
|35
|Š
|21
|

|-
|12
|ã
|168
|
|36
|â
|21
|

|-
|13
|ž
|148
|Czech
|37
|ź
|20
|

|-
|14
|ý
|142
|
|38
|ß
|18
|German

|-
|15
|ę
|141
|
|39
|Ó
|18
|

|-
|16
|ą
|140
|
|40
|ň
|15
|

|-
|17
|ż
|119
|
|41
|Ú
|15
|

|-
|18
|å
|109
|Danish
|42
|Á
|13
|

|-
|19
|š
|99
|
|43
|î
|12
|

|-
|20
|ś
|97
|
|44
|ť
|11
|

|-
|21
|ç
|91
|
|45
|ô
|9
|

|-
|22
|ä
|86
|German
|46
|Ž
|8
|

|-
|23
|à
|83
|
|47
|Ż
|7
|

|-
|24
|ů
|77
|
|48
|Č
|7
|

|-
|25
|ć
|67
|
|49
|ù
|6
|

|}

Although ö, ä and ü do not appear that often, with only these and Ü, Ö, Ä and ß, the entire German language works. So adding these letters to the fonts is quite important.

Preferably, all foreign letters would be added to the fonts (see [[Font Patcher]] or [[Refont]]). However, if time permits only adding a few, '''í''' would be more important than, say, '''ô'''.

It is commonplace for missing accented letters to be redirected in the .dat file to the corresponding unaccented base letter.

=== Coverage Expansion & Remaining Limitations ===

By 2014, all the system (e.g., main menu) fonts (Carleton, Carleton_condensed, Stone in sizes 24pt and 48pt; Mason and Mason_glow in 48pt) had good coverage of the "Top 50" and beyond, although not all 256 codepoints.
This was confirmed more specifically in 2024, as part of an [https://forums.thedarkmod.com/index.php?/topic/22427-analysis-of-212-tdm-fonts/ Analysis of 2.12 Fonts]. This analysis indicated that, unlike the system fonts, the FM fonts generally did not provide specific glyphs beyond ASCII.

In 2024, Stone 24pt, important for subtitles and a number of readables, was further extended to cover all 256 codepoints. This was tested with TDM 2.13[betas] and released with 2.14.

In 2026, English/European Carleton 24pt, widely used in the main menu and also some readables, was improved to:
* extend coverage to all codepoints
* replace sloppy hand-drawn Latin-1 glyphs with fresh glyphs, most of them generated from TTF then edge-darkened
* for simplicity, re-implement the red "glow" effect as if a drop-shadow.

Testing of this is planned with TDM 2.15 betas.

Stone 48pt improvements are under consideration for TDM 2.15.

== Font Encoding for Russian Cyrillic ==

Characters conform to the [https://en.wikipedia.org/wiki/Win-1251 WIN-1251 native encoding, shown in the Wikipedia article]. Exception: the character '''0xFF''' (я) is mapped to '''0xB6''' upon loading. Therefore any Russian font must contain я at the place 0xB6. (This was to overcome a historical Doom3 bug that is now fixed. But to date "the remapping for Russian is still in place, tho, to avoid having to patch all the russian fonts", says bug report [https://bugs.thedarkmod.com/view.php?id=2812 "0002812: Character 0xFF does not work in fonts"]).

=== Cyrillic Character Implementation ===
Within any given font, character coverage may be incomplete.

In 2025, the Russian Mason 48pt font was improved and extended to cover all TDM Russian codepoints, and included in TDM 2.14.

== Possible Future Extensions ==
=== To Additional Latin and Cyrillic Languages? ===
TDM's core all.lang file has #str_ for the names of a few additional languages, not yet supported or exposed in the game interface, that could be built out:

==== Latin Alphabet ====
* Croatian / Hrvatski
* Norse / Norsk
* Finnish / Suomi
* Slovenian (differs from Slovak; for southern Slovenia) / Slovenšcina

==== Cyrillic Alphabet ====
* Bulgarian / Bugarian / Български
* Serbian / Srpski / Српски
* Ukrainian (regional) / Українська

There are no doubt other languages that could be supported by TDM's existing suite of 8-bit encodings.
=== To Unicode? ===
It is possible to visualize a transition to a DAT format (and engine code) that supported UCS (16-bit) Unicode, allowing the existing fonts to then be expanded to cover more characters. Then perhaps all.lang would be the only .lang needed.
=== To Asian Languages (Korean, Chinese, Japanese)? ===
The original D3 had support for Asian languages, so it might be possible to add them to TDM, too, but with a heavy burden on font development and translation. Also, writing from right-to-left (Hebrew) or top-down (Japanese) might be tricky or outright impossible in our GUI without more work in the C++ code. Plus, these languages use more than 256 different characters, and an 8 bit table will not hold these.

[[Category:Fonts]]

{{i18n}}

Translations of Main Menus

2026-06-23T20:36:49Z

Geep: /* See Also */ Add I18N_-_Translator's_Guide link

... and other I18N TDM-platform strings that are not FM-specific.

==Core Phrases Considered "Translated"==
Shown in declining count order, for TDM 2.14.

* Catalan - 1265 (94%)
* Russian - 1232 (92%)
* French - 1197 (89%)
* German - 1195 (89%)
* Turkish - 1193 (89%)
* Hungarian - 1190 (88%)
* Polish - 1183 (88%)
* Slovak - 1164 (86%)
* Italian - 1142 (85%)
* Romanian - 1137 (84%)
* Spanish - 1102 (82%)
* Danish - 1095 (82%)
* Portuguese - 1034 (77%)
* Czech - 998 (74%)
* Dutch - 142 (11%)
* Swedish - 136 (10%)

=== Commentary ===
First-ranked Catalan is the newest entry. As for other languages, presumably they have suffered some slippage of coverage due to the minor accumulations of new English phrases over the last decade, without translation updates.

Bottom-ranked Dutch and Swedish remain as stubs, awaiting full translation. Not shown: Other possible future-candidate Latin and Cyrillic languages, with similar stubs in all.lang, but no .lang files generated at this time.

Translation with AI may be called upon to help with these shortcomings.

=== Methodology===
As of TDM 2.14, english.lang defines '''1347''' #str_ phrases (and presumably a similar number in the [english] section of all.lang). This value is the denominator of percentage calculations.

The numerators come from counting the number of lines in various "missing.txt" files that result from running gen_lang_plus with its "-missing" option. Here's how it does its categorization for each [language]...

If, for a given [english] #str_ ID in all.lang, either:
# there's no matching [language] #str_ ID; or
# there's a matching [language] #str_ID, but with the same phrase as [english], and it's not marked with the special translator comment "// stays the same"

then that is output as a "missing" (untranslated) line. The count of these is then subtracted from 1347 to give the "translated" count shown.

===Caveats===
* Because of certain problems (multiline comments, duplicate entries), these numbers are merely very good estimates, not definitive.
* Some phrases shouldn't or can't be translated (e.g., PC function keys), or are the same in English and the other language, even if not marked with "// stays the same". In particular, translation away from English may be difficult for some technical and/or abbreviated terms in Settings. Perhaps a more concerted effort to apply the "// stays the same" tag is warranted.
* These estimates do not account of any possible platform text left hard-coded in English text, so not represented by a #str_. Hopefully there's little to none of that left.
* These estimates do not account for platform aspects with no translation mechanism, e.g.:
** English words burned into textures of shared assets, e.g., old broadsides & newspapers; a few decals
** Readme's about potential games to select
** Barks and subtitles (those common to all FMs)
** TDM's website, installer, wiki, forums, etc.
* The quality of the translations are not assessed. In particular, improvements to Stone and Carleton fonts in support of certain accented characters will not likely roll out to individual strings until TDM 2.15. A few menu strings remain in the unimproved, deprecated Carleton_Condensed font.

==See Also==
* [[I18N Status]], particularly "TDM Core".
* [[I18N - Translator's Guide]], with implications for the "// stays the same" tag.
* [[I18N - Charset]]

I18N - Translating Fan Missions

2026-06-23T19:37:14Z

Geep: /* FM Specific Dictionaries */ Add warnings about encodings

== Introduction ==

{{infobox|''Important:'' Use [[I18N.pl]] to prepare an FM before you attempt to translate it!}}

== Translation ==

=== darkmod.txt ===

{{infobox|''Important:'' Due to bug #3012 it is not yet possible to translate darkmod.txt no README.txt - so please ignore this section for now.}}

If you translate strings in '''darkmod.txt''', '''DO NOT''' translate the field names like ''Author:'', ''Required TDM Version:'' etc. These must stay in English, or TDM will not be able to interpret them. Only translate the text that comes after them! If you use [[I18N.pl]], this will be automatically done for you, you should not edit ''darkmod.txt'' in this case!

If you want to add your name as translator to the credits, include it in a README.txt file inside ''YOURFM_l10n.pk4'' file.

=== FM Specific Dictionaries ===

{{infobox|''Caution:'' Every language-specific *.lang file described next must be in the proper 8-bit encoding for its language, NOT utf8. The best way to ensure this to edit your FM's all.lang (which IS utf8), then use one of the [[Gen Lang Programs]] to generate the set of properly-encoded files. Be aware that some text editors will cause problems by auto-converting 8-bit (aka ANSI) encodings to utf8 upon save.}}

These dictionaries live in the directory '''strings/fm/''' and must follow a specific format, explained below. The name for such a dictionary is always '''LANGUAGE.lang''', f.i. "english.lang".

The string IDs for FMs are 20000 … 89999, using these ensures that they do not conflict with strings from the TDM core. Note that if you have a string that matches one of the other core strings (like "Silver Key", "#str_10000"), then you should use just the core string ID. This saves the translators from having to translate the string again.

You '''MUST''' also separate them from the rest of your FM into their own package called "YOURFM_l10n.pk4" where YOURFM is the name of your original PK4 file. This ensures that TDM can install/update the I18N package properly.

Let's see how this looks for the FM named ''Outpost'', which provides two translations (English and French):

<pre>
outpost.pk4:

xdata/outpost.xd
maps/outpost.map
maps/outpost.cm
maps/outpost.proc
maps/outpost.script
maps/outpost.aas32
strings/fm/english.lang // include a copy of this, so the FM package
// also works stand-alone

outpost_l10n.pk4:

strings/fm/english.lang
strings/fm/french.lang
README.txt // f.i. with credits for translators
</pre>

Note that all files names should be in lowercase, otherwise there can be problems under Linux.

Example dictionary, note the entire content is wrapped in "{ }"

<pre style="font-size: 83%">
// String table english (iso-8859-1) for: The Outpost

// This file was generated automatically on 2011-08-20 13:56 UTC by i18n.pl v0.02
{
"#str_20000" "The Outpost"
"#str_20001" "Break into a builder outpost to retrieve a gold ingot."
"#str_20002" "Gold Ingot"
"#str_20003" "Leave the outpost after your main objectives are done and get back to the front gates."
"#str_20004" "You won't find bags full of money in a builder outpost, but take away any valuables you can get hold of. Find valuables worth at least 600."
"#str_20005" "You won't find bags full of money in a builder outpost, but take away any valuables you can get hold of. Find valuables worth at least 700."
"#str_20006" "No knock outs too."
"#str_20007" "Killing is not your style. No corpses tonight."
"#str_20008" "You won't find bags full of money in a builder outpost, but take away any valuables you can get hold of. Find valuables worth at least 800."
"#str_20009" "The massive gold ingot should be worth a fair amount of money. Find out where the ingot is kept and change its ownership."
}
</pre>

This setup makes it easier to translate the FM, because a translator needs only to copy ''english.lang'' to ''german.lang'', change the strings, repackage the ''outpost_l10n.pk4'' file, and it works! ''[Well, as long as the target language, like German, also uses an iso-8859-1 encoding, and the text editor (+ op sys) preserves that. Not the safest method.]''

=== Images with Text ===

If the text is painted on the image itself, you first need to paint a different image with the text in the foreign language. If you cannot do this yourself, ask one of the [[I18N_-_List_of_TDM_translators|translators]].

Then it depends on where the image is used. If it is used inside a GUI, you can set it up so that different material shaders are used depending on the language, and each material shader can use the right image for the appropriate language.

{{infobox|Note: If the image is used as f.i. wall texture, then you need to use a similiar technique.}}

First, create a file named <tt>materials/yourfmname.mtr</tt>. Here is an example from Thief's Den used for the ingame map in the inventory:

<pre>
// blends in-game map details onto background parchment
thiefsdenmap
{
{
blend filter
map guis/assets/maps/thiefsdenmap
}
}

// italien map
thiefsdenmap_it
{
{
blend filter
map guis/assets/maps/thiefsdenmap_it
}
}
</pre>

'''Only English and Italian are shown here, you need one version for each language.'''

You also need the actual images, in this case:

* <tt>dds/guis/assets/maps/thiefsdenmap_it.dds</tt> (Italian version, should go into "yourfm_l10n.pk4" as the other languages)
* <tt>dds/guis/assets/maps/thiefsdenmap.dds</tt> (English original, should go into "yourfm.pk4")

Then modify the GUI file (in this case <tt>guis/thiefsdenmap.gui</tt>) where the map is used to say:

windowDef Desktop {
rect 0, 0, 640, 480
nocursor 1
windowDef background_map {
rect 100, -10, 440, 480
background "guis/assets/readables/oldparchment_landscape"
visible 1
windowDef actual_map {
rect 33, 70, 400, 340
{{red|background "thiefsdenmap" // shader of the map}}
visible 1
}
}
}

and replace the red line with:

{{red|background "#str_20100" // shader of the map}}

The number (20100) here is an example, use a free number that is not already used in your <tt>fm/strings/english.lang</tt> file!

In the <tt>fm/strings/english.lang</tt> file, add the following line:

"#str_20100" "thiefsdenmap"

This will use this shader to display the map. Then, in the '''<tt>fm/strings/italian.lang</tt>''' file, add
this line:

"#str_20100" "thiefsdenmap_it"

This means in Italian, the other shader is used.

The map should now display correctly in both languages.

{{infobox|Please note that non-existing strings will default to English. So in any other language, the English map will be used as fallback.}}

In case this still all unclear, use these files as an example:

# http://www.bloodgate.com/mirrors/tdm/pub/pk4/i18n/thiefs_den.pk4
# http://www.bloodgate.com/mirrors/tdm/pub/pk4/i18n/thiefs_den_l10n.pk4

== Publishing the FM ==

If you upload your FM somewhere, you need to upload both files, the '''.PK4''' and the '''*_l10n.pk4'''. The interface for publishing an FM on [http://www.thedarkmod.com/admin/fms.php thedarkmod.com] has a special field where you can enter the URL for the '''*_l10n.pk4''' file.

{{i18n}}

Translations of Main Menus

2026-06-23T16:52:40Z

Geep: /* Phrases Considered "Translated" */ Add "Core" to heading

Translations of Main Menus

2026-06-23T16:51:33Z

Geep: /* See Also */

... and other I18N TDM-platform strings that are not FM-specific.

==Phrases Considered "Translated"==
Shown in declining count order, for TDM 2.14.

* Catalan - 1265 (94%)
* Russian - 1232 (92%)
* French - 1197 (89%)
* German - 1195 (89%)
* Turkish - 1193 (89%)
* Hungarian - 1190 (88%)
* Polish - 1183 (88%)
* Slovak - 1164 (86%)
* Italian - 1142 (85%)
* Romanian - 1137 (84%)
* Spanish - 1102 (82%)
* Danish - 1095 (82%)
* Portuguese - 1034 (77%)
* Czech - 998 (74%)
* Dutch - 142 (11%)
* Swedish - 136 (10%)

=== Commentary ===
First-ranked Catalan is the newest entry. As for other languages, presumably they have suffered some slippage of coverage due to the minor accumulations of new English phrases over the last decade, without translation updates.

Bottom-ranked Dutch and Swedish remain as stubs, awaiting full translation. Not shown: Other possible future-candidate Latin and Cyrillic languages, with similar stubs in all.lang, but no .lang files generated at this time.

Translation with AI may be called upon to help with these shortcomings.

=== Methodology===
As of TDM 2.14, english.lang defines '''1347''' #str_ phrases (and presumably a similar number in the [english] section of all.lang). This value is the denominator of percentage calculations.

The numerators come from counting the number of lines in various "missing.txt" files that result from running gen_lang_plus with its "-missing" option. Here's how it does its categorization for each [language]...

If, for a given [english] #str_ ID in all.lang, either:
# there's no matching [language] #str_ ID; or
# there's a matching [language] #str_ID, but with the same phrase as [english], and it's not marked with the special translator comment "// stays the same"

then that is output as a "missing" (untranslated) line. The count of these is then subtracted from 1347 to give the "translated" count shown.

===Caveats===
* Because of certain problems (multiline comments, duplicate entries), these numbers are merely very good estimates, not definitive.
* Some phrases shouldn't or can't be translated (e.g., PC function keys), or are the same in English and the other language, even if not marked with "// stays the same". In particular, translation away from English may be difficult for some technical and/or abbreviated terms in Settings. Perhaps a more concerted effort to apply the "// stays the same" tag is warranted.
* These estimates do not account of any possible platform text left hard-coded in English text, so not represented by a #str_. Hopefully there's little to none of that left.
* These estimates do not account for platform aspects with no translation mechanism, e.g.:
** English words burned into textures of shared assets, e.g., old broadsides & newspapers; a few decals
** Readme's about potential games to select
** Barks and subtitles (those common to all FMs)
** TDM's website, installer, wiki, forums, etc.
* The quality of the translations are not assessed. In particular, improvements to Stone and Carleton fonts in support of certain accented characters will not likely roll out to individual strings until TDM 2.15. A few menu strings remain in the unimproved, deprecated Carleton_Condensed font.

==See Also==
* [[I18N Status]], particularly "TDM Core".
* [[I18N - Charset]]

Translations of Main Menus

2026-06-23T16:43:22Z

Geep: /* Caveats */

Translations of Main Menus

2026-06-23T12:41:40Z

Geep: /* Commentary */

... and other I18N TDM-platform strings that are not FM-specific.

==Phrases Considered "Translated"==
Shown in declining count order, for TDM 2.14.

* Catalan - 1265 (94%)
* Russian - 1232 (92%)
* French - 1197 (89%)
* German - 1195 (89%)
* Turkish - 1193 (89%)
* Hungarian - 1190 (88%)
* Polish - 1183 (88%)
* Slovak - 1164 (86%)
* Italian - 1142 (85%)
* Romanian - 1137 (84%)
* Spanish - 1102 (82%)
* Danish - 1095 (82%)
* Portuguese - 1034 (77%)
* Czech - 998 (74%)
* Dutch - 142 (11%)
* Swedish - 136 (10%)

=== Commentary ===
First-ranked Catalan is the newest entry. As for other languages, presumably they have suffered some slippage of coverage due to the minor accumulations of new English phrases over the last decade, without translation updates.

Bottom-ranked Dutch and Swedish remain as stubs, awaiting full translation. Not shown: Other possible future-candidate Latin and Cyrillic languages, with similar stubs in all.lang, but no .lang files generated at this time.

Translation with AI may be called upon to help with these shortcomings.

=== Methodology===
As of TDM 2.14, english.lang defines '''1347''' #str_ phrases (and presumably a similar number in the [english] section of all.lang). This value is the denominator of percentage calculations.

The numerators come from counting the number of lines in various "missing.txt" files that result from running gen_lang_plus with its "-missing" option. Here's how it does its categorization for each [language]...

If, for a given [english] #str_ ID in all.lang, either:
# there's no matching [language] #str_ ID; or
# there's a matching [language] #str_ID, but with the same phrase as [english], and it's not marked with the special translator comment "// stays the same"

then that is output as a "missing" (untranslated) line. The count of these is then subtracted from 1347 to give the "translated" count shown.

===Caveats===
* Because of certain problems (multiline comments, duplicate entries), these numbers are merely very good estimates, not definitive.
* Some phrases shouldn't or can't be translated (e.g., PC function keys), or are the same in English and the other language, even if not marked with "// stays the same". In particular, translation away from English may be difficult for some technical and/or abbreviated terms in Settings. Perhaps a more concerted effort to apply the "// stays the same" tag is warranted.
* These estimates do not account of any possible platform text left hard-coded in English text, so not represented by a #str_. Hopefully there's little to none of that left.
* These estimates do not account for platform aspects with no translation mechanism, e.g.:
** Readme's about potential games to select
** Barks and subtitles (common to all FMs)
** TDM's website, installer, wiki, forums, etc.
* The quality of the translations are not assessed. In particular, improvements to Stone and Carleton fonts in support of certain accented characters will not likely roll out to individual strings until TDM 2.15. A few menu strings remain in the unimproved, deprecated Carleton_Condensed font.
==See Also==
* [[I18N Status]], particularly "Core".
* [[I18N - Charset]]

Translations of Main Menus

2026-06-23T12:40:02Z

Geep: /* Methodology */

... and other I18N TDM-platform strings that are not FM-specific.

==Phrases Considered "Translated"==
Shown in declining count order, for TDM 2.14.

* Catalan - 1265 (94%)
* Russian - 1232 (92%)
* French - 1197 (89%)
* German - 1195 (89%)
* Turkish - 1193 (89%)
* Hungarian - 1190 (88%)
* Polish - 1183 (88%)
* Slovak - 1164 (86%)
* Italian - 1142 (85%)
* Romanian - 1137 (84%)
* Spanish - 1102 (82%)
* Danish - 1095 (82%)
* Portuguese - 1034 (77%)
* Czech - 998 (74%)
* Dutch - 142 (11%)
* Swedish - 136 (10%)

=== Commentary ===
First-ranked Catalan is the newest entry. As for other languages, presumably they have suffered some slippage of coverage due to the minor accumulations of new English phrases over the last decade, without translation updates.

Bottom-ranked Dutch and Swedish remain as stubs, awaiting full translation. Not shown: Other possible future-candidate Latin and Cyrillic languages, with similar stubs in all.lang, but no .lang files generated at this time.

Translation with AI may be called to help with these shortcomings.

=== Methodology===
As of TDM 2.14, english.lang defines '''1347''' #str_ phrases (and presumably a similar number in the [english] section of all.lang). This value is the denominator of percentage calculations.

The numerators come from counting the number of lines in various "missing.txt" files that result from running gen_lang_plus with its "-missing" option. Here's how it does its categorization for each [language]...

If, for a given [english] #str_ ID in all.lang, either:
# there's no matching [language] #str_ ID; or
# there's a matching [language] #str_ID, but with the same phrase as [english], and it's not marked with the special translator comment "// stays the same"

then that is output as a "missing" (untranslated) line. The count of these is then subtracted from 1347 to give the "translated" count shown.

===Caveats===
* Because of certain problems (multiline comments, duplicate entries), these numbers are merely very good estimates, not definitive.
* Some phrases shouldn't or can't be translated (e.g., PC function keys), or are the same in English and the other language, even if not marked with "// stays the same". In particular, translation away from English may be difficult for some technical and/or abbreviated terms in Settings. Perhaps a more concerted effort to apply the "// stays the same" tag is warranted.
* These estimates do not account of any possible platform text left hard-coded in English text, so not represented by a #str_. Hopefully there's little to none of that left.
* These estimates do not account for platform aspects with no translation mechanism, e.g.:
** Readme's about potential games to select
** Barks and subtitles (common to all FMs)
** TDM's website, installer, wiki, forums, etc.
* The quality of the translations are not assessed. In particular, improvements to Stone and Carleton fonts in support of certain accented characters will not likely roll out to individual strings until TDM 2.15. A few menu strings remain in the unimproved, deprecated Carleton_Condensed font.
==See Also==
* [[I18N Status]], particularly "Core".
* [[I18N - Charset]]

Translations of Main Menus

2026-06-23T12:35:47Z

Geep: /* See Also */ again

... and other I18N TDM-platform strings that are not FM-specific.

==Phrases Considered "Translated"==
Shown in declining count order, for TDM 2.14.

* Catalan - 1265 (94%)
* Russian - 1232 (92%)
* French - 1197 (89%)
* German - 1195 (89%)
* Turkish - 1193 (89%)
* Hungarian - 1190 (88%)
* Polish - 1183 (88%)
* Slovak - 1164 (86%)
* Italian - 1142 (85%)
* Romanian - 1137 (84%)
* Spanish - 1102 (82%)
* Danish - 1095 (82%)
* Portuguese - 1034 (77%)
* Czech - 998 (74%)
* Dutch - 142 (11%)
* Swedish - 136 (10%)

=== Commentary ===
First-ranked Catalan is the newest entry. As for other languages, presumably they have suffered some slippage of coverage due to the minor accumulations of new English phrases over the last decade, without translation updates.

Bottom-ranked Dutch and Swedish remain as stubs, awaiting full translation. Not shown: Other possible future-candidate Latin and Cyrillic languages, with similar stubs in all.lang, but no .lang files generated at this time.

Translation with AI may be called to help with these shortcomings.

=== Methodology===
As of TDM 2.14, english.lang defines '''1347''' #str_ phrases (and presumably a similar number in the [english] section of all.lang). This value is the denominator of percentage calculations.

The numerators come from counting the number of lines in various "missing.txt" files that result from running gen_lang_plus with its "-missing" option. Here's how it does its categorization for each [language]...

If, for a given [english] #str_ ID in all.lang, either:
# there's no matching [language] #str_ ID; or
# there's a matching [language] #str_ID, but with the same phrase as [english], and it's not marked with the special translator comment "// stays the same"

then that is output as a "missing" (untranslated) line.

===Caveats===
* Because of certain problems (multiline comments, duplicate entries), these numbers are merely very good estimates, not definitive.
* Some phrases shouldn't or can't be translated (e.g., PC function keys), or are the same in English and the other language, even if not marked with "// stays the same". In particular, translation away from English may be difficult for some technical and/or abbreviated terms in Settings. Perhaps a more concerted effort to apply the "// stays the same" tag is warranted.
* These estimates do not account of any possible platform text left hard-coded in English text, so not represented by a #str_. Hopefully there's little to none of that left.
* These estimates do not account for platform aspects with no translation mechanism, e.g.:
** Readme's about potential games to select
** Barks and subtitles (common to all FMs)
** TDM's website, installer, wiki, forums, etc.
* The quality of the translations are not assessed. In particular, improvements to Stone and Carleton fonts in support of certain accented characters will not likely roll out to individual strings until TDM 2.15. A few menu strings remain in the unimproved, deprecated Carleton_Condensed font.
==See Also==
* [[I18N Status]], particularly "Core".
* [[I18N - Charset]]

Translations of Main Menus

2026-06-23T12:35:09Z

Geep: /* See Also */ fix links

... and other I18N TDM-platform strings that are not FM-specific.

==Phrases Considered "Translated"==
Shown in declining count order, for TDM 2.14.

* Catalan - 1265 (94%)
* Russian - 1232 (92%)
* French - 1197 (89%)
* German - 1195 (89%)
* Turkish - 1193 (89%)
* Hungarian - 1190 (88%)
* Polish - 1183 (88%)
* Slovak - 1164 (86%)
* Italian - 1142 (85%)
* Romanian - 1137 (84%)
* Spanish - 1102 (82%)
* Danish - 1095 (82%)
* Portuguese - 1034 (77%)
* Czech - 998 (74%)
* Dutch - 142 (11%)
* Swedish - 136 (10%)

=== Commentary ===
First-ranked Catalan is the newest entry. As for other languages, presumably they have suffered some slippage of coverage due to the minor accumulations of new English phrases over the last decade, without translation updates.

Bottom-ranked Dutch and Swedish remain as stubs, awaiting full translation. Not shown: Other possible future-candidate Latin and Cyrillic languages, with similar stubs in all.lang, but no .lang files generated at this time.

Translation with AI may be called to help with these shortcomings.

=== Methodology===
As of TDM 2.14, english.lang defines '''1347''' #str_ phrases (and presumably a similar number in the [english] section of all.lang). This value is the denominator of percentage calculations.

The numerators come from counting the number of lines in various "missing.txt" files that result from running gen_lang_plus with its "-missing" option. Here's how it does its categorization for each [language]...

If, for a given [english] #str_ ID in all.lang, either:
# there's no matching [language] #str_ ID; or
# there's a matching [language] #str_ID, but with the same phrase as [english], and it's not marked with the special translator comment "// stays the same"

then that is output as a "missing" (untranslated) line.

===Caveats===
* Because of certain problems (multiline comments, duplicate entries), these numbers are merely very good estimates, not definitive.
* Some phrases shouldn't or can't be translated (e.g., PC function keys), or are the same in English and the other language, even if not marked with "// stays the same". In particular, translation away from English may be difficult for some technical and/or abbreviated terms in Settings. Perhaps a more concerted effort to apply the "// stays the same" tag is warranted.
* These estimates do not account of any possible platform text left hard-coded in English text, so not represented by a #str_. Hopefully there's little to none of that left.
* These estimates do not account for platform aspects with no translation mechanism, e.g.:
** Readme's about potential games to select
** Barks and subtitles (common to all FMs)
** TDM's website, installer, wiki, forums, etc.
* The quality of the translations are not assessed. In particular, improvements to Stone and Carleton fonts in support of certain accented characters will not likely roll out to individual strings until TDM 2.15. A few menu strings remain in the unimproved, deprecated Carleton_Condensed font.
==See Also==
* [I18N Status], particularly "Core".
* [I18N - Charset]

Translations of Main Menus

2026-06-23T12:30:15Z

Geep: Restructure

... and other I18N TDM-platform strings that are not FM-specific.

==Phrases Considered "Translated"==
Shown in declining count order, for TDM 2.14.

* Catalan - 1265 (94%)
* Russian - 1232 (92%)
* French - 1197 (89%)
* German - 1195 (89%)
* Turkish - 1193 (89%)
* Hungarian - 1190 (88%)
* Polish - 1183 (88%)
* Slovak - 1164 (86%)
* Italian - 1142 (85%)
* Romanian - 1137 (84%)
* Spanish - 1102 (82%)
* Danish - 1095 (82%)
* Portuguese - 1034 (77%)
* Czech - 998 (74%)
* Dutch - 142 (11%)
* Swedish - 136 (10%)

=== Commentary ===
First-ranked Catalan is the newest entry. As for other languages, presumably they have suffered some slippage of coverage due to the minor accumulations of new English phrases over the last decade, without translation updates.

Bottom-ranked Dutch and Swedish remain as stubs, awaiting full translation. Not shown: Other possible future-candidate Latin and Cyrillic languages, with similar stubs in all.lang, but no .lang files generated at this time.

Translation with AI may be called to help with these shortcomings.

=== Methodology===
As of TDM 2.14, english.lang defines '''1347''' #str_ phrases (and presumably a similar number in the [english] section of all.lang). This value is the denominator of percentage calculations.

The numerators come from counting the number of lines in various "missing.txt" files that result from running gen_lang_plus with its "-missing" option. Here's how it does its categorization for each [language]...

If, for a given [english] #str_ ID in all.lang, either:
# there's no matching [language] #str_ ID; or
# there's a matching [language] #str_ID, but with the same phrase as [english], and it's not marked with the special translator comment "// stays the same"

then that is output as a "missing" (untranslated) line.

===Caveats===
* Because of certain problems (multiline comments, duplicate entries), these numbers are merely very good estimates, not definitive.
* Some phrases shouldn't or can't be translated (e.g., PC function keys), or are the same in English and the other language, even if not marked with "// stays the same". In particular, translation away from English may be difficult for some technical and/or abbreviated terms in Settings. Perhaps a more concerted effort to apply the "// stays the same" tag is warranted.
* These estimates do not account of any possible platform text left hard-coded in English text, so not represented by a #str_. Hopefully there's little to none of that left.
* These estimates do not account for platform aspects with no translation mechanism, e.g.:
** Readme's about potential games to select
** Barks and subtitles (common to all FMs)
** TDM's website, installer, wiki, forums, etc.
* The quality of the translations are not assessed. In particular, improvements to Stone and Carleton fonts in support of certain accented characters will not likely roll out to individual strings until TDM 2.15. A few menu strings remain in the unimproved, deprecated Carleton_Condensed font.
==See Also==
* [i18n - Core Translation]
* [i18n - Charset]

I18N Status

2026-06-23T11:26:00Z

Geep: /* TDM Core */ Add legend to 99% bar

This article deals with the localisation/translation of both TDM itself, as well as [[Fan Missions]].

{{infobox|{{red|The I18N support in TDM will only work with v1.07 or newer.}}}}

== FM List ==
===Translations Developed Under or Available through Language-Specific Third-Party Sites===
These translations may in some cases go beyond I18N-text translations, to include images and vocals.

An example is DarkFate.org, which has Russian language translation of Thief-family games, including on the order of 100 TDM FMs. A current list may be found [https://darkfate.org/view/details/files/fan-missions/translates/tdm here]. See also an earlier TDM forum post about [https://forums.thedarkmod.com/index.php?/topic/16416-russian-translation-of-fm/page/2/&tab=comments#comment-380965 Dark Fate resources for Russian-speaking translators of TDM FMs].

===I18N-Text Translations Available Within TheDarkMod.com FMs===
Click on a column header to sort the list, or toggle ascending/descending order.

{{infobox|{{red|'''This list may be incomplete!'''}}}}

{|class="wikitable sortable" border=1 style="border-collapse: collapse; font-size: 80%" cellspacing=0 cellpadding=2 width=100%
|-
!style="background:#e0e0f0"|Name
!style="background:#e0e0f0"|<abbr style="font-size:80%" title="Converted to the I18N system">I18N?</abbr>
!style="background:#d0d0e0"|<abbr style="font-size:80%" title="Czech">cs</abbr>
!style="background:#d0d0e0"|<abbr style="font-size:80%" title="Danish">da</abbr>
!style="background:#d0d0e0"|<abbr style="font-size:80%" title="Dutch">nl</abbr>
!style="background:#d0d0e0"|<abbr style="font-size:80%" title="English">en</abbr>
!style="background:#d0d0e0"|<abbr style="font-size:80%" title="French">fr</abbr>
!style="background:#d0d0e0"|<abbr style="font-size:80%" title="German">de</abbr>
!style="background:#d0d0e0"|<abbr style="font-size:80%" title="Hungarian">hu</abbr>
!style="background:#d0d0e0"|<abbr style="font-size:80%" title="Italian">it</abbr>
!style="background:#d0d0e0"|<abbr style="font-size:80%" title="Spanish">es</abbr>
!style="background:#d0d0e0"|<abbr style="font-size:80%" title="Russian">ru</abbr>
!style="background:#d0d0e0"|<abbr style="font-size:80%" title="Portuguese">pt</abbr>
!style="background:#d0d0e0"|<abbr style="font-size:80%" title="Polish">pl</abbr>

|-
!Special Delivery
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-yes}}
|{{I18N-yes}}
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}

|-
!Awaiting the Storm
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}

|-
!Business as Usual
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}

|-
!Chalice of the Kings
|{{I18N-yn|bg=#f08020|text=50%}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-yes}}
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}

|-
!Vengeance for a Thief Part 1
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}

|-
!Closemouthed Shadows
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}

|-
!Deceptive Shadows
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}

|-
!House in Blackbog Hollow
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}

|-
!House Of Theo
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}

|-
!Living Expenses
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-yes}}
|{{I18N-yes}}
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}

|-
!Mad's Mountain
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}

|-
!Pandora's Box
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}

|-
!Rake Off
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}

|-
!Somewhere Above the City
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}

|-
!Swing
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-yes}}
|{{I18N-yes}}
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}

|-
!The Crown of Penitence
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-yes}}
|{{I18N-yes}}
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}

|-
!Illusionist's Tower
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}

|-
!The Outpost
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-yes}}
|{{I18N-yes}}
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}

|-
!The Parcel
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}

|-
!The Rift
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}

|-
!The Sons of Baltona 1
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-yes}}
|{{I18N-yes}}
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}

|-
!The Tears of Saint Lucia
|{{I18N-yn|bg=#80c010|text=90%}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-yn|bg=#80c010|text=90%}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}

|-
!The Thieves
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-yes}}
|{{I18N-yes}}
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}

|-
!Thief's Den
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-yes}}
|{{I18N-yes}}
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}

|-
!Too Late
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}

|-
!Training Mission
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-yes}}
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}

|-
!Trapped!
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}

|-
!Winter Harvest v2.4
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}

|-
!A Night to Remember
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}

|-
!A Score to Settle
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}

|-
!Alberic's Curse
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}

|-
!Betrayal
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}

|-
!Dragon's Claw
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}

|-
!Fiasco at Fauchard Street
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}

|-
!In Remembrance of Him
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}

|-
!Krysztalowy Grob (Crystal Grave)
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-yes}}

|-
!Let Sleeping Thieves Lie
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}

|-
!Lockdown
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}

|-
!Lord Dufford's
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}

|-
!Mandrasola
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}

|-
!No Honor Among Thieves
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}

|-
!Patently Dangerous
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}

|-
!Reap as you sow
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}

|-
!Return to the City
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}

|-
!Rightful Property
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}

|-
!Samhain Night on Bone Hill
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}

|-
!The Siege Shop
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}

|-
!Sneak and Destroy
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}

|-
!Sound Alert & Blackjack Trainer
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}

|-
!St. Alban's Cathedral
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}

|-
!The Alchemist
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}

|-
!The Beleaguered Fence
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}

|-
!The Builder's Influence
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}

|-
!The Caduceus of St. Alban
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}

|-
!The Creeps
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}

|-
!The Glenham Tower
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}

|-
!The Heart of Lone Salvation
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}

|-
!The Knighton Manor
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}

|-
!The Phrase Book
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}

|-
!The Transaction
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}

|-
!Flakebridge Monastery
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}

|-
!Old Habits
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}

|-
!In the North
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}

|}

If you want to help translating these missions into other languages, you can download them [http://www.bloodgate.com/mirrors/tdm/pub/pk4/i18n/ here].

== TDM Core ==

=== As of 2017 ===

:Conversion into i18n-ready form:
:{{percent|99}}

* All the strings in the menu, the HUD, the in-game messages, the different menus as well as inventory item names and categories have been made translatable.
* A [[I18N - Charset|charset]] has been defined and made supported by the code.
* Both the menu font (Carleton) and the HUD font (Stone) have been patched to include the foreign characters. (''Stone misses a few, esp. uppercase ones. Some Carleton characters are unattractive.'')
* The bitmaps in the various menus where converted to text, including the huge headers
* The default Doom3 ''english.lang'' has been slimmed down (from >5400 to 200 entries), then all the nec. strings for TDM have been added, including a lot of sensible default strings that are either useful or used in FMs (like names for inventory items, speaker names and so on), resulting over '''1130 entries'''.
* There is a '''[[I18N.pl|script]]''' which can convert old FMs into I18N capable FMs, even matching different translations.
* Both the 0xff character bug, as well as the problem that '''choiceDef'''s do not work have been resolved
* Menu and inventory name translations are complete for {{green|'''English'''}}, {{green|'''Danish'''}}, {{green|'''Italian'''}}, {{green|'''Czech'''}}, {{green|'''Polish'''}}, {{green|'''Portuguese'''}}, {{green|'''Russian'''}}, {{green|'''French'''}}, {{green|'''Spanish'''}}, {{green|'''German'''}}, {{green|'''Romanian'''}}, and {{green|'''Hungarian'''}}.
* {{red|'''Swedish'''}}, {{red|'''Slovak'''}} and {{red|'''Dutch'''}} can be selected in the menu, but as of February 2017 still have substantially incomplete translations. Anyone capable of providing said translations, even in part, please post in the TDM forum under the "I want to Help" section.
* {{green|'''Turkish'''}} has been added to the menu translation list and will be available in 2.05
==== TODO ====

# The Download and Load/Save menu still need to be converted so their headlines can be translated.
# Adding accented and Umlaut characters the other fonts (only the 24px variant needs still to be done). To make this easier, a [[Font Patcher]] utility has been written.
# When an l10n.pk4 file is updated, the entire mission is redownloaded. That should be avoided somehow.
# Find more people who can contribute translations – maybe make it easier by creating a website where anyone can contribute translations for individual strings, ala [https://translations.launchpad.net/ launchpad]?

=== As of 2026 ===
...and TDM 2.14.
* See [[Translations of Main Menus]] for a numeric estimation of core string completion by language.

* Great progress has been made on {{green|'''Slovak'''}}, and {{green|'''Catalan'''}} is newly available.
* {{red|'''Swedish'''}} and {{red|'''Dutch'''}} remain substantially incomplete.
* Both Stone and Carleton fonts in 24pt, the basis for almost all core strings, now cover all 256 TDM-defined codepoints. Having a full complement of accented characters makes translation easier. Unattractive Carleton characters were replaced.
* Font improvements are driven by familiar tools, like GIMP, and new tools like [[Refont]], [[datBounds]], and gen_lang_plus (among [[Gen Lang Programs]]).

{{i18n}}

I18N Status

2026-06-23T02:03:35Z

Geep: /* TDM Core */ Add 2017 update

This article deals with the localisation/translation of both TDM itself, as well as [[Fan Missions]].

{{infobox|{{red|The I18N support in TDM will only work with v1.07 or newer.}}}}

== FM List ==
===Translations Developed Under or Available through Language-Specific Third-Party Sites===
These translations may in some cases go beyond I18N-text translations, to include images and vocals.

An example is DarkFate.org, which has Russian language translation of Thief-family games, including on the order of 100 TDM FMs. A current list may be found [https://darkfate.org/view/details/files/fan-missions/translates/tdm here]. See also an earlier TDM forum post about [https://forums.thedarkmod.com/index.php?/topic/16416-russian-translation-of-fm/page/2/&tab=comments#comment-380965 Dark Fate resources for Russian-speaking translators of TDM FMs].

===I18N-Text Translations Available Within TheDarkMod.com FMs===
Click on a column header to sort the list, or toggle ascending/descending order.

{{infobox|{{red|'''This list may be incomplete!'''}}}}

{|class="wikitable sortable" border=1 style="border-collapse: collapse; font-size: 80%" cellspacing=0 cellpadding=2 width=100%
|-
!style="background:#e0e0f0"|Name
!style="background:#e0e0f0"|<abbr style="font-size:80%" title="Converted to the I18N system">I18N?</abbr>
!style="background:#d0d0e0"|<abbr style="font-size:80%" title="Czech">cs</abbr>
!style="background:#d0d0e0"|<abbr style="font-size:80%" title="Danish">da</abbr>
!style="background:#d0d0e0"|<abbr style="font-size:80%" title="Dutch">nl</abbr>
!style="background:#d0d0e0"|<abbr style="font-size:80%" title="English">en</abbr>
!style="background:#d0d0e0"|<abbr style="font-size:80%" title="French">fr</abbr>
!style="background:#d0d0e0"|<abbr style="font-size:80%" title="German">de</abbr>
!style="background:#d0d0e0"|<abbr style="font-size:80%" title="Hungarian">hu</abbr>
!style="background:#d0d0e0"|<abbr style="font-size:80%" title="Italian">it</abbr>
!style="background:#d0d0e0"|<abbr style="font-size:80%" title="Spanish">es</abbr>
!style="background:#d0d0e0"|<abbr style="font-size:80%" title="Russian">ru</abbr>
!style="background:#d0d0e0"|<abbr style="font-size:80%" title="Portuguese">pt</abbr>
!style="background:#d0d0e0"|<abbr style="font-size:80%" title="Polish">pl</abbr>

|-
!Special Delivery
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-yes}}
|{{I18N-yes}}
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}

|-
!Awaiting the Storm
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}

|-
!Business as Usual
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}

|-
!Chalice of the Kings
|{{I18N-yn|bg=#f08020|text=50%}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-yes}}
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}

|-
!Vengeance for a Thief Part 1
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}

|-
!Closemouthed Shadows
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}

|-
!Deceptive Shadows
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}

|-
!House in Blackbog Hollow
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}

|-
!House Of Theo
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}

|-
!Living Expenses
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-yes}}
|{{I18N-yes}}
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}

|-
!Mad's Mountain
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}

|-
!Pandora's Box
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}

|-
!Rake Off
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}

|-
!Somewhere Above the City
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}

|-
!Swing
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-yes}}
|{{I18N-yes}}
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}

|-
!The Crown of Penitence
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-yes}}
|{{I18N-yes}}
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}

|-
!Illusionist's Tower
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}

|-
!The Outpost
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-yes}}
|{{I18N-yes}}
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}

|-
!The Parcel
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}

|-
!The Rift
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}

|-
!The Sons of Baltona 1
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-yes}}
|{{I18N-yes}}
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}

|-
!The Tears of Saint Lucia
|{{I18N-yn|bg=#80c010|text=90%}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-yn|bg=#80c010|text=90%}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}

|-
!The Thieves
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-yes}}
|{{I18N-yes}}
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}

|-
!Thief's Den
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-yes}}
|{{I18N-yes}}
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}

|-
!Too Late
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}

|-
!Training Mission
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-yes}}
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}

|-
!Trapped!
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}

|-
!Winter Harvest v2.4
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}

|-
!A Night to Remember
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}

|-
!A Score to Settle
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}

|-
!Alberic's Curse
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}

|-
!Betrayal
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}

|-
!Dragon's Claw
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}

|-
!Fiasco at Fauchard Street
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}

|-
!In Remembrance of Him
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}

|-
!Krysztalowy Grob (Crystal Grave)
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-yes}}

|-
!Let Sleeping Thieves Lie
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}

|-
!Lockdown
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}

|-
!Lord Dufford's
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}

|-
!Mandrasola
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}

|-
!No Honor Among Thieves
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}

|-
!Patently Dangerous
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}

|-
!Reap as you sow
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}

|-
!Return to the City
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}

|-
!Rightful Property
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}

|-
!Samhain Night on Bone Hill
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}

|-
!The Siege Shop
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}

|-
!Sneak and Destroy
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}

|-
!Sound Alert & Blackjack Trainer
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}

|-
!St. Alban's Cathedral
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}

|-
!The Alchemist
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}

|-
!The Beleaguered Fence
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}

|-
!The Builder's Influence
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}

|-
!The Caduceus of St. Alban
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}

|-
!The Creeps
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}

|-
!The Glenham Tower
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}

|-
!The Heart of Lone Salvation
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}

|-
!The Knighton Manor
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}

|-
!The Phrase Book
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}

|-
!The Transaction
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}

|-
!Flakebridge Monastery
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}

|-
!Old Habits
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}

|-
!In the North
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-yes}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}
|{{I18N-no}}

|}

If you want to help translating these missions into other languages, you can download them [http://www.bloodgate.com/mirrors/tdm/pub/pk4/i18n/ here].

== TDM Core ==

=== As of 2017 ===
:{{percent|99}}

* All the strings in the menu, the HUD, the in-game messages, the different menus as well as inventory item names and categories have been made translatable.
* A [[I18N - Charset|charset]] has been defined and made supported by the code.
* Both the menu font (Carleton) and the HUD font (Stone) have been patched to include the foreign characters. (''Stone misses a few, esp. uppercase ones. Some Carleton characters are unattractive.'')
* The bitmaps in the various menus where converted to text, including the huge headers
* The default Doom3 ''english.lang'' has been slimmed down (from >5400 to 200 entries), then all the nec. strings for TDM have been added, including a lot of sensible default strings that are either useful or used in FMs (like names for inventory items, speaker names and so on), resulting over '''1130 entries'''.
* There is a '''[[I18N.pl|script]]''' which can convert old FMs into I18N capable FMs, even matching different translations.
* Both the 0xff character bug, as well as the problem that '''choiceDef'''s do not work have been resolved
* Menu and inventory name translations are complete for {{green|'''English'''}}, {{green|'''Danish'''}}, {{green|'''Italian'''}}, {{green|'''Czech'''}}, {{green|'''Polish'''}}, {{green|'''Portuguese'''}}, {{green|'''Russian'''}}, {{green|'''French'''}}, {{green|'''Spanish'''}}, {{green|'''German'''}}, {{green|'''Romanian'''}}, and {{green|'''Hungarian'''}}.
* {{red|'''Swedish'''}}, {{red|'''Slovak'''}} and {{red|'''Dutch'''}} can be selected in the menu, but as of February 2017 still have substantially incomplete translations. Anyone capable of providing said translations, even in part, please post in the TDM forum under the "I want to Help" section.
* {{green|'''Turkish'''}} has been added to the menu translation list and will be available in 2.05
==== TODO ====

# The Download and Load/Save menu still need to be converted so their headlines can be translated.
# Adding accented and Umlaut characters the other fonts (only the 24px variant needs still to be done). To make this easier, a [[Font Patcher]] utility has been written.
# When an l10n.pk4 file is updated, the entire mission is redownloaded. That should be avoided somehow.
# Find more people who can contribute translations – maybe make it easier by creating a website where anyone can contribute translations for individual strings, ala [https://translations.launchpad.net/ launchpad]?

=== As of 2026 ===
See [[Translations of Main Menus]] for a numeric estimation of core string completion by language.

* Great progress has been made on {{green|'''Slovak'''}}, and {{green|'''Catalan'''}} is newly available.
* {{red|'''Swedish'''}} and {{red|'''Dutch'''}} remain substantially incomplete.
* Both Stone and Carleton fonts in 24pt, the basis for almost all core strings, now cover all 256 TDM-defined codepoints. Having a full complement of accented characters makes translation easier. Unattractive Carleton characters were replaced.
* Font improvements are driven by familiar tools, like GIMP, and new tools like [[Refont]], [[datBounds]], and gen_lang_plus (among [[Gen Lang Programs]]).

{{i18n}}

Translations of Main Menus

2026-06-23T01:13:14Z

Geep:

... and other I18N TDM-platform strings that are not FM-specific.
Estimates of percent translated are derived primarily from results from gen_lang_plus with its -missing option.

As of TDM 2.14, english.lang defines 1347 #str_ phrases (and presumably a similar number in the [english] section of all.lang). If, for a given [english] #str_ ID in all.lang, either:
# there's no matching [language] #str_ ID; or
# there's a matching [language] #str_ID, but with the same phrase as [english], and it's not marked with the comment "// stays the same"

then that is counted as "untranslated" (i.e., missing).

Phrases considered "translated", shown in declining count order:

* catalan - 1265 (94%)
* russian - 1232 (92%)
* french - 1197 (89%)
* german - 1195 (89%)
* turkish - 1193 (89%)
* hungarian - 1190 (88%)
* polish - 1183 (88%)
* slovak - 1164 (86%)
* italian - 1142 (85%)
* romanian - 1137 (84%)
* spanish - 1102 (82%)
* danish - 1095 (82%)
* portuguese - 1034 (77%)
* czech - 998 (74%)
* dutch - 142 (11%)
* swedish - 136 (10%)

Caveats:
* Because of certain problems (multiline comments, duplicate entries), these numbers are estimates, not definitive.
* Some phrases shouldn't or can't be translated (e.g., PC function keys), or are the same in English and the other language, even if not marked with "// stays the same".)
* These estimates do not account of any possible platform text left hard-coded in English text, so not represented by a #str_.
* These estimates do not account for platform aspects with no translation mechanism, e.g.:
** Readme's about potential games to select
** Barks and subtitles (common to all FMs)

Translations of Main Menus

2026-06-23T01:11:54Z

Geep: create article

... and other I18N TDM-platform strings that are not FM-specific.
Estimates of percent translated are derived primarily on results from gen_lang_plus with -missing option.

As of TDM 2.14, english.lang defines 1347 #str_ phrases (and presumably a similar number in the [english] section of all.lang). If, for a given [english] #str_ ID in all.lang, either:
# there's no matching [language] #str_ ID; or
# there's a matching [language] #str_ID, but with the same phrase as [english], and it's not marked with the comment "// stays the same"

then that is counted as "untranslated" (i.e., missing).

Phrases considered "translated", shown in declining count order:

* catalan - 1265 (94%)
* russian - 1232 (92%)
* french - 1197 (89%)
* german - 1195 (89%)
* turkish - 1193 (89%)
* hungarian - 1190 (88%)
* polish - 1183 (88%)
* slovak - 1164 (86%)
* italian - 1142 (85%)
* romanian - 1137 (84%)
* spanish - 1102 (82%)
* danish - 1095 (82%)
* portuguese - 1034 (77%)
* czech - 998 (74%)
* dutch - 142 (11%)
* swedish - 136 (10%)

Caveats:
* Because of certain problems (multiline comments, duplicate entries), these numbers are estimates, not definitive.
* Some phrases shouldn't or can't be translated (e.g., PC function keys), or are the same in English and the other language, even if not marked with "// stays the same".)
* These estimates do not account of any possible platform text left hard-coded in English text, so not represented by a #str_.
* These estimates do not account for platform aspects with no translation mechanism, e.g.:
** Readme's about potential games to select
** Barks and subtitles (common to all FMs)

Multilanguage Display

2026-06-19T17:44:18Z

Geep: /* TDM & ISO Char Sets - Details, Potential Tricks, Limitations */

== Background ==
''This describes a particular challenging use case of a TDM methodology that has been around for some time. The motivation to detail this was a 2026 update by Geep to the language map files, following a revision of Carleton 24pt font used throughout the Main Menu.''

In TDM's main menu, the Settings/Video/Language page attempts to list all the supported languages in their native form with respect to character set, that is, untranslated. Showing multiple language strings together is difficult, but some tricks are available. The result has been a reasonable near-term workaround for this particular page, applicable to comparable cases. (Comprehensive support for multilanguage display likely involves a major restructuring, for instance, moving to a native Unicode architecture with combined Latin and Cyrillic bitmaps.)

Recall that strings for the main menu are found in the utf8 file tdm_base01.pk4/strings/all.lang, where there are sections for [English], [German], etc. A particular section is used to generate for distribution the corresponding file, e.g., french.lang, german.lang, etc., in a language-specific 8-bit encoding. When you play TDM, and select a given language, the corresponding .lang file (if provided) is read.

Except for Cyrillic Russian, these files use encodings within the ISO-8859 family (as detailed in [[I18N_-_Charset]]). Any specific encoding is a bottleneck... by design, not all characters in any one member of the ISO-8859 family will be accessible by some other members.

== Language Names in Idealized UTF8 Form ==
Only the TDM-exposed languages are shown here. The all.lang file has additional strings for other potential Latin and Cyrillic languages. For reference, the generated encoding for the <language>.lang file is shown in the comment.

"#str_02460" "English" // English [ISO-8859-1]
"#str_02461" "Deutsch" // German [ISO-8859-1]
"#str_02462" "Español" // Spanish [ISO-8859-1]
"#str_02463" "Français" // French [ISO-8859-15]
"#str_02464" "Português" // Portuguese [ISO-8859-1]
"#str_02465" "Polski" // Polish [ISO-8859-2]
"#str_02466" "Italiano" // Italian [ISO-8859-1]
"#str_02467" "Česky" // Czech [ISO-8859-2]
"#str_02468" "Русский" // Russian [WIN-1251]
"#str_02469" "Català" // Catalan [ISO-8859-1]
"#str_02470" "Dansk" // Danish [ISO-8859-1]
"#str_02472" "Nederlands" // Dutch [ISO-8859-1]
"#str_02474" "Magyar" // Hungarian [ISO-8859-2]
"#str_02476" "Svenska" // Swedish [ISO-8859-1]
"#str_02477" "Türkçe" // Turkish [ISO-8859-9]
"#str_02479" "Română" // Romanian [ISO-8859-16]
"#str_02480" "Slovenčina" // Slovak [ISO-8859-2]

== First Compromise – Cyrillic vs. Latin Font ==
While there is some overlap in characters between Cyrillic and Latin encodings, it is insufficient for our purposes. So, for [English] and other European sections, a Latin transliteration from Cyrillic is used:

"#str_02468" "Russkiy" // Russian

Going the other way, for [Russian], the current treatment is not to do a Cyrillic transliteration from Latin, but instead to drop accents, rendering just in ASCII (except of course “Russian”), e.g.:

"#str_02460" "English" // English
"#str_02461" "Deutsch" // German
"#str_02462" "Espanol" // Spanish
"#str_02463" "Francais" // French
"#str_02464" "Portugues" // Portuguese
"#str_02465" "Polski" // Polish
"#str_02466" "Italiano" // Italian
"#str_02467" "Cesky" // Czech
"#str_02468" "Русский" // Russian
"#str_02469" "Catala" // Catalan
"#str_02470" "Dansk" // Danish
"#str_02472" "Nederlands" // Dutch
"#str_02474" "Magyar" // Hungarian
"#str_02476" "Svenska" // Swedish
"#str_02477" "Turkce" // Turkish
"#str_02479" "Romana" // Romanian
"#str_02480" "Slovencina" // Slovak

== Moving between ISO-8859 Members ==
In the discussion here, let “L1” be the current language (from the player’s perspective) or the [language] section of interest in all.lang (from the translator’s perspective). Let “L2” be the language of the foreign word, i.e., L1 and L2 differ.

=== Type and Go ===
In several cases, the translator merely puts the ideal character in the all.lang strings. After <language>.lang generation, everything works. Cases are:

# L1 and L2 are both use the same ISO-8859 encoding. (Specifically, they are either both ISO-8859-1, which doesn’t need <language>.map files, or both ISO-8859-2, and have <language>.map files with, by convention, identical contents.) NOTE: For TDM’s purposes, ISO-8859-15 (French) can be considered part of the ISO-8859-1 family.
# L2 character is ASCII (i.e., in ISO range 0x00-0x7f). This is always the case if L2 = English. Characters in this range have identical codepoints in all five TDM-supported ISO-8859 and in the TDM target encoding.
# L2 character is in the ISO range 0xA0-0xFF, with additional constraints.

For the last case, the L2 character must be either:
* present at the same codepoint in all five TDM-supported ISO-8859 encodings, and in the TDM target encoding. For our Latin language names, these accented characters are like that:
ç in "Français" and "Türkçe" at 0xE7
à in "Català" at 0xEA
â in "Română" at 0xE2
ü in "Türkçe" at 0xFC
* present at the same codepoint in ISO-8859 encodings for L1 and L2, and in the TDM target encoding.
* present in different codepoints in ISO-8859 encodings for L1 and L2, but with each being either the same as the TDM target encoding, or mapped to the TDM target encoding by the <language>.map file.

=== Tricks ===
If the L2 character is not represented in the ISO encoding for L1, then at <L1>.lang generation time, it will be replaced by a “?”. To work around this, the translator has two methods:

====Trick Method 1 – Direct Stuffing====
When L1 encoding is ISO-8859-1 (or -9 or -15, which all have identical encodings for the 0xA0-BF ranges) and L2 character is in TDM’s 0xA0-0xBF range (or D7, F7), then you can lookup the ISO character associated with that codepoint (shown in parentheses in cells of the i18n- charmap table), and type it. Examples:

[English] // and other ISO-8859-1, -9, or -15
"#str_02467" "¬esky" // our default mapping is ISO 8859-1, so ¬ is shown as Č (¬)
"#str_02480" "Sloven®ina" // Slovak (® in ISO-8859-1 is č in our font)

Here’s another example of that last stuffing from a TDM-unexposed language, showing also a diaresis (0xA8):

"#str_02481" "Sloven¨®ina" // Slovenian (southern slovenia) (¨ => š)

In this case, ISO-8859-1 would need to use the diaresis, but ISO-8859-15 (French) would not, i.e., could type and go with š.
The spreadsheet shows all available substitutions in light blue.

====Trick Method 2 – Special Mapping with Repurposed Character====
If all else fails, a little-used character in L1 can be redirected to the L2 codepoint TDM wants, by an extra mapping command in the <L1>.map file. Current such tricks are...

To get ñ for "Español":

* for iso 2, put ¨ (diaeresis 0xA8)
* for iso 16, put ¶ (pilcrow 0xB6)

To get ê for "Português":

*for iso 2: Put ´ (acute accent 0xBD)

== TDM & ISO Char Sets - Details, Potential Tricks, Limitations ==

The main table below (after the Key) was drafted by Google AI, from a prompt that defined the header and an example row, and specified:

"Rows are a combination of all the printable 8-bit codepoints in the range 0x80-0xff defined in ISO-8859-1, -2, -9, -15, and -16. The rows are ordered by Unicode number. If a particular ISO standard does not include the character, leave that cell blank."

Subsequently, after Excel import, the TDM and Comments columns were filled in by Geep, and color coding added. Language mappings were independently color coded, then verified against existing language maps. Finally converted to wikitable format.

This table skips codepoints in the range 0x00-0x7f, because they are the same for all ISO-8859 standards. No mapping required.

{| class="wikitable" style="font-size: 95%; line-height: 1.3em;"
|+ Color Key
! Cell !! Meaning
|-

| style="color:#8c8c8c;" | Light Gray Text Row || Symbol not included in TDM custom character set (so TDM column blank). Can use for char substitution tricks.
|-

| 0xNN on white || Type desired utf8 char (in Symbol column) in all.lang. Generation goes directly to TDM codepoint given.
|-

| style="background:#ebbb54;" | 0xNN, amber hilite || Type desired utf8 char in all.lang. Generation + mapping (in <language>.map file) goes to TDM codepoint via codepoint shown.
|-

| style="background:#ebbb54;color:#606060;" | 0xNN in gray || Type desired utf8 char in all.lang. Generation + mapping (in <language>.map file) goes to TDM codepoint OF SUBSTITUTE CHARACTER via codepoint shown.
|-

| style="background:#ebbb54;color:#ff0000;" | 0xNN in red || Character not part of this ISO. "0xnn" shown is not ISO, but for trick mapping (in <language.map), to support main menu's multilingual "Languages" page.
|-

| style="background:#9ab4e3;" | Substitute Char || Character not part of this ISO. But as trick, you can stuff in this substitute char at the needed TDM codepoint.
|-

| style="background:#43a8cc;" | n/a || Not available to use substitute character, due to trick mapping (in <language>.map) elsewhere.
|-

| Empty Cell || In ISO column, means character not part of this ISO (so may be candidate for future trick mapping; or simply not fully analyzed viz substitute char.)
|-

| style="background:#dbab8a;" | Tan Row || Orphaned character in TDM set, not part of 5 ISO-8859 standards for current TDM-supported languages.
|-
|}

{| class="wikitable" style="font-size: 95%; line-height: 1.3em;"
|+ Unicode Coverage for TDM
! Unicode !! Symbol !! TDM !! 1 !! 2 !! 9 !! 15 !! 16 !! Unicode Name !! Comments
|-

| U+00A0 ||   || 0xA0 || 0xA0 || 0xA0 || 0xA0 || 0xA0 || 0xA0 || no-break space ||
|- style="color:#8c8c8c;"

| U+00A1 || ¡ || || 0xA1 || || 0xA1 || 0xA1 || || inverted exclamation mark ||
|- style="color:#8c8c8c;"

| U+00A2 || ¢ || || 0xA2 || || 0xA2 || 0xA2 || || cent sign ||
|- style="color:#8c8c8c;"

| U+00A3 || £ || || 0xA3 || || 0xA3 || 0xA3 || || pound sign ||
|- style="color:#8c8c8c;"

| U+00A4 || ¤ || || 0xA4 || 0xA4 || 0xA4 || || || currency sign ||
|- style="color:#8c8c8c;"

| U+00A5 || ¥ || || 0xA5 || || 0xA5 || 0xA5 || || yen sign ||
|- style="color:#8c8c8c;"

| U+00A6 || ¦ || || 0xA6 || || 0xA6 || || || broken bar ||
|-

| U+00A7 || § || 0xA7 || 0xA7 || 0xA7 || 0xA7 || 0xA7 || 0xA7 || section sign ||
|- style="color:#8c8c8c;"

| U+00A8 || ¨ || || 0xA8 || 0xA8 || 0xA8 || || || diaeresis || See also hack use for ñ
|- style="color:#8c8c8c;"

| U+00A9 || © || || 0xA9 || || 0xA9 || 0xA9 || 0xA9 || copyright sign ||
|- style="color:#8c8c8c;"

| U+00AA || ª || || 0xAA || || 0xAA || 0xAA || || feminine ordinal indicator ||
|- style="color:#8c8c8c;"

| U+00AB || « || || 0xAB || || 0xAB || 0xAB || 0xAB || left-pointing double angle quotation mark ||
|- style="color:#8c8c8c;"

| U+00AC || ¬ || || 0xAC || || 0xAC || 0xAC || || not sign ||
|-

| U+00AD || || 0xAD || 0xAD || 0xAD || 0xAD || 0xAD || 0xAD || soft hyphen ||
|- style="color:#8c8c8c;"

| U+00AE || ® || || 0xAE || || 0xAE || 0xAE || || registered sign ||
|- style="color:#8c8c8c;"

| U+00AF || ¯ || || 0xAF || || 0xAF || 0xAF || || macron ||
|- style="color:#8c8c8c;"

| U+00B0 || ° || || 0xB0 || 0xB0 || 0xB0 || 0xB0 || 0xB0 || degree sign ||
|- style="color:#8c8c8c;"

| U+00B1 || ± || || 0xB1 || || 0xB1 || 0xB1 || 0xB1 || plus-minus sign ||
|- style="color:#8c8c8c;"

| U+00B2 || ² || || 0xB2 || || 0xB2 || 0xB2 || || superscript two ||
|- style="color:#8c8c8c;"

| U+00B3 || ³ || || 0xB3 || || 0xB3 || 0xB3 || || superscript three ||
|- style="color:#8c8c8c;"

| U+00B4 || ´ || || 0xB4 || 0xB4 || 0xB4 || || || acute accent ||
|- style="color:#8c8c8c;"

| U+00B5 || µ || || 0xB5 || || 0xB5 || 0xB5 || || micro sign ||
|- style="color:#8c8c8c;"

| U+00B6 || ¶ || || 0xB6 || || 0xB6 || 0xB6 || 0xB6 || pilcrow sign ||
|- style="color:#8c8c8c;"

| U+00B7 || · || || 0xB7 || || 0xB7 || 0xB7 || 0xB7 || middle dot ||
|- style="color:#8c8c8c;"

| U+00B8 || ¸ || || 0xB8 || 0xB8 || 0xB8 || || || cedilla ||
|- style="color:#8c8c8c;"

| U+00B9 || ¹ || || 0xB9 || || 0xB9 || 0xB9 || || superscript one ||
|- style="color:#8c8c8c;"

| U+00BA || º || || 0xBA || || 0xBA || 0xBA || || masculine ordinal indicator ||
|- style="color:#8c8c8c;"

| U+00BB || » || || 0xBB || || 0xBB || 0xBB || 0xBB || right-pointing double angle quotation mark ||
|- style="color:#8c8c8c;"

| U+00BC || ¼ || || 0xBC || || 0xBC || || || vulgar fraction one quarter ||
|- style="color:#8c8c8c;"

| U+00BD || ½ || || 0xBD || || 0xBD || || || vulgar fraction one half ||
|- style="color:#8c8c8c;"

| U+00BE || ¾ || || 0xBE || || 0xBE || || || vulgar fraction three quarters ||
|-

| U+00BF || ¿ || 0xBF || 0xBF || || 0xBF || 0xBF || || inverted question mark ||
|-

| U+00C0 || À || 0xC0 || 0xC0 || || 0xC0 || 0xC0 || 0xC0 || latin capital letter a with grave ||
|-

| U+00C1 || Á || 0xC1 || 0xC1 || 0xC1 || 0xC1 || 0xC1 || 0xC1 || latin capital letter a with acute ||
|-

| U+00C2 || Â || 0xC2 || 0xC2 || 0xC2 || 0xC2 || 0xC2 || 0xC2 || latin capital letter a with circumflex ||
|-

| U+00C3 || Ã || 0xC3 || 0xC3 || || 0xC3 || 0xC3 || || latin capital letter a with tilde ||
|-

| U+00C4 || Ä || 0xC4 || 0xC4 || 0xC4 || 0xC4 || 0xC4 || 0xC4 || latin capital letter a with diaeresis ||
|-

| U+00C5 || Å || 0xC5 || 0xC5 || || 0xC5 || 0xC5 || || latin capital letter a with ring above ||
|-

| U+00C6 || Æ || 0xC6 || 0xC6 || || 0xC6 || 0xC6 || 0xC6 || latin capital letter ae ||
|-

| U+00C7 || Ç || 0xC7 || 0xC7 || 0xC7 || 0xC7 || 0xC7 || 0xC7 || latin capital letter c with cedilla ||
|-

| U+00C8 || È || 0xC8 || 0xC8 || || 0xC8 || 0xC8 || 0xC8 || latin capital letter e with grave ||
|-

| U+00C9 || É || 0xC9 || 0xC9 || 0xC9 || 0xC9 || 0xC9 || 0xC9 || latin capital letter e with acute ||
|-

| U+00CA || Ê || 0xCA || 0xCA || || 0xCA || 0xCA || 0xCA || latin capital letter e with circumflex ||
|-

| U+00CB || Ë || 0xCB || 0xCB || 0xCB || 0xCB || 0xCB || 0xCB || latin capital letter e with diaeresis ||
|-

| U+00CC || Ì || 0xCC || 0xCC || || 0xCC || 0xCC || 0xCC || latin capital letter i with grave ||
|-

| U+00CD || Í || 0xCD || 0xCD || 0xCD || 0xCD || 0xCD || 0xCD || latin capital letter i with acute ||
|-

| U+00CE || Î || 0xCE || 0xCE || 0xCE || 0xCE || 0xCE || 0xCE || latin capital letter i with circumflex ||
|-

| U+00CF || Ï || 0xCF || 0xCF || || 0xCF || 0xCF || 0xCF || latin capital letter i with diaeresis ||
|-

| U+00D0 || Ð || 0xD0 || 0xD0 || || style="background:#43a8cc;" | n/a || 0xD0 || || latin capital letter eth || Same glyph as U+0110 latin capital letter d with stroke
|-

| U+00D1 || Ñ || 0xD1 || 0xD1 || || 0xD1 || 0xD1 || || latin capital letter n with tilde ||
|-

| U+00D2 || Ò || 0xD2 || 0xD2 || || 0xD2 || 0xD2 || 0xD2 || latin capital letter o with grave ||
|-

| U+00D3 || Ó || 0xD3 || 0xD3 || 0xC1 || 0xD3 || 0xD3 || 0xD3 || latin capital letter o with acute ||
|-

| U+00D4 || Ô || 0xD4 || 0xD4 || 0xD4 || 0xD4 || 0xD4 || 0xD4 || latin capital letter o with circumflex || Formerly also mapped from 0x88; redundant, Ğ has 0x88 codepoint now
|-

| U+00D5 || Õ || 0xD5 || 0xD5 || || 0xD5 || 0xD5 || || latin capital letter o with tilde ||
|-

| U+00D6 || Ö || 0xD6 || 0xD6 || 0xD6 || 0xD6 || 0xD6 || 0xD6 || latin capital letter o with diaeresis ||
|- style="color:#8c8c8c;"

| U+00D7 || × || || 0xD7 || 0xD7 || 0xD7 || 0xD7 || || multiplication sign ||
|-

| U+00D8 || Ø || 0xD8 || 0xD8 || || 0xD8 || 0xD8 || || latin capital letter o with stroke ||
|-

| U+00D9 || Ù || 0xD9 || 0xD9 || || 0xD9 || 0xD9 || 0xD9 || latin capital letter u with grave ||
|-

| U+00DA || Ú || 0xDA || 0xDA || 0xDA || 0xDA || 0xDA || 0xDA || latin capital letter u with acute ||
|-

| U+00DB || Û || 0xDB || 0xDB || || 0xDB || 0xDB || 0xDB || latin capital letter u with circumflex ||
|-

| U+00DC || Ü || 0xDC || 0xDC || 0xDC || 0xDC || 0xDC || 0xDC || latin capital letter u with diaeresis ||
|-

| U+00DD || Ý || 0xDD || 0xDD || 0xDD || || 0xDD || || latin capital letter y with acute ||
|-

| U+00DE || Þ || 0xDE || 0xDE || || || 0xDE || || latin capital letter thorn ||
|-

| U+00DF || ß || 0xDF || 0xDF || 0xDF || 0xDF || 0xDF || 0xDF || latin small letter sharp s ||
|-

| U+00E0 || à || 0xE0 || 0xE0 || || 0xE0 || 0xE0 || 0xE0 || latin small letter a with grave ||
|-

| U+00E1 || á || 0xE1 || 0xE1 || 0xE1 || 0xE1 || 0xE1 || 0xE1 || latin small letter a with acute ||
|-

| U+00E2 || â || 0xE2 || 0xE2 || 0xE2 || 0xE2 || 0xE2 || 0xE2 || latin small letter a with circumflex ||
|-

| U+00E3 || ã || 0xE3 || 0xE3 || || 0xE3 || 0xE3 || || latin small letter a with tilde ||
|-

| U+00E4 || ä || 0xE4 || 0xE4 || 0xE4 || 0xE4 || 0xE4 || 0xE4 || latin small letter a with diaeresis ||
|-

| U+00E5 || å || 0xE5 || 0xE5 || || 0xE5 || 0xE5 || || latin small letter a with ring above ||
|-

| U+00E6 || æ || 0xE6 || 0xE6 || || 0xE6 || 0xE6 || 0xE6 || latin small letter ae ||
|-

| U+00E7 || ç || 0xE7 || 0xE7 || 0xE7 || 0xE7 || 0xE7 || 0xE7 || latin small letter c with cedilla ||
|-

| U+00E8 || è || 0xE8 || 0xE8 || || 0xE8 || 0xE8 || 0xE8 || latin small letter e with grave ||
|-

| U+00E9 || é || 0xE9 || 0xE9 || 0xE9 || 0xE9 || 0xE9 || 0xE9 || latin small letter e with acute ||
|-

| U+00EA || ê || 0xEA || 0xEA || style="background:#ebbb54;color:#ff0000;" | 0xBD || 0xEA || 0xEA || 0xEA || latin small letter e with circumflex || Hack for iso 2: Put ´ (acute accent, 0xBD) to get ê for "Português"
|-

| U+00EB || ë || 0xEB || 0xEB || 0xEB || 0xEB || 0xEB || 0xEB || latin small letter e with diaeresis ||
|-

| U+00EC || ì || 0xEC || 0xEC || || 0xEC || 0xEC || 0xEC || latin small letter i with grave ||
|-

| U+00ED || í || 0xED || 0xED || 0xED || 0xED || 0xED || 0xED || latin small letter i with acute ||
|-

| U+00EE || î || 0xEE || 0xEE || 0xEE || 0xEE || 0xEE || 0xEE || latin small letter i with circumflex ||
|-

| U+00EF || ï || 0xEF || 0xEF || || 0xEF || 0xEF || 0xEF || latin small letter i with diaeresis ||
|-

| U+00F0 || ð || 0xF0 || 0xF0 || || || 0xF0 || || latin small letter eth ||
|-

| U+00F1 || ñ || 0xF1 || 0xF1 || style="background:#ebbb54;color:#ff0000;" | 0xA8 || 0xF1 || 0xF1 || style="background:#ebbb54;color:#ff0000;" | 0xB6 || latin small letter n with tilde || Hacks to get ñ for "Español": for iso 2, put ¨ (diaeresis 0xA8); for iso 16, put ¶ (0xB6)
|-

| U+00F2 || ò || 0xF2 || 0xF2 || || 0xF2 || 0xF2 || 0xF2 || latin small letter o with grave ||
|-

| U+00F3 || ó || 0xF3 || 0xF3 || 0xF3 || 0xF3 || 0xF3 || 0xF3 || latin small letter o with acute ||
|-

| U+00F4 || ô || 0xF4 || 0xF4 || 0xF4 || 0xF4 || 0xF4 || 0xF4 || latin small letter o with circumflex || Formerly also mapped from 0x88; redundant, ğ has TDM 0x88 codepoint now
|-

| U+00F5 || õ || 0xF5 || 0xF5 || || 0xF5 || 0xF5 || || latin small letter o with tilde ||
|-

| U+00F6 || ö || 0xF6 || 0xF6 || 0xF6 || 0xF6 || 0xF6 || 0xF6 || latin small letter o with diaeresis ||
|- style="color:#8c8c8c;"

| U+00F7 || ÷ || || 0xF7 || 0xF7 || 0xF7 || 0xF7 || || division sign ||
|-

| U+00F8 || ø || 0xF8 || 0xF8 || || 0xF8 || 0xF8 || || latin small letter o with stroke ||
|-

| U+00F9 || ù || 0xF9 || 0xF9 || || 0xF9 || 0xF9 || 0xF9 || latin small letter u with grave ||
|-

| U+00FA || ú || 0xFA || 0xFA || 0xFA || 0xFA || 0xFA || 0xFA || latin small letter u with acute ||
|-

| U+00FB || û || 0xFB || 0xFB || || 0xFB || 0xFB || 0xFB || latin small letter u with circumflex ||
|-

| U+00FC || ü || 0xFC || 0xFC || 0xFC || 0xFC || 0xFC || 0xFC || latin small letter u with diaeresis ||
|-

| U+00FD || ý || 0xFD || 0xFD || 0xFD || || 0xFD || || latin small letter y with acute ||
|-

| U+00FE || þ || 0xFE || 0xFE || || || 0xFE || || latin small letter thorn ||
|-

| U+00FF || ÿ || 0xFF || 0xFF || || 0xFF || 0xFF || 0xFF || latin small letter y with diaeresis ||
|-

| U+0102 || Ă || 0x8B || || style="background:#ebbb54;" | 0xC3 || || || style="background:#ebbb54;" | 0xC3 || latin capital letter a with breve ||
|-

| U+0103 || ă || 0x9B || || style="background:#ebbb54;" | 0xE3 || || || style="background:#ebbb54;" | 0xE3 || latin small letter a with breve ||
|-

| U+0104 || Ą || 0xAA || style="background:#9ab4e3" | ª || style="background:#ebbb54;" | 0xA1 || style="background:#9ab4e3" | ª || style="background:#9ab4e3" | ª || style="background:#ebbb54;" | 0xA1 || latin capital letter a with ogonek ||
|-

| U+0105 || ą || 0xBA || style="background:#9ab4e3" | º || style="background:#ebbb54;" | 0xB1 || style="background:#9ab4e3" | º || style="background:#9ab4e3" | º || style="background:#ebbb54;" | 0xA2 || latin small letter a with ogonek ||
|-

| U+0106 || Ć || 0x82 || || style="background:#ebbb54;" | 0xC6 || || || style="background:#ebbb54;" | 0xC5 || latin capital letter c with acute ||
|-

| U+0107 || ć || 0x92 || || style="background:#ebbb54;" | 0xE6 || || || style="background:#ebbb54;" | 0xE5 || latin small letter c with acute ||
|- style="background:#dbab8a;"

| U+0108 || Ĉ || 0x86 || || || || || || latin capital c with circumflex || Only in ISO-8859-3 (for Esperanto) at 0xC6
|- style="background:#dbab8a;"

| U+0109 || ĉ || 0x96 || || || || || || latin small c with circumflex || Only in ISO-8859-3 (for Esperanto) at 0xE6
|-

| U+010C || Č || 0xAC || style="background:#9ab4e3" | ¬ || style="background:#ebbb54;" | 0xC8 || style="background:#9ab4e3" | ¬ || style="background:#9ab4e3" | ¬ || style="background:#ebbb54;" | 0xB2 || latin capital letter c with caron || Substitute char "not sign" at 0xAC
|-

| U+010D || č || 0xAE || style="background:#9ab4e3" | ® || style="background:#ebbb54;" | 0xE8 || style="background:#9ab4e3" | ® || style="background:#9ab4e3" | ® || style="background:#ebbb54;" | 0xB9 || latin small letter c with caron || Substitute char "registration sign" at 0xAE
|-

| U+010E || Ď || 0xB3 || style="background:#9ab4e3" | ³ || style="background:#ebbb54;" | 0xCF || style="background:#9ab4e3" | ³ || style="background:#9ab4e3" | ³ || || latin capital letter d with caron || Substitute char "superscript three" at 0xB3
|-

| U+010F || ď || 0xB7 || style="background:#9ab4e3; font-weight:bold" | · || style="background:#ebbb54;" | 0xEF || style="background:#9ab4e3; font-weight:bold" | · || style="background:#9ab4e3; font-weight:bold" | · || || latin small letter d with caron || Substitute char "middle dot" at 0xB7
|-

| U+0110 || Đ || 0xD0 || 0xD0 || 0xD0 || style="background:#43a8cc;" | n/a || || 0xD0 || latin capital letter d with stroke || Same glyph as U+00D0 latin capital letter eth
|-

| U+0111 || đ || 0x90 || || style="background:#ebbb54;" | 0xF0 || style="background:#43a8cc;" | n/a || || style="background:#ebbb54;" | 0xF0 || latin small letter d with stroke ||
|-

| U+0118 || Ę || 0xAB || style="background:#9ab4e3" | « || style="background:#ebbb54;" | 0xCA || style="background:#9ab4e3" | « || style="background:#9ab4e3" | « || style="background:#ebbb54;" | 0xDD || latin capital letter e with ogonek || Substitute char "left-pointing double angle quotation mark" at 0xAB
|-

| U+0119 || ę || 0xBB || style="background:#9ab4e3" | » || style="background:#ebbb54;" | 0xEA || style="background:#9ab4e3" | » || style="background:#9ab4e3" | » || style="background:#ebbb54;" | 0xFD || latin small letter e with ogonek || Substitute char "right-pointing double angle quotation mark" at 0xBB
|-

| U+011A || Ě || 0xA5 || style="background:#9ab4e3" | ¥ || style="background:#ebbb54;" | 0xCC || style="background:#9ab4e3" | ¥ || style="background:#9ab4e3" | ¥ || || latin capital letter e with caron || Substitute char "yen sign" at 0xA5
|-

| U+011B || ě || 0xA3 || style="background:#9ab4e3" | £ || style="background:#ebbb54;" | 0xEC || style="background:#9ab4e3" | £ || style="background:#9ab4e3" | £ || || latin small letter e with caron || Substitute char "pound sign" at 0xA3
|-

| U+011E || Ğ || 0x88 || || || style="background:#ebbb54;" | 0xD0 || || || latin capital letter g with breve || As of TDM 2.13 (TDM codemap), 2.15 (turkish.map)
|-

| U+011F || ğ || 0x98 || || || style="background:#ebbb54;" | 0xF0 || || || latin small letter g with breve || As of TDM 2.13 (TDM codemap), 2.15 (turkish.map)
|- style="color:#8c8c8c;"

| U+0130 || İ || || || || style="background:#ebbb54;" | 0xDD || || || latin capital letter i with dot above || Turkish: utf8 "İ" will be mapped to "Î" (0xCE)
|- style="color:#8c8c8c;"

| U+0131 || ı || || || || style="background:#ebbb54;" | 0xFD || || || latin small letter dotless i || Turkish: utf8 "ı" will be mapped to ASCII "i" (0x69)
|- style="color:#8c8c8c;"

| U+0139 || Ĺ || || || 0xC5 || || || || latin capital letter l with acute ||
|- style="color:#8c8c8c;"

| U+013A || ĺ || || || 0xE5 || || || || latin small letter l with acute ||
|- style="color:#8c8c8c;"

| U+013D || Ľ || || || 0xA5 || || || || latin capital letter l with caron ||
|- style="color:#8c8c8c;"

| U+013E || ľ || || || 0xB5 || || || || latin small letter l with caron ||
|-

| U+0141 || Ł || 0xB1 || style="background:#9ab4e3" | ± || style="background:#ebbb54;" | 0xA3 || style="background:#9ab4e3" | ± || style="background:#9ab4e3" | ± || style="background:#ebbb54;" | 0xA3 || latin capital letter l with stroke || Substitute char "plus-minus sign" at 0xB1
|-

| U+0142 || ł || 0xB5 || style="background:#9ab4e3" | µ || style="background:#ebbb54;" | 0xB3 || style="background:#9ab4e3" | µ || style="background:#9ab4e3" | µ || style="background:#ebbb54;" | 0xB3 || latin small letter l with stroke || Substitute char "micro sign" at 0xB5
|-

| U+0143 || Ń || 0x8C || || style="background:#ebbb54;" | 0xD1 || || || style="background:#ebbb54;" | 0xD1 || latin capital letter n with acute ||
|-

| U+0144 || ń || 0x9C || || style="background:#ebbb54;" | 0xF1 || || || style="background:#ebbb54;" | 0xF1 || latin small letter n with acute ||
|-

| U+0147 || Ň || 0x80 || || style="background:#ebbb54;" | 0xD2 || || || || latin capital letter n with caron ||
|-

| U+0148 || ň || 0xA1 || style="background:#9ab4e3" | ¡ || style="background:#ebbb54;" | 0xF2 || style="background:#9ab4e3" | ¡ || style="background:#9ab4e3" | ¡ || || latin small letter n with caron || Substitute char "inverted exclamation mark" at 0xA1
|-

| U+0150 || Ő || 0xB0 || style="background:#9ab4e3" | ° || style="background:#ebbb54;" | 0xD5 || style="background:#9ab4e3" | ° || style="background:#9ab4e3" | ° || style="background:#ebbb54;" | 0xD5 || latin capital letter o with double acute || Similiar to Ö, used in Hungarian. Substitute char "degree sign" at 0xB0
|-

| U+0151 || ő || 0xB9 || style="background:#9ab4e3" | ¹ || style="background:#ebbb54;" | 0xF5 || style="background:#9ab4e3" | ¹ || style="background:#9ab4e3" | ¹ || style="background:#ebbb54;" | 0xF5 || latin small letter o with double acute || Similiar to ö, used in Hungarian. Substitute char "superscript 1" at 0xB9
|-

| U+0152 || Œ || 0xBC || style="background:#9ab4e3" | ¼ || || style="background:#9ab4e3" | ¼ || 0xBC || 0xBC || latin capital ligature oe || Substitute char "vulgar fraction one quarter" at 0xBC
|-

| U+0153 || œ || 0xBD || style="background:#9ab4e3" | ½ || || style="background:#9ab4e3" | ½ || 0xBD || 0xBD || latin small ligature oe || Substitute char "vulgar fraction one half" at 0xBD
|-

| U+0154 || Ŕ || 0x89 || || style="background:#ebbb54;" | 0xC0 || || || || latin capital letter r with acute ||
|-

| U+0155 || ŕ || 0x99 || || style="background:#ebbb54;" | 0xE0 || || || || latin small letter r with acute ||
|-

| U+0158 || Ř || 0xD7 || style="background:#9ab4e3" | × || style="background:#ebbb54;" | 0xD8 || style="background:#9ab4e3" | × || style="background:#9ab4e3" | × || || latin capital letter r with caron || Substitute char "multiple sign" at 0xD7
|-

| U+0159 || ř || 0xF7 || style="background:#9ab4e3" | ÷ || style="background:#ebbb54;" | 0xF8 || style="background:#9ab4e3" | ÷ || style="background:#9ab4e3" | ÷ || || latin small letter r with caron || Substitute char "divide sign" at 0xF7
|-

| U+015A || Ś || 0x81 || || style="background:#ebbb54;" | 0xA6 || || || style="background:#ebbb54;" | 0xD7 || latin capital letter s with acute ||
|-

| U+015B || ś || 0x91 || || style="background:#ebbb54;" | 0xB6 || || || style="background:#ebbb54;" | 0xF7 || latin small letter s with acute ||
|- style="background:#dbab8a;"

| U+015C || Ŝ || 0x85 || || || || || || latin capital letter s with circumflex || Only in ISO-8859-3 (for Esperanto) at 0xDE
|- style="background:#dbab8a;"

| U+015D || ŝ || 0x95 || || || || || || latin small letter s with circumflex || Only in ISO-8859-3 (for Esperanto) at 0xFE
|-

| U+015E || Ş || 0x8D || || style="background:#ebbb54;" | 0xAA || style="background:#ebbb54;" | 0xDE || || || latin capital letter s with cedilla || Can stand in for "...comma under"
|-

| U+015F || ş || 0x9D || || style="background:#ebbb54;" | 0xBA || style="background:#ebbb54;" | 0xFE || || || latin small letter s with cedilla || Can stand in for "...comma under"
|-

| U+0160 || Š || 0xA6 || style="background:#9ab4e3" | ¦ || style="background:#ebbb54;" | 0xA9 || style="background:#9ab4e3" | ¦ || 0xA6 || 0xA6 || latin capital letter s with caron || Substitute char "broken bar" at 0xA6
|-

| U+0161 || š || 0xA8 || style="background:#9ab4e3" | ¨ || style="background:#ebbb54;" | 0xB9 || style="background:#9ab4e3" | ¨ || 0xA8 || 0xA8 || latin small letter s with caron || Substitute char "diaeresis" at 0xA8
|-

| U+0162 || Ţ || 0x8E || || style="background:#ebbb54;" | 0xDE || || || || latin capital letter t with cedilla || Can stand in for "...comma under"
|-

| U+0163 || ţ || 0x9E || || style="background:#ebbb54;" | 0xFE || || || || latin small letter t with cedilla || Can stand in for "...comma under"
|-

| U+0164 || Ť || 0xB2 || style="background:#9ab4e3" | ² || style="background:#ebbb54;" | 0xAB || style="background:#9ab4e3" | ² || style="background:#9ab4e3" | ² || || latin capital letter t with caron || Substitute char "superscript two" at 0xB2
|-

| U+0165 || ť || 0xB6 || style="background:#9ab4e3" | ¶ || style="background:#ebbb54;" | 0xBB || style="background:#9ab4e3" | ¶ || style="background:#9ab4e3" | ¶ || || latin small letter t with caron || Substitute char "pilcrow sign" at 0xB6
|-

| U+016E || Ů || 0xA9 || style="background:#9ab4e3" | © || style="background:#ebbb54;" | 0xD9 || style="background:#9ab4e3" | © || style="background:#9ab4e3" | © || || latin capital letter u with ring above || Substitute char "copyright sign" at 0xA9
|-

| U+016F || ů || 0xAF || style="background:#9ab4e3" | ¯ || style="background:#ebbb54;" | 0xF9 || style="background:#9ab4e3" | ¯ || style="background:#9ab4e3" | ¯ || || latin small letter u with ring above || Substitute char "macron" at 0xAF
|-

| U+0170 || Ű || 0xA2 || style="background:#9ab4e3" | ¢ || style="background:#ebbb54;" | 0xDB || style="background:#9ab4e3" | ¢ || style="background:#9ab4e3" | ¢ || style="background:#ebbb54;" | 0xD8 || latin capital letter u with double acute || Similiar to Ü, used in Hungarian. Substitute char "cent sign" at 0xA2
|-

| U+0171 || ű || 0xA4 || style="background:#9ab4e3" | ¤ || style="background:#ebbb54;" | 0xFB || style="background:#9ab4e3" | ¤ || style="background:#9ab4e3" | ¤ || style="background:#ebbb54;" | 0xF8 || latin small letter u with double acute || Similiar to Ü, used in Hungarian. Substitute char "currency sign" at 0xA4
|-

| U+0178 || Ÿ || 0xBE || style="background:#9ab4e3" | ¾ || || style="background:#9ab4e3" | ¾ || 0xBE || 0xBE || latin capital letter y with diaeresis || Substitute char "vulgar fraction three quarters" at 0xBE
|-

| U+0179 || Ź || 0x84 || || style="background:#ebbb54;" | 0xAC || || || style="background:#ebbb54;" | | 0xAC || latin capital letter z with acute ||
|-

| U+017A || ź || 0x94 || || style="background:#ebbb54;" | 0xBC || || || style="background:#ebbb54;" | 0xAE || latin small letter z with acute ||
|-

| U+017B || Ż || 0x83 || || style="background:#ebbb54;" | 0xAF || || || style="background:#ebbb54;" | 0xAF || latin capital letter z with dot above ||
|-

| U+017C || ż || 0x93 || || style="background:#ebbb54;" | 0xBF || || || style="background:#ebbb54;" | 0xBF || latin small letter z with dot above ||
|-

| U+017D || Ž || 0xB4 || style="background:#9ab4e3" | ´ || style="background:#ebbb54;" | 0xAE || style="background:#9ab4e3" | ´ || 0xB4 || 0xB4 || latin capital letter z with caron || Substitute char "accute accent" at 0xB4
|-

| U+017E || ž || 0xB8 || style="background:#9ab4e3" | ¸ || style="background:#ebbb54;" | 0xBE || style="background:#9ab4e3" | ¸ || 0xB8 || 0xB8 || latin small letter z with caron || Substitute char "cedilla" at 0xB8
|- style="background:#dbab8a;"

| U+01D3 || Ǔ || 0x8A || || || || || || latin capital u with caron || Not found in ISO-8859. Pinyin tone marking
|- style="background:#dbab8a;"

| U+01D4 || ǔ || 0x9A || || || || || || latin small u with caron || Not found in ISO-8859. Pinyin tone marking
|-

| U+0218 || Ș || 0x8D || || || || || style="background:#ebbb54;" | 0xAA || latin capital letter s with comma below || See also "...with cedilla"
|-

| U+0219 || ș || 0x9D || || || || || style="background:#ebbb54;" | 0xBA || latin small letter s with comma below || See also "...with cedilla"
|-

| U+021A || Ț || 0x8E || || || || || style="background:#ebbb54;" | 0xDE || latin capital letter t with comma below || See also "...with cedilla"
|-

| U+021B || ț || 0x9E || || || || || style="background:#ebbb54;" | 0xFE || latin small letter t with comma below || See also "...with cedilla"
|- style="color:#8c8c8c;"

| U+02C7 || ˇ || || || || 0xB7 || || || caron ||
|- style="color:#8c8c8c;"

| U+02D8 || ˘ || || || || 0xA2 || || || breve ||
|- style="color:#8c8c8c;"

| U+02D9 || ˙ || || || || 0xFF || || || dot above ||
|- style="color:#8c8c8c;"

| U+02DB || ˛ || || || || 0xB2 || || || ogonek ||
|- style="color:#8c8c8c;"

| U+02DD || ˝ || || || || 0xBD || || || double acute accent ||
|- style="background:#dbab8a;"

| U+1E90 || Ẑ || 0x87 || || || || || || latin capital z with circumflex || Not found in ISO-8859. Rare use in Cyrillic-to-Latin transliteration, or Pinyin
|- style="background:#dbab8a;"

| U+1E91 || ẑ || 0x97 || || || || || || latin small z with circumflex || Not found in ISO-8859. Rare use in Cyrillic-to-Latin transliteration, or Pinyin
|- style="color:#8c8c8c;"

| U+201D || ” || || || || || || 0xB5 || right double quotation mark ||
|- style="color:#8c8c8c;"

| U+201E || „ || || || || || || 0xA5 || double low-9 quotation mark ||
|- style="color:#8c8c8c;"

| U+20AC || € || || || || || 0xA4 || 0xA4 || euro sign ||
|}

== For More ==
* [[I18N - Character mapping]] sketches the format and location of <language>.map files.
* [[I18N - Charset]] is the main article about TDM language use and various encodings.

Multilanguage Display

2026-06-19T17:35:13Z

Geep: /* Background */

== Background ==
''This describes a particular challenging use case of a TDM methodology that has been around for some time. The motivation to detail this was a 2026 update by Geep to the language map files, following a revision of Carleton 24pt font used throughout the Main Menu.''

In TDM's main menu, the Settings/Video/Language page attempts to list all the supported languages in their native form with respect to character set, that is, untranslated. Showing multiple language strings together is difficult, but some tricks are available. The result has been a reasonable near-term workaround for this particular page, applicable to comparable cases. (Comprehensive support for multilanguage display likely involves a major restructuring, for instance, moving to a native Unicode architecture with combined Latin and Cyrillic bitmaps.)

Recall that strings for the main menu are found in the utf8 file tdm_base01.pk4/strings/all.lang, where there are sections for [English], [German], etc. A particular section is used to generate for distribution the corresponding file, e.g., french.lang, german.lang, etc., in a language-specific 8-bit encoding. When you play TDM, and select a given language, the corresponding .lang file (if provided) is read.

Except for Cyrillic Russian, these files use encodings within the ISO-8859 family (as detailed in [[I18N_-_Charset]]). Any specific encoding is a bottleneck... by design, not all characters in any one member of the ISO-8859 family will be accessible by some other members.

== Language Names in Idealized UTF8 Form ==
Only the TDM-exposed languages are shown here. The all.lang file has additional strings for other potential Latin and Cyrillic languages. For reference, the generated encoding for the <language>.lang file is shown in the comment.

"#str_02460" "English" // English [ISO-8859-1]
"#str_02461" "Deutsch" // German [ISO-8859-1]
"#str_02462" "Español" // Spanish [ISO-8859-1]
"#str_02463" "Français" // French [ISO-8859-15]
"#str_02464" "Português" // Portuguese [ISO-8859-1]
"#str_02465" "Polski" // Polish [ISO-8859-2]
"#str_02466" "Italiano" // Italian [ISO-8859-1]
"#str_02467" "Česky" // Czech [ISO-8859-2]
"#str_02468" "Русский" // Russian [WIN-1251]
"#str_02469" "Català" // Catalan [ISO-8859-1]
"#str_02470" "Dansk" // Danish [ISO-8859-1]
"#str_02472" "Nederlands" // Dutch [ISO-8859-1]
"#str_02474" "Magyar" // Hungarian [ISO-8859-2]
"#str_02476" "Svenska" // Swedish [ISO-8859-1]
"#str_02477" "Türkçe" // Turkish [ISO-8859-9]
"#str_02479" "Română" // Romanian [ISO-8859-16]
"#str_02480" "Slovenčina" // Slovak [ISO-8859-2]

== First Compromise – Cyrillic vs. Latin Font ==
While there is some overlap in characters between Cyrillic and Latin encodings, it is insufficient for our purposes. So, for [English] and other European sections, a Latin transliteration from Cyrillic is used:

"#str_02468" "Russkiy" // Russian

Going the other way, for [Russian], the current treatment is not to do a Cyrillic transliteration from Latin, but instead to drop accents, rendering just in ASCII (except of course “Russian”), e.g.:

"#str_02460" "English" // English
"#str_02461" "Deutsch" // German
"#str_02462" "Espanol" // Spanish
"#str_02463" "Francais" // French
"#str_02464" "Portugues" // Portuguese
"#str_02465" "Polski" // Polish
"#str_02466" "Italiano" // Italian
"#str_02467" "Cesky" // Czech
"#str_02468" "Русский" // Russian
"#str_02469" "Catala" // Catalan
"#str_02470" "Dansk" // Danish
"#str_02472" "Nederlands" // Dutch
"#str_02474" "Magyar" // Hungarian
"#str_02476" "Svenska" // Swedish
"#str_02477" "Turkce" // Turkish
"#str_02479" "Romana" // Romanian
"#str_02480" "Slovencina" // Slovak

== Moving between ISO-8859 Members ==
In the discussion here, let “L1” be the current language (from the player’s perspective) or the [language] section of interest in all.lang (from the translator’s perspective). Let “L2” be the language of the foreign word, i.e., L1 and L2 differ.

=== Type and Go ===
In several cases, the translator merely puts the ideal character in the all.lang strings. After <language>.lang generation, everything works. Cases are:

# L1 and L2 are both use the same ISO-8859 encoding. (Specifically, they are either both ISO-8859-1, which doesn’t need <language>.map files, or both ISO-8859-2, and have <language>.map files with, by convention, identical contents.) NOTE: For TDM’s purposes, ISO-8859-15 (French) can be considered part of the ISO-8859-1 family.
# L2 character is ASCII (i.e., in ISO range 0x00-0x7f). This is always the case if L2 = English. Characters in this range have identical codepoints in all five TDM-supported ISO-8859 and in the TDM target encoding.
# L2 character is in the ISO range 0xA0-0xFF, with additional constraints.

For the last case, the L2 character must be either:
* present at the same codepoint in all five TDM-supported ISO-8859 encodings, and in the TDM target encoding. For our Latin language names, these accented characters are like that:
ç in "Français" and "Türkçe" at 0xE7
à in "Català" at 0xEA
â in "Română" at 0xE2
ü in "Türkçe" at 0xFC
* present at the same codepoint in ISO-8859 encodings for L1 and L2, and in the TDM target encoding.
* present in different codepoints in ISO-8859 encodings for L1 and L2, but with each being either the same as the TDM target encoding, or mapped to the TDM target encoding by the <language>.map file.

=== Tricks ===
If the L2 character is not represented in the ISO encoding for L1, then at <L1>.lang generation time, it will be replaced by a “?”. To work around this, the translator has two methods:

====Trick Method 1 – Direct Stuffing====
When L1 encoding is ISO-8859-1 (or -9 or -15, which all have identical encodings for the 0xA0-BF ranges) and L2 character is in TDM’s 0xA0-0xBF range (or D7, F7), then you can lookup the ISO character associated with that codepoint (shown in parentheses in cells of the i18n- charmap table), and type it. Examples:

[English] // and other ISO-8859-1, -9, or -15
"#str_02467" "¬esky" // our default mapping is ISO 8859-1, so ¬ is shown as Č (¬)
"#str_02480" "Sloven®ina" // Slovak (® in ISO-8859-1 is č in our font)

Here’s another example of that last stuffing from a TDM-unexposed language, showing also a diaresis (0xA8):

"#str_02481" "Sloven¨®ina" // Slovenian (southern slovenia) (¨ => š)

In this case, ISO-8859-1 would need to use the diaresis, but ISO-8859-15 (French) would not, i.e., could type and go with š.
The spreadsheet shows all available substitutions in light blue.

====Trick Method 2 – Special Mapping with Repurposed Character====
If all else fails, a little-used character in L1 can be redirected to the L2 codepoint TDM wants, by an extra mapping command in the <L1>.map file. Current such tricks are...

To get ñ for "Español":

* for iso 2, put ¨ (diaeresis 0xA8)
* for iso 16, put ¶ (pilcrow 0xB6)

To get ê for "Português":

*for iso 2: Put ´ (acute accent 0xBD)

== TDM & ISO Char Sets - Details, Potential Tricks, Limitations ==

The main table below (after the Key) was drafted by Google AI, from a prompt that defined the header and an example row, and specified:

"Rows are a combination of all the printable 8-bit codepoints in the range 0x80-0xff defined in ISO-8859-1, -2, -9, -15, and -16. The rows are ordered by Unicode number. If a particular ISO standard does not include the character, leave that cell blank."

Subsequently, after Excel import, the TDM and Comments columns were filled in by Geep, and color coding added. Language mappings were independently color coded, then verified against existing language maps. Finally converted to wikitable format.

This table skips codepoints in the range 0x00-0x7f, because they are the same for all ISO-8859 standards. No mapping required.

{| class="wikitable" style="font-size: 95%; line-height: 1.3em;"
|+ Color Key
! Cell !! Meaning
|-

| style="color:#8c8c8c;" | Light Gray Text Row || Symbol not included in TDM custom character set (so TDM column blank). Can use for char substitution tricks.
|-

| 0xNN on white || Type desired utf8 char (in Symbol column) in all.lang. Generation goes directly to TDM codepoint given.
|-

| style="background:#ebbb54;" | 0xNN, amber hilite || Type desired utf8 char in all.lang. Generation + mapping (in <language>.map file) goes to TDM codepoint via codepoint shown.
|-

| style="background:#ebbb54;color:#606060;" | 0xNN in gray || Type desired utf8 char in all.lang. Generation + mapping (in <language>.map file) goes to TDM codepoint OF SUBSTITUTE CHARACTER via codepoint shown.
|-

| style="background:#ebbb54;color:#ff0000;" | 0xNN in red || Character not part of this ISO. "0xnn" shown is not ISO, but for trick mapping (in <language.map), to support main menu's multilingual "Languages" page.
|-

| style="background:#9ab4e3;" | Substitute Char || Character not part of this ISO. But as trick, you can stuff in this substitute char at the needed TDM codepoint.
|-

| style="background:#43a8cc;" | n/a || Not available to use substitute character, due to trick mapping (in <language>.map) elsewhere.
|-

| Empty Cell || In ISO column, means character not part of this ISO (so may be candidate for future trick mapping; or simply not fully analyzed viz substitute char.)
|-

| style="background:#dbab8a;" | Tan Row || Orphaned character in TDM set, not part of 5 ISO-8859 standards for current TDM-supported languages.
|-
|}

{| class="wikitable" style="font-size: 95%; line-height: 1.3em;"
|+ Unicode Coverage for TDM
! Unicode !! Symbol !! TDM !! 1 !! 2 !! 9 !! 15 !! 16 !! Unicode Name !! Comments
|-

| U+00A0 ||   || 0xA0 || 0xA0 || 0xA0 || 0xA0 || 0xA0 || 0xA0 || no-break space ||
|- style="color:#8c8c8c;"

| U+00A1 || ¡ || || 0xA1 || || 0xA1 || 0xA1 || || inverted exclamation mark ||
|- style="color:#8c8c8c;"

| U+00A2 || ¢ || || 0xA2 || || 0xA2 || 0xA2 || || cent sign ||
|- style="color:#8c8c8c;"

| U+00A3 || £ || || 0xA3 || || 0xA3 || 0xA3 || || pound sign ||
|- style="color:#8c8c8c;"

| U+00A4 || ¤ || || 0xA4 || 0xA4 || 0xA4 || || || currency sign ||
|- style="color:#8c8c8c;"

| U+00A5 || ¥ || || 0xA5 || || 0xA5 || 0xA5 || || yen sign ||
|- style="color:#8c8c8c;"

| U+00A6 || ¦ || || 0xA6 || || 0xA6 || || || broken bar ||
|-

| U+00A7 || § || 0xA7 || 0xA7 || 0xA7 || 0xA7 || 0xA7 || 0xA7 || section sign ||
|- style="color:#8c8c8c;"

| U+00A8 || ¨ || || 0xA8 || 0xA8 || 0xA8 || || || diaeresis || See also hack use for ñ
|- style="color:#8c8c8c;"

| U+00A9 || © || || 0xA9 || || 0xA9 || 0xA9 || 0xA9 || copyright sign ||
|- style="color:#8c8c8c;"

| U+00AA || ª || || 0xAA || || 0xAA || 0xAA || || feminine ordinal indicator ||
|- style="color:#8c8c8c;"

| U+00AB || « || || 0xAB || || 0xAB || 0xAB || 0xAB || left-pointing double angle quotation mark ||
|- style="color:#8c8c8c;"

| U+00AC || ¬ || || 0xAC || || 0xAC || 0xAC || || not sign ||
|-

| U+00AD || || 0xAD || 0xAD || 0xAD || 0xAD || 0xAD || 0xAD || soft hyphen ||
|- style="color:#8c8c8c;"

| U+00AE || ® || || 0xAE || || 0xAE || 0xAE || || registered sign ||
|- style="color:#8c8c8c;"

| U+00AF || ¯ || || 0xAF || || 0xAF || 0xAF || || macron ||
|- style="color:#8c8c8c;"

| U+00B0 || ° || || 0xB0 || 0xB0 || 0xB0 || 0xB0 || 0xB0 || degree sign ||
|- style="color:#8c8c8c;"

| U+00B1 || ± || || 0xB1 || || 0xB1 || 0xB1 || 0xB1 || plus-minus sign ||
|- style="color:#8c8c8c;"

| U+00B2 || ² || || 0xB2 || || 0xB2 || 0xB2 || || superscript two ||
|- style="color:#8c8c8c;"

| U+00B3 || ³ || || 0xB3 || || 0xB3 || 0xB3 || || superscript three ||
|- style="color:#8c8c8c;"

| U+00B4 || ´ || || 0xB4 || 0xB4 || 0xB4 || || || acute accent ||
|- style="color:#8c8c8c;"

| U+00B5 || µ || || 0xB5 || || 0xB5 || 0xB5 || || micro sign ||
|- style="color:#8c8c8c;"

| U+00B6 || ¶ || || 0xB6 || || 0xB6 || 0xB6 || 0xB6 || pilcrow sign ||
|- style="color:#8c8c8c;"

| U+00B7 || · || || 0xB7 || || 0xB7 || 0xB7 || 0xB7 || middle dot ||
|- style="color:#8c8c8c;"

| U+00B8 || ¸ || || 0xB8 || 0xB8 || 0xB8 || || || cedilla ||
|- style="color:#8c8c8c;"

| U+00B9 || ¹ || || 0xB9 || || 0xB9 || 0xB9 || || superscript one ||
|- style="color:#8c8c8c;"

| U+00BA || º || || 0xBA || || 0xBA || 0xBA || || masculine ordinal indicator ||
|- style="color:#8c8c8c;"

| U+00BB || » || || 0xBB || || 0xBB || 0xBB || 0xBB || right-pointing double angle quotation mark ||
|- style="color:#8c8c8c;"

| U+00BC || ¼ || || 0xBC || || 0xBC || || || vulgar fraction one quarter ||
|- style="color:#8c8c8c;"

| U+00BD || ½ || || 0xBD || || 0xBD || || || vulgar fraction one half ||
|- style="color:#8c8c8c;"

| U+00BE || ¾ || || 0xBE || || 0xBE || || || vulgar fraction three quarters ||
|-

| U+00BF || ¿ || 0xBF || 0xBF || || 0xBF || 0xBF || || inverted question mark ||
|-

| U+00C0 || À || 0xC0 || 0xC0 || || 0xC0 || 0xC0 || 0xC0 || latin capital letter a with grave ||
|-

| U+00C1 || Á || 0xC1 || 0xC1 || 0xC1 || 0xC1 || 0xC1 || 0xC1 || latin capital letter a with acute ||
|-

| U+00C2 || Â || 0xC2 || 0xC2 || 0xC2 || 0xC2 || 0xC2 || 0xC2 || latin capital letter a with circumflex ||
|-

| U+00C3 || Ã || 0xC3 || 0xC3 || || 0xC3 || 0xC3 || || latin capital letter a with tilde ||
|-

| U+00C4 || Ä || 0xC4 || 0xC4 || 0xC4 || 0xC4 || 0xC4 || 0xC4 || latin capital letter a with diaeresis ||
|-

| U+00C5 || Å || 0xC5 || 0xC5 || || 0xC5 || 0xC5 || || latin capital letter a with ring above ||
|-

| U+00C6 || Æ || 0xC6 || 0xC6 || || 0xC6 || 0xC6 || 0xC6 || latin capital letter ae ||
|-

| U+00C7 || Ç || 0xC7 || 0xC7 || 0xC7 || 0xC7 || 0xC7 || 0xC7 || latin capital letter c with cedilla ||
|-

| U+00C8 || È || 0xC8 || 0xC8 || || 0xC8 || 0xC8 || 0xC8 || latin capital letter e with grave ||
|-

| U+00C9 || É || 0xC9 || 0xC9 || 0xC9 || 0xC9 || 0xC9 || 0xC9 || latin capital letter e with acute ||
|-

| U+00CA || Ê || 0xCA || 0xCA || || 0xCA || 0xCA || 0xCA || latin capital letter e with circumflex ||
|-

| U+00CB || Ë || 0xCB || 0xCB || 0xCB || 0xCB || 0xCB || 0xCB || latin capital letter e with diaeresis ||
|-

| U+00CC || Ì || 0xCC || 0xCC || || 0xCC || 0xCC || 0xCC || latin capital letter i with grave ||
|-

| U+00CD || Í || 0xCD || 0xCD || 0xCD || 0xCD || 0xCD || 0xCD || latin capital letter i with acute ||
|-

| U+00CE || Î || 0xCE || 0xCE || 0xCE || 0xCE || 0xCE || 0xCE || latin capital letter i with circumflex ||
|-

| U+00CF || Ï || 0xCF || 0xCF || || 0xCF || 0xCF || 0xCF || latin capital letter i with diaeresis ||
|-

| U+00D0 || Ð || 0xD0 || 0xD0 || || style="background:#43a8cc;" | n/a || 0xD0 || || latin capital letter eth || Same glyph as U+0110 latin capital letter d with stroke
|-

| U+00D1 || Ñ || 0xD1 || 0xD1 || || 0xD1 || 0xD1 || || latin capital letter n with tilde ||
|-

| U+00D2 || Ò || 0xD2 || 0xD2 || || 0xD2 || 0xD2 || 0xD2 || latin capital letter o with grave ||
|-

| U+00D3 || Ó || 0xD3 || 0xD3 || 0xC1 || 0xD3 || 0xD3 || 0xD3 || latin capital letter o with acute ||
|-

| U+00D4 || Ô || 0xD4 || 0xD4 || 0xD4 || 0xD4 || 0xD4 || 0xD4 || latin capital letter o with circumflex || Formerly also mapped from 0x88; redundant, Ğ has 0x88 codepoint now
|-

| U+00D5 || Õ || 0xD5 || 0xD5 || || 0xD5 || 0xD5 || || latin capital letter o with tilde ||
|-

| U+00D6 || Ö || 0xD6 || 0xD6 || 0xD6 || 0xD6 || 0xD6 || 0xD6 || latin capital letter o with diaeresis ||
|- style="color:#8c8c8c;"

| U+00D7 || × || || 0xD7 || 0xD7 || 0xD7 || 0xD7 || || multiplication sign ||
|-

| U+00D8 || Ø || 0xD8 || 0xD8 || || 0xD8 || 0xD8 || || latin capital letter o with stroke ||
|-

| U+00D9 || Ù || 0xD9 || 0xD9 || || 0xD9 || 0xD9 || 0xD9 || latin capital letter u with grave ||
|-

| U+00DA || Ú || 0xDA || 0xDA || 0xDA || 0xDA || 0xDA || 0xDA || latin capital letter u with acute ||
|-

| U+00DB || Û || 0xDB || 0xDB || || 0xDB || 0xDB || 0xDB || latin capital letter u with circumflex ||
|-

| U+00DC || Ü || 0xDC || 0xDC || 0xDC || 0xDC || 0xDC || 0xDC || latin capital letter u with diaeresis ||
|-

| U+00DD || Ý || 0xDD || 0xDD || 0xDD || || 0xDD || || latin capital letter y with acute ||
|-

| U+00DE || Þ || 0xDE || 0xDE || || || 0xDE || || latin capital letter thorn ||
|-

| U+00DF || ß || 0xDF || 0xDF || 0xDF || 0xDF || 0xDF || 0xDF || latin small letter sharp s ||
|-

| U+00E0 || à || 0xE0 || 0xE0 || || 0xE0 || 0xE0 || 0xE0 || latin small letter a with grave ||
|-

| U+00E1 || á || 0xE1 || 0xE1 || 0xE1 || 0xE1 || 0xE1 || 0xE1 || latin small letter a with acute ||
|-

| U+00E2 || â || 0xE2 || 0xE2 || 0xE2 || 0xE2 || 0xE2 || 0xE2 || latin small letter a with circumflex ||
|-

| U+00E3 || ã || 0xE3 || 0xE3 || || 0xE3 || 0xE3 || || latin small letter a with tilde ||
|-

| U+00E4 || ä || 0xE4 || 0xE4 || 0xE4 || 0xE4 || 0xE4 || 0xE4 || latin small letter a with diaeresis ||
|-

| U+00E5 || å || 0xE5 || 0xE5 || || 0xE5 || 0xE5 || || latin small letter a with ring above ||
|-

| U+00E6 || æ || 0xE6 || 0xE6 || || 0xE6 || 0xE6 || 0xE6 || latin small letter ae ||
|-

| U+00E7 || ç || 0xE7 || 0xE7 || 0xE7 || 0xE7 || 0xE7 || 0xE7 || latin small letter c with cedilla ||
|-

| U+00E8 || è || 0xE8 || 0xE8 || || 0xE8 || 0xE8 || 0xE8 || latin small letter e with grave ||
|-

| U+00E9 || é || 0xE9 || 0xE9 || 0xE9 || 0xE9 || 0xE9 || 0xE9 || latin small letter e with acute ||
|-

| U+00EA || ê || 0xEA || 0xEA || style="background:#ebbb54;color:#ff0000;" | 0xBD || 0xEA || 0xEA || 0xEA || latin small letter e with circumflex || Hack for iso 2: Put ´ (acute accent, 0xBD) to get ê for "Português"
|-

| U+00EB || ë || 0xEB || 0xEB || 0xEB || 0xEB || 0xEB || 0xEB || latin small letter e with diaeresis ||
|-

| U+00EC || ì || 0xEC || 0xEC || || 0xEC || 0xEC || 0xEC || latin small letter i with grave ||
|-

| U+00ED || í || 0xED || 0xED || 0xED || 0xED || 0xED || 0xED || latin small letter i with acute ||
|-

| U+00EE || î || 0xEE || 0xEE || 0xEE || 0xEE || 0xEE || 0xEE || latin small letter i with circumflex ||
|-

| U+00EF || ï || 0xEF || 0xEF || || 0xEF || 0xEF || 0xEF || latin small letter i with diaeresis ||
|-

| U+00F0 || ð || 0xF0 || 0xF0 || || || 0xF0 || || latin small letter eth ||
|-

| U+00F1 || ñ || 0xF1 || 0xF1 || style="background:#ebbb54;color:#ff0000;" | 0xA8 || 0xF1 || 0xF1 || style="background:#ebbb54;color:#ff0000;" | 0xB6 || latin small letter n with tilde || Hacks to get ñ for "Español": for iso 2, put ¨ (diaeresis 0xA8); for iso 16, put ¶ (0xB6)
|-

| U+00F2 || ò || 0xF2 || 0xF2 || || 0xF2 || 0xF2 || 0xF2 || latin small letter o with grave ||
|-

| U+00F3 || ó || 0xF3 || 0xF3 || 0xF3 || 0xF3 || 0xF3 || 0xF3 || latin small letter o with acute ||
|-

| U+00F4 || ô || 0xF4 || 0xF4 || 0xF4 || 0xF4 || 0xF4 || 0xF4 || latin small letter o with circumflex || Formerly also mapped from 0x88; redundant, ğ has TDM 0x88 codepoint now
|-

| U+00F5 || õ || 0xF5 || 0xF5 || || 0xF5 || 0xF5 || || latin small letter o with tilde ||
|-

| U+00F6 || ö || 0xF6 || 0xF6 || 0xF6 || 0xF6 || 0xF6 || 0xF6 || latin small letter o with diaeresis ||
|- style="color:#8c8c8c;"

| U+00F7 || ÷ || || 0xF7 || 0xF7 || 0xF7 || 0xF7 || || division sign ||
|-

| U+00F8 || ø || 0xF8 || 0xF8 || || 0xF8 || 0xF8 || || latin small letter o with stroke ||
|-

| U+00F9 || ù || 0xF9 || 0xF9 || || 0xF9 || 0xF9 || 0xF9 || latin small letter u with grave ||
|-

| U+00FA || ú || 0xFA || 0xFA || 0xFA || 0xFA || 0xFA || 0xFA || latin small letter u with acute ||
|-

| U+00FB || û || 0xFB || 0xFB || || 0xFB || 0xFB || 0xFB || latin small letter u with circumflex ||
|-

| U+00FC || ü || 0xFC || 0xFC || 0xFC || 0xFC || 0xFC || 0xFC || latin small letter u with diaeresis ||
|-

| U+00FD || ý || 0xFD || 0xFD || 0xFD || || 0xFD || || latin small letter y with acute ||
|-

| U+00FE || þ || 0xFE || 0xFE || || || 0xFE || || latin small letter thorn ||
|-

| U+00FF || ÿ || 0xFF || 0xFF || || 0xFF || 0xFF || 0xFF || latin small letter y with diaeresis ||
|-

| U+0102 || Ă || 0x8B || || style="background:#ebbb54;" | 0xC3 || || || style="background:#ebbb54;" | 0xC3 || latin capital letter a with breve ||
|-

| U+0103 || ă || 0x9B || || style="background:#ebbb54;" | 0xE3 || || || style="background:#ebbb54;" | 0xE3 || latin small letter a with breve ||
|-

| U+0104 || Ą || 0xAA || style="background:#9ab4e3" | ª || style="background:#ebbb54;" | 0xA1 || style="background:#9ab4e3" | ª || style="background:#9ab4e3" | ª || style="background:#ebbb54;" | 0xA1 || latin capital letter a with ogonek ||
|-

| U+0105 || ą || 0xBA || style="background:#9ab4e3" | º || style="background:#ebbb54;" | 0xB1 || style="background:#9ab4e3" | º || style="background:#9ab4e3" | º || style="background:#ebbb54;" | 0xA2 || latin small letter a with ogonek ||
|-

| U+0106 || Ć || 0x82 || || style="background:#ebbb54;" | 0xC6 || || || style="background:#ebbb54;" | 0xC5 || latin capital letter c with acute ||
|-

| U+0107 || ć || 0x92 || || style="background:#ebbb54;" | 0xE6 || || || style="background:#ebbb54;" | 0xE5 || latin small letter c with acute ||
|- style="background:#dbab8a;"

| U+0108 || Ĉ || 0x86 || || || || || || latin capital c with circumflex || Only in ISO-8859-3 (for Esperanto) at 0xC6
|- style="background:#dbab8a;"

| U+0109 || ĉ || 0x96 || || || || || || latin small c with circumflex || Only in ISO-8859-3 (for Esperanto) at 0xE6
|-

| U+010C || Č || 0xAC || style="background:#9ab4e3" | ¬ || style="background:#ebbb54;" | 0xC8 || style="background:#9ab4e3" | ¬ || style="background:#9ab4e3" | ¬ || style="background:#ebbb54;" | 0xB2 || latin capital letter c with caron || Substitute char "not sign" at 0xAC
|-

| U+010D || č || 0xAE || style="background:#9ab4e3" | ® || style="background:#ebbb54;" | 0xE8 || style="background:#9ab4e3" | ® || style="background:#9ab4e3" | ® || style="background:#ebbb54;" | 0xB9 || latin small letter c with caron || Substitute char "registration sign" at 0xAE
|-

| U+010E || Ď || 0xB3 || style="background:#9ab4e3" | ³ || style="background:#ebbb54;" | 0xCF || style="background:#9ab4e3" | ³ || style="background:#9ab4e3" | ³ || || latin capital letter d with caron || Substitute char "superscript three" at 0xB3
|-

| U+010F || ď || 0xB7 || style="background:#9ab4e3; font-weight:bold" | · || style="background:#ebbb54;" | 0xEF || style="background:#9ab4e3; font-weight:bold" | · || style="background:#9ab4e3; font-weight:bold" | · || || latin small letter d with caron || Substitute char "middle dot" at 0xB7
|-

| U+0110 || Đ || 0xD0 || 0xD0 || 0xD0 || style="background:#43a8cc;" | n/a || || 0xD0 || latin capital letter d with stroke || Same glyph as U+00D0 latin capital letter eth
|-

| U+0111 || đ || 0x90 || || style="background:#ebbb54;" | 0xF0 || style="background:#43a8cc;" | n/a || || style="background:#ebbb54;" | 0xF0 || latin small letter d with stroke ||
|-

| U+0118 || Ę || 0xAB || style="background:#9ab4e3" | « || style="background:#ebbb54;" | 0xCA || style="background:#9ab4e3" | « || style="background:#9ab4e3" | « || style="background:#ebbb54;" | 0xDD || latin capital letter e with ogonek || Substitute char "left-pointing double angle quotation mark" at 0xAB
|-

| U+0119 || ę || 0xBB || style="background:#9ab4e3" | » || style="background:#ebbb54;" | 0xEA || style="background:#9ab4e3" | » || style="background:#9ab4e3" | » || style="background:#ebbb54;" | 0xFD || latin small letter e with ogonek || Substitute char "right-pointing double angle quotation mark" at 0xBB
|-

| U+011A || Ě || 0xA5 || style="background:#9ab4e3" | ¥ || style="background:#ebbb54;" | 0xCC || style="background:#9ab4e3" | ¥ || style="background:#9ab4e3" | ¥ || || latin capital letter e with caron || Substitute char "yen sign" at 0xA5
|-

| U+011B || ě || 0xA3 || style="background:#9ab4e3" | £ || style="background:#ebbb54;" | 0xEC || style="background:#9ab4e3" | £ || style="background:#9ab4e3" | £ || || latin small letter e with caron || Substitute char "pound sign" at 0xA3
|-

| U+011E || Ğ || 0x88 || || || style="background:#ebbb54;" | 0xD0 || || || latin capital letter g with breve || As of TDM 2.13
|-

| U+011F || ğ || 0x98 || || || style="background:#ebbb54;" | 0xF0 || || || latin small letter g with breve || As of TDM 2.13
|- style="color:#8c8c8c;"

| U+0130 || İ || || || || style="background:#ebbb54;" | 0xDD || || || latin capital letter i with dot above || Turkish: utf8 "İ" will be mapped to "Î" (0xCE)
|- style="color:#8c8c8c;"

| U+0131 || ı || || || || style="background:#ebbb54;" | 0xFD || || || latin small letter dotless i || Turkish: utf8 "ı" will be mapped to ASCII "i" (0x69)
|- style="color:#8c8c8c;"

| U+0139 || Ĺ || || || 0xC5 || || || || latin capital letter l with acute ||
|- style="color:#8c8c8c;"

| U+013A || ĺ || || || 0xE5 || || || || latin small letter l with acute ||
|- style="color:#8c8c8c;"

| U+013D || Ľ || || || 0xA5 || || || || latin capital letter l with caron ||
|- style="color:#8c8c8c;"

| U+013E || ľ || || || 0xB5 || || || || latin small letter l with caron ||
|-

| U+0141 || Ł || 0xB1 || style="background:#9ab4e3" | ± || style="background:#ebbb54;" | 0xA3 || style="background:#9ab4e3" | ± || style="background:#9ab4e3" | ± || style="background:#ebbb54;" | 0xA3 || latin capital letter l with stroke || Substitute char "plus-minus sign" at 0xB1
|-

| U+0142 || ł || 0xB5 || style="background:#9ab4e3" | µ || style="background:#ebbb54;" | 0xB3 || style="background:#9ab4e3" | µ || style="background:#9ab4e3" | µ || style="background:#ebbb54;" | 0xB3 || latin small letter l with stroke || Substitute char "micro sign" at 0xB5
|-

| U+0143 || Ń || 0x8C || || style="background:#ebbb54;" | 0xD1 || || || style="background:#ebbb54;" | 0xD1 || latin capital letter n with acute ||
|-

| U+0144 || ń || 0x9C || || style="background:#ebbb54;" | 0xF1 || || || style="background:#ebbb54;" | 0xF1 || latin small letter n with acute ||
|-

| U+0147 || Ň || 0x80 || || style="background:#ebbb54;" | 0xD2 || || || || latin capital letter n with caron ||
|-

| U+0148 || ň || 0xA1 || style="background:#9ab4e3" | ¡ || style="background:#ebbb54;" | 0xF2 || style="background:#9ab4e3" | ¡ || style="background:#9ab4e3" | ¡ || || latin small letter n with caron || Substitute char "inverted exclamation mark" at 0xA1
|-

| U+0150 || Ő || 0xB0 || style="background:#9ab4e3" | ° || style="background:#ebbb54;" | 0xD5 || style="background:#9ab4e3" | ° || style="background:#9ab4e3" | ° || style="background:#ebbb54;" | 0xD5 || latin capital letter o with double acute || Similiar to Ö, used in Hungarian. Substitute char "degree sign" at 0xB0
|-

| U+0151 || ő || 0xB9 || style="background:#9ab4e3" | ¹ || style="background:#ebbb54;" | 0xF5 || style="background:#9ab4e3" | ¹ || style="background:#9ab4e3" | ¹ || style="background:#ebbb54;" | 0xF5 || latin small letter o with double acute || Similiar to ö, used in Hungarian. Substitute char "superscript 1" at 0xB9
|-

| U+0152 || Œ || 0xBC || style="background:#9ab4e3" | ¼ || || style="background:#9ab4e3" | ¼ || 0xBC || 0xBC || latin capital ligature oe || Substitute char "vulgar fraction one quarter" at 0xBC
|-

| U+0153 || œ || 0xBD || style="background:#9ab4e3" | ½ || || style="background:#9ab4e3" | ½ || 0xBD || 0xBD || latin small ligature oe || Substitute char "vulgar fraction one half" at 0xBD
|-

| U+0154 || Ŕ || 0x89 || || style="background:#ebbb54;" | 0xC0 || || || || latin capital letter r with acute ||
|-

| U+0155 || ŕ || 0x99 || || style="background:#ebbb54;" | 0xE0 || || || || latin small letter r with acute ||
|-

| U+0158 || Ř || 0xD7 || style="background:#9ab4e3" | × || style="background:#ebbb54;" | 0xD8 || style="background:#9ab4e3" | × || style="background:#9ab4e3" | × || || latin capital letter r with caron || Substitute char "multiple sign" at 0xD7
|-

| U+0159 || ř || 0xF7 || style="background:#9ab4e3" | ÷ || style="background:#ebbb54;" | 0xF8 || style="background:#9ab4e3" | ÷ || style="background:#9ab4e3" | ÷ || || latin small letter r with caron || Substitute char "divide sign" at 0xF7
|-

| U+015A || Ś || 0x81 || || style="background:#ebbb54;" | 0xA6 || || || style="background:#ebbb54;" | 0xD7 || latin capital letter s with acute ||
|-

| U+015B || ś || 0x91 || || style="background:#ebbb54;" | 0xB6 || || || style="background:#ebbb54;" | 0xF7 || latin small letter s with acute ||
|- style="background:#dbab8a;"

| U+015C || Ŝ || 0x85 || || || || || || latin capital letter s with circumflex || Only in ISO-8859-3 (for Esperanto) at 0xDE
|- style="background:#dbab8a;"

| U+015D || ŝ || 0x95 || || || || || || latin small letter s with circumflex || Only in ISO-8859-3 (for Esperanto) at 0xFE
|-

| U+015E || Ş || 0x8D || || style="background:#ebbb54;" | 0xAA || style="background:#ebbb54;" | 0xDE || || || latin capital letter s with cedilla || Can stand in for "...comma under"
|-

| U+015F || ş || 0x9D || || style="background:#ebbb54;" | 0xBA || style="background:#ebbb54;" | 0xFE || || || latin small letter s with cedilla || Can stand in for "...comma under"
|-

| U+0160 || Š || 0xA6 || style="background:#9ab4e3" | ¦ || style="background:#ebbb54;" | 0xA9 || style="background:#9ab4e3" | ¦ || 0xA6 || 0xA6 || latin capital letter s with caron || Substitute char "broken bar" at 0xA6
|-

| U+0161 || š || 0xA8 || style="background:#9ab4e3" | ¨ || style="background:#ebbb54;" | 0xB9 || style="background:#9ab4e3" | ¨ || 0xA8 || 0xA8 || latin small letter s with caron || Substitute char "diaeresis" at 0xA8
|-

| U+0162 || Ţ || 0x8E || || style="background:#ebbb54;" | 0xDE || || || || latin capital letter t with cedilla || Can stand in for "...comma under"
|-

| U+0163 || ţ || 0x9E || || style="background:#ebbb54;" | 0xFE || || || || latin small letter t with cedilla || Can stand in for "...comma under"
|-

| U+0164 || Ť || 0xB2 || style="background:#9ab4e3" | ² || style="background:#ebbb54;" | 0xAB || style="background:#9ab4e3" | ² || style="background:#9ab4e3" | ² || || latin capital letter t with caron || Substitute char "superscript two" at 0xB2
|-

| U+0165 || ť || 0xB6 || style="background:#9ab4e3" | ¶ || style="background:#ebbb54;" | 0xBB || style="background:#9ab4e3" | ¶ || style="background:#9ab4e3" | ¶ || || latin small letter t with caron || Substitute char "pilcrow sign" at 0xB6
|-

| U+016E || Ů || 0xA9 || style="background:#9ab4e3" | © || style="background:#ebbb54;" | 0xD9 || style="background:#9ab4e3" | © || style="background:#9ab4e3" | © || || latin capital letter u with ring above || Substitute char "copyright sign" at 0xA9
|-

| U+016F || ů || 0xAF || style="background:#9ab4e3" | ¯ || style="background:#ebbb54;" | 0xF9 || style="background:#9ab4e3" | ¯ || style="background:#9ab4e3" | ¯ || || latin small letter u with ring above || Substitute char "macron" at 0xAF
|-

| U+0170 || Ű || 0xA2 || style="background:#9ab4e3" | ¢ || style="background:#ebbb54;" | 0xDB || style="background:#9ab4e3" | ¢ || style="background:#9ab4e3" | ¢ || style="background:#ebbb54;" | 0xD8 || latin capital letter u with double acute || Similiar to Ü, used in Hungarian. Substitute char "cent sign" at 0xA2
|-

| U+0171 || ű || 0xA4 || style="background:#9ab4e3" | ¤ || style="background:#ebbb54;" | 0xFB || style="background:#9ab4e3" | ¤ || style="background:#9ab4e3" | ¤ || style="background:#ebbb54;" | 0xF8 || latin small letter u with double acute || Similiar to Ü, used in Hungarian. Substitute char "currency sign" at 0xA4
|-

| U+0178 || Ÿ || 0xBE || style="background:#9ab4e3" | ¾ || || style="background:#9ab4e3" | ¾ || 0xBE || 0xBE || latin capital letter y with diaeresis || Substitute char "vulgar fraction three quarters" at 0xBE
|-

| U+0179 || Ź || 0x84 || || style="background:#ebbb54;" | 0xAC || || || style="background:#ebbb54;" | | 0xAC || latin capital letter z with acute ||
|-

| U+017A || ź || 0x94 || || style="background:#ebbb54;" | 0xBC || || || style="background:#ebbb54;" | 0xAE || latin small letter z with acute ||
|-

| U+017B || Ż || 0x83 || || style="background:#ebbb54;" | 0xAF || || || style="background:#ebbb54;" | 0xAF || latin capital letter z with dot above ||
|-

| U+017C || ż || 0x93 || || style="background:#ebbb54;" | 0xBF || || || style="background:#ebbb54;" | 0xBF || latin small letter z with dot above ||
|-

| U+017D || Ž || 0xB4 || style="background:#9ab4e3" | ´ || style="background:#ebbb54;" | 0xAE || style="background:#9ab4e3" | ´ || 0xB4 || 0xB4 || latin capital letter z with caron || Substitute char "accute accent" at 0xB4
|-

| U+017E || ž || 0xB8 || style="background:#9ab4e3" | ¸ || style="background:#ebbb54;" | 0xBE || style="background:#9ab4e3" | ¸ || 0xB8 || 0xB8 || latin small letter z with caron || Substitute char "cedilla" at 0xB8
|- style="background:#dbab8a;"

| U+01D3 || Ǔ || 0x8A || || || || || || latin capital u with caron || Not found in ISO-8859. Pinyin tone marking
|- style="background:#dbab8a;"

| U+01D4 || ǔ || 0x9A || || || || || || latin small u with caron || Not found in ISO-8859. Pinyin tone marking
|-

| U+0218 || Ș || 0x8D || || || || || style="background:#ebbb54;" | 0xAA || latin capital letter s with comma below || See also "...with cedilla"
|-

| U+0219 || ș || 0x9D || || || || || style="background:#ebbb54;" | 0xBA || latin small letter s with comma below || See also "...with cedilla"
|-

| U+021A || Ț || 0x8E || || || || || style="background:#ebbb54;" | 0xDE || latin capital letter t with comma below || See also "...with cedilla"
|-

| U+021B || ț || 0x9E || || || || || style="background:#ebbb54;" | 0xFE || latin small letter t with comma below || See also "...with cedilla"
|- style="color:#8c8c8c;"

| U+02C7 || ˇ || || || || 0xB7 || || || caron ||
|- style="color:#8c8c8c;"

| U+02D8 || ˘ || || || || 0xA2 || || || breve ||
|- style="color:#8c8c8c;"

| U+02D9 || ˙ || || || || 0xFF || || || dot above ||
|- style="color:#8c8c8c;"

| U+02DB || ˛ || || || || 0xB2 || || || ogonek ||
|- style="color:#8c8c8c;"

| U+02DD || ˝ || || || || 0xBD || || || double acute accent ||
|- style="background:#dbab8a;"

| U+1E90 || Ẑ || 0x87 || || || || || || latin capital z with circumflex || Not found in ISO-8859. Rare use in Cyrillic-to-Latin transliteration, or Pinyin
|- style="background:#dbab8a;"

| U+1E91 || ẑ || 0x97 || || || || || || latin small z with circumflex || Not found in ISO-8859. Rare use in Cyrillic-to-Latin transliteration, or Pinyin
|- style="color:#8c8c8c;"

| U+201D || ” || || || || || || 0xB5 || right double quotation mark ||
|- style="color:#8c8c8c;"

| U+201E || „ || || || || || || 0xA5 || double low-9 quotation mark ||
|- style="color:#8c8c8c;"

| U+20AC || € || || || || || 0xA4 || 0xA4 || euro sign ||
|}

== For More ==
* [[I18N - Character mapping]] sketches the format and location of <language>.map files.
* [[I18N - Charset]] is the main article about TDM language use and various encodings.

Multilanguage Display

2026-06-19T17:30:54Z

Geep: /* For More */ adds section

== Background ==
''This describes a particular challenging use case of a TDM methodology that has been around for some time. The motivation to detail this was a 2026 update by Geep to the language map files, following a revision of Carleton 24pt font used throughout the Main Menu.''

In TDM's main menu, the Settings/Video/Language page attempts to list all the supported languages in their native form with respect to character set, that is, untranslated. Showing multiple language strings together is difficult, but some tricks are available. The result has been a reasonable near-term workaround for this particular page, applicable to comparable cases. (Comprehensive support for multilanguage display likely involves a major restructuring, for instance, moving to a native Unicode architecture with combined Latin and Cyrillic bitmaps.)

Recall that strings for the main menu are found in the utf8 file tdm_base01.pk4/strings/all.lang, where there is are sections for [English], [German], etc. A particular section is used to generate for distribution the corresponding file, e.g., french.lang, german.lang, etc., in a language-specific 8-bit encoding. When you play TDM, and select a given language, the corresponding .lang file (if needed) is read.

Except for Cyrillic Russian, these files use encodings within the ISO-8859 family (as detailed in [[I18N_-_Charset]]). Any specific encoding is a bottleneck... by design, not all characters in any one member of the ISO-8859 family will be accessible by some other members.

== Language Names in Idealized UTF8 Form ==
Only the TDM-exposed languages are shown here. The all.lang file has additional strings for other potential Latin and Cyrillic languages. For reference, the generated encoding for the <language>.lang file is shown in the comment.

"#str_02460" "English" // English [ISO-8859-1]
"#str_02461" "Deutsch" // German [ISO-8859-1]
"#str_02462" "Español" // Spanish [ISO-8859-1]
"#str_02463" "Français" // French [ISO-8859-15]
"#str_02464" "Português" // Portuguese [ISO-8859-1]
"#str_02465" "Polski" // Polish [ISO-8859-2]
"#str_02466" "Italiano" // Italian [ISO-8859-1]
"#str_02467" "Česky" // Czech [ISO-8859-2]
"#str_02468" "Русский" // Russian [WIN-1251]
"#str_02469" "Català" // Catalan [ISO-8859-1]
"#str_02470" "Dansk" // Danish [ISO-8859-1]
"#str_02472" "Nederlands" // Dutch [ISO-8859-1]
"#str_02474" "Magyar" // Hungarian [ISO-8859-2]
"#str_02476" "Svenska" // Swedish [ISO-8859-1]
"#str_02477" "Türkçe" // Turkish [ISO-8859-9]
"#str_02479" "Română" // Romanian [ISO-8859-16]
"#str_02480" "Slovenčina" // Slovak [ISO-8859-2]

== First Compromise – Cyrillic vs. Latin Font ==
While there is some overlap in characters between Cyrillic and Latin encodings, it is insufficient for our purposes. So, for [English] and other European sections, a Latin transliteration from Cyrillic is used:

"#str_02468" "Russkiy" // Russian

Going the other way, for [Russian], the current treatment is not to do a Cyrillic transliteration from Latin, but instead to drop accents, rendering just in ASCII (except of course “Russian”), e.g.:

"#str_02460" "English" // English
"#str_02461" "Deutsch" // German
"#str_02462" "Espanol" // Spanish
"#str_02463" "Francais" // French
"#str_02464" "Portugues" // Portuguese
"#str_02465" "Polski" // Polish
"#str_02466" "Italiano" // Italian
"#str_02467" "Cesky" // Czech
"#str_02468" "Русский" // Russian
"#str_02469" "Catala" // Catalan
"#str_02470" "Dansk" // Danish
"#str_02472" "Nederlands" // Dutch
"#str_02474" "Magyar" // Hungarian
"#str_02476" "Svenska" // Swedish
"#str_02477" "Turkce" // Turkish
"#str_02479" "Romana" // Romanian
"#str_02480" "Slovencina" // Slovak

== Moving between ISO-8859 Members ==
In the discussion here, let “L1” be the current language (from the player’s perspective) or the [language] section of interest in all.lang (from the translator’s perspective). Let “L2” be the language of the foreign word, i.e., L1 and L2 differ.

=== Type and Go ===
In several cases, the translator merely puts the ideal character in the all.lang strings. After <language>.lang generation, everything works. Cases are:

# L1 and L2 are both use the same ISO-8859 encoding. (Specifically, they are either both ISO-8859-1, which doesn’t need <language>.map files, or both ISO-8859-2, and have <language>.map files with, by convention, identical contents.) NOTE: For TDM’s purposes, ISO-8859-15 (French) can be considered part of the ISO-8859-1 family.
# L2 character is ASCII (i.e., in ISO range 0x00-0x7f). This is always the case if L2 = English. Characters in this range have identical codepoints in all five TDM-supported ISO-8859 and in the TDM target encoding.
# L2 character is in the ISO range 0xA0-0xFF, with additional constraints.

For the last case, the L2 character must be either:
* present at the same codepoint in all five TDM-supported ISO-8859 encodings, and in the TDM target encoding. For our Latin language names, these accented characters are like that:
ç in "Français" and "Türkçe" at 0xE7
à in "Català" at 0xEA
â in "Română" at 0xE2
ü in "Türkçe" at 0xFC
* present at the same codepoint in ISO-8859 encodings for L1 and L2, and in the TDM target encoding.
* present in different codepoints in ISO-8859 encodings for L1 and L2, but with each being either the same as the TDM target encoding, or mapped to the TDM target encoding by the <language>.map file.

=== Tricks ===
If the L2 character is not represented in the ISO encoding for L1, then at <L1>.lang generation time, it will be replaced by a “?”. To work around this, the translator has two methods:

====Trick Method 1 – Direct Stuffing====
When L1 encoding is ISO-8859-1 (or -9 or -15, which all have identical encodings for the 0xA0-BF ranges) and L2 character is in TDM’s 0xA0-0xBF range (or D7, F7), then you can lookup the ISO character associated with that codepoint (shown in parentheses in cells of the i18n- charmap table), and type it. Examples:

[English] // and other ISO-8859-1, -9, or -15
"#str_02467" "¬esky" // our default mapping is ISO 8859-1, so ¬ is shown as Č (¬)
"#str_02480" "Sloven®ina" // Slovak (® in ISO-8859-1 is č in our font)

Here’s another example of that last stuffing from a TDM-unexposed language, showing also a diaresis (0xA8):

"#str_02481" "Sloven¨®ina" // Slovenian (southern slovenia) (¨ => š)

In this case, ISO-8859-1 would need to use the diaresis, but ISO-8859-15 (French) would not, i.e., could type and go with š.
The spreadsheet shows all available substitutions in light blue.

====Trick Method 2 – Special Mapping with Repurposed Character====
If all else fails, a little-used character in L1 can be redirected to the L2 codepoint TDM wants, by an extra mapping command in the <L1>.map file. Current such tricks are...

To get ñ for "Español":

* for iso 2, put ¨ (diaeresis 0xA8)
* for iso 16, put ¶ (pilcrow 0xB6)

To get ê for "Português":

*for iso 2: Put ´ (acute accent 0xBD)

== TDM & ISO Char Sets - Details, Potential Tricks, Limitations ==

The main table below (after the Key) was drafted by Google AI, from a prompt that defined the header and an example row, and specified:

"Rows are a combination of all the printable 8-bit codepoints in the range 0x80-0xff defined in ISO-8859-1, -2, -9, -15, and -16. The rows are ordered by Unicode number. If a particular ISO standard does not include the character, leave that cell blank."

Subsequently, after Excel import, the TDM and Comments columns were filled in by Geep, and color coding added. Language mappings were independently color coded, then verified against existing language maps. Finally converted to wikitable format.

This table skips codepoints in the range 0x00-0x7f, because they are the same for all ISO-8859 standards. No mapping required.

{| class="wikitable" style="font-size: 95%; line-height: 1.3em;"
|+ Color Key
! Cell !! Meaning
|-

| style="color:#8c8c8c;" | Light Gray Text Row || Symbol not included in TDM custom character set (so TDM column blank). Can use for char substitution tricks.
|-

| 0xNN on white || Type desired utf8 char (in Symbol column) in all.lang. Generation goes directly to TDM codepoint given.
|-

| style="background:#ebbb54;" | 0xNN, amber hilite || Type desired utf8 char in all.lang. Generation + mapping (in <language>.map file) goes to TDM codepoint via codepoint shown.
|-

| style="background:#ebbb54;color:#606060;" | 0xNN in gray || Type desired utf8 char in all.lang. Generation + mapping (in <language>.map file) goes to TDM codepoint OF SUBSTITUTE CHARACTER via codepoint shown.
|-

| style="background:#ebbb54;color:#ff0000;" | 0xNN in red || Character not part of this ISO. "0xnn" shown is not ISO, but for trick mapping (in <language.map), to support main menu's multilingual "Languages" page.
|-

| style="background:#9ab4e3;" | Substitute Char || Character not part of this ISO. But as trick, you can stuff in this substitute char at the needed TDM codepoint.
|-

| style="background:#43a8cc;" | n/a || Not available to use substitute character, due to trick mapping (in <language>.map) elsewhere.
|-

| Empty Cell || In ISO column, means character not part of this ISO (so may be candidate for future trick mapping; or simply not fully analyzed viz substitute char.)
|-

| style="background:#dbab8a;" | Tan Row || Orphaned character in TDM set, not part of 5 ISO-8859 standards for current TDM-supported languages.
|-
|}

{| class="wikitable" style="font-size: 95%; line-height: 1.3em;"
|+ Unicode Coverage for TDM
! Unicode !! Symbol !! TDM !! 1 !! 2 !! 9 !! 15 !! 16 !! Unicode Name !! Comments
|-

| U+00A0 ||   || 0xA0 || 0xA0 || 0xA0 || 0xA0 || 0xA0 || 0xA0 || no-break space ||
|- style="color:#8c8c8c;"

| U+00A1 || ¡ || || 0xA1 || || 0xA1 || 0xA1 || || inverted exclamation mark ||
|- style="color:#8c8c8c;"

| U+00A2 || ¢ || || 0xA2 || || 0xA2 || 0xA2 || || cent sign ||
|- style="color:#8c8c8c;"

| U+00A3 || £ || || 0xA3 || || 0xA3 || 0xA3 || || pound sign ||
|- style="color:#8c8c8c;"

| U+00A4 || ¤ || || 0xA4 || 0xA4 || 0xA4 || || || currency sign ||
|- style="color:#8c8c8c;"

| U+00A5 || ¥ || || 0xA5 || || 0xA5 || 0xA5 || || yen sign ||
|- style="color:#8c8c8c;"

| U+00A6 || ¦ || || 0xA6 || || 0xA6 || || || broken bar ||
|-

| U+00A7 || § || 0xA7 || 0xA7 || 0xA7 || 0xA7 || 0xA7 || 0xA7 || section sign ||
|- style="color:#8c8c8c;"

| U+00A8 || ¨ || || 0xA8 || 0xA8 || 0xA8 || || || diaeresis || See also hack use for ñ
|- style="color:#8c8c8c;"

| U+00A9 || © || || 0xA9 || || 0xA9 || 0xA9 || 0xA9 || copyright sign ||
|- style="color:#8c8c8c;"

| U+00AA || ª || || 0xAA || || 0xAA || 0xAA || || feminine ordinal indicator ||
|- style="color:#8c8c8c;"

| U+00AB || « || || 0xAB || || 0xAB || 0xAB || 0xAB || left-pointing double angle quotation mark ||
|- style="color:#8c8c8c;"

| U+00AC || ¬ || || 0xAC || || 0xAC || 0xAC || || not sign ||
|-

| U+00AD || || 0xAD || 0xAD || 0xAD || 0xAD || 0xAD || 0xAD || soft hyphen ||
|- style="color:#8c8c8c;"

| U+00AE || ® || || 0xAE || || 0xAE || 0xAE || || registered sign ||
|- style="color:#8c8c8c;"

| U+00AF || ¯ || || 0xAF || || 0xAF || 0xAF || || macron ||
|- style="color:#8c8c8c;"

| U+00B0 || ° || || 0xB0 || 0xB0 || 0xB0 || 0xB0 || 0xB0 || degree sign ||
|- style="color:#8c8c8c;"

| U+00B1 || ± || || 0xB1 || || 0xB1 || 0xB1 || 0xB1 || plus-minus sign ||
|- style="color:#8c8c8c;"

| U+00B2 || ² || || 0xB2 || || 0xB2 || 0xB2 || || superscript two ||
|- style="color:#8c8c8c;"

| U+00B3 || ³ || || 0xB3 || || 0xB3 || 0xB3 || || superscript three ||
|- style="color:#8c8c8c;"

| U+00B4 || ´ || || 0xB4 || 0xB4 || 0xB4 || || || acute accent ||
|- style="color:#8c8c8c;"

| U+00B5 || µ || || 0xB5 || || 0xB5 || 0xB5 || || micro sign ||
|- style="color:#8c8c8c;"

| U+00B6 || ¶ || || 0xB6 || || 0xB6 || 0xB6 || 0xB6 || pilcrow sign ||
|- style="color:#8c8c8c;"

| U+00B7 || · || || 0xB7 || || 0xB7 || 0xB7 || 0xB7 || middle dot ||
|- style="color:#8c8c8c;"

| U+00B8 || ¸ || || 0xB8 || 0xB8 || 0xB8 || || || cedilla ||
|- style="color:#8c8c8c;"

| U+00B9 || ¹ || || 0xB9 || || 0xB9 || 0xB9 || || superscript one ||
|- style="color:#8c8c8c;"

| U+00BA || º || || 0xBA || || 0xBA || 0xBA || || masculine ordinal indicator ||
|- style="color:#8c8c8c;"

| U+00BB || » || || 0xBB || || 0xBB || 0xBB || 0xBB || right-pointing double angle quotation mark ||
|- style="color:#8c8c8c;"

| U+00BC || ¼ || || 0xBC || || 0xBC || || || vulgar fraction one quarter ||
|- style="color:#8c8c8c;"

| U+00BD || ½ || || 0xBD || || 0xBD || || || vulgar fraction one half ||
|- style="color:#8c8c8c;"

| U+00BE || ¾ || || 0xBE || || 0xBE || || || vulgar fraction three quarters ||
|-

| U+00BF || ¿ || 0xBF || 0xBF || || 0xBF || 0xBF || || inverted question mark ||
|-

| U+00C0 || À || 0xC0 || 0xC0 || || 0xC0 || 0xC0 || 0xC0 || latin capital letter a with grave ||
|-

| U+00C1 || Á || 0xC1 || 0xC1 || 0xC1 || 0xC1 || 0xC1 || 0xC1 || latin capital letter a with acute ||
|-

| U+00C2 || Â || 0xC2 || 0xC2 || 0xC2 || 0xC2 || 0xC2 || 0xC2 || latin capital letter a with circumflex ||
|-

| U+00C3 || Ã || 0xC3 || 0xC3 || || 0xC3 || 0xC3 || || latin capital letter a with tilde ||
|-

| U+00C4 || Ä || 0xC4 || 0xC4 || 0xC4 || 0xC4 || 0xC4 || 0xC4 || latin capital letter a with diaeresis ||
|-

| U+00C5 || Å || 0xC5 || 0xC5 || || 0xC5 || 0xC5 || || latin capital letter a with ring above ||
|-

| U+00C6 || Æ || 0xC6 || 0xC6 || || 0xC6 || 0xC6 || 0xC6 || latin capital letter ae ||
|-

| U+00C7 || Ç || 0xC7 || 0xC7 || 0xC7 || 0xC7 || 0xC7 || 0xC7 || latin capital letter c with cedilla ||
|-

| U+00C8 || È || 0xC8 || 0xC8 || || 0xC8 || 0xC8 || 0xC8 || latin capital letter e with grave ||
|-

| U+00C9 || É || 0xC9 || 0xC9 || 0xC9 || 0xC9 || 0xC9 || 0xC9 || latin capital letter e with acute ||
|-

| U+00CA || Ê || 0xCA || 0xCA || || 0xCA || 0xCA || 0xCA || latin capital letter e with circumflex ||
|-

| U+00CB || Ë || 0xCB || 0xCB || 0xCB || 0xCB || 0xCB || 0xCB || latin capital letter e with diaeresis ||
|-

| U+00CC || Ì || 0xCC || 0xCC || || 0xCC || 0xCC || 0xCC || latin capital letter i with grave ||
|-

| U+00CD || Í || 0xCD || 0xCD || 0xCD || 0xCD || 0xCD || 0xCD || latin capital letter i with acute ||
|-

| U+00CE || Î || 0xCE || 0xCE || 0xCE || 0xCE || 0xCE || 0xCE || latin capital letter i with circumflex ||
|-

| U+00CF || Ï || 0xCF || 0xCF || || 0xCF || 0xCF || 0xCF || latin capital letter i with diaeresis ||
|-

| U+00D0 || Ð || 0xD0 || 0xD0 || || style="background:#43a8cc;" | n/a || 0xD0 || || latin capital letter eth || Same glyph as U+0110 latin capital letter d with stroke
|-

| U+00D1 || Ñ || 0xD1 || 0xD1 || || 0xD1 || 0xD1 || || latin capital letter n with tilde ||
|-

| U+00D2 || Ò || 0xD2 || 0xD2 || || 0xD2 || 0xD2 || 0xD2 || latin capital letter o with grave ||
|-

| U+00D3 || Ó || 0xD3 || 0xD3 || 0xC1 || 0xD3 || 0xD3 || 0xD3 || latin capital letter o with acute ||
|-

| U+00D4 || Ô || 0xD4 || 0xD4 || 0xD4 || 0xD4 || 0xD4 || 0xD4 || latin capital letter o with circumflex || Formerly also mapped from 0x88; redundant, Ğ has 0x88 codepoint now
|-

| U+00D5 || Õ || 0xD5 || 0xD5 || || 0xD5 || 0xD5 || || latin capital letter o with tilde ||
|-

| U+00D6 || Ö || 0xD6 || 0xD6 || 0xD6 || 0xD6 || 0xD6 || 0xD6 || latin capital letter o with diaeresis ||
|- style="color:#8c8c8c;"

| U+00D7 || × || || 0xD7 || 0xD7 || 0xD7 || 0xD7 || || multiplication sign ||
|-

| U+00D8 || Ø || 0xD8 || 0xD8 || || 0xD8 || 0xD8 || || latin capital letter o with stroke ||
|-

| U+00D9 || Ù || 0xD9 || 0xD9 || || 0xD9 || 0xD9 || 0xD9 || latin capital letter u with grave ||
|-

| U+00DA || Ú || 0xDA || 0xDA || 0xDA || 0xDA || 0xDA || 0xDA || latin capital letter u with acute ||
|-

| U+00DB || Û || 0xDB || 0xDB || || 0xDB || 0xDB || 0xDB || latin capital letter u with circumflex ||
|-

| U+00DC || Ü || 0xDC || 0xDC || 0xDC || 0xDC || 0xDC || 0xDC || latin capital letter u with diaeresis ||
|-

| U+00DD || Ý || 0xDD || 0xDD || 0xDD || || 0xDD || || latin capital letter y with acute ||
|-

| U+00DE || Þ || 0xDE || 0xDE || || || 0xDE || || latin capital letter thorn ||
|-

| U+00DF || ß || 0xDF || 0xDF || 0xDF || 0xDF || 0xDF || 0xDF || latin small letter sharp s ||
|-

| U+00E0 || à || 0xE0 || 0xE0 || || 0xE0 || 0xE0 || 0xE0 || latin small letter a with grave ||
|-

| U+00E1 || á || 0xE1 || 0xE1 || 0xE1 || 0xE1 || 0xE1 || 0xE1 || latin small letter a with acute ||
|-

| U+00E2 || â || 0xE2 || 0xE2 || 0xE2 || 0xE2 || 0xE2 || 0xE2 || latin small letter a with circumflex ||
|-

| U+00E3 || ã || 0xE3 || 0xE3 || || 0xE3 || 0xE3 || || latin small letter a with tilde ||
|-

| U+00E4 || ä || 0xE4 || 0xE4 || 0xE4 || 0xE4 || 0xE4 || 0xE4 || latin small letter a with diaeresis ||
|-

| U+00E5 || å || 0xE5 || 0xE5 || || 0xE5 || 0xE5 || || latin small letter a with ring above ||
|-

| U+00E6 || æ || 0xE6 || 0xE6 || || 0xE6 || 0xE6 || 0xE6 || latin small letter ae ||
|-

| U+00E7 || ç || 0xE7 || 0xE7 || 0xE7 || 0xE7 || 0xE7 || 0xE7 || latin small letter c with cedilla ||
|-

| U+00E8 || è || 0xE8 || 0xE8 || || 0xE8 || 0xE8 || 0xE8 || latin small letter e with grave ||
|-

| U+00E9 || é || 0xE9 || 0xE9 || 0xE9 || 0xE9 || 0xE9 || 0xE9 || latin small letter e with acute ||
|-

| U+00EA || ê || 0xEA || 0xEA || style="background:#ebbb54;color:#ff0000;" | 0xBD || 0xEA || 0xEA || 0xEA || latin small letter e with circumflex || Hack for iso 2: Put ´ (acute accent, 0xBD) to get ê for "Português"
|-

| U+00EB || ë || 0xEB || 0xEB || 0xEB || 0xEB || 0xEB || 0xEB || latin small letter e with diaeresis ||
|-

| U+00EC || ì || 0xEC || 0xEC || || 0xEC || 0xEC || 0xEC || latin small letter i with grave ||
|-

| U+00ED || í || 0xED || 0xED || 0xED || 0xED || 0xED || 0xED || latin small letter i with acute ||
|-

| U+00EE || î || 0xEE || 0xEE || 0xEE || 0xEE || 0xEE || 0xEE || latin small letter i with circumflex ||
|-

| U+00EF || ï || 0xEF || 0xEF || || 0xEF || 0xEF || 0xEF || latin small letter i with diaeresis ||
|-

| U+00F0 || ð || 0xF0 || 0xF0 || || || 0xF0 || || latin small letter eth ||
|-

| U+00F1 || ñ || 0xF1 || 0xF1 || style="background:#ebbb54;color:#ff0000;" | 0xA8 || 0xF1 || 0xF1 || style="background:#ebbb54;color:#ff0000;" | 0xB6 || latin small letter n with tilde || Hacks to get ñ for "Español": for iso 2, put ¨ (diaeresis 0xA8); for iso 16, put ¶ (0xB6)
|-

| U+00F2 || ò || 0xF2 || 0xF2 || || 0xF2 || 0xF2 || 0xF2 || latin small letter o with grave ||
|-

| U+00F3 || ó || 0xF3 || 0xF3 || 0xF3 || 0xF3 || 0xF3 || 0xF3 || latin small letter o with acute ||
|-

| U+00F4 || ô || 0xF4 || 0xF4 || 0xF4 || 0xF4 || 0xF4 || 0xF4 || latin small letter o with circumflex || Formerly also mapped from 0x88; redundant, ğ has TDM 0x88 codepoint now
|-

| U+00F5 || õ || 0xF5 || 0xF5 || || 0xF5 || 0xF5 || || latin small letter o with tilde ||
|-

| U+00F6 || ö || 0xF6 || 0xF6 || 0xF6 || 0xF6 || 0xF6 || 0xF6 || latin small letter o with diaeresis ||
|- style="color:#8c8c8c;"

| U+00F7 || ÷ || || 0xF7 || 0xF7 || 0xF7 || 0xF7 || || division sign ||
|-

| U+00F8 || ø || 0xF8 || 0xF8 || || 0xF8 || 0xF8 || || latin small letter o with stroke ||
|-

| U+00F9 || ù || 0xF9 || 0xF9 || || 0xF9 || 0xF9 || 0xF9 || latin small letter u with grave ||
|-

| U+00FA || ú || 0xFA || 0xFA || 0xFA || 0xFA || 0xFA || 0xFA || latin small letter u with acute ||
|-

| U+00FB || û || 0xFB || 0xFB || || 0xFB || 0xFB || 0xFB || latin small letter u with circumflex ||
|-

| U+00FC || ü || 0xFC || 0xFC || 0xFC || 0xFC || 0xFC || 0xFC || latin small letter u with diaeresis ||
|-

| U+00FD || ý || 0xFD || 0xFD || 0xFD || || 0xFD || || latin small letter y with acute ||
|-

| U+00FE || þ || 0xFE || 0xFE || || || 0xFE || || latin small letter thorn ||
|-

| U+00FF || ÿ || 0xFF || 0xFF || || 0xFF || 0xFF || 0xFF || latin small letter y with diaeresis ||
|-

| U+0102 || Ă || 0x8B || || style="background:#ebbb54;" | 0xC3 || || || style="background:#ebbb54;" | 0xC3 || latin capital letter a with breve ||
|-

| U+0103 || ă || 0x9B || || style="background:#ebbb54;" | 0xE3 || || || style="background:#ebbb54;" | 0xE3 || latin small letter a with breve ||
|-

| U+0104 || Ą || 0xAA || style="background:#9ab4e3" | ª || style="background:#ebbb54;" | 0xA1 || style="background:#9ab4e3" | ª || style="background:#9ab4e3" | ª || style="background:#ebbb54;" | 0xA1 || latin capital letter a with ogonek ||
|-

| U+0105 || ą || 0xBA || style="background:#9ab4e3" | º || style="background:#ebbb54;" | 0xB1 || style="background:#9ab4e3" | º || style="background:#9ab4e3" | º || style="background:#ebbb54;" | 0xA2 || latin small letter a with ogonek ||
|-

| U+0106 || Ć || 0x82 || || style="background:#ebbb54;" | 0xC6 || || || style="background:#ebbb54;" | 0xC5 || latin capital letter c with acute ||
|-

| U+0107 || ć || 0x92 || || style="background:#ebbb54;" | 0xE6 || || || style="background:#ebbb54;" | 0xE5 || latin small letter c with acute ||
|- style="background:#dbab8a;"

| U+0108 || Ĉ || 0x86 || || || || || || latin capital c with circumflex || Only in ISO-8859-3 (for Esperanto) at 0xC6
|- style="background:#dbab8a;"

| U+0109 || ĉ || 0x96 || || || || || || latin small c with circumflex || Only in ISO-8859-3 (for Esperanto) at 0xE6
|-

| U+010C || Č || 0xAC || style="background:#9ab4e3" | ¬ || style="background:#ebbb54;" | 0xC8 || style="background:#9ab4e3" | ¬ || style="background:#9ab4e3" | ¬ || style="background:#ebbb54;" | 0xB2 || latin capital letter c with caron || Substitute char "not sign" at 0xAC
|-

| U+010D || č || 0xAE || style="background:#9ab4e3" | ® || style="background:#ebbb54;" | 0xE8 || style="background:#9ab4e3" | ® || style="background:#9ab4e3" | ® || style="background:#ebbb54;" | 0xB9 || latin small letter c with caron || Substitute char "registration sign" at 0xAE
|-

| U+010E || Ď || 0xB3 || style="background:#9ab4e3" | ³ || style="background:#ebbb54;" | 0xCF || style="background:#9ab4e3" | ³ || style="background:#9ab4e3" | ³ || || latin capital letter d with caron || Substitute char "superscript three" at 0xB3
|-

| U+010F || ď || 0xB7 || style="background:#9ab4e3; font-weight:bold" | · || style="background:#ebbb54;" | 0xEF || style="background:#9ab4e3; font-weight:bold" | · || style="background:#9ab4e3; font-weight:bold" | · || || latin small letter d with caron || Substitute char "middle dot" at 0xB7
|-

| U+0110 || Đ || 0xD0 || 0xD0 || 0xD0 || style="background:#43a8cc;" | n/a || || 0xD0 || latin capital letter d with stroke || Same glyph as U+00D0 latin capital letter eth
|-

| U+0111 || đ || 0x90 || || style="background:#ebbb54;" | 0xF0 || style="background:#43a8cc;" | n/a || || style="background:#ebbb54;" | 0xF0 || latin small letter d with stroke ||
|-

| U+0118 || Ę || 0xAB || style="background:#9ab4e3" | « || style="background:#ebbb54;" | 0xCA || style="background:#9ab4e3" | « || style="background:#9ab4e3" | « || style="background:#ebbb54;" | 0xDD || latin capital letter e with ogonek || Substitute char "left-pointing double angle quotation mark" at 0xAB
|-

| U+0119 || ę || 0xBB || style="background:#9ab4e3" | » || style="background:#ebbb54;" | 0xEA || style="background:#9ab4e3" | » || style="background:#9ab4e3" | » || style="background:#ebbb54;" | 0xFD || latin small letter e with ogonek || Substitute char "right-pointing double angle quotation mark" at 0xBB
|-

| U+011A || Ě || 0xA5 || style="background:#9ab4e3" | ¥ || style="background:#ebbb54;" | 0xCC || style="background:#9ab4e3" | ¥ || style="background:#9ab4e3" | ¥ || || latin capital letter e with caron || Substitute char "yen sign" at 0xA5
|-

| U+011B || ě || 0xA3 || style="background:#9ab4e3" | £ || style="background:#ebbb54;" | 0xEC || style="background:#9ab4e3" | £ || style="background:#9ab4e3" | £ || || latin small letter e with caron || Substitute char "pound sign" at 0xA3
|-

| U+011E || Ğ || 0x88 || || || style="background:#ebbb54;" | 0xD0 || || || latin capital letter g with breve || As of TDM 2.13
|-

| U+011F || ğ || 0x98 || || || style="background:#ebbb54;" | 0xF0 || || || latin small letter g with breve || As of TDM 2.13
|- style="color:#8c8c8c;"

| U+0130 || İ || || || || style="background:#ebbb54;" | 0xDD || || || latin capital letter i with dot above || Turkish: utf8 "İ" will be mapped to "Î" (0xCE)
|- style="color:#8c8c8c;"

| U+0131 || ı || || || || style="background:#ebbb54;" | 0xFD || || || latin small letter dotless i || Turkish: utf8 "ı" will be mapped to ASCII "i" (0x69)
|- style="color:#8c8c8c;"

| U+0139 || Ĺ || || || 0xC5 || || || || latin capital letter l with acute ||
|- style="color:#8c8c8c;"

| U+013A || ĺ || || || 0xE5 || || || || latin small letter l with acute ||
|- style="color:#8c8c8c;"

| U+013D || Ľ || || || 0xA5 || || || || latin capital letter l with caron ||
|- style="color:#8c8c8c;"

| U+013E || ľ || || || 0xB5 || || || || latin small letter l with caron ||
|-

| U+0141 || Ł || 0xB1 || style="background:#9ab4e3" | ± || style="background:#ebbb54;" | 0xA3 || style="background:#9ab4e3" | ± || style="background:#9ab4e3" | ± || style="background:#ebbb54;" | 0xA3 || latin capital letter l with stroke || Substitute char "plus-minus sign" at 0xB1
|-

| U+0142 || ł || 0xB5 || style="background:#9ab4e3" | µ || style="background:#ebbb54;" | 0xB3 || style="background:#9ab4e3" | µ || style="background:#9ab4e3" | µ || style="background:#ebbb54;" | 0xB3 || latin small letter l with stroke || Substitute char "micro sign" at 0xB5
|-

| U+0143 || Ń || 0x8C || || style="background:#ebbb54;" | 0xD1 || || || style="background:#ebbb54;" | 0xD1 || latin capital letter n with acute ||
|-

| U+0144 || ń || 0x9C || || style="background:#ebbb54;" | 0xF1 || || || style="background:#ebbb54;" | 0xF1 || latin small letter n with acute ||
|-

| U+0147 || Ň || 0x80 || || style="background:#ebbb54;" | 0xD2 || || || || latin capital letter n with caron ||
|-

| U+0148 || ň || 0xA1 || style="background:#9ab4e3" | ¡ || style="background:#ebbb54;" | 0xF2 || style="background:#9ab4e3" | ¡ || style="background:#9ab4e3" | ¡ || || latin small letter n with caron || Substitute char "inverted exclamation mark" at 0xA1
|-

| U+0150 || Ő || 0xB0 || style="background:#9ab4e3" | ° || style="background:#ebbb54;" | 0xD5 || style="background:#9ab4e3" | ° || style="background:#9ab4e3" | ° || style="background:#ebbb54;" | 0xD5 || latin capital letter o with double acute || Similiar to Ö, used in Hungarian. Substitute char "degree sign" at 0xB0
|-

| U+0151 || ő || 0xB9 || style="background:#9ab4e3" | ¹ || style="background:#ebbb54;" | 0xF5 || style="background:#9ab4e3" | ¹ || style="background:#9ab4e3" | ¹ || style="background:#ebbb54;" | 0xF5 || latin small letter o with double acute || Similiar to ö, used in Hungarian. Substitute char "superscript 1" at 0xB9
|-

| U+0152 || Œ || 0xBC || style="background:#9ab4e3" | ¼ || || style="background:#9ab4e3" | ¼ || 0xBC || 0xBC || latin capital ligature oe || Substitute char "vulgar fraction one quarter" at 0xBC
|-

| U+0153 || œ || 0xBD || style="background:#9ab4e3" | ½ || || style="background:#9ab4e3" | ½ || 0xBD || 0xBD || latin small ligature oe || Substitute char "vulgar fraction one half" at 0xBD
|-

| U+0154 || Ŕ || 0x89 || || style="background:#ebbb54;" | 0xC0 || || || || latin capital letter r with acute ||
|-

| U+0155 || ŕ || 0x99 || || style="background:#ebbb54;" | 0xE0 || || || || latin small letter r with acute ||
|-

| U+0158 || Ř || 0xD7 || style="background:#9ab4e3" | × || style="background:#ebbb54;" | 0xD8 || style="background:#9ab4e3" | × || style="background:#9ab4e3" | × || || latin capital letter r with caron || Substitute char "multiple sign" at 0xD7
|-

| U+0159 || ř || 0xF7 || style="background:#9ab4e3" | ÷ || style="background:#ebbb54;" | 0xF8 || style="background:#9ab4e3" | ÷ || style="background:#9ab4e3" | ÷ || || latin small letter r with caron || Substitute char "divide sign" at 0xF7
|-

| U+015A || Ś || 0x81 || || style="background:#ebbb54;" | 0xA6 || || || style="background:#ebbb54;" | 0xD7 || latin capital letter s with acute ||
|-

| U+015B || ś || 0x91 || || style="background:#ebbb54;" | 0xB6 || || || style="background:#ebbb54;" | 0xF7 || latin small letter s with acute ||
|- style="background:#dbab8a;"

| U+015C || Ŝ || 0x85 || || || || || || latin capital letter s with circumflex || Only in ISO-8859-3 (for Esperanto) at 0xDE
|- style="background:#dbab8a;"

| U+015D || ŝ || 0x95 || || || || || || latin small letter s with circumflex || Only in ISO-8859-3 (for Esperanto) at 0xFE
|-

| U+015E || Ş || 0x8D || || style="background:#ebbb54;" | 0xAA || style="background:#ebbb54;" | 0xDE || || || latin capital letter s with cedilla || Can stand in for "...comma under"
|-

| U+015F || ş || 0x9D || || style="background:#ebbb54;" | 0xBA || style="background:#ebbb54;" | 0xFE || || || latin small letter s with cedilla || Can stand in for "...comma under"
|-

| U+0160 || Š || 0xA6 || style="background:#9ab4e3" | ¦ || style="background:#ebbb54;" | 0xA9 || style="background:#9ab4e3" | ¦ || 0xA6 || 0xA6 || latin capital letter s with caron || Substitute char "broken bar" at 0xA6
|-

| U+0161 || š || 0xA8 || style="background:#9ab4e3" | ¨ || style="background:#ebbb54;" | 0xB9 || style="background:#9ab4e3" | ¨ || 0xA8 || 0xA8 || latin small letter s with caron || Substitute char "diaeresis" at 0xA8
|-

| U+0162 || Ţ || 0x8E || || style="background:#ebbb54;" | 0xDE || || || || latin capital letter t with cedilla || Can stand in for "...comma under"
|-

| U+0163 || ţ || 0x9E || || style="background:#ebbb54;" | 0xFE || || || || latin small letter t with cedilla || Can stand in for "...comma under"
|-

| U+0164 || Ť || 0xB2 || style="background:#9ab4e3" | ² || style="background:#ebbb54;" | 0xAB || style="background:#9ab4e3" | ² || style="background:#9ab4e3" | ² || || latin capital letter t with caron || Substitute char "superscript two" at 0xB2
|-

| U+0165 || ť || 0xB6 || style="background:#9ab4e3" | ¶ || style="background:#ebbb54;" | 0xBB || style="background:#9ab4e3" | ¶ || style="background:#9ab4e3" | ¶ || || latin small letter t with caron || Substitute char "pilcrow sign" at 0xB6
|-

| U+016E || Ů || 0xA9 || style="background:#9ab4e3" | © || style="background:#ebbb54;" | 0xD9 || style="background:#9ab4e3" | © || style="background:#9ab4e3" | © || || latin capital letter u with ring above || Substitute char "copyright sign" at 0xA9
|-

| U+016F || ů || 0xAF || style="background:#9ab4e3" | ¯ || style="background:#ebbb54;" | 0xF9 || style="background:#9ab4e3" | ¯ || style="background:#9ab4e3" | ¯ || || latin small letter u with ring above || Substitute char "macron" at 0xAF
|-

| U+0170 || Ű || 0xA2 || style="background:#9ab4e3" | ¢ || style="background:#ebbb54;" | 0xDB || style="background:#9ab4e3" | ¢ || style="background:#9ab4e3" | ¢ || style="background:#ebbb54;" | 0xD8 || latin capital letter u with double acute || Similiar to Ü, used in Hungarian. Substitute char "cent sign" at 0xA2
|-

| U+0171 || ű || 0xA4 || style="background:#9ab4e3" | ¤ || style="background:#ebbb54;" | 0xFB || style="background:#9ab4e3" | ¤ || style="background:#9ab4e3" | ¤ || style="background:#ebbb54;" | 0xF8 || latin small letter u with double acute || Similiar to Ü, used in Hungarian. Substitute char "currency sign" at 0xA4
|-

| U+0178 || Ÿ || 0xBE || style="background:#9ab4e3" | ¾ || || style="background:#9ab4e3" | ¾ || 0xBE || 0xBE || latin capital letter y with diaeresis || Substitute char "vulgar fraction three quarters" at 0xBE
|-

| U+0179 || Ź || 0x84 || || style="background:#ebbb54;" | 0xAC || || || style="background:#ebbb54;" | | 0xAC || latin capital letter z with acute ||
|-

| U+017A || ź || 0x94 || || style="background:#ebbb54;" | 0xBC || || || style="background:#ebbb54;" | 0xAE || latin small letter z with acute ||
|-

| U+017B || Ż || 0x83 || || style="background:#ebbb54;" | 0xAF || || || style="background:#ebbb54;" | 0xAF || latin capital letter z with dot above ||
|-

| U+017C || ż || 0x93 || || style="background:#ebbb54;" | 0xBF || || || style="background:#ebbb54;" | 0xBF || latin small letter z with dot above ||
|-

| U+017D || Ž || 0xB4 || style="background:#9ab4e3" | ´ || style="background:#ebbb54;" | 0xAE || style="background:#9ab4e3" | ´ || 0xB4 || 0xB4 || latin capital letter z with caron || Substitute char "accute accent" at 0xB4
|-

| U+017E || ž || 0xB8 || style="background:#9ab4e3" | ¸ || style="background:#ebbb54;" | 0xBE || style="background:#9ab4e3" | ¸ || 0xB8 || 0xB8 || latin small letter z with caron || Substitute char "cedilla" at 0xB8
|- style="background:#dbab8a;"

| U+01D3 || Ǔ || 0x8A || || || || || || latin capital u with caron || Not found in ISO-8859. Pinyin tone marking
|- style="background:#dbab8a;"

| U+01D4 || ǔ || 0x9A || || || || || || latin small u with caron || Not found in ISO-8859. Pinyin tone marking
|-

| U+0218 || Ș || 0x8D || || || || || style="background:#ebbb54;" | 0xAA || latin capital letter s with comma below || See also "...with cedilla"
|-

| U+0219 || ș || 0x9D || || || || || style="background:#ebbb54;" | 0xBA || latin small letter s with comma below || See also "...with cedilla"
|-

| U+021A || Ț || 0x8E || || || || || style="background:#ebbb54;" | 0xDE || latin capital letter t with comma below || See also "...with cedilla"
|-

| U+021B || ț || 0x9E || || || || || style="background:#ebbb54;" | 0xFE || latin small letter t with comma below || See also "...with cedilla"
|- style="color:#8c8c8c;"

| U+02C7 || ˇ || || || || 0xB7 || || || caron ||
|- style="color:#8c8c8c;"

| U+02D8 || ˘ || || || || 0xA2 || || || breve ||
|- style="color:#8c8c8c;"

| U+02D9 || ˙ || || || || 0xFF || || || dot above ||
|- style="color:#8c8c8c;"

| U+02DB || ˛ || || || || 0xB2 || || || ogonek ||
|- style="color:#8c8c8c;"

| U+02DD || ˝ || || || || 0xBD || || || double acute accent ||
|- style="background:#dbab8a;"

| U+1E90 || Ẑ || 0x87 || || || || || || latin capital z with circumflex || Not found in ISO-8859. Rare use in Cyrillic-to-Latin transliteration, or Pinyin
|- style="background:#dbab8a;"

| U+1E91 || ẑ || 0x97 || || || || || || latin small z with circumflex || Not found in ISO-8859. Rare use in Cyrillic-to-Latin transliteration, or Pinyin
|- style="color:#8c8c8c;"

| U+201D || ” || || || || || || 0xB5 || right double quotation mark ||
|- style="color:#8c8c8c;"

| U+201E || „ || || || || || || 0xA5 || double low-9 quotation mark ||
|- style="color:#8c8c8c;"

| U+20AC || € || || || || || 0xA4 || 0xA4 || euro sign ||
|}

== For More ==
* [[I18N - Character mapping]] sketches the format and location of <language>.map files.
* [[I18N - Charset]] is the main article about TDM language use and various encodings.

I18N - Character mapping

2026-06-19T17:21:26Z

Geep: /* Remapping */ link to Multilanguage Display, minor tweaks

The D3 code that handles the GUI bitmap font can only load a specific range of bytes as characters. To get the most out of the available entries, a special font is used (Carleton for the menu f.i.). These fonts are build/patched so that the right characters appear in the right place.

== Encodings ==

Whether used to define translation dictionaries that are system-wide (in tdm_base01.pk4/strings/) or FM-specific (in <FM>/strings/), language files (f.i. german.lang), derived from Unicode all.lang, are expected to be in the following encodings:

* '''Czech, Polish, Hungarian, Slovak:''' [https://secure.wikimedia.org/wikipedia/en/wiki/ISO/IEC_8859-2 ISO-8859-2] ('''not WIN-1250!)
* '''Russian:''' [https://secure.wikimedia.org/wikipedia/en/wiki/Win-1251 WIN-1251]
* '''Romanian:''' ISO-8859-16
* '''French:''' ISO-8859-15
* '''Turkish:''' ISO-8859-9
* '''All other languages:''' [https://secure.wikimedia.org/wikipedia/en/wiki/ISO/IEC_8859-1 ISO-8859-1]. This covers English, German, Italian, Spanish, Portuguese, Swedish, Danish, Dutch, and Catalan.

=== Remapping ===

The characters are remapped upon loading the dictionary/readable from their source encoding (e.g. ISO 8859-2) to the special character map TDM uses. Responsible for this are mapping files, f.i. "strings/czech.map". If a map file for a specific language is not found, "strings/default.map" is used instead. (Note: a default map is no longer shipped, at least since TDM 2.10 and probably much earlier. Generally, ISO-8859-1 languages don't need remapping.) This remapping is font-agnostic.

More about current regular and "trick" mappings, including a per-character table, is discussed in [[Multilanguage Display]].

The game only looks for remapping files in the tdm_base01.pk4/strings directory. So they cannot be overridden by any .map file placed in an FM's string directory.

The content of a map file is wrapped in '''{''' and '''}''', and each mapping consists of two hexadecimal numbers, the source and the target character number.

== Examples ==

For russian:

<pre>
{
0xFF 0xB6 // я
}
</pre>

For European languages in ISO 8859-2 charset (f.i. Czech):

<pre>
// a comment
{
0xF2 0xA1 // ň
0xDB 0xA2 // Ű (similiar to Ü, used in Hungarian)
0xFB 0xA4 // ű
0xA9 0xA6 // Š
0xB9 0xA8 // š
0xA1 0xAA // Ą
0xC8 0xAC // Č
0xCA 0xAB // Ę
0xE8 0xAE // č
0xD5 0xB0 // Ő (similiar to Ö, used in Hungarian)
0xA3 0xB1 // Ł
0xAb 0xB2 // Ť
0xCF 0xB3 // Ď
0xAC 0xB4 // Ž
0xB3 0xB5 // ł
0xBf 0xB6 // ż
0xEF 0xB7 // ď
0xBE 0xB8 // ž
0xF5 0xB9 // ő (similiar to ö, used in Hungarian)
0xB1 0xBA // ą
0xEA 0xBB // ę
0xF8 0xF7 // ř
0xD8 0xD7 // Ř
0xEC 0xA3 // ě
0xCC 0xA5 // Ě
0xD9 0xA9 // Ů
0xF9 0xAF // ů
0xBB 0xB6 // ť
}
</pre>
{{i18n}}* [[Font Patcher]]

[[Category:fonts]]

I18N - Charset

2026-06-19T16:07:45Z

Geep: /* Access to TDM Characters from Various Languages */ add section

== Introduction ==

The D3 code that handles the GUI bitmap font can only load a specific range of bytes as characters. To get the most out of the available entries, special charsets are used. The fonts (Carleton for the menu f.i.) are build/patched so that the right characters appear in the right place.

== LANG File Encodings ==

=== all.lang ===

This file is in '''UTF-8''', and converted with the help of either the script '''devel/gen_lang.pl''':

perl devel/gen_lang.pl

or, more recently, the Windows C++ utility program '''gen_lang_plus'''. [[Gen_Lang_Programs]] has details of these.

This process ensures that the generated language files are in their proper encodings (see below).

=== All other language files ===

Language-specific files (f.i. '''german.lang''') provide string dictionaries. A system-wide set is provided in tdm_base01.pk4/strings/. A deployed FM may offer similar files in its /strings/ folder... at the very least '''english.lang'''. All such files are expected to be in the following 8-bit encodings:

* '''Czech, Hungarian, Slovak, Polish:''' [https://secure.wikimedia.org/wikipedia/en/wiki/ISO/IEC_8859-2 ISO-8859-2] ('''not WIN-1250!)
* '''Russian:''' [https://secure.wikimedia.org/wikipedia/en/wiki/Win-1251 WIN-1251]
* '''French:''' [https://secure.wikimedia.org/wikipedia/en/wiki/ISO/IEC_8859-15 ISO-8859-15]
* '''Romanian:''' [https://secure.wikimedia.org/wikipedia/en/wiki/ISO/IEC_8859-16 ISO-8859-16]
* '''Turkish:''' [https://secure.wikimedia.org/wikipedia/en/wiki/ISO/IEC_8859-9 ISO-8859-9]
* '''All other languages:''' [https://secure.wikimedia.org/wikipedia/en/wiki/ISO/IEC_8859-1 ISO-8859-1]. This covers TDM-supported languages English, German, Italian, Spanish, Portuguese, Swedish, Danish, Dutch, and Catalan.

{{infobox|The core dictionaries are automatically generated in the right encoding, but make sure that you use the right encoding for the FM dictionary, too!}}

== Character Remapping ==

The characters are remapped upon loading the dictionary/readable, from their native encoding to the two special ones (respectively for Latin and Cyrillic) that TDM uses and that are described next. Responsible for the remapping are [[I18N - Character mapping|mapping files]], f.i. "strings/czech.map". If a map file for a specific language is not found in "tdm_base01.pk4/strings" (and there is no "default.map" there, which is the case these days), then no remapping takes place. Generally, ISO-8859-1 languages do not require remapping. The map files for the four ISO-8859-2 languages have identical content.

See '''[[I18N - Character mapping|Character mapping]]''' for more information.

== Font Encoding for European Languages ==

This TDM-specific 8-bit encoding applies to all TDM fonts for English/European languages, that is, everything except the Cyrillic-based Russian. This encoding controls the ordering within a font's binary DAT file.

Note that the double accented characters in Hungarian '''Ő, ő, Ű and ű''' look a bit different from '''Ö, ö, Ü and ü'''!

In the table below, the original ISO 8859-1 characters are given in ''()'' below the TDM character. In addition, printable characters in the range 0x80-0x9f, shown in light or dark green, are also TDM characters, replacing ISO-8859 control characters (not shown).

'''Color code:'''

{{box|#f0d0d0|Character not usable by TDM|Unusable}}{{box|#d0e0d0|Character not yet used in TDM|Unused}}{{box|#c0ffc0|Character displayed in v1.08 or newer|Usable in v1.08}}{{box|#80f080|Character displayed in v2.03 or newer|Usable in v2.03}}{{box|#d0d0f0|Changed from the ISO-8859-1 default, usable by TDM 1.0 or newer|Changed from ISO 8859-1}}

{|class="wikitable" border=1 style="border-collapse: collapse; font-size: 95%" cellspacing=0 cellpadding=2 width=100%

|-
!
!…0
!…1
!…2
!…3
!…4
!…5
!…6
!…7
!…8
!…9
!…A
!…B
!…C
!…D
!…E
!…F

|-
!0…
|align='center' style='background: #f0d0d0'|00 '''–'''
|align='center' style='background: #f0d0d0'|01 '''–'''
|align='center' style='background: #f0d0d0'|02 '''–'''
|align='center' style='background: #f0d0d0'|03 '''–'''
|align='center' style='background: #f0d0d0'|04 '''–'''
|align='center' style='background: #f0d0d0'|05 '''–'''
|align='center' style='background: #f0d0d0'|06 '''–'''
|align='center' style='background: #f0d0d0'|07 '''–'''
|align='center' style='background: #f0d0d0'|08 '''–'''
|align='center' style='background: #f0d0d0'|09 '''–'''
|align='center' style='background: #f0d0d0'|0A '''–'''
|align='center' style='background: #f0d0d0'|0B '''–'''
|align='center' style='background: #f0d0d0'|0C '''–'''
|align='center' style='background: #f0d0d0'|0D '''–'''
|align='center' style='background: #f0d0d0'|0E '''–'''
|align='center' style='background: #f0d0d0'|0F '''–'''

|-
!1…
|align='center' style='background: #f0d0d0'|10 '''–'''
|align='center' style='background: #f0d0d0'|11 '''–'''
|align='center' style='background: #f0d0d0'|12 '''–'''
|align='center' style='background: #f0d0d0'|13 '''–'''
|align='center' style='background: #f0d0d0'|14 '''–'''
|align='center' style='background: #f0d0d0'|15 '''–'''
|align='center' style='background: #f0d0d0'|16 '''–'''
|align='center' style='background: #f0d0d0'|17 '''–'''
|align='center' style='background: #f0d0d0'|18 '''–'''
|align='center' style='background: #f0d0d0'|19 '''–'''
|align='center' style='background: #f0d0d0'|1A '''–'''
|align='center' style='background: #f0d0d0'|1B '''–'''
|align='center' style='background: #f0d0d0'|1C '''–'''
|align='center' style='background: #f0d0d0'|1D '''–'''
|align='center' style='background: #f0d0d0'|1E '''–'''
|align='center' style='background: #f0d0d0'|1F '''–'''

|-
!2…
|align='center'|20 ''' '''
|align='center'|21 '''!'''
|align='center'|22 '''"'''
|align='center'|23 '''#'''
|align='center'|24 '''$'''
|align='center'|25 '''%'''
|align='center'|26 '''&'''
|align='center'|27 '''''''
|align='center'|28 '''('''
|align='center'|29 ''')'''
|align='center'|2A '''*'''
|align='center'|2B '''+'''
|align='center'|2C ''','''
|align='center'|2D '''-'''
|align='center'|2E '''.'''
|align='center'|2F '''/'''

|-
!3…
|align='center'|30 '''0'''
|align='center'|31 '''1'''
|align='center'|32 '''2'''
|align='center'|33 '''3'''
|align='center'|34 '''4'''
|align='center'|35 '''5'''
|align='center'|36 '''6'''
|align='center'|37 '''7'''
|align='center'|38 '''8'''
|align='center'|39 '''9'''
|align='center'|3A ''':'''
|align='center'|3B ''';'''
|align='center'|3C '''<'''
|align='center'|3D '''='''
|align='center'|3E '''>'''
|align='center'|3F '''?'''

|-
!4…
|align='center'|40 '''@'''
|align='center'|41 '''A'''
|align='center'|42 '''B'''
|align='center'|43 '''C'''
|align='center'|44 '''D'''
|align='center'|45 '''E'''
|align='center'|46 '''F'''
|align='center'|47 '''G'''
|align='center'|48 '''H'''
|align='center'|49 '''I'''
|align='center'|4A '''J'''
|align='center'|4B '''K'''
|align='center'|4C '''L'''
|align='center'|4D '''M'''
|align='center'|4E '''N'''
|align='center'|4F '''O'''

|-
!5…
|align='center'|50 '''P'''
|align='center'|51 '''Q'''
|align='center'|52 '''R'''
|align='center'|53 '''S'''
|align='center'|54 '''T'''
|align='center'|55 '''U'''
|align='center'|56 '''V'''
|align='center'|57 '''W'''
|align='center'|58 '''X'''
|align='center'|59 '''Y'''
|align='center'|5A '''Z'''
|align='center'|5B '''['''
|align='center'|5C '''\'''
|align='center'|5D ''']'''
|align='center'|5E '''^'''
|align='center'|5F '''_'''

|-
!6…
|align='center'|60 '''`'''
|align='center'|61 '''a'''
|align='center'|62 '''b'''
|align='center'|63 '''c'''
|align='center'|64 '''d'''
|align='center'|65 '''e'''
|align='center'|66 '''f'''
|align='center'|67 '''g'''
|align='center'|68 '''h'''
|align='center'|69 '''i'''
|align='center'|6A '''j'''
|align='center'|6B '''k'''
|align='center'|6C '''l'''
|align='center'|6D '''m'''
|align='center'|6E '''n'''
|align='center'|6F '''o'''

|-
!7…
|align='center'|70 '''p'''
|align='center'|71 '''q'''
|align='center'|72 '''r'''
|align='center'|73 '''s'''
|align='center'|74 '''t'''
|align='center'|75 '''u'''
|align='center'|76 '''v'''
|align='center'|77 '''w'''
|align='center'|78 '''x'''
|align='center'|79 '''y'''
|align='center'|7A '''z'''
|align='center'|7B '''{'''
|align='center'|7C '''|'''
|align='center'|7D '''}'''
|align='center'|7E '''~'''
|align='center' style='background: #d0e0d0'|7F '''�'''

|-
!8…
|align='center' style='background: #c0ffc0'|80 '''Ň'''
|align='center' style='background: #c0ffc0'|81 '''Ś'''
|align='center' style='background: #c0ffc0'|82 '''Ć'''
|align='center' style='background: #c0ffc0'|83 '''Ż'''
|align='center' style='background: #c0ffc0'|84 '''Ź'''
|align='center' style='background: #c0ffc0'|85 '''Ŝ'''
|align='center' style='background: #c0ffc0'|86 '''Ĉ'''
|align='center' style='background: #c0ffc0'|87 '''Ẑ'''
|align='center' style='background: #c0ffc0'|88 '''Ô''' [1]
|align='center' style='background: #c0ffc0'|89 '''Ŕ'''
|align='center' style='background: #c0ffc0'|8A '''Ǔ'''
|align='center' style='background: #c0ffc0'|8B '''Ă'''
|align='center' style='background: #c0ffc0'|8C '''Ń'''
|align='center' style='background: #80f080'|8D '''Ș'''
|align='center' style='background: #80f080'|8E '''Ț'''
|align='center' style='background: #d0e0d0'|8F '''�'''

|-
!9…
|align='center' style='background: #80f080'|90 '''đ'''
|align='center' style='background: #c0ffc0'|91 '''ś'''
|align='center' style='background: #c0ffc0'|92 '''ć'''
|align='center' style='background: #c0ffc0'|93 '''ż'''
|align='center' style='background: #c0ffc0'|94 '''ź'''
|align='center' style='background: #c0ffc0'|95 '''ŝ'''
|align='center' style='background: #c0ffc0'|96 '''ĉ'''
|align='center' style='background: #c0ffc0'|97 '''ẑ'''
|align='center' style='background: #c0ffc0'|98 '''ô''' [1]
|align='center' style='background: #c0ffc0'|99 '''ŕ'''
|align='center' style='background: #c0ffc0'|9A '''ǔ'''
|align='center' style='background: #c0ffc0'|9B '''ă'''
|align='center' style='background: #c0ffc0'|9C '''ń'''
|align='center' style='background: #80f080'|9D '''ș'''
|align='center' style='background: #80f080'|9E '''ț'''
|align='center' style='background: #d0e0d0'|9F '''�'''

|-
!A…
|align='center'|A0 '''[https://secure.wikimedia.org/wikipedia/en/wiki/Non-breaking_space NBSP]''' [2]
|align='center' style='background: #d0d0f0'|A1 '''ň''' (¡)'''
|align='center' style='background: #d0d0f0'|A2 '''Ű''' (¢)'''
|align='center' style='background: #d0d0f0'|A3 '''ě''' (£)'''
|align='center' style='background: #d0d0f0'|A4 '''ű''' (¤)'''
|align='center' style='background: #d0d0f0'|A5 '''Ě''' (¥)'''
|align='center' style='background: #d0d0f0'|A6 '''Š''' (¦)'''
|align='center'|A7 '''§'''
|align='center' style='background: #d0d0f0'|A8 '''š''' (¨)'''
|align='center' style='background: #d0d0f0'|A9 '''Ů''' (©)'''
|align='center' style='background: #d0d0f0'|AA '''Ą''' (ª)'''
|align='center' style='background: #d0d0f0'|AB '''Ę''' («)'''
|align='center' style='background: #d0d0f0'|AC '''Č''' (¬)'''
|align='center'|AD '''[https://secure.wikimedia.org/wikipedia/en/wiki/Soft_hyphen SHY]''' [2]
|align='center' style='background: #d0d0f0'|AE '''č''' (®)'''
|align='center' style='background: #d0d0f0'|AF '''ů''' (¯)'''

|-
!B…
|align='center' style='background: #d0d0f0'|B0 '''Ő''' (°)'''
|align='center' style='background: #d0d0f0'|B1 '''Ł''' (±)'''
|align='center' style='background: #d0d0f0'|B2 '''Ť''' (²)'''
|align='center' style='background: #d0d0f0'|B3 '''Ď''' (³)'''
|align='center' style='background: #d0d0f0'|B4 '''Ž''' (´)'''
|align='center' style='background: #d0d0f0'|B5 '''ł''' (µ)'''
|align='center' style='background: #d0d0f0'|B6 '''ť''' (¶)'''
|align='center' style='background: #d0d0f0'|B7 '''ď''' (·)'''
|align='center' style='background: #d0d0f0'|B8 '''ž''' (¸)'''
|align='center' style='background: #d0d0f0'|B9 '''ő''' (¹)'''
|align='center' style='background: #d0d0f0'|BA '''ą''' (º)'''
|align='center' style='background: #d0d0f0'|BB '''ę''' (»)'''
|align='center' style='background: #d0d0f0'|BC '''Œ''' (¼)'''
|align='center' style='background: #d0d0f0'|BD '''œ''' (½)'''
|align='center' style='background: #d0d0f0'|BE '''Ÿ''' (¾)'''
|align='center'|BF '''¿'''

|-
!C…
|align='center'|C0 '''À'''
|align='center'|C1 '''Á'''
|align='center'|C2 '''Â'''
|align='center'|C3 '''Ã'''
|align='center'|C4 '''Ä'''
|align='center'|C5 '''Å'''
|align='center'|C6 '''Æ'''
|align='center'|C7 '''Ç'''
|align='center'|C8 '''È'''
|align='center'|C9 '''É'''
|align='center'|CA '''Ê'''
|align='center'|CB '''Ë'''
|align='center'|CC '''Ì'''
|align='center'|CD '''Í'''
|align='center'|CE '''Î'''
|align='center'|CF '''Ï'''

|-
!D…
|align='center'|D0 '''Ð'''
|align='center'|D1 '''Ñ'''
|align='center'|D2 '''Ò'''
|align='center'|D3 '''Ó'''
|align='center'|D4 '''Ô'''
|align='center'|D5 '''Õ'''
|align='center'|D6 '''Ö'''
|align='center' style='background: #d0d0f0'|D7 '''Ř''' (×)'''
|align='center'|D8 '''Ø'''
|align='center'|D9 '''Ù'''
|align='center'|DA '''Ú'''
|align='center'|DB '''Û'''
|align='center'|DC '''Ü'''
|align='center'|DD '''Ý'''
|align='center'|DE '''Þ'''
|align='center'|DF '''ß'''

|-
!E…
|align='center'|E0 '''à'''
|align='center'|E1 '''á'''
|align='center'|E2 '''â'''
|align='center'|E3 '''ã'''
|align='center'|E4 '''ä'''
|align='center'|E5 '''å'''
|align='center'|E6 '''æ'''
|align='center'|E7 '''ç'''
|align='center'|E8 '''è'''
|align='center'|E9 '''é'''
|align='center'|EA '''ê'''
|align='center'|EB '''ë'''
|align='center'|EC '''ì'''
|align='center'|ED '''í'''
|align='center'|EE '''î'''
|align='center'|EF '''ï'''

|-
!F…
|align='center'|F0 '''ð'''
|align='center'|F1 '''ñ'''
|align='center'|F2 '''ò'''
|align='center'|F3 '''ó'''
|align='center'|F4 '''ô'''
|align='center'|F5 '''õ'''
|align='center'|F6 '''ö'''
|align='center' style='background: #d0d0f0'|F7 '''ř''' (÷)'''
|align='center'|F8 '''ø'''
|align='center'|F9 '''ù'''
|align='center'|FA '''ú'''
|align='center'|FB '''û'''
|align='center'|FC '''ü'''
|align='center'|FD '''ý'''
|align='center'|FE '''þ'''
|align='center'|FF '''ÿ'''

|}

==== Table Notes ====

'''[1]''' As discussed [https://forums.thedarkmod.com/index.php?/topic/22427-analysis-of-212-tdm-fonts/&do=findComment&comment=494855 here], the TDM char set has a redundant treatment of 2 characters:

* Ô appears at 0x88 and 0xD4
* ô appears at 0x98 and 0xF4

Starting with TDM 2.13, the redundancy can be removed and these new characters (from ISO-8859-3) introduced:

* Ğ appears at 0x88
* ğ appears at 0x98

'''[2]''' Avoid using the non-breaking space (NBSP, 0xA0) and the soft hyphen (SHY, 0xAD) in your strings. The TDM engine has no code to respect these during word wrap. Font maintainers: probably map NBSP to the <space> glyph, SHY to undefined/hollow box or zero-sized box.

==== Corresponding Unicode ====

For a mapping of these 256 codepoints to Unicode U+NNNN values and formal names, download 'TDM 8859-Style Font Map to Unicode-16.txt':

* [https://drive.google.com/file/d/1wLEtuFvnrZ-WHK8ign8i3diIXZdriZ4F/view?usp=sharing for TDM 2.13]
* [https://drive.google.com/file/d/1UAz9jSZpT_j33STP3So_Re8JWa8QuAmz/view?usp=sharing for TDM 2.12 and earlier]

Each of these files (by Geep, 2024) is in a standardized format so that it can also be imported into font design programs like FontForge as a custom 256-position map. In the comments, there is additional information about:
* ISO 8859-x sourcing of each character.
* alternative representations of some European and control characters.

==== Access to TDM Characters from Various Languages ====
See [[Multilanguage Display]], which includes an itemized table of characters across TDM/ISO codemaps. This discusses which characters (assuming the font implements them) the translator can...
* enter directly
* enter by tricks
* not currently access.

==== Fonts with Special Characters ====
Certain fonts have a few codepoints that purposefully diverge from the table entry.

* Carleton font (regular, bold, glow) uses codepoint 0x23, ordinarily "#", to represent "superscript #", which is used in the main menu system to indicate FMs for which a translation pack is available.
* Treasure Map font has characters for "pirate skull and crossbones" and "bottle of booze (or poison)".

== European Character Implementation ==
=== Priority Early-On - the "Top 50" ===

Some of the special characters are used more often than others. Here is a statistic over the entire string set of the TDM core, from TDM v1.08, showing the top 50 most-used characters (excluding a-z, 0-9 and russian characters):

{|class="wikitable" border=1 style="border-collapse: collapse; font-size: 85%" cellspacing=0 cellpadding=2

|-
|Rank
|Occurances
|Letter
|Remarks
|Rank
|Occurances
|Letter
|Remarks

|-
|1
|í
|715
|
|25
|ć
|67
|

|-
|2
|é
|674
|
|26
|è
|65
|

|-
|3
|á
|524
|
|27
|ú
|56
|

|-
|4
|ø
|303
|Danish
|28
|ê
|52
|

|-
|5
|č
|288
|
|29
|ö
|48
|German

|-
|6
|ó
|283
|
|30
|É
|46
|

|-
|7
|ü
|270
|German
|31
|ñ
|37
|

|-
|8
|ł
|203
|Polish
|32
|õ
|32
|

|-
|9
|æ
|200
|Danish
|33
|ń
|26
|

|-
|10
|ě
|182
|
|34
|Ł
|24
|

|-
|11
|ř
|175
|Czech
|35
|Š
|21
|

|-
|12
|ã
|168
|
|36
|â
|21
|

|-
|13
|ž
|148
|Czech
|37
|ź
|20
|

|-
|14
|ý
|142
|
|38
|ß
|18
|German

|-
|15
|ę
|141
|
|39
|Ó
|18
|

|-
|16
|ą
|140
|
|40
|ň
|15
|

|-
|17
|ż
|119
|
|41
|Ú
|15
|

|-
|18
|å
|109
|Danish
|42
|Á
|13
|

|-
|19
|š
|99
|
|43
|î
|12
|

|-
|20
|ś
|97
|
|44
|ť
|11
|

|-
|21
|ç
|91
|
|45
|ô
|9
|

|-
|22
|ä
|86
|German
|46
|Ž
|8
|

|-
|23
|à
|83
|
|47
|Ż
|7
|

|-
|24
|ů
|77
|
|48
|Č
|7
|

|-
|25
|ć
|67
|
|49
|ù
|6
|

|}

Although ö, ä and ü do not appear that often, with only these and Ü, Ö, Ä and ß, the entire German language works. So adding these letters to the fonts is quite important.

Preferably, all foreign letters would be added to the fonts (see [[Font Patcher]] or [[Refont]]). However, if time permits only adding a few, '''í''' would be more important than, say, '''ô'''.

It is commonplace for missing accented letters to be redirected in the .dat file to the corresponding unaccented base letter.

=== Coverage Expansion & Remaining Limitations ===

By 2014, all the system (e.g., main menu) fonts (Carleton, Carleton_condensed, Stone in sizes 24pt and 48pt; Mason and Mason_glow in 48pt) had good coverage of the "Top 50" and beyond, although not all 256 codepoints.
This was confirmed more specifically in 2024, as part of an [https://forums.thedarkmod.com/index.php?/topic/22427-analysis-of-212-tdm-fonts/ Analysis of 2.12 Fonts]. This analysis indicated that, unlike the system fonts, the FM fonts generally did not provide specific glyphs beyond ASCII.

In 2024, Stone 24pt, important for subtitles and a number of readables, was further extended to cover all 256 codepoints. This was tested with TDM 2.13[betas] and released with 2.14.

In 2026, English/European Carleton 24pt, widely used in the main menu and also some readables, was improved to:
* extend coverage to all codepoints
* replace sloppy hand-drawn Latin-1 glyphs with fresh glyphs, most of them generated from TTF then edge-darkened
* for simplicity, re-implement the red "glow" effect as if a drop-shadow.

Testing of this is planned with TDM 2.15 betas.

Stone 48pt improvements are under consideration for TDM 2.15.

== Font Encoding for Russian Cyrillic ==

Characters conform to the [https://en.wikipedia.org/wiki/Win-1251 WIN-1251 native encoding, shown in the Wikipedia article]. Exception: the character '''0xFF''' (я) is mapped to '''0xB6''' upon loading. Therefore any Russian font must contain я at the place 0xB6. (This was to overcome a historical Doom3 bug that is now fixed. But to date "the remapping for Russian is still in place, tho, to avoid having to patch all the russian fonts", says bug report [https://bugs.thedarkmod.com/view.php?id=2812 "0002812: Character 0xFF does not work in fonts"]).

=== Cyrillic Character Implementation ===
Within any given font, character coverage may be incomplete.

In 2025, the Russian Mason 48pt font was improved and extended to cover all TDM Russian codepoints, and included in TDM 2.14.

== Future Extensions to Unicode and/or Asian Languages (Korean, Chinese, Japanese)? ==

It is possible to visualize a transition to a DAT format (and engine code) that supported UCS (16-bit) Unicode, allowing the existing fonts to then be expanded to cover more characters. Then perhaps all.lang would be the only .lang needed.

As for Asian languages, the original D3 had support for them, so it might be possible to add them to TDM, too, but with a heavy burden on font development and translation. Also, writing from right-to-left (Hebrew) or top-down (Japanese) might be tricky or outright impossible in our GUI without more work in the C++ code. Plus, these languages use more than 256 different characters, and an 8 bit table will not hold these.

[[Category:Fonts]]

{{i18n}}

Multilanguage Display

2026-06-19T15:50:36Z

Geep: finalize for now

== Background ==
''This describes a particular challenging use case of a TDM methodology that has been around for some time. The motivation to detail this was a 2026 update by Geep to the language map files, following a revision of Carleton 24pt font used throughout the Main Menu.''

In TDM's main menu, the Settings/Video/Language page attempts to list all the supported languages in their native form with respect to character set, that is, untranslated. Showing multiple language strings together is difficult, but some tricks are available. The result has been a reasonable near-term workaround for this particular page, applicable to comparable cases. (Comprehensive support for multilanguage display likely involves a major restructuring, for instance, moving to a native Unicode architecture with combined Latin and Cyrillic bitmaps.)

Recall that strings for the main menu are found in the utf8 file tdm_base01.pk4/strings/all.lang, where there is are sections for [English], [German], etc. A particular section is used to generate for distribution the corresponding file, e.g., french.lang, german.lang, etc., in a language-specific 8-bit encoding. When you play TDM, and select a given language, the corresponding .lang file (if needed) is read.

Except for Cyrillic Russian, these files use encodings within the ISO-8859 family (as detailed in [[I18N_-_Charset]]). Any specific encoding is a bottleneck... by design, not all characters in any one member of the ISO-8859 family will be accessible by some other members.

== Language Names in Idealized UTF8 Form ==
Only the TDM-exposed languages are shown here. The all.lang file has additional strings for other potential Latin and Cyrillic languages. For reference, the generated encoding for the <language>.lang file is shown in the comment.

"#str_02460" "English" // English [ISO-8859-1]
"#str_02461" "Deutsch" // German [ISO-8859-1]
"#str_02462" "Español" // Spanish [ISO-8859-1]
"#str_02463" "Français" // French [ISO-8859-15]
"#str_02464" "Português" // Portuguese [ISO-8859-1]
"#str_02465" "Polski" // Polish [ISO-8859-2]
"#str_02466" "Italiano" // Italian [ISO-8859-1]
"#str_02467" "Česky" // Czech [ISO-8859-2]
"#str_02468" "Русский" // Russian [WIN-1251]
"#str_02469" "Català" // Catalan [ISO-8859-1]
"#str_02470" "Dansk" // Danish [ISO-8859-1]
"#str_02472" "Nederlands" // Dutch [ISO-8859-1]
"#str_02474" "Magyar" // Hungarian [ISO-8859-2]
"#str_02476" "Svenska" // Swedish [ISO-8859-1]
"#str_02477" "Türkçe" // Turkish [ISO-8859-9]
"#str_02479" "Română" // Romanian [ISO-8859-16]
"#str_02480" "Slovenčina" // Slovak [ISO-8859-2]

== First Compromise – Cyrillic vs. Latin Font ==
While there is some overlap in characters between Cyrillic and Latin encodings, it is insufficient for our purposes. So, for [English] and other European sections, a Latin transliteration from Cyrillic is used:

"#str_02468" "Russkiy" // Russian

Going the other way, for [Russian], the current treatment is not to do a Cyrillic transliteration from Latin, but instead to drop accents, rendering just in ASCII (except of course “Russian”), e.g.:

"#str_02460" "English" // English
"#str_02461" "Deutsch" // German
"#str_02462" "Espanol" // Spanish
"#str_02463" "Francais" // French
"#str_02464" "Portugues" // Portuguese
"#str_02465" "Polski" // Polish
"#str_02466" "Italiano" // Italian
"#str_02467" "Cesky" // Czech
"#str_02468" "Русский" // Russian
"#str_02469" "Catala" // Catalan
"#str_02470" "Dansk" // Danish
"#str_02472" "Nederlands" // Dutch
"#str_02474" "Magyar" // Hungarian
"#str_02476" "Svenska" // Swedish
"#str_02477" "Turkce" // Turkish
"#str_02479" "Romana" // Romanian
"#str_02480" "Slovencina" // Slovak

== Moving between ISO-8859 Members ==
In the discussion here, let “L1” be the current language (from the player’s perspective) or the [language] section of interest in all.lang (from the translator’s perspective). Let “L2” be the language of the foreign word, i.e., L1 and L2 differ.

=== Type and Go ===
In several cases, the translator merely puts the ideal character in the all.lang strings. After <language>.lang generation, everything works. Cases are:

# L1 and L2 are both use the same ISO-8859 encoding. (Specifically, they are either both ISO-8859-1, which doesn’t need <language>.map files, or both ISO-8859-2, and have <language>.map files with, by convention, identical contents.) NOTE: For TDM’s purposes, ISO-8859-15 (French) can be considered part of the ISO-8859-1 family.
# L2 character is ASCII (i.e., in ISO range 0x00-0x7f). This is always the case if L2 = English. Characters in this range have identical codepoints in all five TDM-supported ISO-8859 and in the TDM target encoding.
# L2 character is in the ISO range 0xA0-0xFF, with additional constraints.

For the last case, the L2 character must be either:
* present at the same codepoint in all five TDM-supported ISO-8859 encodings, and in the TDM target encoding. For our Latin language names, these accented characters are like that:
ç in "Français" and "Türkçe" at 0xE7
à in "Català" at 0xEA
â in "Română" at 0xE2
ü in "Türkçe" at 0xFC
* present at the same codepoint in ISO-8859 encodings for L1 and L2, and in the TDM target encoding.
* present in different codepoints in ISO-8859 encodings for L1 and L2, but with each being either the same as the TDM target encoding, or mapped to the TDM target encoding by the <language>.map file.

=== Tricks ===
If the L2 character is not represented in the ISO encoding for L1, then at <L1>.lang generation time, it will be replaced by a “?”. To work around this, the translator has two methods:

====Trick Method 1 – Direct Stuffing====
When L1 encoding is ISO-8859-1 (or -9 or -15, which all have identical encodings for the 0xA0-BF ranges) and L2 character is in TDM’s 0xA0-0xBF range (or D7, F7), then you can lookup the ISO character associated with that codepoint (shown in parentheses in cells of the i18n- charmap table), and type it. Examples:

[English] // and other ISO-8859-1, -9, or -15
"#str_02467" "¬esky" // our default mapping is ISO 8859-1, so ¬ is shown as Č (¬)
"#str_02480" "Sloven®ina" // Slovak (® in ISO-8859-1 is č in our font)

Here’s another example of that last stuffing from a TDM-unexposed language, showing also a diaresis (0xA8):

"#str_02481" "Sloven¨®ina" // Slovenian (southern slovenia) (¨ => š)

In this case, ISO-8859-1 would need to use the diaresis, but ISO-8859-15 (French) would not, i.e., could type and go with š.
The spreadsheet shows all available substitutions in light blue.

====Trick Method 2 – Special Mapping with Repurposed Character====
If all else fails, a little-used character in L1 can be redirected to the L2 codepoint TDM wants, by an extra mapping command in the <L1>.map file. Current such tricks are...

To get ñ for "Español":

* for iso 2, put ¨ (diaeresis 0xA8)
* for iso 16, put ¶ (pilcrow 0xB6)

To get ê for "Português":

*for iso 2: Put ´ (acute accent 0xBD)

== TDM & ISO Char Sets - Details, Potential Tricks, Limitations ==

The main table below (after the Key) was drafted by Google AI, from a prompt that defined the header and an example row, and specified:

"Rows are a combination of all the printable 8-bit codepoints in the range 0x80-0xff defined in ISO-8859-1, -2, -9, -15, and -16. The rows are ordered by Unicode number. If a particular ISO standard does not include the character, leave that cell blank."

Subsequently, after Excel import, the TDM and Comments columns were filled in by Geep, and color coding added. Language mappings were independently color coded, then verified against existing language maps. Finally converted to wikitable format.

This table skips codepoints in the range 0x00-0x7f, because they are the same for all ISO-8859 standards. No mapping required.

{| class="wikitable" style="font-size: 95%; line-height: 1.3em;"
|+ Color Key
! Cell !! Meaning
|-

| style="color:#8c8c8c;" | Light Gray Text Row || Symbol not included in TDM custom character set (so TDM column blank). Can use for char substitution tricks.
|-

| 0xNN on white || Type desired utf8 char (in Symbol column) in all.lang. Generation goes directly to TDM codepoint given.
|-

| style="background:#ebbb54;" | 0xNN, amber hilite || Type desired utf8 char in all.lang. Generation + mapping (in <language>.map file) goes to TDM codepoint via codepoint shown.
|-

| style="background:#ebbb54;color:#606060;" | 0xNN in gray || Type desired utf8 char in all.lang. Generation + mapping (in <language>.map file) goes to TDM codepoint OF SUBSTITUTE CHARACTER via codepoint shown.
|-

| style="background:#ebbb54;color:#ff0000;" | 0xNN in red || Character not part of this ISO. "0xnn" shown is not ISO, but for trick mapping (in <language.map), to support main menu's multilingual "Languages" page.
|-

| style="background:#9ab4e3;" | Substitute Char || Character not part of this ISO. But as trick, you can stuff in this substitute char at the needed TDM codepoint.
|-

| style="background:#43a8cc;" | n/a || Not available to use substitute character, due to trick mapping (in <language>.map) elsewhere.
|-

| Empty Cell || In ISO column, means character not part of this ISO (so may be candidate for future trick mapping; or simply not fully analyzed viz substitute char.)
|-

| style="background:#dbab8a;" | Tan Row || Orphaned character in TDM set, not part of 5 ISO-8859 standards for current TDM-supported languages.
|-
|}

{| class="wikitable" style="font-size: 95%; line-height: 1.3em;"
|+ Unicode Coverage for TDM
! Unicode !! Symbol !! TDM !! 1 !! 2 !! 9 !! 15 !! 16 !! Unicode Name !! Comments
|-

| U+00A0 ||   || 0xA0 || 0xA0 || 0xA0 || 0xA0 || 0xA0 || 0xA0 || no-break space ||
|- style="color:#8c8c8c;"

| U+00A1 || ¡ || || 0xA1 || || 0xA1 || 0xA1 || || inverted exclamation mark ||
|- style="color:#8c8c8c;"

| U+00A2 || ¢ || || 0xA2 || || 0xA2 || 0xA2 || || cent sign ||
|- style="color:#8c8c8c;"

| U+00A3 || £ || || 0xA3 || || 0xA3 || 0xA3 || || pound sign ||
|- style="color:#8c8c8c;"

| U+00A4 || ¤ || || 0xA4 || 0xA4 || 0xA4 || || || currency sign ||
|- style="color:#8c8c8c;"

| U+00A5 || ¥ || || 0xA5 || || 0xA5 || 0xA5 || || yen sign ||
|- style="color:#8c8c8c;"

| U+00A6 || ¦ || || 0xA6 || || 0xA6 || || || broken bar ||
|-

| U+00A7 || § || 0xA7 || 0xA7 || 0xA7 || 0xA7 || 0xA7 || 0xA7 || section sign ||
|- style="color:#8c8c8c;"

| U+00A8 || ¨ || || 0xA8 || 0xA8 || 0xA8 || || || diaeresis || See also hack use for ñ
|- style="color:#8c8c8c;"

| U+00A9 || © || || 0xA9 || || 0xA9 || 0xA9 || 0xA9 || copyright sign ||
|- style="color:#8c8c8c;"

| U+00AA || ª || || 0xAA || || 0xAA || 0xAA || || feminine ordinal indicator ||
|- style="color:#8c8c8c;"

| U+00AB || « || || 0xAB || || 0xAB || 0xAB || 0xAB || left-pointing double angle quotation mark ||
|- style="color:#8c8c8c;"

| U+00AC || ¬ || || 0xAC || || 0xAC || 0xAC || || not sign ||
|-

| U+00AD || || 0xAD || 0xAD || 0xAD || 0xAD || 0xAD || 0xAD || soft hyphen ||
|- style="color:#8c8c8c;"

| U+00AE || ® || || 0xAE || || 0xAE || 0xAE || || registered sign ||
|- style="color:#8c8c8c;"

| U+00AF || ¯ || || 0xAF || || 0xAF || 0xAF || || macron ||
|- style="color:#8c8c8c;"

| U+00B0 || ° || || 0xB0 || 0xB0 || 0xB0 || 0xB0 || 0xB0 || degree sign ||
|- style="color:#8c8c8c;"

| U+00B1 || ± || || 0xB1 || || 0xB1 || 0xB1 || 0xB1 || plus-minus sign ||
|- style="color:#8c8c8c;"

| U+00B2 || ² || || 0xB2 || || 0xB2 || 0xB2 || || superscript two ||
|- style="color:#8c8c8c;"

| U+00B3 || ³ || || 0xB3 || || 0xB3 || 0xB3 || || superscript three ||
|- style="color:#8c8c8c;"

| U+00B4 || ´ || || 0xB4 || 0xB4 || 0xB4 || || || acute accent ||
|- style="color:#8c8c8c;"

| U+00B5 || µ || || 0xB5 || || 0xB5 || 0xB5 || || micro sign ||
|- style="color:#8c8c8c;"

| U+00B6 || ¶ || || 0xB6 || || 0xB6 || 0xB6 || 0xB6 || pilcrow sign ||
|- style="color:#8c8c8c;"

| U+00B7 || · || || 0xB7 || || 0xB7 || 0xB7 || 0xB7 || middle dot ||
|- style="color:#8c8c8c;"

| U+00B8 || ¸ || || 0xB8 || 0xB8 || 0xB8 || || || cedilla ||
|- style="color:#8c8c8c;"

| U+00B9 || ¹ || || 0xB9 || || 0xB9 || 0xB9 || || superscript one ||
|- style="color:#8c8c8c;"

| U+00BA || º || || 0xBA || || 0xBA || 0xBA || || masculine ordinal indicator ||
|- style="color:#8c8c8c;"

| U+00BB || » || || 0xBB || || 0xBB || 0xBB || 0xBB || right-pointing double angle quotation mark ||
|- style="color:#8c8c8c;"

| U+00BC || ¼ || || 0xBC || || 0xBC || || || vulgar fraction one quarter ||
|- style="color:#8c8c8c;"

| U+00BD || ½ || || 0xBD || || 0xBD || || || vulgar fraction one half ||
|- style="color:#8c8c8c;"

| U+00BE || ¾ || || 0xBE || || 0xBE || || || vulgar fraction three quarters ||
|-

| U+00BF || ¿ || 0xBF || 0xBF || || 0xBF || 0xBF || || inverted question mark ||
|-

| U+00C0 || À || 0xC0 || 0xC0 || || 0xC0 || 0xC0 || 0xC0 || latin capital letter a with grave ||
|-

| U+00C1 || Á || 0xC1 || 0xC1 || 0xC1 || 0xC1 || 0xC1 || 0xC1 || latin capital letter a with acute ||
|-

| U+00C2 || Â || 0xC2 || 0xC2 || 0xC2 || 0xC2 || 0xC2 || 0xC2 || latin capital letter a with circumflex ||
|-

| U+00C3 || Ã || 0xC3 || 0xC3 || || 0xC3 || 0xC3 || || latin capital letter a with tilde ||
|-

| U+00C4 || Ä || 0xC4 || 0xC4 || 0xC4 || 0xC4 || 0xC4 || 0xC4 || latin capital letter a with diaeresis ||
|-

| U+00C5 || Å || 0xC5 || 0xC5 || || 0xC5 || 0xC5 || || latin capital letter a with ring above ||
|-

| U+00C6 || Æ || 0xC6 || 0xC6 || || 0xC6 || 0xC6 || 0xC6 || latin capital letter ae ||
|-

| U+00C7 || Ç || 0xC7 || 0xC7 || 0xC7 || 0xC7 || 0xC7 || 0xC7 || latin capital letter c with cedilla ||
|-

| U+00C8 || È || 0xC8 || 0xC8 || || 0xC8 || 0xC8 || 0xC8 || latin capital letter e with grave ||
|-

| U+00C9 || É || 0xC9 || 0xC9 || 0xC9 || 0xC9 || 0xC9 || 0xC9 || latin capital letter e with acute ||
|-

| U+00CA || Ê || 0xCA || 0xCA || || 0xCA || 0xCA || 0xCA || latin capital letter e with circumflex ||
|-

| U+00CB || Ë || 0xCB || 0xCB || 0xCB || 0xCB || 0xCB || 0xCB || latin capital letter e with diaeresis ||
|-

| U+00CC || Ì || 0xCC || 0xCC || || 0xCC || 0xCC || 0xCC || latin capital letter i with grave ||
|-

| U+00CD || Í || 0xCD || 0xCD || 0xCD || 0xCD || 0xCD || 0xCD || latin capital letter i with acute ||
|-

| U+00CE || Î || 0xCE || 0xCE || 0xCE || 0xCE || 0xCE || 0xCE || latin capital letter i with circumflex ||
|-

| U+00CF || Ï || 0xCF || 0xCF || || 0xCF || 0xCF || 0xCF || latin capital letter i with diaeresis ||
|-

| U+00D0 || Ð || 0xD0 || 0xD0 || || style="background:#43a8cc;" | n/a || 0xD0 || || latin capital letter eth || Same glyph as U+0110 latin capital letter d with stroke
|-

| U+00D1 || Ñ || 0xD1 || 0xD1 || || 0xD1 || 0xD1 || || latin capital letter n with tilde ||
|-

| U+00D2 || Ò || 0xD2 || 0xD2 || || 0xD2 || 0xD2 || 0xD2 || latin capital letter o with grave ||
|-

| U+00D3 || Ó || 0xD3 || 0xD3 || 0xC1 || 0xD3 || 0xD3 || 0xD3 || latin capital letter o with acute ||
|-

| U+00D4 || Ô || 0xD4 || 0xD4 || 0xD4 || 0xD4 || 0xD4 || 0xD4 || latin capital letter o with circumflex || Formerly also mapped from 0x88; redundant, Ğ has 0x88 codepoint now
|-

| U+00D5 || Õ || 0xD5 || 0xD5 || || 0xD5 || 0xD5 || || latin capital letter o with tilde ||
|-

| U+00D6 || Ö || 0xD6 || 0xD6 || 0xD6 || 0xD6 || 0xD6 || 0xD6 || latin capital letter o with diaeresis ||
|- style="color:#8c8c8c;"

| U+00D7 || × || || 0xD7 || 0xD7 || 0xD7 || 0xD7 || || multiplication sign ||
|-

| U+00D8 || Ø || 0xD8 || 0xD8 || || 0xD8 || 0xD8 || || latin capital letter o with stroke ||
|-

| U+00D9 || Ù || 0xD9 || 0xD9 || || 0xD9 || 0xD9 || 0xD9 || latin capital letter u with grave ||
|-

| U+00DA || Ú || 0xDA || 0xDA || 0xDA || 0xDA || 0xDA || 0xDA || latin capital letter u with acute ||
|-

| U+00DB || Û || 0xDB || 0xDB || || 0xDB || 0xDB || 0xDB || latin capital letter u with circumflex ||
|-

| U+00DC || Ü || 0xDC || 0xDC || 0xDC || 0xDC || 0xDC || 0xDC || latin capital letter u with diaeresis ||
|-

| U+00DD || Ý || 0xDD || 0xDD || 0xDD || || 0xDD || || latin capital letter y with acute ||
|-

| U+00DE || Þ || 0xDE || 0xDE || || || 0xDE || || latin capital letter thorn ||
|-

| U+00DF || ß || 0xDF || 0xDF || 0xDF || 0xDF || 0xDF || 0xDF || latin small letter sharp s ||
|-

| U+00E0 || à || 0xE0 || 0xE0 || || 0xE0 || 0xE0 || 0xE0 || latin small letter a with grave ||
|-

| U+00E1 || á || 0xE1 || 0xE1 || 0xE1 || 0xE1 || 0xE1 || 0xE1 || latin small letter a with acute ||
|-

| U+00E2 || â || 0xE2 || 0xE2 || 0xE2 || 0xE2 || 0xE2 || 0xE2 || latin small letter a with circumflex ||
|-

| U+00E3 || ã || 0xE3 || 0xE3 || || 0xE3 || 0xE3 || || latin small letter a with tilde ||
|-

| U+00E4 || ä || 0xE4 || 0xE4 || 0xE4 || 0xE4 || 0xE4 || 0xE4 || latin small letter a with diaeresis ||
|-

| U+00E5 || å || 0xE5 || 0xE5 || || 0xE5 || 0xE5 || || latin small letter a with ring above ||
|-

| U+00E6 || æ || 0xE6 || 0xE6 || || 0xE6 || 0xE6 || 0xE6 || latin small letter ae ||
|-

| U+00E7 || ç || 0xE7 || 0xE7 || 0xE7 || 0xE7 || 0xE7 || 0xE7 || latin small letter c with cedilla ||
|-

| U+00E8 || è || 0xE8 || 0xE8 || || 0xE8 || 0xE8 || 0xE8 || latin small letter e with grave ||
|-

| U+00E9 || é || 0xE9 || 0xE9 || 0xE9 || 0xE9 || 0xE9 || 0xE9 || latin small letter e with acute ||
|-

| U+00EA || ê || 0xEA || 0xEA || style="background:#ebbb54;color:#ff0000;" | 0xBD || 0xEA || 0xEA || 0xEA || latin small letter e with circumflex || Hack for iso 2: Put ´ (acute accent, 0xBD) to get ê for "Português"
|-

| U+00EB || ë || 0xEB || 0xEB || 0xEB || 0xEB || 0xEB || 0xEB || latin small letter e with diaeresis ||
|-

| U+00EC || ì || 0xEC || 0xEC || || 0xEC || 0xEC || 0xEC || latin small letter i with grave ||
|-

| U+00ED || í || 0xED || 0xED || 0xED || 0xED || 0xED || 0xED || latin small letter i with acute ||
|-

| U+00EE || î || 0xEE || 0xEE || 0xEE || 0xEE || 0xEE || 0xEE || latin small letter i with circumflex ||
|-

| U+00EF || ï || 0xEF || 0xEF || || 0xEF || 0xEF || 0xEF || latin small letter i with diaeresis ||
|-

| U+00F0 || ð || 0xF0 || 0xF0 || || || 0xF0 || || latin small letter eth ||
|-

| U+00F1 || ñ || 0xF1 || 0xF1 || style="background:#ebbb54;color:#ff0000;" | 0xA8 || 0xF1 || 0xF1 || style="background:#ebbb54;color:#ff0000;" | 0xB6 || latin small letter n with tilde || Hacks to get ñ for "Español": for iso 2, put ¨ (diaeresis 0xA8); for iso 16, put ¶ (0xB6)
|-

| U+00F2 || ò || 0xF2 || 0xF2 || || 0xF2 || 0xF2 || 0xF2 || latin small letter o with grave ||
|-

| U+00F3 || ó || 0xF3 || 0xF3 || 0xF3 || 0xF3 || 0xF3 || 0xF3 || latin small letter o with acute ||
|-

| U+00F4 || ô || 0xF4 || 0xF4 || 0xF4 || 0xF4 || 0xF4 || 0xF4 || latin small letter o with circumflex || Formerly also mapped from 0x88; redundant, ğ has TDM 0x88 codepoint now
|-

| U+00F5 || õ || 0xF5 || 0xF5 || || 0xF5 || 0xF5 || || latin small letter o with tilde ||
|-

| U+00F6 || ö || 0xF6 || 0xF6 || 0xF6 || 0xF6 || 0xF6 || 0xF6 || latin small letter o with diaeresis ||
|- style="color:#8c8c8c;"

| U+00F7 || ÷ || || 0xF7 || 0xF7 || 0xF7 || 0xF7 || || division sign ||
|-

| U+00F8 || ø || 0xF8 || 0xF8 || || 0xF8 || 0xF8 || || latin small letter o with stroke ||
|-

| U+00F9 || ù || 0xF9 || 0xF9 || || 0xF9 || 0xF9 || 0xF9 || latin small letter u with grave ||
|-

| U+00FA || ú || 0xFA || 0xFA || 0xFA || 0xFA || 0xFA || 0xFA || latin small letter u with acute ||
|-

| U+00FB || û || 0xFB || 0xFB || || 0xFB || 0xFB || 0xFB || latin small letter u with circumflex ||
|-

| U+00FC || ü || 0xFC || 0xFC || 0xFC || 0xFC || 0xFC || 0xFC || latin small letter u with diaeresis ||
|-

| U+00FD || ý || 0xFD || 0xFD || 0xFD || || 0xFD || || latin small letter y with acute ||
|-

| U+00FE || þ || 0xFE || 0xFE || || || 0xFE || || latin small letter thorn ||
|-

| U+00FF || ÿ || 0xFF || 0xFF || || 0xFF || 0xFF || 0xFF || latin small letter y with diaeresis ||
|-

| U+0102 || Ă || 0x8B || || style="background:#ebbb54;" | 0xC3 || || || style="background:#ebbb54;" | 0xC3 || latin capital letter a with breve ||
|-

| U+0103 || ă || 0x9B || || style="background:#ebbb54;" | 0xE3 || || || style="background:#ebbb54;" | 0xE3 || latin small letter a with breve ||
|-

| U+0104 || Ą || 0xAA || style="background:#9ab4e3" | ª || style="background:#ebbb54;" | 0xA1 || style="background:#9ab4e3" | ª || style="background:#9ab4e3" | ª || style="background:#ebbb54;" | 0xA1 || latin capital letter a with ogonek ||
|-

| U+0105 || ą || 0xBA || style="background:#9ab4e3" | º || style="background:#ebbb54;" | 0xB1 || style="background:#9ab4e3" | º || style="background:#9ab4e3" | º || style="background:#ebbb54;" | 0xA2 || latin small letter a with ogonek ||
|-

| U+0106 || Ć || 0x82 || || style="background:#ebbb54;" | 0xC6 || || || style="background:#ebbb54;" | 0xC5 || latin capital letter c with acute ||
|-

| U+0107 || ć || 0x92 || || style="background:#ebbb54;" | 0xE6 || || || style="background:#ebbb54;" | 0xE5 || latin small letter c with acute ||
|- style="background:#dbab8a;"

| U+0108 || Ĉ || 0x86 || || || || || || latin capital c with circumflex || Only in ISO-8859-3 (for Esperanto) at 0xC6
|- style="background:#dbab8a;"

| U+0109 || ĉ || 0x96 || || || || || || latin small c with circumflex || Only in ISO-8859-3 (for Esperanto) at 0xE6
|-

| U+010C || Č || 0xAC || style="background:#9ab4e3" | ¬ || style="background:#ebbb54;" | 0xC8 || style="background:#9ab4e3" | ¬ || style="background:#9ab4e3" | ¬ || style="background:#ebbb54;" | 0xB2 || latin capital letter c with caron || Substitute char "not sign" at 0xAC
|-

| U+010D || č || 0xAE || style="background:#9ab4e3" | ® || style="background:#ebbb54;" | 0xE8 || style="background:#9ab4e3" | ® || style="background:#9ab4e3" | ® || style="background:#ebbb54;" | 0xB9 || latin small letter c with caron || Substitute char "registration sign" at 0xAE
|-

| U+010E || Ď || 0xB3 || style="background:#9ab4e3" | ³ || style="background:#ebbb54;" | 0xCF || style="background:#9ab4e3" | ³ || style="background:#9ab4e3" | ³ || || latin capital letter d with caron || Substitute char "superscript three" at 0xB3
|-

| U+010F || ď || 0xB7 || style="background:#9ab4e3; font-weight:bold" | · || style="background:#ebbb54;" | 0xEF || style="background:#9ab4e3; font-weight:bold" | · || style="background:#9ab4e3; font-weight:bold" | · || || latin small letter d with caron || Substitute char "middle dot" at 0xB7
|-

| U+0110 || Đ || 0xD0 || 0xD0 || 0xD0 || style="background:#43a8cc;" | n/a || || 0xD0 || latin capital letter d with stroke || Same glyph as U+00D0 latin capital letter eth
|-

| U+0111 || đ || 0x90 || || style="background:#ebbb54;" | 0xF0 || style="background:#43a8cc;" | n/a || || style="background:#ebbb54;" | 0xF0 || latin small letter d with stroke ||
|-

| U+0118 || Ę || 0xAB || style="background:#9ab4e3" | « || style="background:#ebbb54;" | 0xCA || style="background:#9ab4e3" | « || style="background:#9ab4e3" | « || style="background:#ebbb54;" | 0xDD || latin capital letter e with ogonek || Substitute char "left-pointing double angle quotation mark" at 0xAB
|-

| U+0119 || ę || 0xBB || style="background:#9ab4e3" | » || style="background:#ebbb54;" | 0xEA || style="background:#9ab4e3" | » || style="background:#9ab4e3" | » || style="background:#ebbb54;" | 0xFD || latin small letter e with ogonek || Substitute char "right-pointing double angle quotation mark" at 0xBB
|-

| U+011A || Ě || 0xA5 || style="background:#9ab4e3" | ¥ || style="background:#ebbb54;" | 0xCC || style="background:#9ab4e3" | ¥ || style="background:#9ab4e3" | ¥ || || latin capital letter e with caron || Substitute char "yen sign" at 0xA5
|-

| U+011B || ě || 0xA3 || style="background:#9ab4e3" | £ || style="background:#ebbb54;" | 0xEC || style="background:#9ab4e3" | £ || style="background:#9ab4e3" | £ || || latin small letter e with caron || Substitute char "pound sign" at 0xA3
|-

| U+011E || Ğ || 0x88 || || || style="background:#ebbb54;" | 0xD0 || || || latin capital letter g with breve || As of TDM 2.13
|-

| U+011F || ğ || 0x98 || || || style="background:#ebbb54;" | 0xF0 || || || latin small letter g with breve || As of TDM 2.13
|- style="color:#8c8c8c;"

| U+0130 || İ || || || || style="background:#ebbb54;" | 0xDD || || || latin capital letter i with dot above || Turkish: utf8 "İ" will be mapped to "Î" (0xCE)
|- style="color:#8c8c8c;"

| U+0131 || ı || || || || style="background:#ebbb54;" | 0xFD || || || latin small letter dotless i || Turkish: utf8 "ı" will be mapped to ASCII "i" (0x69)
|- style="color:#8c8c8c;"

| U+0139 || Ĺ || || || 0xC5 || || || || latin capital letter l with acute ||
|- style="color:#8c8c8c;"

| U+013A || ĺ || || || 0xE5 || || || || latin small letter l with acute ||
|- style="color:#8c8c8c;"

| U+013D || Ľ || || || 0xA5 || || || || latin capital letter l with caron ||
|- style="color:#8c8c8c;"

| U+013E || ľ || || || 0xB5 || || || || latin small letter l with caron ||
|-

| U+0141 || Ł || 0xB1 || style="background:#9ab4e3" | ± || style="background:#ebbb54;" | 0xA3 || style="background:#9ab4e3" | ± || style="background:#9ab4e3" | ± || style="background:#ebbb54;" | 0xA3 || latin capital letter l with stroke || Substitute char "plus-minus sign" at 0xB1
|-

| U+0142 || ł || 0xB5 || style="background:#9ab4e3" | µ || style="background:#ebbb54;" | 0xB3 || style="background:#9ab4e3" | µ || style="background:#9ab4e3" | µ || style="background:#ebbb54;" | 0xB3 || latin small letter l with stroke || Substitute char "micro sign" at 0xB5
|-

| U+0143 || Ń || 0x8C || || style="background:#ebbb54;" | 0xD1 || || || style="background:#ebbb54;" | 0xD1 || latin capital letter n with acute ||
|-

| U+0144 || ń || 0x9C || || style="background:#ebbb54;" | 0xF1 || || || style="background:#ebbb54;" | 0xF1 || latin small letter n with acute ||
|-

| U+0147 || Ň || 0x80 || || style="background:#ebbb54;" | 0xD2 || || || || latin capital letter n with caron ||
|-

| U+0148 || ň || 0xA1 || style="background:#9ab4e3" | ¡ || style="background:#ebbb54;" | 0xF2 || style="background:#9ab4e3" | ¡ || style="background:#9ab4e3" | ¡ || || latin small letter n with caron || Substitute char "inverted exclamation mark" at 0xA1
|-

| U+0150 || Ő || 0xB0 || style="background:#9ab4e3" | ° || style="background:#ebbb54;" | 0xD5 || style="background:#9ab4e3" | ° || style="background:#9ab4e3" | ° || style="background:#ebbb54;" | 0xD5 || latin capital letter o with double acute || Similiar to Ö, used in Hungarian. Substitute char "degree sign" at 0xB0
|-

| U+0151 || ő || 0xB9 || style="background:#9ab4e3" | ¹ || style="background:#ebbb54;" | 0xF5 || style="background:#9ab4e3" | ¹ || style="background:#9ab4e3" | ¹ || style="background:#ebbb54;" | 0xF5 || latin small letter o with double acute || Similiar to ö, used in Hungarian. Substitute char "superscript 1" at 0xB9
|-

| U+0152 || Œ || 0xBC || style="background:#9ab4e3" | ¼ || || style="background:#9ab4e3" | ¼ || 0xBC || 0xBC || latin capital ligature oe || Substitute char "vulgar fraction one quarter" at 0xBC
|-

| U+0153 || œ || 0xBD || style="background:#9ab4e3" | ½ || || style="background:#9ab4e3" | ½ || 0xBD || 0xBD || latin small ligature oe || Substitute char "vulgar fraction one half" at 0xBD
|-

| U+0154 || Ŕ || 0x89 || || style="background:#ebbb54;" | 0xC0 || || || || latin capital letter r with acute ||
|-

| U+0155 || ŕ || 0x99 || || style="background:#ebbb54;" | 0xE0 || || || || latin small letter r with acute ||
|-

| U+0158 || Ř || 0xD7 || style="background:#9ab4e3" | × || style="background:#ebbb54;" | 0xD8 || style="background:#9ab4e3" | × || style="background:#9ab4e3" | × || || latin capital letter r with caron || Substitute char "multiple sign" at 0xD7
|-

| U+0159 || ř || 0xF7 || style="background:#9ab4e3" | ÷ || style="background:#ebbb54;" | 0xF8 || style="background:#9ab4e3" | ÷ || style="background:#9ab4e3" | ÷ || || latin small letter r with caron || Substitute char "divide sign" at 0xF7
|-

| U+015A || Ś || 0x81 || || style="background:#ebbb54;" | 0xA6 || || || style="background:#ebbb54;" | 0xD7 || latin capital letter s with acute ||
|-

| U+015B || ś || 0x91 || || style="background:#ebbb54;" | 0xB6 || || || style="background:#ebbb54;" | 0xF7 || latin small letter s with acute ||
|- style="background:#dbab8a;"

| U+015C || Ŝ || 0x85 || || || || || || latin capital letter s with circumflex || Only in ISO-8859-3 (for Esperanto) at 0xDE
|- style="background:#dbab8a;"

| U+015D || ŝ || 0x95 || || || || || || latin small letter s with circumflex || Only in ISO-8859-3 (for Esperanto) at 0xFE
|-

| U+015E || Ş || 0x8D || || style="background:#ebbb54;" | 0xAA || style="background:#ebbb54;" | 0xDE || || || latin capital letter s with cedilla || Can stand in for "...comma under"
|-

| U+015F || ş || 0x9D || || style="background:#ebbb54;" | 0xBA || style="background:#ebbb54;" | 0xFE || || || latin small letter s with cedilla || Can stand in for "...comma under"
|-

| U+0160 || Š || 0xA6 || style="background:#9ab4e3" | ¦ || style="background:#ebbb54;" | 0xA9 || style="background:#9ab4e3" | ¦ || 0xA6 || 0xA6 || latin capital letter s with caron || Substitute char "broken bar" at 0xA6
|-

| U+0161 || š || 0xA8 || style="background:#9ab4e3" | ¨ || style="background:#ebbb54;" | 0xB9 || style="background:#9ab4e3" | ¨ || 0xA8 || 0xA8 || latin small letter s with caron || Substitute char "diaeresis" at 0xA8
|-

| U+0162 || Ţ || 0x8E || || style="background:#ebbb54;" | 0xDE || || || || latin capital letter t with cedilla || Can stand in for "...comma under"
|-

| U+0163 || ţ || 0x9E || || style="background:#ebbb54;" | 0xFE || || || || latin small letter t with cedilla || Can stand in for "...comma under"
|-

| U+0164 || Ť || 0xB2 || style="background:#9ab4e3" | ² || style="background:#ebbb54;" | 0xAB || style="background:#9ab4e3" | ² || style="background:#9ab4e3" | ² || || latin capital letter t with caron || Substitute char "superscript two" at 0xB2
|-

| U+0165 || ť || 0xB6 || style="background:#9ab4e3" | ¶ || style="background:#ebbb54;" | 0xBB || style="background:#9ab4e3" | ¶ || style="background:#9ab4e3" | ¶ || || latin small letter t with caron || Substitute char "pilcrow sign" at 0xB6
|-

| U+016E || Ů || 0xA9 || style="background:#9ab4e3" | © || style="background:#ebbb54;" | 0xD9 || style="background:#9ab4e3" | © || style="background:#9ab4e3" | © || || latin capital letter u with ring above || Substitute char "copyright sign" at 0xA9
|-

| U+016F || ů || 0xAF || style="background:#9ab4e3" | ¯ || style="background:#ebbb54;" | 0xF9 || style="background:#9ab4e3" | ¯ || style="background:#9ab4e3" | ¯ || || latin small letter u with ring above || Substitute char "macron" at 0xAF
|-

| U+0170 || Ű || 0xA2 || style="background:#9ab4e3" | ¢ || style="background:#ebbb54;" | 0xDB || style="background:#9ab4e3" | ¢ || style="background:#9ab4e3" | ¢ || style="background:#ebbb54;" | 0xD8 || latin capital letter u with double acute || Similiar to Ü, used in Hungarian. Substitute char "cent sign" at 0xA2
|-

| U+0171 || ű || 0xA4 || style="background:#9ab4e3" | ¤ || style="background:#ebbb54;" | 0xFB || style="background:#9ab4e3" | ¤ || style="background:#9ab4e3" | ¤ || style="background:#ebbb54;" | 0xF8 || latin small letter u with double acute || Similiar to Ü, used in Hungarian. Substitute char "currency sign" at 0xA4
|-

| U+0178 || Ÿ || 0xBE || style="background:#9ab4e3" | ¾ || || style="background:#9ab4e3" | ¾ || 0xBE || 0xBE || latin capital letter y with diaeresis || Substitute char "vulgar fraction three quarters" at 0xBE
|-

| U+0179 || Ź || 0x84 || || style="background:#ebbb54;" | 0xAC || || || style="background:#ebbb54;" | | 0xAC || latin capital letter z with acute ||
|-

| U+017A || ź || 0x94 || || style="background:#ebbb54;" | 0xBC || || || style="background:#ebbb54;" | 0xAE || latin small letter z with acute ||
|-

| U+017B || Ż || 0x83 || || style="background:#ebbb54;" | 0xAF || || || style="background:#ebbb54;" | 0xAF || latin capital letter z with dot above ||
|-

| U+017C || ż || 0x93 || || style="background:#ebbb54;" | 0xBF || || || style="background:#ebbb54;" | 0xBF || latin small letter z with dot above ||
|-

| U+017D || Ž || 0xB4 || style="background:#9ab4e3" | ´ || style="background:#ebbb54;" | 0xAE || style="background:#9ab4e3" | ´ || 0xB4 || 0xB4 || latin capital letter z with caron || Substitute char "accute accent" at 0xB4
|-

| U+017E || ž || 0xB8 || style="background:#9ab4e3" | ¸ || style="background:#ebbb54;" | 0xBE || style="background:#9ab4e3" | ¸ || 0xB8 || 0xB8 || latin small letter z with caron || Substitute char "cedilla" at 0xB8
|- style="background:#dbab8a;"

| U+01D3 || Ǔ || 0x8A || || || || || || latin capital u with caron || Not found in ISO-8859. Pinyin tone marking
|- style="background:#dbab8a;"

| U+01D4 || ǔ || 0x9A || || || || || || latin small u with caron || Not found in ISO-8859. Pinyin tone marking
|-

| U+0218 || Ș || 0x8D || || || || || style="background:#ebbb54;" | 0xAA || latin capital letter s with comma below || See also "...with cedilla"
|-

| U+0219 || ș || 0x9D || || || || || style="background:#ebbb54;" | 0xBA || latin small letter s with comma below || See also "...with cedilla"
|-

| U+021A || Ț || 0x8E || || || || || style="background:#ebbb54;" | 0xDE || latin capital letter t with comma below || See also "...with cedilla"
|-

| U+021B || ț || 0x9E || || || || || style="background:#ebbb54;" | 0xFE || latin small letter t with comma below || See also "...with cedilla"
|- style="color:#8c8c8c;"

| U+02C7 || ˇ || || || || 0xB7 || || || caron ||
|- style="color:#8c8c8c;"

| U+02D8 || ˘ || || || || 0xA2 || || || breve ||
|- style="color:#8c8c8c;"

| U+02D9 || ˙ || || || || 0xFF || || || dot above ||
|- style="color:#8c8c8c;"

| U+02DB || ˛ || || || || 0xB2 || || || ogonek ||
|- style="color:#8c8c8c;"

| U+02DD || ˝ || || || || 0xBD || || || double acute accent ||
|- style="background:#dbab8a;"

| U+1E90 || Ẑ || 0x87 || || || || || || latin capital z with circumflex || Not found in ISO-8859. Rare use in Cyrillic-to-Latin transliteration, or Pinyin
|- style="background:#dbab8a;"

| U+1E91 || ẑ || 0x97 || || || || || || latin small z with circumflex || Not found in ISO-8859. Rare use in Cyrillic-to-Latin transliteration, or Pinyin
|- style="color:#8c8c8c;"

| U+201D || ” || || || || || || 0xB5 || right double quotation mark ||
|- style="color:#8c8c8c;"

| U+201E || „ || || || || || || 0xA5 || double low-9 quotation mark ||
|- style="color:#8c8c8c;"

| U+20AC || € || || || || || 0xA4 || 0xA4 || euro sign ||
|}

Multilanguage Display

2026-06-19T15:18:23Z

Geep: /* Details of TDM and ISO Char Sets and Potential Tricks and Limitations */ fixup colors

[PAGE IN PROGRESS]

== Background ==
''This describes a particular challenging use case of a TDM methodology that has been around for some time. The motivation to detail this was a 2026 update by Geep to the language map files, following a revision of Carleton 24pt font used throughout the Main Menu.''

In TDM's main menu, the Settings/Video/Language page attempts to list all the supported languages in their native form with respect to character set, that is, untranslated. Showing multiple language strings together is difficult, but some tricks are available. The result has been a reasonable near-term workaround for this particular page, applicable to comparable cases. (Comprehensive support for multilanguage display likely involves a major restructuring, for instance, moving to a native Unicode architecture with combined Latin and Cyrillic bitmaps.)

Recall that strings for the main menu are found in the utf8 file tdm_base01.pk4/strings/all.lang, where there is are sections for [English], [German], etc. A particular section is used to generate for distribution the corresponding file, e.g., french.lang, german.lang, etc., in a language-specific 8-bit encoding. When you play TDM, and select a given language, the corresponding .lang file (if needed) is read.

Except for Cyrillic Russian, these files use encodings within the ISO-8859 family (as detailed in [[I18N_-_Charset]]). Any specific encoding is a bottleneck... by design, not all characters in any one member of the ISO-8859 family will be accessible by some other members.

== Language Names in Idealized UTF8 Form ==
Only the TDM-exposed languages are shown here. The all.lang file has additional strings for other potential Latin and Cyrillic languages. For reference, the generated encoding for the <language>.lang file is shown in the comment.

"#str_02460" "English" // English [ISO-8859-1]
"#str_02461" "Deutsch" // German [ISO-8859-1]
"#str_02462" "Español" // Spanish [ISO-8859-1]
"#str_02463" "Français" // French [ISO-8859-15]
"#str_02464" "Português" // Portuguese [ISO-8859-1]
"#str_02465" "Polski" // Polish [ISO-8859-2]
"#str_02466" "Italiano" // Italian [ISO-8859-1]
"#str_02467" "Česky" // Czech [ISO-8859-2]
"#str_02468" "Русский" // Russian [WIN-1251]
"#str_02469" "Català" // Catalan [ISO-8859-1]
"#str_02470" "Dansk" // Danish [ISO-8859-1]
"#str_02472" "Nederlands" // Dutch [ISO-8859-1]
"#str_02474" "Magyar" // Hungarian [ISO-8859-2]
"#str_02476" "Svenska" // Swedish [ISO-8859-1]
"#str_02477" "Türkçe" // Turkish [ISO-8859-9]
"#str_02479" "Română" // Romanian [ISO-8859-16]
"#str_02480" "Slovenčina" // Slovak [ISO-8859-2]

== First Compromise – Cyrillic vs. Latin Font ==
While there is some overlap in characters between Cyrillic and Latin encodings, it is insufficient for our purposes. So, for [English] and other European sections, a Latin transliteration from Cyrillic is used:

"#str_02468" "Russkiy" // Russian

Going the other way, for [Russian], the current treatment is not to do a Cyrillic transliteration from Latin, but instead to drop accents, rendering just in ASCII (except of course “Russian”), e.g.:

"#str_02460" "English" // English
"#str_02461" "Deutsch" // German
"#str_02462" "Espanol" // Spanish
"#str_02463" "Francais" // French
"#str_02464" "Portugues" // Portuguese
"#str_02465" "Polski" // Polish
"#str_02466" "Italiano" // Italian
"#str_02467" "Cesky" // Czech
"#str_02468" "Русский" // Russian
"#str_02469" "Catala" // Catalan
"#str_02470" "Dansk" // Danish
"#str_02472" "Nederlands" // Dutch
"#str_02474" "Magyar" // Hungarian
"#str_02476" "Svenska" // Swedish
"#str_02477" "Turkce" // Turkish
"#str_02479" "Romana" // Romanian
"#str_02480" "Slovencina" // Slovak

== Moving between ISO-8859 Members ==
In the discussion here, let “L1” be the current language (from the player’s perspective) or the [language] section of interest in all.lang (from the translator’s perspective). Let “L2” be the language of the foreign word, i.e., L1 and L2 differ.

=== Type and Go ===
In several cases, the translator merely puts the ideal character in the all.lang strings. After <language>.lang generation, everything works. Cases are:

# L1 and L2 are both use the same ISO-8859 encoding. (Specifically, they are either both ISO-8859-1, which doesn’t need <language>.map files, or both ISO-8859-2, and have <language>.map files with, by convention, identical contents.) NOTE: For TDM’s purposes, ISO-8859-15 (French) can be considered part of the ISO-8859-1 family.
# L2 character is ASCII (i.e., in ISO range 0x00-0x7f). This is always the case if L2 = English. Characters in this range have identical codepoints in all five TDM-supported ISO-8859 and in the TDM target encoding.
# L2 character is in the ISO range 0xA0-0xFF, with additional constraints.

For the last case, the L2 character must be either:
* present at the same codepoint in all five TDM-supported ISO-8859 encodings, and in the TDM target encoding. For our Latin language names, these accented characters are like that:
ç in "Français" and "Türkçe" at 0xE7
à in "Català" at 0xEA
â in "Română" at 0xE2
ü in "Türkçe" at 0xFC
* present at the same codepoint in ISO-8859 encodings for L1 and L2, and in the TDM target encoding.
* present in different codepoints in ISO-8859 encodings for L1 and L2, but with each being either the same as the TDM target encoding, or mapped to the TDM target encoding by the <language>.map file.

=== Tricks ===
If the L2 character is not represented in the ISO encoding for L1, then at <L1>.lang generation time, it will be replaced by a “?”. To work around this, the translator has two methods:

====Trick Method 1 – Direct Stuffing====
When L1 encoding is ISO-8859-1 (or -9 or -15, which all have identical encodings for the 0xA0-BF ranges) and L2 character is in TDM’s 0xA0-0xBF range (or D7, F7), then you can lookup the ISO character associated with that codepoint (shown in parentheses in cells of the i18n- charmap table), and type it. Examples:

[English] // and other ISO-8859-1, -9, or -15
"#str_02467" "¬esky" // our default mapping is ISO 8859-1, so ¬ is shown as Č (¬)
"#str_02480" "Sloven®ina" // Slovak (® in ISO-8859-1 is č in our font)

Here’s another example of that last stuffing from a TDM-unexposed language, showing also a diaresis (0xA8):

"#str_02481" "Sloven¨®ina" // Slovenian (southern slovenia) (¨ => š)

In this case, ISO-8859-1 would need to use the diaresis, but ISO-8859-15 (French) would not, i.e., could type and go with š.
The spreadsheet shows all available substitutions in light blue.

====Trick Method 2 – Special Mapping with Repurposed Character====
If all else fails, a little-used character in L1 can be redirected to the L2 codepoint TDM wants, by an extra mapping command in the <L1>.map file. Current such tricks are...

To get ñ for "Español":

* for iso 2, put ¨ (diaeresis 0xA8)
* for iso 16, put ¶ (pilcrow 0xB6)

To get ê for "Português":

*for iso 2: Put ´ (acute accent 0xBD)

== Details of TDM and ISO Char Sets and Potential Tricks and Limitations ==
[WORK IN PROGRESS][COLOR CODING NOT RIGHT YET]

The main table below (after the Key) was drafted by Google AI, from a prompt that defined the header and an example row, and specified:

"Rows are a combine of all the printable 8-bit codepoints in the range 0x80-0xff defined in ISO-8859-1, -2, -9, -15, and -16. The rows are ordered by Unicode number. If a particular ISO standard does not include the character, leave that cell blank."

Subsequently, the TDM and Comments columns were filled in by Geep, and color coding added.
Language mappings were independently color coded, then verified against existing language maps.
This table skips codepoints in the range 0x00-0x7f, because they are the same for all ISO-8859 standards. No mapping required.

{| class="wikitable" style="font-size: 95%; line-height: 1.3em;"
|+ Color Key
! Cell !! Meaning
|-

| style="color:#8c8c8c;" | Light Gray Text Row || Symbol not included in TDM custom character set (so TDM column blank). Can use for char substitution tricks.
|-

| 0xNN on white || Type desired utf8 char (in Symbol column) in all.lang. Generation goes directly to TDM codepoint given.
|-

| style="background:#ebbb54;" | 0xNN, amber hilite || Type desired utf8 char in all.lang. Generation + mapping (in <language>.map file) goes to TDM codepoint via codepoint shown.
|-

| style="background:#ebbb54;color:#606060;" | 0xNN in gray || Type desired utf8 char in all.lang. Generation + mapping (in <language>.map file) goes to TDM codepoint OF SUBSTITUTE CHARACTER via codepoint shown.
|-

| style="background:#ebbb54;color:#ff0000;" | 0xNN in red || Character not part of this ISO. "0xnn" shown is not ISO, but for trick mapping (in <language.map), to support main menu's multilingual "Languages" page.
|-

| style="background:#9ab4e3;" | Substitute Char || Character not part of this ISO. But as trick, you can stuff in this substitute char at the needed TDM codepoint.
|-

| style="background:#43a8cc;" | n/a || Not available to use substitute character, due to trick mapping (in <language>.map) elsewhere.
|-

| Empty Cell || In ISO column, means character not part of this ISO (so may be candidate for future trick mapping; or simply not fully analyzed viz substitute char.)
|-

| style="background:#dbab8a;" | Tan Row || Orphaned character in TDM set, not part of 5 ISO-8859 standards for current TDM-supported languages.
|-
|}

{| class="wikitable" style="font-size: 95%; line-height: 1.3em;"
|+ Unicode Coverage for TDM
! Unicode !! Symbol !! TDM !! 1 !! 2 !! 9 !! 15 !! 16 !! Unicode Name !! Comments
|-

| U+00A0 ||   || 0xA0 || 0xA0 || 0xA0 || 0xA0 || 0xA0 || 0xA0 || no-break space ||
|- style="color:#8c8c8c;"

| U+00A1 || ¡ || || 0xA1 || || 0xA1 || 0xA1 || || inverted exclamation mark ||
|- style="color:#8c8c8c;"

| U+00A2 || ¢ || || 0xA2 || || 0xA2 || 0xA2 || || cent sign ||
|- style="color:#8c8c8c;"

| U+00A3 || £ || || 0xA3 || || 0xA3 || 0xA3 || || pound sign ||
|- style="color:#8c8c8c;"

| U+00A4 || ¤ || || 0xA4 || 0xA4 || 0xA4 || || || currency sign ||
|- style="color:#8c8c8c;"

| U+00A5 || ¥ || || 0xA5 || || 0xA5 || 0xA5 || || yen sign ||
|- style="color:#8c8c8c;"

| U+00A6 || ¦ || || 0xA6 || || 0xA6 || || || broken bar ||
|-

| U+00A7 || § || 0xA7 || 0xA7 || 0xA7 || 0xA7 || 0xA7 || 0xA7 || section sign ||
|- style="color:#8c8c8c;"

| U+00A8 || ¨ || || 0xA8 || 0xA8 || 0xA8 || || || diaeresis || See also hack use for ñ
|- style="color:#8c8c8c;"

| U+00A9 || © || || 0xA9 || || 0xA9 || 0xA9 || 0xA9 || copyright sign ||
|- style="color:#8c8c8c;"

| U+00AA || ª || || 0xAA || || 0xAA || 0xAA || || feminine ordinal indicator ||
|- style="color:#8c8c8c;"

| U+00AB || « || || 0xAB || || 0xAB || 0xAB || 0xAB || left-pointing double angle quotation mark ||
|- style="color:#8c8c8c;"

| U+00AC || ¬ || || 0xAC || || 0xAC || 0xAC || || not sign ||
|-

| U+00AD || || 0xAD || 0xAD || 0xAD || 0xAD || 0xAD || 0xAD || soft hyphen ||
|- style="color:#8c8c8c;"

| U+00AE || ® || || 0xAE || || 0xAE || 0xAE || || registered sign ||
|- style="color:#8c8c8c;"

| U+00AF || ¯ || || 0xAF || || 0xAF || 0xAF || || macron ||
|- style="color:#8c8c8c;"

| U+00B0 || ° || || 0xB0 || 0xB0 || 0xB0 || 0xB0 || 0xB0 || degree sign ||
|- style="color:#8c8c8c;"

| U+00B1 || ± || || 0xB1 || || 0xB1 || 0xB1 || 0xB1 || plus-minus sign ||
|- style="color:#8c8c8c;"

| U+00B2 || ² || || 0xB2 || || 0xB2 || 0xB2 || || superscript two ||
|- style="color:#8c8c8c;"

| U+00B3 || ³ || || 0xB3 || || 0xB3 || 0xB3 || || superscript three ||
|- style="color:#8c8c8c;"

| U+00B4 || ´ || || 0xB4 || 0xB4 || 0xB4 || || || acute accent ||
|- style="color:#8c8c8c;"

| U+00B5 || µ || || 0xB5 || || 0xB5 || 0xB5 || || micro sign ||
|- style="color:#8c8c8c;"

| U+00B6 || ¶ || || 0xB6 || || 0xB6 || 0xB6 || 0xB6 || pilcrow sign ||
|- style="color:#8c8c8c;"

| U+00B7 || · || || 0xB7 || || 0xB7 || 0xB7 || 0xB7 || middle dot ||
|- style="color:#8c8c8c;"

| U+00B8 || ¸ || || 0xB8 || 0xB8 || 0xB8 || || || cedilla ||
|- style="color:#8c8c8c;"

| U+00B9 || ¹ || || 0xB9 || || 0xB9 || 0xB9 || || superscript one ||
|- style="color:#8c8c8c;"

| U+00BA || º || || 0xBA || || 0xBA || 0xBA || || masculine ordinal indicator ||
|- style="color:#8c8c8c;"

| U+00BB || » || || 0xBB || || 0xBB || 0xBB || 0xBB || right-pointing double angle quotation mark ||
|- style="color:#8c8c8c;"

| U+00BC || ¼ || || 0xBC || || 0xBC || || || vulgar fraction one quarter ||
|- style="color:#8c8c8c;"

| U+00BD || ½ || || 0xBD || || 0xBD || || || vulgar fraction one half ||
|- style="color:#8c8c8c;"

| U+00BE || ¾ || || 0xBE || || 0xBE || || || vulgar fraction three quarters ||
|-

| U+00BF || ¿ || 0xBF || 0xBF || || 0xBF || 0xBF || || inverted question mark ||
|-

| U+00C0 || À || 0xC0 || 0xC0 || || 0xC0 || 0xC0 || 0xC0 || latin capital letter a with grave ||
|-

| U+00C1 || Á || 0xC1 || 0xC1 || 0xC1 || 0xC1 || 0xC1 || 0xC1 || latin capital letter a with acute ||
|-

| U+00C2 || Â || 0xC2 || 0xC2 || 0xC2 || 0xC2 || 0xC2 || 0xC2 || latin capital letter a with circumflex ||
|-

| U+00C3 || Ã || 0xC3 || 0xC3 || || 0xC3 || 0xC3 || || latin capital letter a with tilde ||
|-

| U+00C4 || Ä || 0xC4 || 0xC4 || 0xC4 || 0xC4 || 0xC4 || 0xC4 || latin capital letter a with diaeresis ||
|-

| U+00C5 || Å || 0xC5 || 0xC5 || || 0xC5 || 0xC5 || || latin capital letter a with ring above ||
|-

| U+00C6 || Æ || 0xC6 || 0xC6 || || 0xC6 || 0xC6 || 0xC6 || latin capital letter ae ||
|-

| U+00C7 || Ç || 0xC7 || 0xC7 || 0xC7 || 0xC7 || 0xC7 || 0xC7 || latin capital letter c with cedilla ||
|-

| U+00C8 || È || 0xC8 || 0xC8 || || 0xC8 || 0xC8 || 0xC8 || latin capital letter e with grave ||
|-

| U+00C9 || É || 0xC9 || 0xC9 || 0xC9 || 0xC9 || 0xC9 || 0xC9 || latin capital letter e with acute ||
|-

| U+00CA || Ê || 0xCA || 0xCA || || 0xCA || 0xCA || 0xCA || latin capital letter e with circumflex ||
|-

| U+00CB || Ë || 0xCB || 0xCB || 0xCB || 0xCB || 0xCB || 0xCB || latin capital letter e with diaeresis ||
|-

| U+00CC || Ì || 0xCC || 0xCC || || 0xCC || 0xCC || 0xCC || latin capital letter i with grave ||
|-

| U+00CD || Í || 0xCD || 0xCD || 0xCD || 0xCD || 0xCD || 0xCD || latin capital letter i with acute ||
|-

| U+00CE || Î || 0xCE || 0xCE || 0xCE || 0xCE || 0xCE || 0xCE || latin capital letter i with circumflex ||
|-

| U+00CF || Ï || 0xCF || 0xCF || || 0xCF || 0xCF || 0xCF || latin capital letter i with diaeresis ||
|-

| U+00D0 || Ð || 0xD0 || 0xD0 || || style="background:#43a8cc;" | n/a || 0xD0 || || latin capital letter eth || Same glyph as U+0110 latin capital letter d with stroke
|-

| U+00D1 || Ñ || 0xD1 || 0xD1 || || 0xD1 || 0xD1 || || latin capital letter n with tilde ||
|-

| U+00D2 || Ò || 0xD2 || 0xD2 || || 0xD2 || 0xD2 || 0xD2 || latin capital letter o with grave ||
|-

| U+00D3 || Ó || 0xD3 || 0xD3 || 0xC1 || 0xD3 || 0xD3 || 0xD3 || latin capital letter o with acute ||
|-

| U+00D4 || Ô || 0xD4 || 0xD4 || 0xD4 || 0xD4 || 0xD4 || 0xD4 || latin capital letter o with circumflex || Formerly also mapped from 0x88; redundant, Ğ has 0x88 codepoint now
|-

| U+00D5 || Õ || 0xD5 || 0xD5 || || 0xD5 || 0xD5 || || latin capital letter o with tilde ||
|-

| U+00D6 || Ö || 0xD6 || 0xD6 || 0xD6 || 0xD6 || 0xD6 || 0xD6 || latin capital letter o with diaeresis ||
|- style="color:#8c8c8c;"

| U+00D7 || × || || 0xD7 || 0xD7 || 0xD7 || 0xD7 || || multiplication sign ||
|-

| U+00D8 || Ø || 0xD8 || 0xD8 || || 0xD8 || 0xD8 || || latin capital letter o with stroke ||
|-

| U+00D9 || Ù || 0xD9 || 0xD9 || || 0xD9 || 0xD9 || 0xD9 || latin capital letter u with grave ||
|-

| U+00DA || Ú || 0xDA || 0xDA || 0xDA || 0xDA || 0xDA || 0xDA || latin capital letter u with acute ||
|-

| U+00DB || Û || 0xDB || 0xDB || || 0xDB || 0xDB || 0xDB || latin capital letter u with circumflex ||
|-

| U+00DC || Ü || 0xDC || 0xDC || 0xDC || 0xDC || 0xDC || 0xDC || latin capital letter u with diaeresis ||
|-

| U+00DD || Ý || 0xDD || 0xDD || 0xDD || || 0xDD || || latin capital letter y with acute ||
|-

| U+00DE || Þ || 0xDE || 0xDE || || || 0xDE || || latin capital letter thorn ||
|-

| U+00DF || ß || 0xDF || 0xDF || 0xDF || 0xDF || 0xDF || 0xDF || latin small letter sharp s ||
|-

| U+00E0 || à || 0xE0 || 0xE0 || || 0xE0 || 0xE0 || 0xE0 || latin small letter a with grave ||
|-

| U+00E1 || á || 0xE1 || 0xE1 || 0xE1 || 0xE1 || 0xE1 || 0xE1 || latin small letter a with acute ||
|-

| U+00E2 || â || 0xE2 || 0xE2 || 0xE2 || 0xE2 || 0xE2 || 0xE2 || latin small letter a with circumflex ||
|-

| U+00E3 || ã || 0xE3 || 0xE3 || || 0xE3 || 0xE3 || || latin small letter a with tilde ||
|-

| U+00E4 || ä || 0xE4 || 0xE4 || 0xE4 || 0xE4 || 0xE4 || 0xE4 || latin small letter a with diaeresis ||
|-

| U+00E5 || å || 0xE5 || 0xE5 || || 0xE5 || 0xE5 || || latin small letter a with ring above ||
|-

| U+00E6 || æ || 0xE6 || 0xE6 || || 0xE6 || 0xE6 || 0xE6 || latin small letter ae ||
|-

| U+00E7 || ç || 0xE7 || 0xE7 || 0xE7 || 0xE7 || 0xE7 || 0xE7 || latin small letter c with cedilla ||
|-

| U+00E8 || è || 0xE8 || 0xE8 || || 0xE8 || 0xE8 || 0xE8 || latin small letter e with grave ||
|-

| U+00E9 || é || 0xE9 || 0xE9 || 0xE9 || 0xE9 || 0xE9 || 0xE9 || latin small letter e with acute ||
|-

| U+00EA || ê || 0xEA || 0xEA || style="background:#ebbb54;color:#ff0000;" | 0xBD || 0xEA || 0xEA || 0xEA || latin small letter e with circumflex || Hack for iso 2: Put ´ (acute accent, 0xBD) to get ê for "Português"
|-

| U+00EB || ë || 0xEB || 0xEB || 0xEB || 0xEB || 0xEB || 0xEB || latin small letter e with diaeresis ||
|-

| U+00EC || ì || 0xEC || 0xEC || || 0xEC || 0xEC || 0xEC || latin small letter i with grave ||
|-

| U+00ED || í || 0xED || 0xED || 0xED || 0xED || 0xED || 0xED || latin small letter i with acute ||
|-

| U+00EE || î || 0xEE || 0xEE || 0xEE || 0xEE || 0xEE || 0xEE || latin small letter i with circumflex ||
|-

| U+00EF || ï || 0xEF || 0xEF || || 0xEF || 0xEF || 0xEF || latin small letter i with diaeresis ||
|-

| U+00F0 || ð || 0xF0 || 0xF0 || || || 0xF0 || || latin small letter eth ||
|-

| U+00F1 || ñ || 0xF1 || 0xF1 || style="background:#ebbb54;color:#ff0000;" | 0xA8 || 0xF1 || 0xF1 || style="background:#ebbb54;color:#ff0000;" | 0xB6 || latin small letter n with tilde || Hacks to get ñ for "Español": for iso 2, put ¨ (diaeresis 0xA8); for iso 16, put ¶ (0xB6)
|-

| U+00F2 || ò || 0xF2 || 0xF2 || || 0xF2 || 0xF2 || 0xF2 || latin small letter o with grave ||
|-

| U+00F3 || ó || 0xF3 || 0xF3 || 0xF3 || 0xF3 || 0xF3 || 0xF3 || latin small letter o with acute ||
|-

| U+00F4 || ô || 0xF4 || 0xF4 || 0xF4 || 0xF4 || 0xF4 || 0xF4 || latin small letter o with circumflex || Formerly also mapped from 0x88; redundant, ğ has TDM 0x88 codepoint now
|-

| U+00F5 || õ || 0xF5 || 0xF5 || || 0xF5 || 0xF5 || || latin small letter o with tilde ||
|-

| U+00F6 || ö || 0xF6 || 0xF6 || 0xF6 || 0xF6 || 0xF6 || 0xF6 || latin small letter o with diaeresis ||
|- style="color:#8c8c8c;"

| U+00F7 || ÷ || || 0xF7 || 0xF7 || 0xF7 || 0xF7 || || division sign ||
|-

| U+00F8 || ø || 0xF8 || 0xF8 || || 0xF8 || 0xF8 || || latin small letter o with stroke ||
|-

| U+00F9 || ù || 0xF9 || 0xF9 || || 0xF9 || 0xF9 || 0xF9 || latin small letter u with grave ||
|-

| U+00FA || ú || 0xFA || 0xFA || 0xFA || 0xFA || 0xFA || 0xFA || latin small letter u with acute ||
|-

| U+00FB || û || 0xFB || 0xFB || || 0xFB || 0xFB || 0xFB || latin small letter u with circumflex ||
|-

| U+00FC || ü || 0xFC || 0xFC || 0xFC || 0xFC || 0xFC || 0xFC || latin small letter u with diaeresis ||
|-

| U+00FD || ý || 0xFD || 0xFD || 0xFD || || 0xFD || || latin small letter y with acute ||
|-

| U+00FE || þ || 0xFE || 0xFE || || || 0xFE || || latin small letter thorn ||
|-

| U+00FF || ÿ || 0xFF || 0xFF || || 0xFF || 0xFF || 0xFF || latin small letter y with diaeresis ||
|-

| U+0102 || Ă || 0x8B || || style="background:#ebbb54;" | 0xC3 || || || style="background:#ebbb54;" | 0xC3 || latin capital letter a with breve ||
|-

| U+0103 || ă || 0x9B || || style="background:#ebbb54;" | 0xE3 || || || style="background:#ebbb54;" | 0xE3 || latin small letter a with breve ||
|-

| U+0104 || Ą || 0xAA || style="background:#9ab4e3" | ª || style="background:#ebbb54;" | 0xA1 || style="background:#9ab4e3" | ª || style="background:#9ab4e3" | ª || style="background:#ebbb54;" | 0xA1 || latin capital letter a with ogonek ||
|-

| U+0105 || ą || 0xBA || style="background:#9ab4e3" | º || style="background:#ebbb54;" | 0xB1 || style="background:#9ab4e3" | º || style="background:#9ab4e3" | º || style="background:#ebbb54;" | 0xA2 || latin small letter a with ogonek ||
|-

| U+0106 || Ć || 0x82 || || style="background:#ebbb54;" | 0xC6 || || || style="background:#ebbb54;" | 0xC5 || latin capital letter c with acute ||
|-

| U+0107 || ć || 0x92 || || style="background:#ebbb54;" | 0xE6 || || || style="background:#ebbb54;" | 0xE5 || latin small letter c with acute ||
|- style="background:#dbab8a;"

| U+0108 || Ĉ || 0x86 || || || || || || latin capital c with circumflex || Only in ISO-8859-3 (for Esperanto) at 0xC6
|- style="background:#dbab8a;"

| U+0109 || ĉ || 0x96 || || || || || || latin small c with circumflex || Only in ISO-8859-3 (for Esperanto) at 0xE6
|-

| U+010C || Č || 0xAC || style="background:#9ab4e3" | ¬ || style="background:#ebbb54;" | 0xC8 || style="background:#9ab4e3" | ¬ || style="background:#9ab4e3" | ¬ || style="background:#ebbb54;" | 0xB2 || latin capital letter c with caron || Substitute char "not sign" at 0xAC
|-

| U+010D || č || 0xAE || style="background:#9ab4e3" | ® || style="background:#ebbb54;" | 0xE8 || style="background:#9ab4e3" | ® || style="background:#9ab4e3" | ® || style="background:#ebbb54;" | 0xB9 || latin small letter c with caron || Substitute char "registration sign" at 0xAE
|-

| U+010E || Ď || 0xB3 || style="background:#9ab4e3" | ³ || style="background:#ebbb54;" | 0xCF || style="background:#9ab4e3" | ³ || style="background:#9ab4e3" | ³ || || latin capital letter d with caron || Substitute char "superscript three" at 0xB3
|-

| U+010F || ď || 0xB7 || style="background:#9ab4e3; font-weight:bold" | · || style="background:#ebbb54;" | 0xEF || style="background:#9ab4e3; font-weight:bold" | · || style="background:#9ab4e3; font-weight:bold" | · || || latin small letter d with caron || Substitute char "middle dot" at 0xB7
|-

| U+0110 || Đ || 0xD0 || 0xD0 || 0xD0 || style="background:#43a8cc;" | n/a || || 0xD0 || latin capital letter d with stroke || Same glyph as U+00D0 latin capital letter eth
|-

| U+0111 || đ || 0x90 || || style="background:#ebbb54;" | 0xF0 || style="background:#43a8cc;" | n/a || || style="background:#ebbb54;" | 0xF0 || latin small letter d with stroke ||
|-

| U+0118 || Ę || 0xAB || style="background:#9ab4e3" | « || style="background:#ebbb54;" | 0xCA || style="background:#9ab4e3" | « || style="background:#9ab4e3" | « || style="background:#ebbb54;" | 0xDD || latin capital letter e with ogonek || Substitute char "left-pointing double angle quotation mark" at 0xAB
|-

| U+0119 || ę || 0xBB || style="background:#9ab4e3" | » || style="background:#ebbb54;" | 0xEA || style="background:#9ab4e3" | » || style="background:#9ab4e3" | » || style="background:#ebbb54;" | 0xFD || latin small letter e with ogonek || Substitute char "right-pointing double angle quotation mark" at 0xBB
|-

| U+011A || Ě || 0xA5 || style="background:#9ab4e3" | ¥ || style="background:#ebbb54;" | 0xCC || style="background:#9ab4e3" | ¥ || style="background:#9ab4e3" | ¥ || || latin capital letter e with caron || Substitute char "yen sign" at 0xA5
|-

| U+011B || ě || 0xA3 || style="background:#9ab4e3" | £ || style="background:#ebbb54;" | 0xEC || style="background:#9ab4e3" | £ || style="background:#9ab4e3" | £ || || latin small letter e with caron || Substitute char "pound sign" at 0xA3
|-

| U+011E || Ğ || 0x88 || || || style="background:#ebbb54;" | 0xD0 || || || latin capital letter g with breve || As of TDM 2.13
|-

| U+011F || ğ || 0x98 || || || style="background:#ebbb54;" | 0xF0 || || || latin small letter g with breve || As of TDM 2.13
|- style="color:#8c8c8c;"

| U+0130 || İ || || || || style="background:#ebbb54;" | 0xDD || || || latin capital letter i with dot above || Turkish: utf8 "İ" will be mapped to "Î" (0xCE)
|- style="color:#8c8c8c;"

| U+0131 || ı || || || || style="background:#ebbb54;" | 0xFD || || || latin small letter dotless i || Turkish: utf8 "ı" will be mapped to ASCII "i" (0x69)
|- style="color:#8c8c8c;"

| U+0139 || Ĺ || || || 0xC5 || || || || latin capital letter l with acute ||
|- style="color:#8c8c8c;"

| U+013A || ĺ || || || 0xE5 || || || || latin small letter l with acute ||
|- style="color:#8c8c8c;"

| U+013D || Ľ || || || 0xA5 || || || || latin capital letter l with caron ||
|- style="color:#8c8c8c;"

| U+013E || ľ || || || 0xB5 || || || || latin small letter l with caron ||
|-

| U+0141 || Ł || 0xB1 || style="background:#9ab4e3" | ± || style="background:#ebbb54;" | 0xA3 || style="background:#9ab4e3" | ± || style="background:#9ab4e3" | ± || style="background:#ebbb54;" | 0xA3 || latin capital letter l with stroke || Substitute char "plus-minus sign" at 0xB1
|-

| U+0142 || ł || 0xB5 || style="background:#9ab4e3" | µ || style="background:#ebbb54;" | 0xB3 || style="background:#9ab4e3" | µ || style="background:#9ab4e3" | µ || style="background:#ebbb54;" | 0xB3 || latin small letter l with stroke || Substitute char "micro sign" at 0xB5
|-

| U+0143 || Ń || 0x8C || || style="background:#ebbb54;" | 0xD1 || || || style="background:#ebbb54;" | 0xD1 || latin capital letter n with acute ||
|-

| U+0144 || ń || 0x9C || || style="background:#ebbb54;" | 0xF1 || || || style="background:#ebbb54;" | 0xF1 || latin small letter n with acute ||
|-

| U+0147 || Ň || 0x80 || || style="background:#ebbb54;" | 0xD2 || || || || latin capital letter n with caron ||
|-

| U+0148 || ň || 0xA1 || style="background:#9ab4e3" | ¡ || style="background:#ebbb54;" | 0xF2 || style="background:#9ab4e3" | ¡ || style="background:#9ab4e3" | ¡ || || latin small letter n with caron || Substitute char "inverted exclamation mark" at 0xA1
|-

| U+0150 || Ő || 0xB0 || style="background:#9ab4e3" | ° || style="background:#ebbb54;" | 0xD5 || style="background:#9ab4e3" | ° || style="background:#9ab4e3" | ° || style="background:#ebbb54;" | 0xD5 || latin capital letter o with double acute || Similiar to Ö, used in Hungarian. Substitute char "degree sign" at 0xB0
|-

| U+0151 || ő || 0xB9 || style="background:#9ab4e3" | ¹ || style="background:#ebbb54;" | 0xF5 || style="background:#9ab4e3" | ¹ || style="background:#9ab4e3" | ¹ || style="background:#ebbb54;" | 0xF5 || latin small letter o with double acute || Similiar to ö, used in Hungarian. Substitute char "superscript 1" at 0xB9
|-

| U+0152 || Œ || 0xBC || style="background:#9ab4e3" | ¼ || || style="background:#9ab4e3" | ¼ || 0xBC || 0xBC || latin capital ligature oe || Substitute char "vulgar fraction one quarter" at 0xBC
|-

| U+0153 || œ || 0xBD || style="background:#9ab4e3" | ½ || || style="background:#9ab4e3" | ½ || 0xBD || 0xBD || latin small ligature oe || Substitute char "vulgar fraction one half" at 0xBD
|-

| U+0154 || Ŕ || 0x89 || || style="background:#ebbb54;" | 0xC0 || || || || latin capital letter r with acute ||
|-

| U+0155 || ŕ || 0x99 || || style="background:#ebbb54;" | 0xE0 || || || || latin small letter r with acute ||
|-

| U+0158 || Ř || 0xD7 || style="background:#9ab4e3" | × || style="background:#ebbb54;" | 0xD8 || style="background:#9ab4e3" | × || style="background:#9ab4e3" | × || || latin capital letter r with caron || Substitute char "multiple sign" at 0xD7
|-

| U+0159 || ř || 0xF7 || style="background:#9ab4e3" | ÷ || style="background:#ebbb54;" | 0xF8 || style="background:#9ab4e3" | ÷ || style="background:#9ab4e3" | ÷ || || latin small letter r with caron || Substitute char "divide sign" at 0xF7
|-

| U+015A || Ś || 0x81 || || style="background:#ebbb54;" | 0xA6 || || || style="background:#ebbb54;" | 0xD7 || latin capital letter s with acute ||
|-

| U+015B || ś || 0x91 || || style="background:#ebbb54;" | 0xB6 || || || style="background:#ebbb54;" | 0xF7 || latin small letter s with acute ||
|- style="background:#dbab8a;"

| U+015C || Ŝ || 0x85 || || || || || || latin capital letter s with circumflex || Only in ISO-8859-3 (for Esperanto) at 0xDE
|- style="background:#dbab8a;"

| U+015D || ŝ || 0x95 || || || || || || latin small letter s with circumflex || Only in ISO-8859-3 (for Esperanto) at 0xFE
|-

| U+015E || Ş || 0x8D || || style="background:#ebbb54;" | 0xAA || style="background:#ebbb54;" | 0xDE || || || latin capital letter s with cedilla || Can stand in for "...comma under"
|-

| U+015F || ş || 0x9D || || style="background:#ebbb54;" | 0xBA || style="background:#ebbb54;" | 0xFE || || || latin small letter s with cedilla || Can stand in for "...comma under"
|-

| U+0160 || Š || 0xA6 || style="background:#9ab4e3" | ¦ || style="background:#ebbb54;" | 0xA9 || style="background:#9ab4e3" | ¦ || 0xA6 || 0xA6 || latin capital letter s with caron || Substitute char "broken bar" at 0xA6
|-

| U+0161 || š || 0xA8 || style="background:#9ab4e3" | ¨ || style="background:#ebbb54;" | 0xB9 || style="background:#9ab4e3" | ¨ || 0xA8 || 0xA8 || latin small letter s with caron || Substitute char "diaeresis" at 0xA8
|-

| U+0162 || Ţ || 0x8E || || style="background:#ebbb54;" | 0xDE || || || || latin capital letter t with cedilla || Can stand in for "...comma under"
|-

| U+0163 || ţ || 0x9E || || style="background:#ebbb54;" | 0xFE || || || || latin small letter t with cedilla || Can stand in for "...comma under"
|-

| U+0164 || Ť || 0xB2 || style="background:#9ab4e3" | ² || style="background:#ebbb54;" | 0xAB || style="background:#9ab4e3" | ² || style="background:#9ab4e3" | ² || || latin capital letter t with caron || Substitute char "superscript two" at 0xB2
|-

| U+0165 || ť || 0xB6 || style="background:#9ab4e3" | ¶ || style="background:#ebbb54;" | 0xBB || style="background:#9ab4e3" | ¶ || style="background:#9ab4e3" | ¶ || || latin small letter t with caron || Substitute char "pilcrow sign" at 0xB6
|-

| U+016E || Ů || 0xA9 || style="background:#9ab4e3" | © || style="background:#ebbb54;" | 0xD9 || style="background:#9ab4e3" | © || style="background:#9ab4e3" | © || || latin capital letter u with ring above || Substitute char "copyright sign" at 0xA9
|-

| U+016F || ů || 0xAF || style="background:#9ab4e3" | ¯ || style="background:#ebbb54;" | 0xF9 || style="background:#9ab4e3" | ¯ || style="background:#9ab4e3" | ¯ || || latin small letter u with ring above || Substitute char "macron" at 0xAF
|-

| U+0170 || Ű || 0xA2 || style="background:#9ab4e3" | ¢ || style="background:#ebbb54;" | 0xDB || style="background:#9ab4e3" | ¢ || style="background:#9ab4e3" | ¢ || style="background:#ebbb54;" | 0xD8 || latin capital letter u with double acute || Similiar to Ü, used in Hungarian. Substitute char "cent sign" at 0xA2
|-

| U+0171 || ű || 0xA4 || style="background:#9ab4e3" | ¤ || style="background:#ebbb54;" | 0xFB || style="background:#9ab4e3" | ¤ || style="background:#9ab4e3" | ¤ || style="background:#ebbb54;" | 0xF8 || latin small letter u with double acute || Similiar to Ü, used in Hungarian. Substitute char "currency sign" at 0xA4
|-

| U+0178 || Ÿ || 0xBE || style="background:#9ab4e3" | ¾ || || style="background:#9ab4e3" | ¾ || 0xBE || 0xBE || latin capital letter y with diaeresis || Substitute char "vulgar fraction three quarters" at 0xBE
|-

| U+0179 || Ź || 0x84 || || style="background:#ebbb54;" | 0xAC || || || style="background:#ebbb54;" | | 0xAC || latin capital letter z with acute ||
|-

| U+017A || ź || 0x94 || || style="background:#ebbb54;" | 0xBC || || || style="background:#ebbb54;" | 0xAE || latin small letter z with acute ||
|-

| U+017B || Ż || 0x83 || || style="background:#ebbb54;" | 0xAF || || || style="background:#ebbb54;" | 0xAF || latin capital letter z with dot above ||
|-

| U+017C || ż || 0x93 || || style="background:#ebbb54;" | 0xBF || || || style="background:#ebbb54;" | 0xBF || latin small letter z with dot above ||
|-

| U+017D || Ž || 0xB4 || style="background:#9ab4e3" | ´ || style="background:#ebbb54;" | 0xAE || style="background:#9ab4e3" | ´ || 0xB4 || 0xB4 || latin capital letter z with caron || Substitute char "accute accent" at 0xB4
|-

| U+017E || ž || 0xB8 || style="background:#9ab4e3" | ¸ || style="background:#ebbb54;" | 0xBE || style="background:#9ab4e3" | ¸ || 0xB8 || 0xB8 || latin small letter z with caron || Substitute char "cedilla" at 0xB8
|- style="background:#dbab8a;"

| U+01D3 || Ǔ || 0x8A || || || || || || latin capital u with caron || Not found in ISO-8859. Pinyin tone marking
|- style="background:#dbab8a;"

| U+01D4 || ǔ || 0x9A || || || || || || latin small u with caron || Not found in ISO-8859. Pinyin tone marking
|-

| U+0218 || Ș || 0x8D || || || || || style="background:#ebbb54;" | 0xAA || latin capital letter s with comma below || See also "...with cedilla"
|-

| U+0219 || ș || 0x9D || || || || || style="background:#ebbb54;" | 0xBA || latin small letter s with comma below || See also "...with cedilla"
|-

| U+021A || Ț || 0x8E || || || || || style="background:#ebbb54;" | 0xDE || latin capital letter t with comma below || See also "...with cedilla"
|-

| U+021B || ț || 0x9E || || || || || style="background:#ebbb54;" | 0xFE || latin small letter t with comma below || See also "...with cedilla"
|- style="color:#8c8c8c;"

| U+02C7 || ˇ || || || || 0xB7 || || || caron ||
|- style="color:#8c8c8c;"

| U+02D8 || ˘ || || || || 0xA2 || || || breve ||
|- style="color:#8c8c8c;"

| U+02D9 || ˙ || || || || 0xFF || || || dot above ||
|- style="color:#8c8c8c;"

| U+02DB || ˛ || || || || 0xB2 || || || ogonek ||
|- style="color:#8c8c8c;"

| U+02DD || ˝ || || || || 0xBD || || || double acute accent ||
|- style="background:#dbab8a;"

| U+1E90 || Ẑ || 0x87 || || || || || || latin capital z with circumflex || Not found in ISO-8859. Rare use in Cyrillic-to-Latin transliteration, or Pinyin
|- style="background:#dbab8a;"

| U+1E91 || ẑ || 0x97 || || || || || || latin small z with circumflex || Not found in ISO-8859. Rare use in Cyrillic-to-Latin transliteration, or Pinyin
|- style="color:#8c8c8c;"

| U+201D || ” || || || || || || 0xB5 || right double quotation mark ||
|- style="color:#8c8c8c;"

| U+201E || „ || || || || || || 0xA5 || double low-9 quotation mark ||
|- style="color:#8c8c8c;"

| U+20AC || € || || || || || 0xA4 || 0xA4 || euro sign ||
|}

Multilanguage Display

2026-06-19T13:32:31Z

Geep: /* Background */ link I18n - Charset page

[PAGE IN PROGRESS]

== Background ==
''This describes a particular challenging use case of a TDM methodology that has been around for some time. The motivation to detail this was a 2026 update by Geep to the language map files, following a revision of Carleton 24pt font used throughout the Main Menu.''

In TDM's main menu, the Settings/Video/Language page attempts to list all the supported languages in their native form with respect to character set, that is, untranslated. Showing multiple language strings together is difficult, but some tricks are available. The result has been a reasonable near-term workaround for this particular page, applicable to comparable cases. (Comprehensive support for multilanguage display likely involves a major restructuring, for instance, moving to a native Unicode architecture with combined Latin and Cyrillic bitmaps.)

Recall that strings for the main menu are found in the utf8 file tdm_base01.pk4/strings/all.lang, where there is are sections for [English], [German], etc. A particular section is used to generate for distribution the corresponding file, e.g., french.lang, german.lang, etc., in a language-specific 8-bit encoding. When you play TDM, and select a given language, the corresponding .lang file (if needed) is read.

Except for Cyrillic Russian, these files use encodings within the ISO-8859 family (as detailed in [[I18N_-_Charset]]). Any specific encoding is a bottleneck... by design, not all characters in any one member of the ISO-8859 family will be accessible by some other members.

== Language Names in Idealized UTF8 Form ==
Only the TDM-exposed languages are shown here. The all.lang file has additional strings for other potential Latin and Cyrillic languages. For reference, the generated encoding for the <language>.lang file is shown in the comment.

"#str_02460" "English" // English [ISO-8859-1]
"#str_02461" "Deutsch" // German [ISO-8859-1]
"#str_02462" "Español" // Spanish [ISO-8859-1]
"#str_02463" "Français" // French [ISO-8859-15]
"#str_02464" "Português" // Portuguese [ISO-8859-1]
"#str_02465" "Polski" // Polish [ISO-8859-2]
"#str_02466" "Italiano" // Italian [ISO-8859-1]
"#str_02467" "Česky" // Czech [ISO-8859-2]
"#str_02468" "Русский" // Russian [WIN-1251]
"#str_02469" "Català" // Catalan [ISO-8859-1]
"#str_02470" "Dansk" // Danish [ISO-8859-1]
"#str_02472" "Nederlands" // Dutch [ISO-8859-1]
"#str_02474" "Magyar" // Hungarian [ISO-8859-2]
"#str_02476" "Svenska" // Swedish [ISO-8859-1]
"#str_02477" "Türkçe" // Turkish [ISO-8859-9]
"#str_02479" "Română" // Romanian [ISO-8859-16]
"#str_02480" "Slovenčina" // Slovak [ISO-8859-2]

== First Compromise – Cyrillic vs. Latin Font ==
While there is some overlap in characters between Cyrillic and Latin encodings, it is insufficient for our purposes. So, for [English] and other European sections, a Latin transliteration from Cyrillic is used:

"#str_02468" "Russkiy" // Russian

Going the other way, for [Russian], the current treatment is not to do a Cyrillic transliteration from Latin, but instead to drop accents, rendering just in ASCII (except of course “Russian”), e.g.:

"#str_02460" "English" // English
"#str_02461" "Deutsch" // German
"#str_02462" "Espanol" // Spanish
"#str_02463" "Francais" // French
"#str_02464" "Portugues" // Portuguese
"#str_02465" "Polski" // Polish
"#str_02466" "Italiano" // Italian
"#str_02467" "Cesky" // Czech
"#str_02468" "Русский" // Russian
"#str_02469" "Catala" // Catalan
"#str_02470" "Dansk" // Danish
"#str_02472" "Nederlands" // Dutch
"#str_02474" "Magyar" // Hungarian
"#str_02476" "Svenska" // Swedish
"#str_02477" "Turkce" // Turkish
"#str_02479" "Romana" // Romanian
"#str_02480" "Slovencina" // Slovak

== Moving between ISO-8859 Members ==
In the discussion here, let “L1” be the current language (from the player’s perspective) or the [language] section of interest in all.lang (from the translator’s perspective). Let “L2” be the language of the foreign word, i.e., L1 and L2 differ.

=== Type and Go ===
In several cases, the translator merely puts the ideal character in the all.lang strings. After <language>.lang generation, everything works. Cases are:

# L1 and L2 are both use the same ISO-8859 encoding. (Specifically, they are either both ISO-8859-1, which doesn’t need <language>.map files, or both ISO-8859-2, and have <language>.map files with, by convention, identical contents.) NOTE: For TDM’s purposes, ISO-8859-15 (French) can be considered part of the ISO-8859-1 family.
# L2 character is ASCII (i.e., in ISO range 0x00-0x7f). This is always the case if L2 = English. Characters in this range have identical codepoints in all five TDM-supported ISO-8859 and in the TDM target encoding.
# L2 character is in the ISO range 0xA0-0xFF, with additional constraints.

For the last case, the L2 character must be either:
* present at the same codepoint in all five TDM-supported ISO-8859 encodings, and in the TDM target encoding. For our Latin language names, these accented characters are like that:
ç in "Français" and "Türkçe" at 0xE7
à in "Català" at 0xEA
â in "Română" at 0xE2
ü in "Türkçe" at 0xFC
* present at the same codepoint in ISO-8859 encodings for L1 and L2, and in the TDM target encoding.
* present in different codepoints in ISO-8859 encodings for L1 and L2, but with each being either the same as the TDM target encoding, or mapped to the TDM target encoding by the <language>.map file.

=== Tricks ===
If the L2 character is not represented in the ISO encoding for L1, then at <L1>.lang generation time, it will be replaced by a “?”. To work around this, the translator has two methods:

====Trick Method 1 – Direct Stuffing====
When L1 encoding is ISO-8859-1 (or -9 or -15, which all have identical encodings for the 0xA0-BF ranges) and L2 character is in TDM’s 0xA0-0xBF range (or D7, F7), then you can lookup the ISO character associated with that codepoint (shown in parentheses in cells of the i18n- charmap table), and type it. Examples:

[English] // and other ISO-8859-1, -9, or -15
"#str_02467" "¬esky" // our default mapping is ISO 8859-1, so ¬ is shown as Č (¬)
"#str_02480" "Sloven®ina" // Slovak (® in ISO-8859-1 is č in our font)

Here’s another example of that last stuffing from a TDM-unexposed language, showing also a diaresis (0xA8):

"#str_02481" "Sloven¨®ina" // Slovenian (southern slovenia) (¨ => š)

In this case, ISO-8859-1 would need to use the diaresis, but ISO-8859-15 (French) would not, i.e., could type and go with š.
The spreadsheet shows all available substitutions in light blue.

====Trick Method 2 – Special Mapping with Repurposed Character====
If all else fails, a little-used character in L1 can be redirected to the L2 codepoint TDM wants, by an extra mapping command in the <L1>.map file. Current such tricks are...

To get ñ for "Español":

* for iso 2, put ¨ (diaeresis 0xA8)
* for iso 16, put ¶ (pilcrow 0xB6)

To get ê for "Português":

*for iso 2: Put ´ (acute accent 0xBD)

== Details of TDM and ISO Char Sets and Potential Tricks and Limitations ==
[WORK IN PROGRESS][COLOR CODING NOT RIGHT YET]

The main table below (after the Key) was drafted by Google AI, from a prompt that defined the header and an example row, and specified:

"Rows are a combine of all the printable 8-bit codepoints in the range 0x80-0xff defined in ISO-8859-1, -2, -9, -15, and -16. The rows are ordered by Unicode number. If a particular ISO standard does not include the character, leave that cell blank."

Subsequently, the TDM and Comments columns were filled in by Geep, and color coding added.
Language mappings were independently color coded, then verified against existing language maps.
This table skips codepoints in the range 0x00-0x7f, because they are the same for all ISO-8859 standards. No mapping required.

{| class="wikitable" style="font-size: 95%; line-height: 1.3em;"
|+ Color Key
! Cell !! Meaning
|-

| style="color:#8c8c8c;" | Light Gray Text Row || Symbol not included in TDM custom character set (so TDM column blank). Can use for char substitution tricks.
|-

| 0xNN on white || Type desired utf8 char (in Symbol column) in all.lang. Generation goes directly to TDM codepoint given.
|-

| style="background:#ebbb54;" | 0xNN, amber hilite || Type desired utf8 char in all.lang. Generation + mapping (in <language>.map file) goes to TDM codepoint via codepoint shown.
|-

| style="background:#ebbb54;color:#606060;" | 0xNN in gray || Type desired utf8 char in all.lang. Generation + mapping (in <language>.map file) goes to TDM codepoint OF SUBSTITUTE CHARACTER via codepoint shown.
|-

| style="background:#ebbb54;color:#ff0000;" | 0xNN in red || Character not part of this ISO. "0xnn" shown is not ISO, but for trick mapping (in <language.map), to support main menu's multilingual "Languages" page.
|-

| style="background:#9ab4e3;" | Substitute Char || Character not part of this ISO. But as trick, you can stuff in this substitute char at the needed TDM codepoint.
|-

| style="background:#43a8cc;" | n/a || Not available to use substitute character, due to trick mapping (in <language>.map) elsewhere.
|-

| Empty Cell || In ISO column, means character not part of this ISO (so may be candidate for future trick mapping; or simply not fully analyzed viz substitute char.)
|-

| style="background:#dbab8a;" | Tan Row || Orphaned character in TDM set, not part of 5 ISO-8859 standards for current TDM-supported languages.
|-
|}

{| class="wikitable" style="font-size: 95%; line-height: 1.3em;"
|+ Unicode Coverage for TDM
! Unicode !! Symbol !! TDM !! 1 !! 2 !! 9 !! 15 !! 16 !! Unicode Name !! Comments
|-

| U+00A0 ||   || 0xA0 || 0xA0 || 0xA0 || 0xA0 || 0xA0 || 0xA0 || no-break space ||
|- style="color:#8c8c8c;"

| U+00A1 || ¡ || || 0xA1 || || 0xA1 || 0xA1 || || inverted exclamation mark ||
|- style="color:#8c8c8c;"

| U+00A2 || ¢ || || 0xA2 || || 0xA2 || 0xA2 || || cent sign ||
|- style="color:#8c8c8c;"

| U+00A3 || £ || || 0xA3 || || 0xA3 || 0xA3 || || pound sign ||
|- style="color:#8c8c8c;"

| U+00A4 || ¤ || || 0xA4 || 0xA4 || 0xA4 || || || currency sign ||
|- style="color:#8c8c8c;"

| U+00A5 || ¥ || || 0xA5 || || 0xA5 || 0xA5 || || yen sign ||
|- style="color:#8c8c8c;"

| U+00A6 || ¦ || || 0xA6 || || 0xA6 || || || broken bar ||
|-

| U+00A7 || § || 0xA7 || 0xA7 || 0xA7 || 0xA7 || 0xA7 || 0xA7 || section sign ||
|- style="color:#8c8c8c;"

| U+00A8 || ¨ || || 0xA8 || 0xA8 || 0xA8 || || || diaeresis || See also hack use for ñ
|- style="color:#8c8c8c;"

| U+00A9 || © || || 0xA9 || || 0xA9 || 0xA9 || 0xA9 || copyright sign ||
|- style="color:#8c8c8c;"

| U+00AA || ª || || 0xAA || || 0xAA || 0xAA || || feminine ordinal indicator ||
|- style="color:#8c8c8c;"

| U+00AB || « || || 0xAB || || 0xAB || 0xAB || 0xAB || left-pointing double angle quotation mark ||
|- style="color:#8c8c8c;"

| U+00AC || ¬ || || 0xAC || || 0xAC || 0xAC || || not sign ||
|-

| U+00AD || || 0xAD || 0xAD || 0xAD || 0xAD || 0xAD || 0xAD || soft hyphen ||
|- style="color:#8c8c8c;"

| U+00AE || ® || || 0xAE || || 0xAE || 0xAE || || registered sign ||
|- style="color:#8c8c8c;"

| U+00AF || ¯ || || 0xAF || || 0xAF || 0xAF || || macron ||
|- style="color:#8c8c8c;"

| U+00B0 || ° || || 0xB0 || 0xB0 || 0xB0 || 0xB0 || 0xB0 || degree sign ||
|- style="color:#8c8c8c;"

| U+00B1 || ± || || 0xB1 || || 0xB1 || 0xB1 || 0xB1 || plus-minus sign ||
|- style="color:#8c8c8c;"

| U+00B2 || ² || || 0xB2 || || 0xB2 || 0xB2 || || superscript two ||
|- style="color:#8c8c8c;"

| U+00B3 || ³ || || 0xB3 || || 0xB3 || 0xB3 || || superscript three ||
|- style="color:#8c8c8c;"

| U+00B4 || ´ || || 0xB4 || 0xB4 || 0xB4 || || || acute accent ||
|- style="color:#8c8c8c;"

| U+00B5 || µ || || 0xB5 || || 0xB5 || 0xB5 || || micro sign ||
|- style="color:#8c8c8c;"

| U+00B6 || ¶ || || 0xB6 || || 0xB6 || 0xB6 || 0xB6 || pilcrow sign ||
|- style="color:#8c8c8c;"

| U+00B7 || · || || 0xB7 || || 0xB7 || 0xB7 || 0xB7 || middle dot ||
|- style="color:#8c8c8c;"

| U+00B8 || ¸ || || 0xB8 || 0xB8 || 0xB8 || || || cedilla ||
|- style="color:#8c8c8c;"

| U+00B9 || ¹ || || 0xB9 || || 0xB9 || 0xB9 || || superscript one ||
|- style="color:#8c8c8c;"

| U+00BA || º || || 0xBA || || 0xBA || 0xBA || || masculine ordinal indicator ||
|- style="color:#8c8c8c;"

| U+00BB || » || || 0xBB || || 0xBB || 0xBB || 0xBB || right-pointing double angle quotation mark ||
|- style="color:#8c8c8c;"

| U+00BC || ¼ || || 0xBC || || 0xBC || || || vulgar fraction one quarter ||
|- style="color:#8c8c8c;"

| U+00BD || ½ || || 0xBD || || 0xBD || || || vulgar fraction one half ||
|- style="color:#8c8c8c;"

| U+00BE || ¾ || || 0xBE || || 0xBE || || || vulgar fraction three quarters ||
|-

| U+00BF || ¿ || 0xBF || 0xBF || || 0xBF || 0xBF || || inverted question mark ||
|-

| U+00C0 || À || 0xC0 || 0xC0 || || 0xC0 || 0xC0 || 0xC0 || latin capital letter a with grave ||
|-

| U+00C1 || Á || 0xC1 || 0xC1 || 0xC1 || 0xC1 || 0xC1 || 0xC1 || latin capital letter a with acute ||
|-

| U+00C2 || Â || 0xC2 || 0xC2 || 0xC2 || 0xC2 || 0xC2 || 0xC2 || latin capital letter a with circumflex ||
|-

| U+00C3 || Ã || 0xC3 || 0xC3 || || 0xC3 || 0xC3 || || latin capital letter a with tilde ||
|-

| U+00C4 || Ä || 0xC4 || 0xC4 || 0xC4 || 0xC4 || 0xC4 || 0xC4 || latin capital letter a with diaeresis ||
|-

| U+00C5 || Å || 0xC5 || 0xC5 || || 0xC5 || 0xC5 || || latin capital letter a with ring above ||
|-

| U+00C6 || Æ || 0xC6 || 0xC6 || || 0xC6 || 0xC6 || 0xC6 || latin capital letter ae ||
|-

| U+00C7 || Ç || 0xC7 || 0xC7 || 0xC7 || 0xC7 || 0xC7 || 0xC7 || latin capital letter c with cedilla ||
|-

| U+00C8 || È || 0xC8 || 0xC8 || || 0xC8 || 0xC8 || 0xC8 || latin capital letter e with grave ||
|-

| U+00C9 || É || 0xC9 || 0xC9 || 0xC9 || 0xC9 || 0xC9 || 0xC9 || latin capital letter e with acute ||
|-

| U+00CA || Ê || 0xCA || 0xCA || || 0xCA || 0xCA || 0xCA || latin capital letter e with circumflex ||
|-

| U+00CB || Ë || 0xCB || 0xCB || 0xCB || 0xCB || 0xCB || 0xCB || latin capital letter e with diaeresis ||
|-

| U+00CC || Ì || 0xCC || 0xCC || || 0xCC || 0xCC || 0xCC || latin capital letter i with grave ||
|-

| U+00CD || Í || 0xCD || 0xCD || 0xCD || 0xCD || 0xCD || 0xCD || latin capital letter i with acute ||
|-

| U+00CE || Î || 0xCE || 0xCE || 0xCE || 0xCE || 0xCE || 0xCE || latin capital letter i with circumflex ||
|-

| U+00CF || Ï || 0xCF || 0xCF || || 0xCF || 0xCF || 0xCF || latin capital letter i with diaeresis ||
|-

| U+00D0 || Ð || 0xD0 || 0xD0 || || style="color:#ff0000; font-weight:bold;" | n/a || 0xD0 || || latin capital letter eth || Same glyph as U+0110 latin capital letter d with stroke
|-

| U+00D1 || Ñ || 0xD1 || 0xD1 || || 0xD1 || 0xD1 || || latin capital letter n with tilde ||
|-

| U+00D2 || Ò || 0xD2 || 0xD2 || || 0xD2 || 0xD2 || 0xD2 || latin capital letter o with grave ||
|-

| U+00D3 || Ó || 0xD3 || 0xD3 || 0xC1 || 0xD3 || 0xD3 || 0xD3 || latin capital letter o with acute ||
|-

| U+00D4 || Ô || 0xD4 || 0xD4 || 0xD4 || 0xD4 || 0xD4 || 0xD4 || latin capital letter o with circumflex || Formerly also mapped from 0x88; redundant, Ğ has 0x88 codepoint now
|-

| U+00D5 || Õ || 0xD5 || 0xD5 || || 0xD5 || 0xD5 || || latin capital letter o with tilde ||
|-

| U+00D6 || Ö || 0xD6 || 0xD6 || 0xD6 || 0xD6 || 0xD6 || 0xD6 || latin capital letter o with diaeresis ||
|- style="color:#8c8c8c;"

| U+00D7 || × || || 0xD7 || 0xD7 || 0xD7 || 0xD7 || || multiplication sign ||
|-

| U+00D8 || Ø || 0xD8 || 0xD8 || || 0xD8 || 0xD8 || || latin capital letter o with stroke ||
|-

| U+00D9 || Ù || 0xD9 || 0xD9 || || 0xD9 || 0xD9 || 0xD9 || latin capital letter u with grave ||
|-

| U+00DA || Ú || 0xDA || 0xDA || 0xDA || 0xDA || 0xDA || 0xDA || latin capital letter u with acute ||
|-

| U+00DB || Û || 0xDB || 0xDB || || 0xDB || 0xDB || 0xDB || latin capital letter u with circumflex ||
|-

| U+00DC || Ü || 0xDC || 0xDC || 0xDC || 0xDC || 0xDC || 0xDC || latin capital letter u with diaeresis ||
|-

| U+00DD || Ý || 0xDD || 0xDD || 0xDD || || 0xDD || || latin capital letter y with acute ||
|-

| U+00DE || Þ || 0xDE || 0xDE || || || 0xDE || || latin capital letter thorn ||
|-

| U+00DF || ß || 0xDF || 0xDF || 0xDF || 0xDF || 0xDF || 0xDF || latin small letter sharp s ||
|-

| U+00E0 || à || 0xE0 || 0xE0 || || 0xE0 || 0xE0 || 0xE0 || latin small letter a with grave ||
|-

| U+00E1 || á || 0xE1 || 0xE1 || 0xE1 || 0xE1 || 0xE1 || 0xE1 || latin small letter a with acute ||
|-

| U+00E2 || â || 0xE2 || 0xE2 || 0xE2 || 0xE2 || 0xE2 || 0xE2 || latin small letter a with circumflex ||
|-

| U+00E3 || ã || 0xE3 || 0xE3 || || 0xE3 || 0xE3 || || latin small letter a with tilde ||
|-

| U+00E4 || ä || 0xE4 || 0xE4 || 0xE4 || 0xE4 || 0xE4 || 0xE4 || latin small letter a with diaeresis ||
|-

| U+00E5 || å || 0xE5 || 0xE5 || || 0xE5 || 0xE5 || || latin small letter a with ring above ||
|-

| U+00E6 || æ || 0xE6 || 0xE6 || || 0xE6 || 0xE6 || 0xE6 || latin small letter ae ||
|-

| U+00E7 || ç || 0xE7 || 0xE7 || 0xE7 || 0xE7 || 0xE7 || 0xE7 || latin small letter c with cedilla ||
|-

| U+00E8 || è || 0xE8 || 0xE8 || || 0xE8 || 0xE8 || 0xE8 || latin small letter e with grave ||
|-

| U+00E9 || é || 0xE9 || 0xE9 || 0xE9 || 0xE9 || 0xE9 || 0xE9 || latin small letter e with acute ||
|-

| U+00EA || ê || 0xEA || 0xEA || style="background:#ffe4b5;" | 0xBD || 0xEA || 0xEA || 0xEA || latin small letter e with circumflex || Hack for iso 2: Put ´ (acute accent, 0xBD) to get ê for "Português"
|-

| U+00EB || ë || 0xEB || 0xEB || 0xEB || 0xEB || 0xEB || 0xEB || latin small letter e with diaeresis ||
|-

| U+00EC || ì || 0xEC || 0xEC || || 0xEC || 0xEC || 0xEC || latin small letter i with grave ||
|-

| U+00ED || í || 0xED || 0xED || 0xED || 0xED || 0xED || 0xED || latin small letter i with acute ||
|-

| U+00EE || î || 0xEE || 0xEE || 0xEE || 0xEE || 0xEE || 0xEE || latin small letter i with circumflex ||
|-

| U+00EF || ï || 0xEF || 0xEF || || 0xEF || 0xEF || 0xEF || latin small letter i with diaeresis ||
|-

| U+00F0 || ð || 0xF0 || 0xF0 || || || 0xF0 || || latin small letter eth ||
|-

| U+00F1 || ñ || 0xF1 || 0xF1 || style="background:#ffe4b5;" | 0xA8 || 0xF1 || 0xF1 || style="background:#ffe4b5;" | 0xB6 || latin small letter n with tilde || Hacks to get ñ for "Español": for iso 2, put ¨ (diaeresis 0xA8); for iso 16, put ¶ (0xB6)
|-

| U+00F2 || ò || 0xF2 || 0xF2 || || 0xF2 || 0xF2 || 0xF2 || latin small letter o with grave ||
|-

| U+00F3 || ó || 0xF3 || 0xF3 || 0xF3 || 0xF3 || 0xF3 || 0xF3 || latin small letter o with acute ||
|-

| U+00F4 || ô || 0xF4 || 0xF4 || 0xF4 || 0xF4 || 0xF4 || 0xF4 || latin small letter o with circumflex || Formerly also mapped from 0x88; redundant, ğ has TDM 0x88 codepoint now
|-

| U+00F5 || õ || 0xF5 || 0xF5 || || 0xF5 || 0xF5 || || latin small letter o with tilde ||
|-

| U+00F6 || ö || 0xF6 || 0xF6 || 0xF6 || 0xF6 || 0xF6 || 0xF6 || latin small letter o with diaeresis ||
|- style="color:#8c8c8c;"

| U+00F7 || ÷ || || 0xF7 || 0xF7 || 0xF7 || 0xF7 || || division sign ||
|-

| U+00F8 || ø || 0xF8 || 0xF8 || || 0xF8 || 0xF8 || || latin small letter o with stroke ||
|-

| U+00F9 || ù || 0xF9 || 0xF9 || || 0xF9 || 0xF9 || 0xF9 || latin small letter u with grave ||
|-

| U+00FA || ú || 0xFA || 0xFA || 0xFA || 0xFA || 0xFA || 0xFA || latin small letter u with acute ||
|-

| U+00FB || û || 0xFB || 0xFB || || 0xFB || 0xFB || 0xFB || latin small letter u with circumflex ||
|-

| U+00FC || ü || 0xFC || 0xFC || 0xFC || 0xFC || 0xFC || 0xFC || latin small letter u with diaeresis ||
|-

| U+00FD || ý || 0xFD || 0xFD || 0xFD || || 0xFD || || latin small letter y with acute ||
|-

| U+00FE || þ || 0xFE || 0xFE || || || 0xFE || || latin small letter thorn ||
|-

| U+00FF || ÿ || 0xFF || 0xFF || || 0xFF || 0xFF || 0xFF || latin small letter y with diaeresis ||
|-

| U+0102 || Ă || 0x8B || || style="background:#ffe4b5;" | 0xC3 || || || style="background:#ffe4b5;" | 0xC3 || latin capital letter a with breve ||
|-

| U+0103 || ă || 0x9B || || style="background:#ffe4b5;" | 0xE3 || || || style="background:#ffe4b5;" | 0xE3 || latin small letter a with breve ||
|-

| U+0104 || Ą || 0xAA || style="color:#7a7a7a; font-style:italic;" | ª || 0xA1 || style="color:#7a7a7a; font-style:italic;" | ª || style="color:#7a7a7a; font-style:italic;" | ª || 0xA1 || latin capital letter a with ogonek ||
|-

| U+0105 || ą || 0xBA || style="color:#7a7a7a; font-style:italic;" | º || 0xB1 || style="color:#7a7a7a; font-style:italic;" | º || style="color:#7a7a7a; font-style:italic;" | º || 0xA2 || latin small letter a with ogonek ||
|-

| U+0106 || Ć || 0x82 || || 0xC6 || || || 0xC5 || latin capital letter c with acute ||
|-

| U+0107 || ć || 0x92 || || 0xE6 || || || 0xE5 || latin small letter c with acute ||
|-

| U+0108 || Ĉ || 0x86 || || || || || || latin capital c with circumflex || Only in ISO-8859-3 (for Esperanto) at 0xC6
|-

| U+0109 || ĉ || 0x96 || || || || || || latin small c with circumflex || Only in ISO-8859-3 (for Esperanto) at 0xE6
|-

| U+010C || Č || 0xAC || style="color:#7a7a7a; font-style:italic;" | ¬ || 0xC8 || style="color:#7a7a7a; font-style:italic;" | ¬ || style="color:#7a7a7a; font-style:italic;" | ¬ || 0xB2 || latin capital letter c with caron || Substitute char "not sign" at 0xAC
|-

| U+010D || č || 0xAE || style="color:#7a7a7a; font-style:italic;" | ® || 0xE8 || style="color:#7a7a7a; font-style:italic;" | ® || style="color:#7a7a7a; font-style:italic;" | ® || 0xB9 || latin small letter c with caron || Substitute char "registration sign" at 0xAE
|-

| U+010E || Ď || 0xB3 || style="color:#7a7a7a; font-style:italic;" | ³ || 0xCF || style="color:#7a7a7a; font-style:italic;" | ³ || style="color:#7a7a7a; font-style:italic;" | ³ || || latin capital letter d with caron || Substitute char "superscript three" at 0xB3
|-

| U+010F || ď || 0xB7 || style="color:#7a7a7a; font-style:italic;" | · || 0xEF || style="color:#7a7a7a; font-style:italic;" | · || style="color:#7a7a7a; font-style:italic;" | · || || latin small letter d with caron || Substitute char "middle dot" at 0xB7
|-

| U+0110 || Đ || 0xD0 || 0xD0 || 0xD0 || style="color:#ff0000; font-weight:bold;" | n/a || || 0xD0 || latin capital letter d with stroke || Same glyph as U+00D0 latin capital letter eth
|-

| U+0111 || đ || 0x90 || || 0xF0 || style="color:#ff0000; font-weight:bold;" | n/a || || 0xF0 || latin small letter d with stroke ||
|-

| U+0118 || Ę || 0xAB || style="color:#7a7a7a; font-style:italic;" | « || style="background:#ffe4b5;" | 0xCA || style="color:#7a7a7a; font-style:italic;" | « || style="color:#7a7a7a; font-style:italic;" | « || 0xDD || latin capital letter e with ogonek || Substitute char "left-pointing double angle quotation mark" at 0xAB
|-

| U+0119 || ę || 0xBB || style="color:#7a7a7a; font-style:italic;" | » || style="background:#ffe4b5;" | 0xEA || style="color:#7a7a7a; font-style:italic;" | » || style="color:#7a7a7a; font-style:italic;" | » || 0xFD || latin small letter e with ogonek || Substitute char "right-pointing double angle quotation mark" at 0xBB
|-

| U+011A || Ě || 0xA5 || style="color:#7a7a7a; font-style:italic;" | ¥ || 0xCC || style="color:#7a7a7a; font-style:italic;" | ¥ || style="color:#7a7a7a; font-style:italic;" | ¥ || || latin capital letter e with caron || Substitute char "yen sign" at 0xA5
|-

| U+011B || ě || 0xA3 || style="color:#7a7a7a; font-style:italic;" | £ || 0xEC || style="color:#7a7a7a; font-style:italic;" | £ || style="color:#7a7a7a; font-style:italic;" | £ || || latin small letter e with caron || Substitute char "pound sign" at 0xA3
|-

| U+011E || Ğ || 0x88 || || || 0xD0 || || || latin capital letter g with breve || As of TDM 2.13
|-

| U+011F || ğ || 0x98 || || || 0xF0 || || || latin small letter g with breve || As of TDM 2.13
|- style="color:#8c8c8c;"

| U+0130 || İ || || || || style="background:#ffe4b5;" | 0xDD || || || latin capital letter i with dot above || Turkish: utf8 "İ" will be mapped to "Î" (0xCE)
|- style="color:#8c8c8c;"

| U+0131 || ı || || || || style="background:#ffe4b5;" | 0xFD || || || latin small letter dotless i || Turkish: utf8 "ı" will be mapped to ASCII "i" (0x69)
|- style="color:#8c8c8c;"

| U+0139 || Ĺ || || || 0xC5 || || || || latin capital letter l with acute ||
|- style="color:#8c8c8c;"

| U+013A || ĺ || || || 0xE5 || || || || latin small letter l with acute ||
|- style="color:#8c8c8c;"

| U+013D || Ľ || || || 0xA5 || || || || latin capital letter l with caron ||
|- style="color:#8c8c8c;"

| U+013E || ľ || || || 0xB5 || || || || latin small letter l with caron ||
|-

| U+0141 || Ł || 0xB1 || style="color:#7a7a7a; font-style:italic;" | ± || 0xA3 || style="color:#7a7a7a; font-style:italic;" | ± || style="color:#7a7a7a; font-style:italic;" | ± || 0xA3 || latin capital letter l with stroke || Substitute char "plus-minus sign" at 0xB1
|-

| U+0142 || ł || 0xB5 || style="color:#7a7a7a; font-style:italic;" | µ || 0xB3 || style="color:#7a7a7a; font-style:italic;" | µ || style="color:#7a7a7a; font-style:italic;" | µ || 0xB3 || latin small letter l with stroke || Substitute char "micro sign" at 0xB5
|-

| U+0143 || Ń || 0x8C || || 0xD1 || || || 0xD1 || latin capital letter n with acute ||
|-

| U+0144 || ń || 0x9C || || 0xF1 || || || 0xF1 || latin small letter n with acute ||
|-

| U+0147 || Ň || 0x80 || || 0xD2 || || || || latin capital letter n with caron ||
|-

| U+0148 || ň || 0xA1 || style="color:#7a7a7a; font-style:italic;" | ¡ || 0xF2 || style="color:#7a7a7a; font-style:italic;" | ¡ || style="color:#7a7a7a; font-style:italic;" | ¡ || || latin small letter n with caron || Substitute char "inverted exclamation mark" at 0xA1
|-

| U+0150 || Ő || 0xB0 || style="color:#7a7a7a; font-style:italic;" | ° || style="background:#ffe4b5;" | 0xD5 || style="color:#7a7a7a; font-style:italic;" | ° || style="color:#7a7a7a; font-style:italic;" | ° || style="background:#ffe4b5;" | 0xD5 || latin capital letter o with double acute || Similiar to Ö, used in Hungarian. Substitute char "degree sign" at 0xB0
|-

| U+0151 || ő || 0xB9 || style="color:#7a7a7a; font-style:italic;" | ¹ || style="background:#ffe4b5;" | 0xF5 || style="color:#7a7a7a; font-style:italic;" | ¹ || style="color:#7a7a7a; font-style:italic;" | ¹ || style="background:#ffe4b5;" | 0xF5 || latin small letter o with double acute || Similiar to ö, used in Hungarian. Substitute char "superscript 1" at 0xB9
|-

| U+0152 || Œ || 0xBC || style="color:#7a7a7a; font-style:italic;" | ¼ || || style="color:#7a7a7a; font-style:italic;" | ¼ || 0xBC || 0xBC || latin capital ligature oe || Substitute char "vulgar fraction one quarter" at 0xBC
|-

| U+0153 || œ || 0xBD || style="color:#7a7a7a; font-style:italic;" | ½ || || style="color:#7a7a7a; font-style:italic;" | ½ || 0xBD || 0xBD || latin small ligature oe || Substitute char "vulgar fraction one half" at 0xBD
|-

| U+0154 || Ŕ || 0x89 || || 0xC0 || || || || latin capital letter r with acute ||
|-

| U+0155 || ŕ || 0x99 || || 0xE0 || || || || latin small letter r with acute ||
|-

| U+0158 || Ř || 0xD7 || style="color:#7a7a7a; font-style:italic;" | × || style="background:#ffe4b5;" | 0xD8 || style="color:#7a7a7a; font-style:italic;" | × || style="color:#7a7a7a; font-style:italic;" | × || || latin capital letter r with caron || Substitute char "multiple sign" at 0xD7
|-

| U+0159 || ř || 0xF7 || style="color:#7a7a7a; font-style:italic;" | ÷ || style="background:#ffe4b5;" | 0xF8 || style="color:#7a7a7a; font-style:italic;" | ÷ || style="color:#7a7a7a; font-style:italic;" | ÷ || || latin small letter r with caron || Substitute char "divide sign" at 0xF7
|-

| U+015A || Ś || 0x81 || || 0xA6 || || || style="background:#ffe4b5;" | 0xD7 || latin capital letter s with acute ||
|-

| U+015B || ś || 0x91 || || 0xB6 || || || style="background:#ffe4b5;" | 0xF7 || latin small letter s with acute ||
|-

| U+015C || Ŝ || 0x85 || || || || || || latin capital letter s with circumflex || Only in ISO-8859-3 (for Esperanto) at 0xDE
|-

| U+015D || ŝ || 0x95 || || || || || || latin small letter s with circumflex || Only in ISO-8859-3 (for Esperanto) at 0xFE
|-

| U+015E || Ş || 0x8D || || 0xAA || style="background:#ffe4b5;" | 0xDE || || || latin capital letter s with cedilla || Can stand in for "...comma under"
|-

| U+015F || ş || 0x9D || || 0xBA || style="background:#ffe4b5;" | 0xFE || || || latin small letter s with cedilla || Can stand in for "...comma under"
|-

| U+0160 || Š || 0xA6 || style="color:#7a7a7a; font-style:italic;" | ¦ || 0xA9 || style="color:#7a7a7a; font-style:italic;" | ¦ || 0xA6 || 0xA6 || latin capital letter s with caron || Substitute char "broken bar" at 0xA6
|-

| U+0161 || š || 0xA8 || style="color:#7a7a7a; font-style:italic;" | ¨ || 0xB9 || style="color:#7a7a7a; font-style:italic;" | ¨ || 0xA8 || 0xA8 || latin small letter s with caron || Substitute char "diaeresis" at 0xA8
|-

| U+0162 || Ţ || 0x8E || || style="background:#ffe4b5;" | 0xDE || || || || latin capital letter t with cedilla || Can stand in for "...comma under"
|-

| U+0163 || ţ || 0x9E || || style="background:#ffe4b5;" | 0xFE || || || || latin small letter t with cedilla || Can stand in for "...comma under"
|-

| U+0164 || Ť || 0xB2 || style="color:#7a7a7a; font-style:italic;" | ² || 0xAB || style="color:#7a7a7a; font-style:italic;" | ² || style="color:#7a7a7a; font-style:italic;" | ² || || latin capital letter t with caron || Substitute char "superscript two" at 0xB2
|-

| U+0165 || ť || 0xB6 || style="color:#7a7a7a; font-style:italic;" | ¶ || 0xBB || style="color:#7a7a7a; font-style:italic;" | ¶ || style="color:#7a7a7a; font-style:italic;" | ¶ || || latin small letter t with caron || Substitute char "pilcrow sign" at 0xB6
|-

| U+016E || Ů || 0xA9 || style="color:#7a7a7a; font-style:italic;" | © || 0xD9 || style="color:#7a7a7a; font-style:italic;" | © || style="color:#7a7a7a; font-style:italic;" | © || || latin capital letter u with ring above || Substitute char "copyright sign" at 0xA9
|-

| U+016F || ů || 0xAF || style="color:#7a7a7a; font-style:italic;" | ¯ || 0xF9 || style="color:#7a7a7a; font-style:italic;" | ¯ || style="color:#7a7a7a; font-style:italic;" | ¯ || || latin small letter u with ring above || Substitute char "macron" at 0xAF
|-

| U+0170 || Ű || 0xA2 || style="color:#7a7a7a; font-style:italic;" | ¢ || 0xDB || style="color:#7a7a7a; font-style:italic;" | ¢ || style="color:#7a7a7a; font-style:italic;" | ¢ || style="background:#ffe4b5;" | 0xD8 || latin capital letter u with double acute || Similiar to Ü, used in Hungarian. Substitute char "cent sign" at 0xA2
|-

| U+0171 || ű || 0xA4 || style="color:#7a7a7a; font-style:italic;" | ¤ || 0xFB || style="color:#7a7a7a; font-style:italic;" | ¤ || style="color:#7a7a7a; font-style:italic;" | ¤ || style="background:#ffe4b5;" | 0xF8 || latin small letter u with double acute || Similiar to Ü, used in Hungarian. Substitute char "currency sign" at 0xA4
|-

| U+0178 || Ÿ || 0xBE || style="color:#7a7a7a; font-style:italic;" | ¾ || || style="color:#7a7a7a; font-style:italic;" | ¾ || 0xBE || 0xBE || latin capital letter y with diaeresis || Substitute char "vulgar fraction three quarters" at 0xBE
|-

| U+0179 || Ź || 0x84 || || 0xAC || || || style="color:#7a7a7a; font-style:italic;" | 0xAC || latin capital letter z with acute ||
|-

| U+017A || ź || 0x94 || || 0xBC || || || style="background:#ffe4b5;" | 0xAE || latin small letter z with acute ||
|-

| U+017B || Ż || 0x83 || || 0xAF || || || style="background:#ffe4b5;" | 0xAF || latin capital letter z with dot above ||
|-

| U+017C || ż || 0x93 || || 0xBF || || || style="background:#ffe4b5;" | 0xBF || latin small letter z with dot above ||
|-

| U+017D || Ž || 0xB4 || style="color:#7a7a7a; font-style:italic;" | ´ || 0xAE || style="color:#7a7a7a; font-style:italic;" | ´ || 0xB4 || 0xB4 || latin capital letter z with caron || Substitute char "accute accent" at 0xB4
|-

| U+017E || ž || 0xB8 || style="color:#7a7a7a; font-style:italic;" | ¸ || 0xBE || style="color:#7a7a7a; font-style:italic;" | ¸ || 0xB8 || 0xB8 || latin small letter z with caron || Substitute char "cedilla" at 0xB8
|-

| U+01D3 || Ǔ || 0x8A || || || || || || latin capital u with caron || Not found in ISO-8859. Pinyin tone marking
|-

| U+01D4 || ǔ || 0x9A || || || || || || latin small u with caron || Not found in ISO-8859. Pinyin tone marking
|-

| U+0218 || Ș || 0x8D || || || || || style="background:#ffe4b5;" | 0xAA || latin capital letter s with comma below || See also "...with cedilla"
|-

| U+0219 || ș || 0x9D || || || || || style="background:#ffe4b5;" | 0xBA || latin small letter s with comma below || See also "...with cedilla"
|-

| U+021A || Ț || 0x8E || || || || || style="background:#ffe4b5;" | 0xDE || latin capital letter t with comma below || See also "...with cedilla"
|-

| U+021B || ț || 0x9E || || || || || style="background:#ffe4b5;" | 0xFE || latin small letter t with comma below || See also "...with cedilla"
|- style="color:#8c8c8c;"

| U+02C7 || ˇ || || || || 0xB7 || || || caron ||
|- style="color:#8c8c8c;"

| U+02D8 || ˘ || || || || 0xA2 || || || breve ||
|- style="color:#8c8c8c;"

| U+02D9 || ˙ || || || || style="background:#ffe4b5;" | 0xFF || || || dot above ||
|- style="color:#8c8c8c;"

| U+02DB || ˛ || || || || 0xB2 || || || ogonek ||
|- style="color:#8c8c8c;"

| U+02DD || ˝ || || || || style="background:#ffe4b5;" | 0xBD || || || double acute accent ||
|-

| U+1E90 || Ẑ || 0x87 || || || || || || latin capital z with circumflex || Not found in ISO-8859. Rare use in Cyrillic-to-Latin transliteration, or Pinyin
|-

| U+1E91 || ẑ || 0x97 || || || || || || latin small z with circumflex || Not found in ISO-8859. Rare use in Cyrillic-to-Latin transliteration, or Pinyin
|- style="color:#8c8c8c;"

| U+201D || ” || || || || || || style="background:#ffe4b5;" | 0xB5 || right double quotation mark ||
|- style="color:#8c8c8c;"

| U+201E || „ || || || || || || style="background:#ffe4b5;" | 0xA5 || double low-9 quotation mark ||
|- style="color:#8c8c8c;"

| U+20AC || € || || || || || 0xA4 || 0xA4 || euro sign ||
|}

Multilanguage Display

2026-06-19T13:17:56Z

Geep: Correct colors in table key

[PAGE IN PROGRESS]

== Background ==
''This describes a particular challenging use case of a TDM methodology that has been around for some time. The motivation was a 2026 update by Geep to the language map files, following a revision of Carleton 24pt font used throughout the Main Menu.''

In TDM main menu, the Settings/Video/Language page attempts to list all the supported languages in their native form with respect to character set, that is, untranslated. Showing multiple language strings together is difficult, but some tricks are available. The result has been a reasonable near-term workaround for this particular page, applicable to comparable cases. (Comprehensive support for multilanguage display likely involves a major restructuring, for instance, moving to a native Unicode architecture with combined Latin and Cyrillic bitmaps.)

Recall that strings for the main menu are found in the utf8 file tdm_base01.pk4/strings/all.lang, where there is are sections for [English], [German], etc. A particular section is used to generate for distribution the corresponding language-specific file, e.g., french.lang, german.lang, etc. When you play TDM, and select a given language, the corresponding .lang file (if needed) is read.

Except for Russian, these files use a specific 8-bit encoding within the ISO-8859 family. (The i18n – Char page has specifics here.) This specific encoding is a bottleneck... by design, not all characters in any one member of the ISO-8859 family will be accessible by some other members.

== Language Names in Idealized UTF8 Form ==
Only the TDM-exposed languages are shown here. The all.lang file has additional strings for other potential Latin and Cyrillic languages. For reference, the generated encoding for the <language>.lang file is shown in the comment.

"#str_02460" "English" // English [ISO-8859-1]
"#str_02461" "Deutsch" // German [ISO-8859-1]
"#str_02462" "Español" // Spanish [ISO-8859-1]
"#str_02463" "Français" // French [ISO-8859-15]
"#str_02464" "Português" // Portuguese [ISO-8859-1]
"#str_02465" "Polski" // Polish [ISO-8859-2]
"#str_02466" "Italiano" // Italian [ISO-8859-1]
"#str_02467" "Česky" // Czech [ISO-8859-2]
"#str_02468" "Русский" // Russian [WIN-1251]
"#str_02469" "Català" // Catalan [ISO-8859-1]
"#str_02470" "Dansk" // Danish [ISO-8859-1]
"#str_02472" "Nederlands" // Dutch [ISO-8859-1]
"#str_02474" "Magyar" // Hungarian [ISO-8859-2]
"#str_02476" "Svenska" // Swedish [ISO-8859-1]
"#str_02477" "Türkçe" // Turkish [ISO-8859-9]
"#str_02479" "Română" // Romanian [ISO-8859-16]
"#str_02480" "Slovenčina" // Slovak [ISO-8859-2]

== First Compromise – Cyrillic vs. Latin Font ==
While there is some overlap in characters between Cyrillic and Latin encodings, it is insufficient for our purposes. So, for [English] and other European sections, a Latin transliteration from Cyrillic is used:

"#str_02468" "Russkiy" // Russian

Going the other way, for [Russian], the current treatment is not to do a Cyrillic transliteration from Latin, but instead to drop accents, rendering just in ASCII (except of course “Russian”), e.g.:

"#str_02460" "English" // English
"#str_02461" "Deutsch" // German
"#str_02462" "Espanol" // Spanish
"#str_02463" "Francais" // French
"#str_02464" "Portugues" // Portuguese
"#str_02465" "Polski" // Polish
"#str_02466" "Italiano" // Italian
"#str_02467" "Cesky" // Czech
"#str_02468" "Русский" // Russian
"#str_02469" "Catala" // Catalan
"#str_02470" "Dansk" // Danish
"#str_02472" "Nederlands" // Dutch
"#str_02474" "Magyar" // Hungarian
"#str_02476" "Svenska" // Swedish
"#str_02477" "Turkce" // Turkish
"#str_02479" "Romana" // Romanian
"#str_02480" "Slovencina" // Slovak

== Moving between ISO-8859 Members ==
In the discussion here, let “L1” be the current language (from the player’s perspective) or the [language] section of interest in all.lang (from the translator’s perspective). Let “L2” be the language of the foreign word, i.e., L1 and L2 differ.

=== Type and Go ===
In several cases, the translator merely puts the ideal character in the all.lang strings. After <language>.lang generation, everything works. Cases are:

# L1 and L2 are both use the same ISO-8859 encoding. (Specifically, they are either both ISO-8859-1, which doesn’t need <language>.map files, or both ISO-8859-2, and have <language>.map files with, by convention, identical contents.) NOTE: For TDM’s purposes, ISO-8859-15 (French) can be considered part of the ISO-8859-1 family.
# L2 character is ASCII (i.e., in ISO range 0x00-0x7f). This is always the case if L2 = English. Characters in this range have identical codepoints in all five TDM-supported ISO-8859 and in the TDM target encoding.
# L2 character is in the ISO range 0xA0-0xFF, with additional constraints.

For the last case, the L2 character must be either:
* present at the same codepoint in all five TDM-supported ISO-8859 encodings, and in the TDM target encoding. For our Latin language names, these accented characters are like that:
ç in "Français" and "Türkçe" at 0xE7
à in "Català" at 0xEA
â in "Română" at 0xE2
ü in "Türkçe" at 0xFC
* present at the same codepoint in ISO-8859 encodings for L1 and L2, and in the TDM target encoding.
* present in different codepoints in ISO-8859 encodings for L1 and L2, but with each being either the same as the TDM target encoding, or mapped to the TDM target encoding by the <language>.map file.

=== Tricks ===
If the L2 character is not represented in the ISO encoding for L1, then at <L1>.lang generation time, it will be replaced by a “?”. To work around this, the translator has two methods:

====Trick Method 1 – Direct Stuffing====
When L1 encoding is ISO-8859-1 (or -9 or -15, which all have identical encodings for the 0xA0-BF ranges) and L2 character is in TDM’s 0xA0-0xBF range (or D7, F7), then you can lookup the ISO character associated with that codepoint (shown in parentheses in cells of the i18n- charmap table), and type it. Examples:

[English] // and other ISO-8859-1, -9, or -15
"#str_02467" "¬esky" // our default mapping is ISO 8859-1, so ¬ is shown as Č (¬)
"#str_02480" "Sloven®ina" // Slovak (® in ISO-8859-1 is č in our font)

Here’s another example of that last stuffing from a TDM-unexposed language, showing also a diaresis (0xA8):

"#str_02481" "Sloven¨®ina" // Slovenian (southern slovenia) (¨ => š)

In this case, ISO-8859-1 would need to use the diaresis, but ISO-8859-15 (French) would not, i.e., could type and go with š.
The spreadsheet shows all available substitutions in light blue.

====Trick Method 2 – Special Mapping with Repurposed Character====
If all else fails, a little-used character in L1 can be redirected to the L2 codepoint TDM wants, by an extra mapping command in the <L1>.map file. Current such tricks are...

To get ñ for "Español":

* for iso 2, put ¨ (diaeresis 0xA8)
* for iso 16, put ¶ (pilcrow 0xB6)

To get ê for "Português":

*for iso 2: Put ´ (acute accent 0xBD)

== Details of TDM and ISO Char Sets and Potential Tricks and Limitations ==
[WORK IN PROGRESS][COLOR CODING NOT RIGHT YET]

The main table below (after the Key) was drafted by Google AI, from a prompt that defined the header and an example row, and specified:

"Rows are a combine of all the printable 8-bit codepoints in the range 0x80-0xff defined in ISO-8859-1, -2, -9, -15, and -16. The rows are ordered by Unicode number. If a particular ISO standard does not include the character, leave that cell blank."

Subsequently, the TDM and Comments columns were filled in by Geep, and color coding added.
Language mappings were independently color coded, then verified against existing language maps.
This table skips codepoints in the range 0x00-0x7f, because they are the same for all ISO-8859 standards. No mapping required.

{| class="wikitable" style="font-size: 95%; line-height: 1.3em;"
|+ Color Key
! Cell !! Meaning
|-

| style="color:#8c8c8c;" | Light Gray Text Row || Symbol not included in TDM custom character set (so TDM column blank). Can use for char substitution tricks.
|-

| 0xNN on white || Type desired utf8 char (in Symbol column) in all.lang. Generation goes directly to TDM codepoint given.
|-

| style="background:#ebbb54;" | 0xNN, amber hilite || Type desired utf8 char in all.lang. Generation + mapping (in <language>.map file) goes to TDM codepoint via codepoint shown.
|-

| style="background:#ebbb54;color:#606060;" | 0xNN in gray || Type desired utf8 char in all.lang. Generation + mapping (in <language>.map file) goes to TDM codepoint OF SUBSTITUTE CHARACTER via codepoint shown.
|-

| style="background:#ebbb54;color:#ff0000;" | 0xNN in red || Character not part of this ISO. "0xnn" shown is not ISO, but for trick mapping (in <language.map), to support main menu's multilingual "Languages" page.
|-

| style="background:#9ab4e3;" | Substitute Char || Character not part of this ISO. But as trick, you can stuff in this substitute char at the needed TDM codepoint.
|-

| style="background:#43a8cc;" | n/a || Not available to use substitute character, due to trick mapping (in <language>.map) elsewhere.
|-

| Empty Cell || In ISO column, means character not part of this ISO (so may be candidate for future trick mapping; or simply not fully analyzed viz substitute char.)
|-

| style="background:#dbab8a;" | Tan Row || Orphaned character in TDM set, not part of 5 ISO-8859 standards for current TDM-supported languages.
|-
|}

{| class="wikitable" style="font-size: 95%; line-height: 1.3em;"
|+ Unicode Coverage for TDM
! Unicode !! Symbol !! TDM !! 1 !! 2 !! 9 !! 15 !! 16 !! Unicode Name !! Comments
|-

| U+00A0 ||   || 0xA0 || 0xA0 || 0xA0 || 0xA0 || 0xA0 || 0xA0 || no-break space ||
|- style="color:#8c8c8c;"

| U+00A1 || ¡ || || 0xA1 || || 0xA1 || 0xA1 || || inverted exclamation mark ||
|- style="color:#8c8c8c;"

| U+00A2 || ¢ || || 0xA2 || || 0xA2 || 0xA2 || || cent sign ||
|- style="color:#8c8c8c;"

| U+00A3 || £ || || 0xA3 || || 0xA3 || 0xA3 || || pound sign ||
|- style="color:#8c8c8c;"

| U+00A4 || ¤ || || 0xA4 || 0xA4 || 0xA4 || || || currency sign ||
|- style="color:#8c8c8c;"

| U+00A5 || ¥ || || 0xA5 || || 0xA5 || 0xA5 || || yen sign ||
|- style="color:#8c8c8c;"

| U+00A6 || ¦ || || 0xA6 || || 0xA6 || || || broken bar ||
|-

| U+00A7 || § || 0xA7 || 0xA7 || 0xA7 || 0xA7 || 0xA7 || 0xA7 || section sign ||
|- style="color:#8c8c8c;"

| U+00A8 || ¨ || || 0xA8 || 0xA8 || 0xA8 || || || diaeresis || See also hack use for ñ
|- style="color:#8c8c8c;"

| U+00A9 || © || || 0xA9 || || 0xA9 || 0xA9 || 0xA9 || copyright sign ||
|- style="color:#8c8c8c;"

| U+00AA || ª || || 0xAA || || 0xAA || 0xAA || || feminine ordinal indicator ||
|- style="color:#8c8c8c;"

| U+00AB || « || || 0xAB || || 0xAB || 0xAB || 0xAB || left-pointing double angle quotation mark ||
|- style="color:#8c8c8c;"

| U+00AC || ¬ || || 0xAC || || 0xAC || 0xAC || || not sign ||
|-

| U+00AD || || 0xAD || 0xAD || 0xAD || 0xAD || 0xAD || 0xAD || soft hyphen ||
|- style="color:#8c8c8c;"

| U+00AE || ® || || 0xAE || || 0xAE || 0xAE || || registered sign ||
|- style="color:#8c8c8c;"

| U+00AF || ¯ || || 0xAF || || 0xAF || 0xAF || || macron ||
|- style="color:#8c8c8c;"

| U+00B0 || ° || || 0xB0 || 0xB0 || 0xB0 || 0xB0 || 0xB0 || degree sign ||
|- style="color:#8c8c8c;"

| U+00B1 || ± || || 0xB1 || || 0xB1 || 0xB1 || 0xB1 || plus-minus sign ||
|- style="color:#8c8c8c;"

| U+00B2 || ² || || 0xB2 || || 0xB2 || 0xB2 || || superscript two ||
|- style="color:#8c8c8c;"

| U+00B3 || ³ || || 0xB3 || || 0xB3 || 0xB3 || || superscript three ||
|- style="color:#8c8c8c;"

| U+00B4 || ´ || || 0xB4 || 0xB4 || 0xB4 || || || acute accent ||
|- style="color:#8c8c8c;"

| U+00B5 || µ || || 0xB5 || || 0xB5 || 0xB5 || || micro sign ||
|- style="color:#8c8c8c;"

| U+00B6 || ¶ || || 0xB6 || || 0xB6 || 0xB6 || 0xB6 || pilcrow sign ||
|- style="color:#8c8c8c;"

| U+00B7 || · || || 0xB7 || || 0xB7 || 0xB7 || 0xB7 || middle dot ||
|- style="color:#8c8c8c;"

| U+00B8 || ¸ || || 0xB8 || 0xB8 || 0xB8 || || || cedilla ||
|- style="color:#8c8c8c;"

| U+00B9 || ¹ || || 0xB9 || || 0xB9 || 0xB9 || || superscript one ||
|- style="color:#8c8c8c;"

| U+00BA || º || || 0xBA || || 0xBA || 0xBA || || masculine ordinal indicator ||
|- style="color:#8c8c8c;"

| U+00BB || » || || 0xBB || || 0xBB || 0xBB || 0xBB || right-pointing double angle quotation mark ||
|- style="color:#8c8c8c;"

| U+00BC || ¼ || || 0xBC || || 0xBC || || || vulgar fraction one quarter ||
|- style="color:#8c8c8c;"

| U+00BD || ½ || || 0xBD || || 0xBD || || || vulgar fraction one half ||
|- style="color:#8c8c8c;"

| U+00BE || ¾ || || 0xBE || || 0xBE || || || vulgar fraction three quarters ||
|-

| U+00BF || ¿ || 0xBF || 0xBF || || 0xBF || 0xBF || || inverted question mark ||
|-

| U+00C0 || À || 0xC0 || 0xC0 || || 0xC0 || 0xC0 || 0xC0 || latin capital letter a with grave ||
|-

| U+00C1 || Á || 0xC1 || 0xC1 || 0xC1 || 0xC1 || 0xC1 || 0xC1 || latin capital letter a with acute ||
|-

| U+00C2 || Â || 0xC2 || 0xC2 || 0xC2 || 0xC2 || 0xC2 || 0xC2 || latin capital letter a with circumflex ||
|-

| U+00C3 || Ã || 0xC3 || 0xC3 || || 0xC3 || 0xC3 || || latin capital letter a with tilde ||
|-

| U+00C4 || Ä || 0xC4 || 0xC4 || 0xC4 || 0xC4 || 0xC4 || 0xC4 || latin capital letter a with diaeresis ||
|-

| U+00C5 || Å || 0xC5 || 0xC5 || || 0xC5 || 0xC5 || || latin capital letter a with ring above ||
|-

| U+00C6 || Æ || 0xC6 || 0xC6 || || 0xC6 || 0xC6 || 0xC6 || latin capital letter ae ||
|-

| U+00C7 || Ç || 0xC7 || 0xC7 || 0xC7 || 0xC7 || 0xC7 || 0xC7 || latin capital letter c with cedilla ||
|-

| U+00C8 || È || 0xC8 || 0xC8 || || 0xC8 || 0xC8 || 0xC8 || latin capital letter e with grave ||
|-

| U+00C9 || É || 0xC9 || 0xC9 || 0xC9 || 0xC9 || 0xC9 || 0xC9 || latin capital letter e with acute ||
|-

| U+00CA || Ê || 0xCA || 0xCA || || 0xCA || 0xCA || 0xCA || latin capital letter e with circumflex ||
|-

| U+00CB || Ë || 0xCB || 0xCB || 0xCB || 0xCB || 0xCB || 0xCB || latin capital letter e with diaeresis ||
|-

| U+00CC || Ì || 0xCC || 0xCC || || 0xCC || 0xCC || 0xCC || latin capital letter i with grave ||
|-

| U+00CD || Í || 0xCD || 0xCD || 0xCD || 0xCD || 0xCD || 0xCD || latin capital letter i with acute ||
|-

| U+00CE || Î || 0xCE || 0xCE || 0xCE || 0xCE || 0xCE || 0xCE || latin capital letter i with circumflex ||
|-

| U+00CF || Ï || 0xCF || 0xCF || || 0xCF || 0xCF || 0xCF || latin capital letter i with diaeresis ||
|-

| U+00D0 || Ð || 0xD0 || 0xD0 || || style="color:#ff0000; font-weight:bold;" | n/a || 0xD0 || || latin capital letter eth || Same glyph as U+0110 latin capital letter d with stroke
|-

| U+00D1 || Ñ || 0xD1 || 0xD1 || || 0xD1 || 0xD1 || || latin capital letter n with tilde ||
|-

| U+00D2 || Ò || 0xD2 || 0xD2 || || 0xD2 || 0xD2 || 0xD2 || latin capital letter o with grave ||
|-

| U+00D3 || Ó || 0xD3 || 0xD3 || 0xC1 || 0xD3 || 0xD3 || 0xD3 || latin capital letter o with acute ||
|-

| U+00D4 || Ô || 0xD4 || 0xD4 || 0xD4 || 0xD4 || 0xD4 || 0xD4 || latin capital letter o with circumflex || Formerly also mapped from 0x88; redundant, Ğ has 0x88 codepoint now
|-

| U+00D5 || Õ || 0xD5 || 0xD5 || || 0xD5 || 0xD5 || || latin capital letter o with tilde ||
|-

| U+00D6 || Ö || 0xD6 || 0xD6 || 0xD6 || 0xD6 || 0xD6 || 0xD6 || latin capital letter o with diaeresis ||
|- style="color:#8c8c8c;"

| U+00D7 || × || || 0xD7 || 0xD7 || 0xD7 || 0xD7 || || multiplication sign ||
|-

| U+00D8 || Ø || 0xD8 || 0xD8 || || 0xD8 || 0xD8 || || latin capital letter o with stroke ||
|-

| U+00D9 || Ù || 0xD9 || 0xD9 || || 0xD9 || 0xD9 || 0xD9 || latin capital letter u with grave ||
|-

| U+00DA || Ú || 0xDA || 0xDA || 0xDA || 0xDA || 0xDA || 0xDA || latin capital letter u with acute ||
|-

| U+00DB || Û || 0xDB || 0xDB || || 0xDB || 0xDB || 0xDB || latin capital letter u with circumflex ||
|-

| U+00DC || Ü || 0xDC || 0xDC || 0xDC || 0xDC || 0xDC || 0xDC || latin capital letter u with diaeresis ||
|-

| U+00DD || Ý || 0xDD || 0xDD || 0xDD || || 0xDD || || latin capital letter y with acute ||
|-

| U+00DE || Þ || 0xDE || 0xDE || || || 0xDE || || latin capital letter thorn ||
|-

| U+00DF || ß || 0xDF || 0xDF || 0xDF || 0xDF || 0xDF || 0xDF || latin small letter sharp s ||
|-

| U+00E0 || à || 0xE0 || 0xE0 || || 0xE0 || 0xE0 || 0xE0 || latin small letter a with grave ||
|-

| U+00E1 || á || 0xE1 || 0xE1 || 0xE1 || 0xE1 || 0xE1 || 0xE1 || latin small letter a with acute ||
|-

| U+00E2 || â || 0xE2 || 0xE2 || 0xE2 || 0xE2 || 0xE2 || 0xE2 || latin small letter a with circumflex ||
|-

| U+00E3 || ã || 0xE3 || 0xE3 || || 0xE3 || 0xE3 || || latin small letter a with tilde ||
|-

| U+00E4 || ä || 0xE4 || 0xE4 || 0xE4 || 0xE4 || 0xE4 || 0xE4 || latin small letter a with diaeresis ||
|-

| U+00E5 || å || 0xE5 || 0xE5 || || 0xE5 || 0xE5 || || latin small letter a with ring above ||
|-

| U+00E6 || æ || 0xE6 || 0xE6 || || 0xE6 || 0xE6 || 0xE6 || latin small letter ae ||
|-

| U+00E7 || ç || 0xE7 || 0xE7 || 0xE7 || 0xE7 || 0xE7 || 0xE7 || latin small letter c with cedilla ||
|-

| U+00E8 || è || 0xE8 || 0xE8 || || 0xE8 || 0xE8 || 0xE8 || latin small letter e with grave ||
|-

| U+00E9 || é || 0xE9 || 0xE9 || 0xE9 || 0xE9 || 0xE9 || 0xE9 || latin small letter e with acute ||
|-

| U+00EA || ê || 0xEA || 0xEA || style="background:#ffe4b5;" | 0xBD || 0xEA || 0xEA || 0xEA || latin small letter e with circumflex || Hack for iso 2: Put ´ (acute accent, 0xBD) to get ê for "Português"
|-

| U+00EB || ë || 0xEB || 0xEB || 0xEB || 0xEB || 0xEB || 0xEB || latin small letter e with diaeresis ||
|-

| U+00EC || ì || 0xEC || 0xEC || || 0xEC || 0xEC || 0xEC || latin small letter i with grave ||
|-

| U+00ED || í || 0xED || 0xED || 0xED || 0xED || 0xED || 0xED || latin small letter i with acute ||
|-

| U+00EE || î || 0xEE || 0xEE || 0xEE || 0xEE || 0xEE || 0xEE || latin small letter i with circumflex ||
|-

| U+00EF || ï || 0xEF || 0xEF || || 0xEF || 0xEF || 0xEF || latin small letter i with diaeresis ||
|-

| U+00F0 || ð || 0xF0 || 0xF0 || || || 0xF0 || || latin small letter eth ||
|-

| U+00F1 || ñ || 0xF1 || 0xF1 || style="background:#ffe4b5;" | 0xA8 || 0xF1 || 0xF1 || style="background:#ffe4b5;" | 0xB6 || latin small letter n with tilde || Hacks to get ñ for "Español": for iso 2, put ¨ (diaeresis 0xA8); for iso 16, put ¶ (0xB6)
|-

| U+00F2 || ò || 0xF2 || 0xF2 || || 0xF2 || 0xF2 || 0xF2 || latin small letter o with grave ||
|-

| U+00F3 || ó || 0xF3 || 0xF3 || 0xF3 || 0xF3 || 0xF3 || 0xF3 || latin small letter o with acute ||
|-

| U+00F4 || ô || 0xF4 || 0xF4 || 0xF4 || 0xF4 || 0xF4 || 0xF4 || latin small letter o with circumflex || Formerly also mapped from 0x88; redundant, ğ has TDM 0x88 codepoint now
|-

| U+00F5 || õ || 0xF5 || 0xF5 || || 0xF5 || 0xF5 || || latin small letter o with tilde ||
|-

| U+00F6 || ö || 0xF6 || 0xF6 || 0xF6 || 0xF6 || 0xF6 || 0xF6 || latin small letter o with diaeresis ||
|- style="color:#8c8c8c;"

| U+00F7 || ÷ || || 0xF7 || 0xF7 || 0xF7 || 0xF7 || || division sign ||
|-

| U+00F8 || ø || 0xF8 || 0xF8 || || 0xF8 || 0xF8 || || latin small letter o with stroke ||
|-

| U+00F9 || ù || 0xF9 || 0xF9 || || 0xF9 || 0xF9 || 0xF9 || latin small letter u with grave ||
|-

| U+00FA || ú || 0xFA || 0xFA || 0xFA || 0xFA || 0xFA || 0xFA || latin small letter u with acute ||
|-

| U+00FB || û || 0xFB || 0xFB || || 0xFB || 0xFB || 0xFB || latin small letter u with circumflex ||
|-

| U+00FC || ü || 0xFC || 0xFC || 0xFC || 0xFC || 0xFC || 0xFC || latin small letter u with diaeresis ||
|-

| U+00FD || ý || 0xFD || 0xFD || 0xFD || || 0xFD || || latin small letter y with acute ||
|-

| U+00FE || þ || 0xFE || 0xFE || || || 0xFE || || latin small letter thorn ||
|-

| U+00FF || ÿ || 0xFF || 0xFF || || 0xFF || 0xFF || 0xFF || latin small letter y with diaeresis ||
|-

| U+0102 || Ă || 0x8B || || style="background:#ffe4b5;" | 0xC3 || || || style="background:#ffe4b5;" | 0xC3 || latin capital letter a with breve ||
|-

| U+0103 || ă || 0x9B || || style="background:#ffe4b5;" | 0xE3 || || || style="background:#ffe4b5;" | 0xE3 || latin small letter a with breve ||
|-

| U+0104 || Ą || 0xAA || style="color:#7a7a7a; font-style:italic;" | ª || 0xA1 || style="color:#7a7a7a; font-style:italic;" | ª || style="color:#7a7a7a; font-style:italic;" | ª || 0xA1 || latin capital letter a with ogonek ||
|-

| U+0105 || ą || 0xBA || style="color:#7a7a7a; font-style:italic;" | º || 0xB1 || style="color:#7a7a7a; font-style:italic;" | º || style="color:#7a7a7a; font-style:italic;" | º || 0xA2 || latin small letter a with ogonek ||
|-

| U+0106 || Ć || 0x82 || || 0xC6 || || || 0xC5 || latin capital letter c with acute ||
|-

| U+0107 || ć || 0x92 || || 0xE6 || || || 0xE5 || latin small letter c with acute ||
|-

| U+0108 || Ĉ || 0x86 || || || || || || latin capital c with circumflex || Only in ISO-8859-3 (for Esperanto) at 0xC6
|-

| U+0109 || ĉ || 0x96 || || || || || || latin small c with circumflex || Only in ISO-8859-3 (for Esperanto) at 0xE6
|-

| U+010C || Č || 0xAC || style="color:#7a7a7a; font-style:italic;" | ¬ || 0xC8 || style="color:#7a7a7a; font-style:italic;" | ¬ || style="color:#7a7a7a; font-style:italic;" | ¬ || 0xB2 || latin capital letter c with caron || Substitute char "not sign" at 0xAC
|-

| U+010D || č || 0xAE || style="color:#7a7a7a; font-style:italic;" | ® || 0xE8 || style="color:#7a7a7a; font-style:italic;" | ® || style="color:#7a7a7a; font-style:italic;" | ® || 0xB9 || latin small letter c with caron || Substitute char "registration sign" at 0xAE
|-

| U+010E || Ď || 0xB3 || style="color:#7a7a7a; font-style:italic;" | ³ || 0xCF || style="color:#7a7a7a; font-style:italic;" | ³ || style="color:#7a7a7a; font-style:italic;" | ³ || || latin capital letter d with caron || Substitute char "superscript three" at 0xB3
|-

| U+010F || ď || 0xB7 || style="color:#7a7a7a; font-style:italic;" | · || 0xEF || style="color:#7a7a7a; font-style:italic;" | · || style="color:#7a7a7a; font-style:italic;" | · || || latin small letter d with caron || Substitute char "middle dot" at 0xB7
|-

| U+0110 || Đ || 0xD0 || 0xD0 || 0xD0 || style="color:#ff0000; font-weight:bold;" | n/a || || 0xD0 || latin capital letter d with stroke || Same glyph as U+00D0 latin capital letter eth
|-

| U+0111 || đ || 0x90 || || 0xF0 || style="color:#ff0000; font-weight:bold;" | n/a || || 0xF0 || latin small letter d with stroke ||
|-

| U+0118 || Ę || 0xAB || style="color:#7a7a7a; font-style:italic;" | « || style="background:#ffe4b5;" | 0xCA || style="color:#7a7a7a; font-style:italic;" | « || style="color:#7a7a7a; font-style:italic;" | « || 0xDD || latin capital letter e with ogonek || Substitute char "left-pointing double angle quotation mark" at 0xAB
|-

| U+0119 || ę || 0xBB || style="color:#7a7a7a; font-style:italic;" | » || style="background:#ffe4b5;" | 0xEA || style="color:#7a7a7a; font-style:italic;" | » || style="color:#7a7a7a; font-style:italic;" | » || 0xFD || latin small letter e with ogonek || Substitute char "right-pointing double angle quotation mark" at 0xBB
|-

| U+011A || Ě || 0xA5 || style="color:#7a7a7a; font-style:italic;" | ¥ || 0xCC || style="color:#7a7a7a; font-style:italic;" | ¥ || style="color:#7a7a7a; font-style:italic;" | ¥ || || latin capital letter e with caron || Substitute char "yen sign" at 0xA5
|-

| U+011B || ě || 0xA3 || style="color:#7a7a7a; font-style:italic;" | £ || 0xEC || style="color:#7a7a7a; font-style:italic;" | £ || style="color:#7a7a7a; font-style:italic;" | £ || || latin small letter e with caron || Substitute char "pound sign" at 0xA3
|-

| U+011E || Ğ || 0x88 || || || 0xD0 || || || latin capital letter g with breve || As of TDM 2.13
|-

| U+011F || ğ || 0x98 || || || 0xF0 || || || latin small letter g with breve || As of TDM 2.13
|- style="color:#8c8c8c;"

| U+0130 || İ || || || || style="background:#ffe4b5;" | 0xDD || || || latin capital letter i with dot above || Turkish: utf8 "İ" will be mapped to "Î" (0xCE)
|- style="color:#8c8c8c;"

| U+0131 || ı || || || || style="background:#ffe4b5;" | 0xFD || || || latin small letter dotless i || Turkish: utf8 "ı" will be mapped to ASCII "i" (0x69)
|- style="color:#8c8c8c;"

| U+0139 || Ĺ || || || 0xC5 || || || || latin capital letter l with acute ||
|- style="color:#8c8c8c;"

| U+013A || ĺ || || || 0xE5 || || || || latin small letter l with acute ||
|- style="color:#8c8c8c;"

| U+013D || Ľ || || || 0xA5 || || || || latin capital letter l with caron ||
|- style="color:#8c8c8c;"

| U+013E || ľ || || || 0xB5 || || || || latin small letter l with caron ||
|-

| U+0141 || Ł || 0xB1 || style="color:#7a7a7a; font-style:italic;" | ± || 0xA3 || style="color:#7a7a7a; font-style:italic;" | ± || style="color:#7a7a7a; font-style:italic;" | ± || 0xA3 || latin capital letter l with stroke || Substitute char "plus-minus sign" at 0xB1
|-

| U+0142 || ł || 0xB5 || style="color:#7a7a7a; font-style:italic;" | µ || 0xB3 || style="color:#7a7a7a; font-style:italic;" | µ || style="color:#7a7a7a; font-style:italic;" | µ || 0xB3 || latin small letter l with stroke || Substitute char "micro sign" at 0xB5
|-

| U+0143 || Ń || 0x8C || || 0xD1 || || || 0xD1 || latin capital letter n with acute ||
|-

| U+0144 || ń || 0x9C || || 0xF1 || || || 0xF1 || latin small letter n with acute ||
|-

| U+0147 || Ň || 0x80 || || 0xD2 || || || || latin capital letter n with caron ||
|-

| U+0148 || ň || 0xA1 || style="color:#7a7a7a; font-style:italic;" | ¡ || 0xF2 || style="color:#7a7a7a; font-style:italic;" | ¡ || style="color:#7a7a7a; font-style:italic;" | ¡ || || latin small letter n with caron || Substitute char "inverted exclamation mark" at 0xA1
|-

| U+0150 || Ő || 0xB0 || style="color:#7a7a7a; font-style:italic;" | ° || style="background:#ffe4b5;" | 0xD5 || style="color:#7a7a7a; font-style:italic;" | ° || style="color:#7a7a7a; font-style:italic;" | ° || style="background:#ffe4b5;" | 0xD5 || latin capital letter o with double acute || Similiar to Ö, used in Hungarian. Substitute char "degree sign" at 0xB0
|-

| U+0151 || ő || 0xB9 || style="color:#7a7a7a; font-style:italic;" | ¹ || style="background:#ffe4b5;" | 0xF5 || style="color:#7a7a7a; font-style:italic;" | ¹ || style="color:#7a7a7a; font-style:italic;" | ¹ || style="background:#ffe4b5;" | 0xF5 || latin small letter o with double acute || Similiar to ö, used in Hungarian. Substitute char "superscript 1" at 0xB9
|-

| U+0152 || Œ || 0xBC || style="color:#7a7a7a; font-style:italic;" | ¼ || || style="color:#7a7a7a; font-style:italic;" | ¼ || 0xBC || 0xBC || latin capital ligature oe || Substitute char "vulgar fraction one quarter" at 0xBC
|-

| U+0153 || œ || 0xBD || style="color:#7a7a7a; font-style:italic;" | ½ || || style="color:#7a7a7a; font-style:italic;" | ½ || 0xBD || 0xBD || latin small ligature oe || Substitute char "vulgar fraction one half" at 0xBD
|-

| U+0154 || Ŕ || 0x89 || || 0xC0 || || || || latin capital letter r with acute ||
|-

| U+0155 || ŕ || 0x99 || || 0xE0 || || || || latin small letter r with acute ||
|-

| U+0158 || Ř || 0xD7 || style="color:#7a7a7a; font-style:italic;" | × || style="background:#ffe4b5;" | 0xD8 || style="color:#7a7a7a; font-style:italic;" | × || style="color:#7a7a7a; font-style:italic;" | × || || latin capital letter r with caron || Substitute char "multiple sign" at 0xD7
|-

| U+0159 || ř || 0xF7 || style="color:#7a7a7a; font-style:italic;" | ÷ || style="background:#ffe4b5;" | 0xF8 || style="color:#7a7a7a; font-style:italic;" | ÷ || style="color:#7a7a7a; font-style:italic;" | ÷ || || latin small letter r with caron || Substitute char "divide sign" at 0xF7
|-

| U+015A || Ś || 0x81 || || 0xA6 || || || style="background:#ffe4b5;" | 0xD7 || latin capital letter s with acute ||
|-

| U+015B || ś || 0x91 || || 0xB6 || || || style="background:#ffe4b5;" | 0xF7 || latin small letter s with acute ||
|-

| U+015C || Ŝ || 0x85 || || || || || || latin capital letter s with circumflex || Only in ISO-8859-3 (for Esperanto) at 0xDE
|-

| U+015D || ŝ || 0x95 || || || || || || latin small letter s with circumflex || Only in ISO-8859-3 (for Esperanto) at 0xFE
|-

| U+015E || Ş || 0x8D || || 0xAA || style="background:#ffe4b5;" | 0xDE || || || latin capital letter s with cedilla || Can stand in for "...comma under"
|-

| U+015F || ş || 0x9D || || 0xBA || style="background:#ffe4b5;" | 0xFE || || || latin small letter s with cedilla || Can stand in for "...comma under"
|-

| U+0160 || Š || 0xA6 || style="color:#7a7a7a; font-style:italic;" | ¦ || 0xA9 || style="color:#7a7a7a; font-style:italic;" | ¦ || 0xA6 || 0xA6 || latin capital letter s with caron || Substitute char "broken bar" at 0xA6
|-

| U+0161 || š || 0xA8 || style="color:#7a7a7a; font-style:italic;" | ¨ || 0xB9 || style="color:#7a7a7a; font-style:italic;" | ¨ || 0xA8 || 0xA8 || latin small letter s with caron || Substitute char "diaeresis" at 0xA8
|-

| U+0162 || Ţ || 0x8E || || style="background:#ffe4b5;" | 0xDE || || || || latin capital letter t with cedilla || Can stand in for "...comma under"
|-

| U+0163 || ţ || 0x9E || || style="background:#ffe4b5;" | 0xFE || || || || latin small letter t with cedilla || Can stand in for "...comma under"
|-

| U+0164 || Ť || 0xB2 || style="color:#7a7a7a; font-style:italic;" | ² || 0xAB || style="color:#7a7a7a; font-style:italic;" | ² || style="color:#7a7a7a; font-style:italic;" | ² || || latin capital letter t with caron || Substitute char "superscript two" at 0xB2
|-

| U+0165 || ť || 0xB6 || style="color:#7a7a7a; font-style:italic;" | ¶ || 0xBB || style="color:#7a7a7a; font-style:italic;" | ¶ || style="color:#7a7a7a; font-style:italic;" | ¶ || || latin small letter t with caron || Substitute char "pilcrow sign" at 0xB6
|-

| U+016E || Ů || 0xA9 || style="color:#7a7a7a; font-style:italic;" | © || 0xD9 || style="color:#7a7a7a; font-style:italic;" | © || style="color:#7a7a7a; font-style:italic;" | © || || latin capital letter u with ring above || Substitute char "copyright sign" at 0xA9
|-

| U+016F || ů || 0xAF || style="color:#7a7a7a; font-style:italic;" | ¯ || 0xF9 || style="color:#7a7a7a; font-style:italic;" | ¯ || style="color:#7a7a7a; font-style:italic;" | ¯ || || latin small letter u with ring above || Substitute char "macron" at 0xAF
|-

| U+0170 || Ű || 0xA2 || style="color:#7a7a7a; font-style:italic;" | ¢ || 0xDB || style="color:#7a7a7a; font-style:italic;" | ¢ || style="color:#7a7a7a; font-style:italic;" | ¢ || style="background:#ffe4b5;" | 0xD8 || latin capital letter u with double acute || Similiar to Ü, used in Hungarian. Substitute char "cent sign" at 0xA2
|-

| U+0171 || ű || 0xA4 || style="color:#7a7a7a; font-style:italic;" | ¤ || 0xFB || style="color:#7a7a7a; font-style:italic;" | ¤ || style="color:#7a7a7a; font-style:italic;" | ¤ || style="background:#ffe4b5;" | 0xF8 || latin small letter u with double acute || Similiar to Ü, used in Hungarian. Substitute char "currency sign" at 0xA4
|-

| U+0178 || Ÿ || 0xBE || style="color:#7a7a7a; font-style:italic;" | ¾ || || style="color:#7a7a7a; font-style:italic;" | ¾ || 0xBE || 0xBE || latin capital letter y with diaeresis || Substitute char "vulgar fraction three quarters" at 0xBE
|-

| U+0179 || Ź || 0x84 || || 0xAC || || || style="color:#7a7a7a; font-style:italic;" | 0xAC || latin capital letter z with acute ||
|-

| U+017A || ź || 0x94 || || 0xBC || || || style="background:#ffe4b5;" | 0xAE || latin small letter z with acute ||
|-

| U+017B || Ż || 0x83 || || 0xAF || || || style="background:#ffe4b5;" | 0xAF || latin capital letter z with dot above ||
|-

| U+017C || ż || 0x93 || || 0xBF || || || style="background:#ffe4b5;" | 0xBF || latin small letter z with dot above ||
|-

| U+017D || Ž || 0xB4 || style="color:#7a7a7a; font-style:italic;" | ´ || 0xAE || style="color:#7a7a7a; font-style:italic;" | ´ || 0xB4 || 0xB4 || latin capital letter z with caron || Substitute char "accute accent" at 0xB4
|-

| U+017E || ž || 0xB8 || style="color:#7a7a7a; font-style:italic;" | ¸ || 0xBE || style="color:#7a7a7a; font-style:italic;" | ¸ || 0xB8 || 0xB8 || latin small letter z with caron || Substitute char "cedilla" at 0xB8
|-

| U+01D3 || Ǔ || 0x8A || || || || || || latin capital u with caron || Not found in ISO-8859. Pinyin tone marking
|-

| U+01D4 || ǔ || 0x9A || || || || || || latin small u with caron || Not found in ISO-8859. Pinyin tone marking
|-

| U+0218 || Ș || 0x8D || || || || || style="background:#ffe4b5;" | 0xAA || latin capital letter s with comma below || See also "...with cedilla"
|-

| U+0219 || ș || 0x9D || || || || || style="background:#ffe4b5;" | 0xBA || latin small letter s with comma below || See also "...with cedilla"
|-

| U+021A || Ț || 0x8E || || || || || style="background:#ffe4b5;" | 0xDE || latin capital letter t with comma below || See also "...with cedilla"
|-

| U+021B || ț || 0x9E || || || || || style="background:#ffe4b5;" | 0xFE || latin small letter t with comma below || See also "...with cedilla"
|- style="color:#8c8c8c;"

| U+02C7 || ˇ || || || || 0xB7 || || || caron ||
|- style="color:#8c8c8c;"

| U+02D8 || ˘ || || || || 0xA2 || || || breve ||
|- style="color:#8c8c8c;"

| U+02D9 || ˙ || || || || style="background:#ffe4b5;" | 0xFF || || || dot above ||
|- style="color:#8c8c8c;"

| U+02DB || ˛ || || || || 0xB2 || || || ogonek ||
|- style="color:#8c8c8c;"

| U+02DD || ˝ || || || || style="background:#ffe4b5;" | 0xBD || || || double acute accent ||
|-

| U+1E90 || Ẑ || 0x87 || || || || || || latin capital z with circumflex || Not found in ISO-8859. Rare use in Cyrillic-to-Latin transliteration, or Pinyin
|-

| U+1E91 || ẑ || 0x97 || || || || || || latin small z with circumflex || Not found in ISO-8859. Rare use in Cyrillic-to-Latin transliteration, or Pinyin
|- style="color:#8c8c8c;"

| U+201D || ” || || || || || || style="background:#ffe4b5;" | 0xB5 || right double quotation mark ||
|- style="color:#8c8c8c;"

| U+201E || „ || || || || || || style="background:#ffe4b5;" | 0xA5 || double low-9 quotation mark ||
|- style="color:#8c8c8c;"

| U+20AC || € || || || || || 0xA4 || 0xA4 || euro sign ||
|}

Multilanguage Display

2026-06-18T20:23:22Z

Geep: /* Details of TDM and ISO Char Sets and Potential Tricks and Limitations */ start to fix colors

[PAGE IN PROGRESS]

== Background ==
''This describes a particular challenging use case of a TDM methodology that has been around for some time. The motivation was a 2026 update by Geep to the language map files, following a revision of Carleton 24pt font used throughout the Main Menu.''

In TDM main menu, the Settings/Video/Language page attempts to list all the supported languages in their native form with respect to character set, that is, untranslated. Showing multiple language strings together is difficult, but some tricks are available. The result has been a reasonable near-term workaround for this particular page, applicable to comparable cases. (Comprehensive support for multilanguage display likely involves a major restructuring, for instance, moving to a native Unicode architecture with combined Latin and Cyrillic bitmaps.)

Recall that strings for the main menu are found in the utf8 file tdm_base01.pk4/strings/all.lang, where there is are sections for [English], [German], etc. A particular section is used to generate for distribution the corresponding language-specific file, e.g., french.lang, german.lang, etc. When you play TDM, and select a given language, the corresponding .lang file (if needed) is read.

Except for Russian, these files use a specific 8-bit encoding within the ISO-8859 family. (The i18n – Char page has specifics here.) This specific encoding is a bottleneck... by design, not all characters in any one member of the ISO-8859 family will be accessible by some other members.

== Language Names in Idealized UTF8 Form ==
Only the TDM-exposed languages are shown here. The all.lang file has additional strings for other potential Latin and Cyrillic languages. For reference, the generated encoding for the <language>.lang file is shown in the comment.

"#str_02460" "English" // English [ISO-8859-1]
"#str_02461" "Deutsch" // German [ISO-8859-1]
"#str_02462" "Español" // Spanish [ISO-8859-1]
"#str_02463" "Français" // French [ISO-8859-15]
"#str_02464" "Português" // Portuguese [ISO-8859-1]
"#str_02465" "Polski" // Polish [ISO-8859-2]
"#str_02466" "Italiano" // Italian [ISO-8859-1]
"#str_02467" "Česky" // Czech [ISO-8859-2]
"#str_02468" "Русский" // Russian [WIN-1251]
"#str_02469" "Català" // Catalan [ISO-8859-1]
"#str_02470" "Dansk" // Danish [ISO-8859-1]
"#str_02472" "Nederlands" // Dutch [ISO-8859-1]
"#str_02474" "Magyar" // Hungarian [ISO-8859-2]
"#str_02476" "Svenska" // Swedish [ISO-8859-1]
"#str_02477" "Türkçe" // Turkish [ISO-8859-9]
"#str_02479" "Română" // Romanian [ISO-8859-16]
"#str_02480" "Slovenčina" // Slovak [ISO-8859-2]

== First Compromise – Cyrillic vs. Latin Font ==
While there is some overlap in characters between Cyrillic and Latin encodings, it is insufficient for our purposes. So, for [English] and other European sections, a Latin transliteration from Cyrillic is used:

"#str_02468" "Russkiy" // Russian

Going the other way, for [Russian], the current treatment is not to do a Cyrillic transliteration from Latin, but instead to drop accents, rendering just in ASCII (except of course “Russian”), e.g.:

"#str_02460" "English" // English
"#str_02461" "Deutsch" // German
"#str_02462" "Espanol" // Spanish
"#str_02463" "Francais" // French
"#str_02464" "Portugues" // Portuguese
"#str_02465" "Polski" // Polish
"#str_02466" "Italiano" // Italian
"#str_02467" "Cesky" // Czech
"#str_02468" "Русский" // Russian
"#str_02469" "Catala" // Catalan
"#str_02470" "Dansk" // Danish
"#str_02472" "Nederlands" // Dutch
"#str_02474" "Magyar" // Hungarian
"#str_02476" "Svenska" // Swedish
"#str_02477" "Turkce" // Turkish
"#str_02479" "Romana" // Romanian
"#str_02480" "Slovencina" // Slovak

== Moving between ISO-8859 Members ==
In the discussion here, let “L1” be the current language (from the player’s perspective) or the [language] section of interest in all.lang (from the translator’s perspective). Let “L2” be the language of the foreign word, i.e., L1 and L2 differ.

=== Type and Go ===
In several cases, the translator merely puts the ideal character in the all.lang strings. After <language>.lang generation, everything works. Cases are:

# L1 and L2 are both use the same ISO-8859 encoding. (Specifically, they are either both ISO-8859-1, which doesn’t need <language>.map files, or both ISO-8859-2, and have <language>.map files with, by convention, identical contents.) NOTE: For TDM’s purposes, ISO-8859-15 (French) can be considered part of the ISO-8859-1 family.
# L2 character is ASCII (i.e., in ISO range 0x00-0x7f). This is always the case if L2 = English. Characters in this range have identical codepoints in all five TDM-supported ISO-8859 and in the TDM target encoding.
# L2 character is in the ISO range 0xA0-0xFF, with additional constraints.

For the last case, the L2 character must be either:
* present at the same codepoint in all five TDM-supported ISO-8859 encodings, and in the TDM target encoding. For our Latin language names, these accented characters are like that:
ç in "Français" and "Türkçe" at 0xE7
à in "Català" at 0xEA
â in "Română" at 0xE2
ü in "Türkçe" at 0xFC
* present at the same codepoint in ISO-8859 encodings for L1 and L2, and in the TDM target encoding.
* present in different codepoints in ISO-8859 encodings for L1 and L2, but with each being either the same as the TDM target encoding, or mapped to the TDM target encoding by the <language>.map file.

=== Tricks ===
If the L2 character is not represented in the ISO encoding for L1, then at <L1>.lang generation time, it will be replaced by a “?”. To work around this, the translator has two methods:

====Trick Method 1 – Direct Stuffing====
When L1 encoding is ISO-8859-1 (or -9 or -15, which all have identical encodings for the 0xA0-BF ranges) and L2 character is in TDM’s 0xA0-0xBF range (or D7, F7), then you can lookup the ISO character associated with that codepoint (shown in parentheses in cells of the i18n- charmap table), and type it. Examples:

[English] // and other ISO-8859-1, -9, or -15
"#str_02467" "¬esky" // our default mapping is ISO 8859-1, so ¬ is shown as Č (¬)
"#str_02480" "Sloven®ina" // Slovak (® in ISO-8859-1 is č in our font)

Here’s another example of that last stuffing from a TDM-unexposed language, showing also a diaresis (0xA8):

"#str_02481" "Sloven¨®ina" // Slovenian (southern slovenia) (¨ => š)

In this case, ISO-8859-1 would need to use the diaresis, but ISO-8859-15 (French) would not, i.e., could type and go with š.
The spreadsheet shows all available substitutions in light blue.

====Trick Method 2 – Special Mapping with Repurposed Character====
If all else fails, a little-used character in L1 can be redirected to the L2 codepoint TDM wants, by an extra mapping command in the <L1>.map file. Current such tricks are...

To get ñ for "Español":

* for iso 2, put ¨ (diaeresis 0xA8)
* for iso 16, put ¶ (pilcrow 0xB6)

To get ê for "Português":

*for iso 2: Put ´ (acute accent 0xBD)

== Details of TDM and ISO Char Sets and Potential Tricks and Limitations ==
[WORK IN PROGRESS][COLOR CODING NOT RIGHT YET]

The main table below (after the Key) was drafted by Google AI, from a prompt that defined the header and an example row, and specified:

"Rows are a combine of all the printable 8-bit codepoints in the range 0x80-0xff defined in ISO-8859-1, -2, -9, -15, and -16. The rows are ordered by Unicode number. If a particular ISO standard does not include the character, leave that cell blank."

Subsequently, the TDM and Comments columns were filled in by Geep, and color coding added.
Language mappings were independently color coded, then verified against existing language maps.
This table skips codepoints in the range 0x00-0x7f, because they are the same for all ISO-8859 standards. No mapping required.

{| class="wikitable" style="font-size: 95%; line-height: 1.3em;"
|+ Color Key
! Cell !! Meaning
|-

| style="color:#8c8c8c;" | Light Gray Text Row || Symbol not included in TDM custom character set (so TDM column blank). Can use for char substitution tricks.
|-

| 0xNN on white || Type desired utf8 char (in Symbol column) in all.lang. Generation goes directly to TDM codepoint given.
|-

| style="background:#ffe4b5;" | 0xNN, amber hilite || Type desired utf8 char in all.lang. Generation + mapping (in <language>.map file) goes to TDM codepoint via codepoint shown.
|-

| style="background:#ffe4b5;color:#606060;" | 0xNN in gray || Type desired utf8 char in all.lang. Generation + mapping (in <language>.map file) goes to TDM codepoint OF SUBSTITUTE CHARACTER via codepoint shown.
|-

| style="background:#ffe4b5;color:#ff0000;" | 0xNN in red || Character not part of this ISO. "0xnn" shown is not ISO, but for trick mapping (in <language.map), to support main menu's multilingual "Languages" page.
|-

| style="background:#ffe4b5;" | Substitute Char || Character not part of this ISO. But as trick, you can stuff in this substitute char at the needed TDM codepoint.
|-

| style="background:#ffe4b5;" | n/a || Not available to use substitute character, due to trick mapping (in <language>.map) elsewhere.
|-

| Empty Cell || In ISO column, means character not part of this ISO (so may be candidate for future trick mapping; or simply not fully analyzed viz substitute char.)
|-

| style="background:#ffe4b5;" | Tan Row || Orphaned character in TDM set, not part of 5 ISO-8859 standards for current TDM-supported languages.
|-
|}

{| class="wikitable" style="font-size: 95%; line-height: 1.3em;"
|+ Unicode Coverage for TDM
! Unicode !! Symbol !! TDM !! 1 !! 2 !! 9 !! 15 !! 16 !! Unicode Name !! Comments
|-

| U+00A0 ||   || 0xA0 || 0xA0 || 0xA0 || 0xA0 || 0xA0 || 0xA0 || no-break space ||
|- style="color:#8c8c8c;"

| U+00A1 || ¡ || || 0xA1 || || 0xA1 || 0xA1 || || inverted exclamation mark ||
|- style="color:#8c8c8c;"

| U+00A2 || ¢ || || 0xA2 || || 0xA2 || 0xA2 || || cent sign ||
|- style="color:#8c8c8c;"

| U+00A3 || £ || || 0xA3 || || 0xA3 || 0xA3 || || pound sign ||
|- style="color:#8c8c8c;"

| U+00A4 || ¤ || || 0xA4 || 0xA4 || 0xA4 || || || currency sign ||
|- style="color:#8c8c8c;"

| U+00A5 || ¥ || || 0xA5 || || 0xA5 || 0xA5 || || yen sign ||
|- style="color:#8c8c8c;"

| U+00A6 || ¦ || || 0xA6 || || 0xA6 || || || broken bar ||
|-

| U+00A7 || § || 0xA7 || 0xA7 || 0xA7 || 0xA7 || 0xA7 || 0xA7 || section sign ||
|- style="color:#8c8c8c;"

| U+00A8 || ¨ || || 0xA8 || 0xA8 || 0xA8 || || || diaeresis || See also hack use for ñ
|- style="color:#8c8c8c;"

| U+00A9 || © || || 0xA9 || || 0xA9 || 0xA9 || 0xA9 || copyright sign ||
|- style="color:#8c8c8c;"

| U+00AA || ª || || 0xAA || || 0xAA || 0xAA || || feminine ordinal indicator ||
|- style="color:#8c8c8c;"

| U+00AB || « || || 0xAB || || 0xAB || 0xAB || 0xAB || left-pointing double angle quotation mark ||
|- style="color:#8c8c8c;"

| U+00AC || ¬ || || 0xAC || || 0xAC || 0xAC || || not sign ||
|-

| U+00AD || || 0xAD || 0xAD || 0xAD || 0xAD || 0xAD || 0xAD || soft hyphen ||
|- style="color:#8c8c8c;"

| U+00AE || ® || || 0xAE || || 0xAE || 0xAE || || registered sign ||
|- style="color:#8c8c8c;"

| U+00AF || ¯ || || 0xAF || || 0xAF || 0xAF || || macron ||
|- style="color:#8c8c8c;"

| U+00B0 || ° || || 0xB0 || 0xB0 || 0xB0 || 0xB0 || 0xB0 || degree sign ||
|- style="color:#8c8c8c;"

| U+00B1 || ± || || 0xB1 || || 0xB1 || 0xB1 || 0xB1 || plus-minus sign ||
|- style="color:#8c8c8c;"

| U+00B2 || ² || || 0xB2 || || 0xB2 || 0xB2 || || superscript two ||
|- style="color:#8c8c8c;"

| U+00B3 || ³ || || 0xB3 || || 0xB3 || 0xB3 || || superscript three ||
|- style="color:#8c8c8c;"

| U+00B4 || ´ || || 0xB4 || 0xB4 || 0xB4 || || || acute accent ||
|- style="color:#8c8c8c;"

| U+00B5 || µ || || 0xB5 || || 0xB5 || 0xB5 || || micro sign ||
|- style="color:#8c8c8c;"

| U+00B6 || ¶ || || 0xB6 || || 0xB6 || 0xB6 || 0xB6 || pilcrow sign ||
|- style="color:#8c8c8c;"

| U+00B7 || · || || 0xB7 || || 0xB7 || 0xB7 || 0xB7 || middle dot ||
|- style="color:#8c8c8c;"

| U+00B8 || ¸ || || 0xB8 || 0xB8 || 0xB8 || || || cedilla ||
|- style="color:#8c8c8c;"

| U+00B9 || ¹ || || 0xB9 || || 0xB9 || 0xB9 || || superscript one ||
|- style="color:#8c8c8c;"

| U+00BA || º || || 0xBA || || 0xBA || 0xBA || || masculine ordinal indicator ||
|- style="color:#8c8c8c;"

| U+00BB || » || || 0xBB || || 0xBB || 0xBB || 0xBB || right-pointing double angle quotation mark ||
|- style="color:#8c8c8c;"

| U+00BC || ¼ || || 0xBC || || 0xBC || || || vulgar fraction one quarter ||
|- style="color:#8c8c8c;"

| U+00BD || ½ || || 0xBD || || 0xBD || || || vulgar fraction one half ||
|- style="color:#8c8c8c;"

| U+00BE || ¾ || || 0xBE || || 0xBE || || || vulgar fraction three quarters ||
|-

| U+00BF || ¿ || 0xBF || 0xBF || || 0xBF || 0xBF || || inverted question mark ||
|-

| U+00C0 || À || 0xC0 || 0xC0 || || 0xC0 || 0xC0 || 0xC0 || latin capital letter a with grave ||
|-

| U+00C1 || Á || 0xC1 || 0xC1 || 0xC1 || 0xC1 || 0xC1 || 0xC1 || latin capital letter a with acute ||
|-

| U+00C2 || Â || 0xC2 || 0xC2 || 0xC2 || 0xC2 || 0xC2 || 0xC2 || latin capital letter a with circumflex ||
|-

| U+00C3 || Ã || 0xC3 || 0xC3 || || 0xC3 || 0xC3 || || latin capital letter a with tilde ||
|-

| U+00C4 || Ä || 0xC4 || 0xC4 || 0xC4 || 0xC4 || 0xC4 || 0xC4 || latin capital letter a with diaeresis ||
|-

| U+00C5 || Å || 0xC5 || 0xC5 || || 0xC5 || 0xC5 || || latin capital letter a with ring above ||
|-

| U+00C6 || Æ || 0xC6 || 0xC6 || || 0xC6 || 0xC6 || 0xC6 || latin capital letter ae ||
|-

| U+00C7 || Ç || 0xC7 || 0xC7 || 0xC7 || 0xC7 || 0xC7 || 0xC7 || latin capital letter c with cedilla ||
|-

| U+00C8 || È || 0xC8 || 0xC8 || || 0xC8 || 0xC8 || 0xC8 || latin capital letter e with grave ||
|-

| U+00C9 || É || 0xC9 || 0xC9 || 0xC9 || 0xC9 || 0xC9 || 0xC9 || latin capital letter e with acute ||
|-

| U+00CA || Ê || 0xCA || 0xCA || || 0xCA || 0xCA || 0xCA || latin capital letter e with circumflex ||
|-

| U+00CB || Ë || 0xCB || 0xCB || 0xCB || 0xCB || 0xCB || 0xCB || latin capital letter e with diaeresis ||
|-

| U+00CC || Ì || 0xCC || 0xCC || || 0xCC || 0xCC || 0xCC || latin capital letter i with grave ||
|-

| U+00CD || Í || 0xCD || 0xCD || 0xCD || 0xCD || 0xCD || 0xCD || latin capital letter i with acute ||
|-

| U+00CE || Î || 0xCE || 0xCE || 0xCE || 0xCE || 0xCE || 0xCE || latin capital letter i with circumflex ||
|-

| U+00CF || Ï || 0xCF || 0xCF || || 0xCF || 0xCF || 0xCF || latin capital letter i with diaeresis ||
|-

| U+00D0 || Ð || 0xD0 || 0xD0 || || style="color:#ff0000; font-weight:bold;" | n/a || 0xD0 || || latin capital letter eth || Same glyph as U+0110 latin capital letter d with stroke
|-

| U+00D1 || Ñ || 0xD1 || 0xD1 || || 0xD1 || 0xD1 || || latin capital letter n with tilde ||
|-

| U+00D2 || Ò || 0xD2 || 0xD2 || || 0xD2 || 0xD2 || 0xD2 || latin capital letter o with grave ||
|-

| U+00D3 || Ó || 0xD3 || 0xD3 || 0xC1 || 0xD3 || 0xD3 || 0xD3 || latin capital letter o with acute ||
|-

| U+00D4 || Ô || 0xD4 || 0xD4 || 0xD4 || 0xD4 || 0xD4 || 0xD4 || latin capital letter o with circumflex || Formerly also mapped from 0x88; redundant, Ğ has 0x88 codepoint now
|-

| U+00D5 || Õ || 0xD5 || 0xD5 || || 0xD5 || 0xD5 || || latin capital letter o with tilde ||
|-

| U+00D6 || Ö || 0xD6 || 0xD6 || 0xD6 || 0xD6 || 0xD6 || 0xD6 || latin capital letter o with diaeresis ||
|- style="color:#8c8c8c;"

| U+00D7 || × || || 0xD7 || 0xD7 || 0xD7 || 0xD7 || || multiplication sign ||
|-

| U+00D8 || Ø || 0xD8 || 0xD8 || || 0xD8 || 0xD8 || || latin capital letter o with stroke ||
|-

| U+00D9 || Ù || 0xD9 || 0xD9 || || 0xD9 || 0xD9 || 0xD9 || latin capital letter u with grave ||
|-

| U+00DA || Ú || 0xDA || 0xDA || 0xDA || 0xDA || 0xDA || 0xDA || latin capital letter u with acute ||
|-

| U+00DB || Û || 0xDB || 0xDB || || 0xDB || 0xDB || 0xDB || latin capital letter u with circumflex ||
|-

| U+00DC || Ü || 0xDC || 0xDC || 0xDC || 0xDC || 0xDC || 0xDC || latin capital letter u with diaeresis ||
|-

| U+00DD || Ý || 0xDD || 0xDD || 0xDD || || 0xDD || || latin capital letter y with acute ||
|-

| U+00DE || Þ || 0xDE || 0xDE || || || 0xDE || || latin capital letter thorn ||
|-

| U+00DF || ß || 0xDF || 0xDF || 0xDF || 0xDF || 0xDF || 0xDF || latin small letter sharp s ||
|-

| U+00E0 || à || 0xE0 || 0xE0 || || 0xE0 || 0xE0 || 0xE0 || latin small letter a with grave ||
|-

| U+00E1 || á || 0xE1 || 0xE1 || 0xE1 || 0xE1 || 0xE1 || 0xE1 || latin small letter a with acute ||
|-

| U+00E2 || â || 0xE2 || 0xE2 || 0xE2 || 0xE2 || 0xE2 || 0xE2 || latin small letter a with circumflex ||
|-

| U+00E3 || ã || 0xE3 || 0xE3 || || 0xE3 || 0xE3 || || latin small letter a with tilde ||
|-

| U+00E4 || ä || 0xE4 || 0xE4 || 0xE4 || 0xE4 || 0xE4 || 0xE4 || latin small letter a with diaeresis ||
|-

| U+00E5 || å || 0xE5 || 0xE5 || || 0xE5 || 0xE5 || || latin small letter a with ring above ||
|-

| U+00E6 || æ || 0xE6 || 0xE6 || || 0xE6 || 0xE6 || 0xE6 || latin small letter ae ||
|-

| U+00E7 || ç || 0xE7 || 0xE7 || 0xE7 || 0xE7 || 0xE7 || 0xE7 || latin small letter c with cedilla ||
|-

| U+00E8 || è || 0xE8 || 0xE8 || || 0xE8 || 0xE8 || 0xE8 || latin small letter e with grave ||
|-

| U+00E9 || é || 0xE9 || 0xE9 || 0xE9 || 0xE9 || 0xE9 || 0xE9 || latin small letter e with acute ||
|-

| U+00EA || ê || 0xEA || 0xEA || style="background:#ffe4b5;" | 0xBD || 0xEA || 0xEA || 0xEA || latin small letter e with circumflex || Hack for iso 2: Put ´ (acute accent, 0xBD) to get ê for "Português"
|-

| U+00EB || ë || 0xEB || 0xEB || 0xEB || 0xEB || 0xEB || 0xEB || latin small letter e with diaeresis ||
|-

| U+00EC || ì || 0xEC || 0xEC || || 0xEC || 0xEC || 0xEC || latin small letter i with grave ||
|-

| U+00ED || í || 0xED || 0xED || 0xED || 0xED || 0xED || 0xED || latin small letter i with acute ||
|-

| U+00EE || î || 0xEE || 0xEE || 0xEE || 0xEE || 0xEE || 0xEE || latin small letter i with circumflex ||
|-

| U+00EF || ï || 0xEF || 0xEF || || 0xEF || 0xEF || 0xEF || latin small letter i with diaeresis ||
|-

| U+00F0 || ð || 0xF0 || 0xF0 || || || 0xF0 || || latin small letter eth ||
|-

| U+00F1 || ñ || 0xF1 || 0xF1 || style="background:#ffe4b5;" | 0xA8 || 0xF1 || 0xF1 || style="background:#ffe4b5;" | 0xB6 || latin small letter n with tilde || Hacks to get ñ for "Español": for iso 2, put ¨ (diaeresis 0xA8); for iso 16, put ¶ (0xB6)
|-

| U+00F2 || ò || 0xF2 || 0xF2 || || 0xF2 || 0xF2 || 0xF2 || latin small letter o with grave ||
|-

| U+00F3 || ó || 0xF3 || 0xF3 || 0xF3 || 0xF3 || 0xF3 || 0xF3 || latin small letter o with acute ||
|-

| U+00F4 || ô || 0xF4 || 0xF4 || 0xF4 || 0xF4 || 0xF4 || 0xF4 || latin small letter o with circumflex || Formerly also mapped from 0x88; redundant, ğ has TDM 0x88 codepoint now
|-

| U+00F5 || õ || 0xF5 || 0xF5 || || 0xF5 || 0xF5 || || latin small letter o with tilde ||
|-

| U+00F6 || ö || 0xF6 || 0xF6 || 0xF6 || 0xF6 || 0xF6 || 0xF6 || latin small letter o with diaeresis ||
|- style="color:#8c8c8c;"

| U+00F7 || ÷ || || 0xF7 || 0xF7 || 0xF7 || 0xF7 || || division sign ||
|-

| U+00F8 || ø || 0xF8 || 0xF8 || || 0xF8 || 0xF8 || || latin small letter o with stroke ||
|-

| U+00F9 || ù || 0xF9 || 0xF9 || || 0xF9 || 0xF9 || 0xF9 || latin small letter u with grave ||
|-

| U+00FA || ú || 0xFA || 0xFA || 0xFA || 0xFA || 0xFA || 0xFA || latin small letter u with acute ||
|-

| U+00FB || û || 0xFB || 0xFB || || 0xFB || 0xFB || 0xFB || latin small letter u with circumflex ||
|-

| U+00FC || ü || 0xFC || 0xFC || 0xFC || 0xFC || 0xFC || 0xFC || latin small letter u with diaeresis ||
|-

| U+00FD || ý || 0xFD || 0xFD || 0xFD || || 0xFD || || latin small letter y with acute ||
|-

| U+00FE || þ || 0xFE || 0xFE || || || 0xFE || || latin small letter thorn ||
|-

| U+00FF || ÿ || 0xFF || 0xFF || || 0xFF || 0xFF || 0xFF || latin small letter y with diaeresis ||
|-

| U+0102 || Ă || 0x8B || || style="background:#ffe4b5;" | 0xC3 || || || style="background:#ffe4b5;" | 0xC3 || latin capital letter a with breve ||
|-

| U+0103 || ă || 0x9B || || style="background:#ffe4b5;" | 0xE3 || || || style="background:#ffe4b5;" | 0xE3 || latin small letter a with breve ||
|-

| U+0104 || Ą || 0xAA || style="color:#7a7a7a; font-style:italic;" | ª || 0xA1 || style="color:#7a7a7a; font-style:italic;" | ª || style="color:#7a7a7a; font-style:italic;" | ª || 0xA1 || latin capital letter a with ogonek ||
|-

| U+0105 || ą || 0xBA || style="color:#7a7a7a; font-style:italic;" | º || 0xB1 || style="color:#7a7a7a; font-style:italic;" | º || style="color:#7a7a7a; font-style:italic;" | º || 0xA2 || latin small letter a with ogonek ||
|-

| U+0106 || Ć || 0x82 || || 0xC6 || || || 0xC5 || latin capital letter c with acute ||
|-

| U+0107 || ć || 0x92 || || 0xE6 || || || 0xE5 || latin small letter c with acute ||
|-

| U+0108 || Ĉ || 0x86 || || || || || || latin capital c with circumflex || Only in ISO-8859-3 (for Esperanto) at 0xC6
|-

| U+0109 || ĉ || 0x96 || || || || || || latin small c with circumflex || Only in ISO-8859-3 (for Esperanto) at 0xE6
|-

| U+010C || Č || 0xAC || style="color:#7a7a7a; font-style:italic;" | ¬ || 0xC8 || style="color:#7a7a7a; font-style:italic;" | ¬ || style="color:#7a7a7a; font-style:italic;" | ¬ || 0xB2 || latin capital letter c with caron || Substitute char "not sign" at 0xAC
|-

| U+010D || č || 0xAE || style="color:#7a7a7a; font-style:italic;" | ® || 0xE8 || style="color:#7a7a7a; font-style:italic;" | ® || style="color:#7a7a7a; font-style:italic;" | ® || 0xB9 || latin small letter c with caron || Substitute char "registration sign" at 0xAE
|-

| U+010E || Ď || 0xB3 || style="color:#7a7a7a; font-style:italic;" | ³ || 0xCF || style="color:#7a7a7a; font-style:italic;" | ³ || style="color:#7a7a7a; font-style:italic;" | ³ || || latin capital letter d with caron || Substitute char "superscript three" at 0xB3
|-

| U+010F || ď || 0xB7 || style="color:#7a7a7a; font-style:italic;" | · || 0xEF || style="color:#7a7a7a; font-style:italic;" | · || style="color:#7a7a7a; font-style:italic;" | · || || latin small letter d with caron || Substitute char "middle dot" at 0xB7
|-

| U+0110 || Đ || 0xD0 || 0xD0 || 0xD0 || style="color:#ff0000; font-weight:bold;" | n/a || || 0xD0 || latin capital letter d with stroke || Same glyph as U+00D0 latin capital letter eth
|-

| U+0111 || đ || 0x90 || || 0xF0 || style="color:#ff0000; font-weight:bold;" | n/a || || 0xF0 || latin small letter d with stroke ||
|-

| U+0118 || Ę || 0xAB || style="color:#7a7a7a; font-style:italic;" | « || style="background:#ffe4b5;" | 0xCA || style="color:#7a7a7a; font-style:italic;" | « || style="color:#7a7a7a; font-style:italic;" | « || 0xDD || latin capital letter e with ogonek || Substitute char "left-pointing double angle quotation mark" at 0xAB
|-

| U+0119 || ę || 0xBB || style="color:#7a7a7a; font-style:italic;" | » || style="background:#ffe4b5;" | 0xEA || style="color:#7a7a7a; font-style:italic;" | » || style="color:#7a7a7a; font-style:italic;" | » || 0xFD || latin small letter e with ogonek || Substitute char "right-pointing double angle quotation mark" at 0xBB
|-

| U+011A || Ě || 0xA5 || style="color:#7a7a7a; font-style:italic;" | ¥ || 0xCC || style="color:#7a7a7a; font-style:italic;" | ¥ || style="color:#7a7a7a; font-style:italic;" | ¥ || || latin capital letter e with caron || Substitute char "yen sign" at 0xA5
|-

| U+011B || ě || 0xA3 || style="color:#7a7a7a; font-style:italic;" | £ || 0xEC || style="color:#7a7a7a; font-style:italic;" | £ || style="color:#7a7a7a; font-style:italic;" | £ || || latin small letter e with caron || Substitute char "pound sign" at 0xA3
|-

| U+011E || Ğ || 0x88 || || || 0xD0 || || || latin capital letter g with breve || As of TDM 2.13
|-

| U+011F || ğ || 0x98 || || || 0xF0 || || || latin small letter g with breve || As of TDM 2.13
|- style="color:#8c8c8c;"

| U+0130 || İ || || || || style="background:#ffe4b5;" | 0xDD || || || latin capital letter i with dot above || Turkish: utf8 "İ" will be mapped to "Î" (0xCE)
|- style="color:#8c8c8c;"

| U+0131 || ı || || || || style="background:#ffe4b5;" | 0xFD || || || latin small letter dotless i || Turkish: utf8 "ı" will be mapped to ASCII "i" (0x69)
|- style="color:#8c8c8c;"

| U+0139 || Ĺ || || || 0xC5 || || || || latin capital letter l with acute ||
|- style="color:#8c8c8c;"

| U+013A || ĺ || || || 0xE5 || || || || latin small letter l with acute ||
|- style="color:#8c8c8c;"

| U+013D || Ľ || || || 0xA5 || || || || latin capital letter l with caron ||
|- style="color:#8c8c8c;"

| U+013E || ľ || || || 0xB5 || || || || latin small letter l with caron ||
|-

| U+0141 || Ł || 0xB1 || style="color:#7a7a7a; font-style:italic;" | ± || 0xA3 || style="color:#7a7a7a; font-style:italic;" | ± || style="color:#7a7a7a; font-style:italic;" | ± || 0xA3 || latin capital letter l with stroke || Substitute char "plus-minus sign" at 0xB1
|-

| U+0142 || ł || 0xB5 || style="color:#7a7a7a; font-style:italic;" | µ || 0xB3 || style="color:#7a7a7a; font-style:italic;" | µ || style="color:#7a7a7a; font-style:italic;" | µ || 0xB3 || latin small letter l with stroke || Substitute char "micro sign" at 0xB5
|-

| U+0143 || Ń || 0x8C || || 0xD1 || || || 0xD1 || latin capital letter n with acute ||
|-

| U+0144 || ń || 0x9C || || 0xF1 || || || 0xF1 || latin small letter n with acute ||
|-

| U+0147 || Ň || 0x80 || || 0xD2 || || || || latin capital letter n with caron ||
|-

| U+0148 || ň || 0xA1 || style="color:#7a7a7a; font-style:italic;" | ¡ || 0xF2 || style="color:#7a7a7a; font-style:italic;" | ¡ || style="color:#7a7a7a; font-style:italic;" | ¡ || || latin small letter n with caron || Substitute char "inverted exclamation mark" at 0xA1
|-

| U+0150 || Ő || 0xB0 || style="color:#7a7a7a; font-style:italic;" | ° || style="background:#ffe4b5;" | 0xD5 || style="color:#7a7a7a; font-style:italic;" | ° || style="color:#7a7a7a; font-style:italic;" | ° || style="background:#ffe4b5;" | 0xD5 || latin capital letter o with double acute || Similiar to Ö, used in Hungarian. Substitute char "degree sign" at 0xB0
|-

| U+0151 || ő || 0xB9 || style="color:#7a7a7a; font-style:italic;" | ¹ || style="background:#ffe4b5;" | 0xF5 || style="color:#7a7a7a; font-style:italic;" | ¹ || style="color:#7a7a7a; font-style:italic;" | ¹ || style="background:#ffe4b5;" | 0xF5 || latin small letter o with double acute || Similiar to ö, used in Hungarian. Substitute char "superscript 1" at 0xB9
|-

| U+0152 || Œ || 0xBC || style="color:#7a7a7a; font-style:italic;" | ¼ || || style="color:#7a7a7a; font-style:italic;" | ¼ || 0xBC || 0xBC || latin capital ligature oe || Substitute char "vulgar fraction one quarter" at 0xBC
|-

| U+0153 || œ || 0xBD || style="color:#7a7a7a; font-style:italic;" | ½ || || style="color:#7a7a7a; font-style:italic;" | ½ || 0xBD || 0xBD || latin small ligature oe || Substitute char "vulgar fraction one half" at 0xBD
|-

| U+0154 || Ŕ || 0x89 || || 0xC0 || || || || latin capital letter r with acute ||
|-

| U+0155 || ŕ || 0x99 || || 0xE0 || || || || latin small letter r with acute ||
|-

| U+0158 || Ř || 0xD7 || style="color:#7a7a7a; font-style:italic;" | × || style="background:#ffe4b5;" | 0xD8 || style="color:#7a7a7a; font-style:italic;" | × || style="color:#7a7a7a; font-style:italic;" | × || || latin capital letter r with caron || Substitute char "multiple sign" at 0xD7
|-

| U+0159 || ř || 0xF7 || style="color:#7a7a7a; font-style:italic;" | ÷ || style="background:#ffe4b5;" | 0xF8 || style="color:#7a7a7a; font-style:italic;" | ÷ || style="color:#7a7a7a; font-style:italic;" | ÷ || || latin small letter r with caron || Substitute char "divide sign" at 0xF7
|-

| U+015A || Ś || 0x81 || || 0xA6 || || || style="background:#ffe4b5;" | 0xD7 || latin capital letter s with acute ||
|-

| U+015B || ś || 0x91 || || 0xB6 || || || style="background:#ffe4b5;" | 0xF7 || latin small letter s with acute ||
|-

| U+015C || Ŝ || 0x85 || || || || || || latin capital letter s with circumflex || Only in ISO-8859-3 (for Esperanto) at 0xDE
|-

| U+015D || ŝ || 0x95 || || || || || || latin small letter s with circumflex || Only in ISO-8859-3 (for Esperanto) at 0xFE
|-

| U+015E || Ş || 0x8D || || 0xAA || style="background:#ffe4b5;" | 0xDE || || || latin capital letter s with cedilla || Can stand in for "...comma under"
|-

| U+015F || ş || 0x9D || || 0xBA || style="background:#ffe4b5;" | 0xFE || || || latin small letter s with cedilla || Can stand in for "...comma under"
|-

| U+0160 || Š || 0xA6 || style="color:#7a7a7a; font-style:italic;" | ¦ || 0xA9 || style="color:#7a7a7a; font-style:italic;" | ¦ || 0xA6 || 0xA6 || latin capital letter s with caron || Substitute char "broken bar" at 0xA6
|-

| U+0161 || š || 0xA8 || style="color:#7a7a7a; font-style:italic;" | ¨ || 0xB9 || style="color:#7a7a7a; font-style:italic;" | ¨ || 0xA8 || 0xA8 || latin small letter s with caron || Substitute char "diaeresis" at 0xA8
|-

| U+0162 || Ţ || 0x8E || || style="background:#ffe4b5;" | 0xDE || || || || latin capital letter t with cedilla || Can stand in for "...comma under"
|-

| U+0163 || ţ || 0x9E || || style="background:#ffe4b5;" | 0xFE || || || || latin small letter t with cedilla || Can stand in for "...comma under"
|-

| U+0164 || Ť || 0xB2 || style="color:#7a7a7a; font-style:italic;" | ² || 0xAB || style="color:#7a7a7a; font-style:italic;" | ² || style="color:#7a7a7a; font-style:italic;" | ² || || latin capital letter t with caron || Substitute char "superscript two" at 0xB2
|-

| U+0165 || ť || 0xB6 || style="color:#7a7a7a; font-style:italic;" | ¶ || 0xBB || style="color:#7a7a7a; font-style:italic;" | ¶ || style="color:#7a7a7a; font-style:italic;" | ¶ || || latin small letter t with caron || Substitute char "pilcrow sign" at 0xB6
|-

| U+016E || Ů || 0xA9 || style="color:#7a7a7a; font-style:italic;" | © || 0xD9 || style="color:#7a7a7a; font-style:italic;" | © || style="color:#7a7a7a; font-style:italic;" | © || || latin capital letter u with ring above || Substitute char "copyright sign" at 0xA9
|-

| U+016F || ů || 0xAF || style="color:#7a7a7a; font-style:italic;" | ¯ || 0xF9 || style="color:#7a7a7a; font-style:italic;" | ¯ || style="color:#7a7a7a; font-style:italic;" | ¯ || || latin small letter u with ring above || Substitute char "macron" at 0xAF
|-

| U+0170 || Ű || 0xA2 || style="color:#7a7a7a; font-style:italic;" | ¢ || 0xDB || style="color:#7a7a7a; font-style:italic;" | ¢ || style="color:#7a7a7a; font-style:italic;" | ¢ || style="background:#ffe4b5;" | 0xD8 || latin capital letter u with double acute || Similiar to Ü, used in Hungarian. Substitute char "cent sign" at 0xA2
|-

| U+0171 || ű || 0xA4 || style="color:#7a7a7a; font-style:italic;" | ¤ || 0xFB || style="color:#7a7a7a; font-style:italic;" | ¤ || style="color:#7a7a7a; font-style:italic;" | ¤ || style="background:#ffe4b5;" | 0xF8 || latin small letter u with double acute || Similiar to Ü, used in Hungarian. Substitute char "currency sign" at 0xA4
|-

| U+0178 || Ÿ || 0xBE || style="color:#7a7a7a; font-style:italic;" | ¾ || || style="color:#7a7a7a; font-style:italic;" | ¾ || 0xBE || 0xBE || latin capital letter y with diaeresis || Substitute char "vulgar fraction three quarters" at 0xBE
|-

| U+0179 || Ź || 0x84 || || 0xAC || || || style="color:#7a7a7a; font-style:italic;" | 0xAC || latin capital letter z with acute ||
|-

| U+017A || ź || 0x94 || || 0xBC || || || style="background:#ffe4b5;" | 0xAE || latin small letter z with acute ||
|-

| U+017B || Ż || 0x83 || || 0xAF || || || style="background:#ffe4b5;" | 0xAF || latin capital letter z with dot above ||
|-

| U+017C || ż || 0x93 || || 0xBF || || || style="background:#ffe4b5;" | 0xBF || latin small letter z with dot above ||
|-

| U+017D || Ž || 0xB4 || style="color:#7a7a7a; font-style:italic;" | ´ || 0xAE || style="color:#7a7a7a; font-style:italic;" | ´ || 0xB4 || 0xB4 || latin capital letter z with caron || Substitute char "accute accent" at 0xB4
|-

| U+017E || ž || 0xB8 || style="color:#7a7a7a; font-style:italic;" | ¸ || 0xBE || style="color:#7a7a7a; font-style:italic;" | ¸ || 0xB8 || 0xB8 || latin small letter z with caron || Substitute char "cedilla" at 0xB8
|-

| U+01D3 || Ǔ || 0x8A || || || || || || latin capital u with caron || Not found in ISO-8859. Pinyin tone marking
|-

| U+01D4 || ǔ || 0x9A || || || || || || latin small u with caron || Not found in ISO-8859. Pinyin tone marking
|-

| U+0218 || Ș || 0x8D || || || || || style="background:#ffe4b5;" | 0xAA || latin capital letter s with comma below || See also "...with cedilla"
|-

| U+0219 || ș || 0x9D || || || || || style="background:#ffe4b5;" | 0xBA || latin small letter s with comma below || See also "...with cedilla"
|-

| U+021A || Ț || 0x8E || || || || || style="background:#ffe4b5;" | 0xDE || latin capital letter t with comma below || See also "...with cedilla"
|-

| U+021B || ț || 0x9E || || || || || style="background:#ffe4b5;" | 0xFE || latin small letter t with comma below || See also "...with cedilla"
|- style="color:#8c8c8c;"

| U+02C7 || ˇ || || || || 0xB7 || || || caron ||
|- style="color:#8c8c8c;"

| U+02D8 || ˘ || || || || 0xA2 || || || breve ||
|- style="color:#8c8c8c;"

| U+02D9 || ˙ || || || || style="background:#ffe4b5;" | 0xFF || || || dot above ||
|- style="color:#8c8c8c;"

| U+02DB || ˛ || || || || 0xB2 || || || ogonek ||
|- style="color:#8c8c8c;"

| U+02DD || ˝ || || || || style="background:#ffe4b5;" | 0xBD || || || double acute accent ||
|-

| U+1E90 || Ẑ || 0x87 || || || || || || latin capital z with circumflex || Not found in ISO-8859. Rare use in Cyrillic-to-Latin transliteration, or Pinyin
|-

| U+1E91 || ẑ || 0x97 || || || || || || latin small z with circumflex || Not found in ISO-8859. Rare use in Cyrillic-to-Latin transliteration, or Pinyin
|- style="color:#8c8c8c;"

| U+201D || ” || || || || || || style="background:#ffe4b5;" | 0xB5 || right double quotation mark ||
|- style="color:#8c8c8c;"

| U+201E || „ || || || || || || style="background:#ffe4b5;" | 0xA5 || double low-9 quotation mark ||
|- style="color:#8c8c8c;"

| U+20AC || € || || || || || 0xA4 || 0xA4 || euro sign ||
|}

Multilanguage Display

2026-06-18T19:38:55Z

Geep: Add spreadsheet, fix columns

[PAGE IN PROGRESS]

== Background ==
''This describes a particular challenging use case of a TDM methodology that has been around for some time. The motivation was a 2026 update by Geep to the language map files, following a revision of Carleton 24pt font used throughout the Main Menu.''

In TDM main menu, the Settings/Video/Language page attempts to list all the supported languages in their native form with respect to character set, that is, untranslated. Showing multiple language strings together is difficult, but some tricks are available. The result has been a reasonable near-term workaround for this particular page, applicable to comparable cases. (Comprehensive support for multilanguage display likely involves a major restructuring, for instance, moving to a native Unicode architecture with combined Latin and Cyrillic bitmaps.)

Recall that strings for the main menu are found in the utf8 file tdm_base01.pk4/strings/all.lang, where there is are sections for [English], [German], etc. A particular section is used to generate for distribution the corresponding language-specific file, e.g., french.lang, german.lang, etc. When you play TDM, and select a given language, the corresponding .lang file (if needed) is read.

Except for Russian, these files use a specific 8-bit encoding within the ISO-8859 family. (The i18n – Char page has specifics here.) This specific encoding is a bottleneck... by design, not all characters in any one member of the ISO-8859 family will be accessible by some other members.

== Language Names in Idealized UTF8 Form ==
Only the TDM-exposed languages are shown here. The all.lang file has additional strings for other potential Latin and Cyrillic languages. For reference, the generated encoding for the <language>.lang file is shown in the comment.

"#str_02460" "English" // English [ISO-8859-1]
"#str_02461" "Deutsch" // German [ISO-8859-1]
"#str_02462" "Español" // Spanish [ISO-8859-1]
"#str_02463" "Français" // French [ISO-8859-15]
"#str_02464" "Português" // Portuguese [ISO-8859-1]
"#str_02465" "Polski" // Polish [ISO-8859-2]
"#str_02466" "Italiano" // Italian [ISO-8859-1]
"#str_02467" "Česky" // Czech [ISO-8859-2]
"#str_02468" "Русский" // Russian [WIN-1251]
"#str_02469" "Català" // Catalan [ISO-8859-1]
"#str_02470" "Dansk" // Danish [ISO-8859-1]
"#str_02472" "Nederlands" // Dutch [ISO-8859-1]
"#str_02474" "Magyar" // Hungarian [ISO-8859-2]
"#str_02476" "Svenska" // Swedish [ISO-8859-1]
"#str_02477" "Türkçe" // Turkish [ISO-8859-9]
"#str_02479" "Română" // Romanian [ISO-8859-16]
"#str_02480" "Slovenčina" // Slovak [ISO-8859-2]

== First Compromise – Cyrillic vs. Latin Font ==
While there is some overlap in characters between Cyrillic and Latin encodings, it is insufficient for our purposes. So, for [English] and other European sections, a Latin transliteration from Cyrillic is used:

"#str_02468" "Russkiy" // Russian

Going the other way, for [Russian], the current treatment is not to do a Cyrillic transliteration from Latin, but instead to drop accents, rendering just in ASCII (except of course “Russian”), e.g.:

"#str_02460" "English" // English
"#str_02461" "Deutsch" // German
"#str_02462" "Espanol" // Spanish
"#str_02463" "Francais" // French
"#str_02464" "Portugues" // Portuguese
"#str_02465" "Polski" // Polish
"#str_02466" "Italiano" // Italian
"#str_02467" "Cesky" // Czech
"#str_02468" "Русский" // Russian
"#str_02469" "Catala" // Catalan
"#str_02470" "Dansk" // Danish
"#str_02472" "Nederlands" // Dutch
"#str_02474" "Magyar" // Hungarian
"#str_02476" "Svenska" // Swedish
"#str_02477" "Turkce" // Turkish
"#str_02479" "Romana" // Romanian
"#str_02480" "Slovencina" // Slovak

== Moving between ISO-8859 Members ==
In the discussion here, let “L1” be the current language (from the player’s perspective) or the [language] section of interest in all.lang (from the translator’s perspective). Let “L2” be the language of the foreign word, i.e., L1 and L2 differ.

=== Type and Go ===
In several cases, the translator merely puts the ideal character in the all.lang strings. After <language>.lang generation, everything works. Cases are:

# L1 and L2 are both use the same ISO-8859 encoding. (Specifically, they are either both ISO-8859-1, which doesn’t need <language>.map files, or both ISO-8859-2, and have <language>.map files with, by convention, identical contents.) NOTE: For TDM’s purposes, ISO-8859-15 (French) can be considered part of the ISO-8859-1 family.
# L2 character is ASCII (i.e., in ISO range 0x00-0x7f). This is always the case if L2 = English. Characters in this range have identical codepoints in all five TDM-supported ISO-8859 and in the TDM target encoding.
# L2 character is in the ISO range 0xA0-0xFF, with additional constraints.

For the last case, the L2 character must be either:
* present at the same codepoint in all five TDM-supported ISO-8859 encodings, and in the TDM target encoding. For our Latin language names, these accented characters are like that:
ç in "Français" and "Türkçe" at 0xE7
à in "Català" at 0xEA
â in "Română" at 0xE2
ü in "Türkçe" at 0xFC
* present at the same codepoint in ISO-8859 encodings for L1 and L2, and in the TDM target encoding.
* present in different codepoints in ISO-8859 encodings for L1 and L2, but with each being either the same as the TDM target encoding, or mapped to the TDM target encoding by the <language>.map file.

=== Tricks ===
If the L2 character is not represented in the ISO encoding for L1, then at <L1>.lang generation time, it will be replaced by a “?”. To work around this, the translator has two methods:

====Trick Method 1 – Direct Stuffing====
When L1 encoding is ISO-8859-1 (or -9 or -15, which all have identical encodings for the 0xA0-BF ranges) and L2 character is in TDM’s 0xA0-0xBF range (or D7, F7), then you can lookup the ISO character associated with that codepoint (shown in parentheses in cells of the i18n- charmap table), and type it. Examples:

[English] // and other ISO-8859-1, -9, or -15
"#str_02467" "¬esky" // our default mapping is ISO 8859-1, so ¬ is shown as Č (¬)
"#str_02480" "Sloven®ina" // Slovak (® in ISO-8859-1 is č in our font)

Here’s another example of that last stuffing from a TDM-unexposed language, showing also a diaresis (0xA8):

"#str_02481" "Sloven¨®ina" // Slovenian (southern slovenia) (¨ => š)

In this case, ISO-8859-1 would need to use the diaresis, but ISO-8859-15 (French) would not, i.e., could type and go with š.
The spreadsheet shows all available substitutions in light blue.

====Trick Method 2 – Special Mapping with Repurposed Character====
If all else fails, a little-used character in L1 can be redirected to the L2 codepoint TDM wants, by an extra mapping command in the <L1>.map file. Current such tricks are...

To get ñ for "Español":

* for iso 2, put ¨ (diaeresis 0xA8)
* for iso 16, put ¶ (pilcrow 0xB6)

To get ê for "Português":

*for iso 2: Put ´ (acute accent 0xBD)

== Details of TDM and ISO Char Sets and Potential Tricks and Limitations ==
[WORK IN PROGRESS][COLOR CODING NOT RIGHT YET]

{| class="wikitable" style="font-size: 95%; line-height: 1.3em;"
|+ Unicode Coverage for TDM
! Unicode !! Symbol !! TDM !! 1 !! 2 !! 9 !! 15 !! 16 !! Unicode Name !! Comments
|-

| U+00A0 ||   || 0xA0 || 0xA0 || 0xA0 || 0xA0 || 0xA0 || 0xA0 || no-break space ||
|- style="color:#8c8c8c;"

| U+00A1 || ¡ || || 0xA1 || || 0xA1 || 0xA1 || || inverted exclamation mark ||
|- style="color:#8c8c8c;"

| U+00A2 || ¢ || || 0xA2 || || 0xA2 || 0xA2 || || cent sign ||
|- style="color:#8c8c8c;"

| U+00A3 || £ || || 0xA3 || || 0xA3 || 0xA3 || || pound sign ||
|- style="color:#8c8c8c;"

| U+00A4 || ¤ || || 0xA4 || 0xA4 || 0xA4 || || || currency sign ||
|- style="color:#8c8c8c;"

| U+00A5 || ¥ || || 0xA5 || || 0xA5 || 0xA5 || || yen sign ||
|- style="color:#8c8c8c;"

| U+00A6 || ¦ || || 0xA6 || || 0xA6 || || || broken bar ||
|-

| U+00A7 || § || 0xA7 || 0xA7 || 0xA7 || 0xA7 || 0xA7 || 0xA7 || section sign ||
|- style="color:#8c8c8c;"

| U+00A8 || ¨ || || 0xA8 || 0xA8 || 0xA8 || || || diaeresis || See also hack use for ñ
|- style="color:#8c8c8c;"

| U+00A9 || © || || 0xA9 || || 0xA9 || 0xA9 || 0xA9 || copyright sign ||
|- style="color:#8c8c8c;"

| U+00AA || ª || || 0xAA || || 0xAA || 0xAA || || feminine ordinal indicator ||
|- style="color:#8c8c8c;"

| U+00AB || « || || 0xAB || || 0xAB || 0xAB || 0xAB || left-pointing double angle quotation mark ||
|- style="color:#8c8c8c;"

| U+00AC || ¬ || || 0xAC || || 0xAC || 0xAC || || not sign ||
|-

| U+00AD || || 0xAD || 0xAD || 0xAD || 0xAD || 0xAD || 0xAD || soft hyphen ||
|- style="color:#8c8c8c;"

| U+00AE || ® || || 0xAE || || 0xAE || 0xAE || || registered sign ||
|- style="color:#8c8c8c;"

| U+00AF || ¯ || || 0xAF || || 0xAF || 0xAF || || macron ||
|- style="color:#8c8c8c;"

| U+00B0 || ° || || 0xB0 || 0xB0 || 0xB0 || 0xB0 || 0xB0 || degree sign ||
|- style="color:#8c8c8c;"

| U+00B1 || ± || || 0xB1 || || 0xB1 || 0xB1 || 0xB1 || plus-minus sign ||
|- style="color:#8c8c8c;"

| U+00B2 || ² || || 0xB2 || || 0xB2 || 0xB2 || || superscript two ||
|- style="color:#8c8c8c;"

| U+00B3 || ³ || || 0xB3 || || 0xB3 || 0xB3 || || superscript three ||
|- style="color:#8c8c8c;"

| U+00B4 || ´ || || 0xB4 || 0xB4 || 0xB4 || || || acute accent ||
|- style="color:#8c8c8c;"

| U+00B5 || µ || || 0xB5 || || 0xB5 || 0xB5 || || micro sign ||
|- style="color:#8c8c8c;"

| U+00B6 || ¶ || || 0xB6 || || 0xB6 || 0xB6 || 0xB6 || pilcrow sign ||
|- style="color:#8c8c8c;"

| U+00B7 || · || || 0xB7 || || 0xB7 || 0xB7 || 0xB7 || middle dot ||
|- style="color:#8c8c8c;"

| U+00B8 || ¸ || || 0xB8 || 0xB8 || 0xB8 || || || cedilla ||
|- style="color:#8c8c8c;"

| U+00B9 || ¹ || || 0xB9 || || 0xB9 || 0xB9 || || superscript one ||
|- style="color:#8c8c8c;"

| U+00BA || º || || 0xBA || || 0xBA || 0xBA || || masculine ordinal indicator ||
|- style="color:#8c8c8c;"

| U+00BB || » || || 0xBB || || 0xBB || 0xBB || 0xBB || right-pointing double angle quotation mark ||
|- style="color:#8c8c8c;"

| U+00BC || ¼ || || 0xBC || || 0xBC || || || vulgar fraction one quarter ||
|- style="color:#8c8c8c;"

| U+00BD || ½ || || 0xBD || || 0xBD || || || vulgar fraction one half ||
|- style="color:#8c8c8c;"

| U+00BE || ¾ || || 0xBE || || 0xBE || || || vulgar fraction three quarters ||
|-

| U+00BF || ¿ || 0xBF || 0xBF || || 0xBF || 0xBF || || inverted question mark ||
|-

| U+00C0 || À || 0xC0 || 0xC0 || || 0xC0 || 0xC0 || 0xC0 || latin capital letter a with grave ||
|-

| U+00C1 || Á || 0xC1 || 0xC1 || 0xC1 || 0xC1 || 0xC1 || 0xC1 || latin capital letter a with acute ||
|-

| U+00C2 || Â || 0xC2 || 0xC2 || 0xC2 || 0xC2 || 0xC2 || 0xC2 || latin capital letter a with circumflex ||
|-

| U+00C3 || Ã || 0xC3 || 0xC3 || || 0xC3 || 0xC3 || || latin capital letter a with tilde ||
|-

| U+00C4 || Ä || 0xC4 || 0xC4 || 0xC4 || 0xC4 || 0xC4 || 0xC4 || latin capital letter a with diaeresis ||
|-

| U+00C5 || Å || 0xC5 || 0xC5 || || 0xC5 || 0xC5 || || latin capital letter a with ring above ||
|-

| U+00C6 || Æ || 0xC6 || 0xC6 || || 0xC6 || 0xC6 || 0xC6 || latin capital letter ae ||
|-

| U+00C7 || Ç || 0xC7 || 0xC7 || 0xC7 || 0xC7 || 0xC7 || 0xC7 || latin capital letter c with cedilla ||
|-

| U+00C8 || È || 0xC8 || 0xC8 || || 0xC8 || 0xC8 || 0xC8 || latin capital letter e with grave ||
|-

| U+00C9 || É || 0xC9 || 0xC9 || 0xC9 || 0xC9 || 0xC9 || 0xC9 || latin capital letter e with acute ||
|-

| U+00CA || Ê || 0xCA || 0xCA || || 0xCA || 0xCA || 0xCA || latin capital letter e with circumflex ||
|-

| U+00CB || Ë || 0xCB || 0xCB || 0xCB || 0xCB || 0xCB || 0xCB || latin capital letter e with diaeresis ||
|-

| U+00CC || Ì || 0xCC || 0xCC || || 0xCC || 0xCC || 0xCC || latin capital letter i with grave ||
|-

| U+00CD || Í || 0xCD || 0xCD || 0xCD || 0xCD || 0xCD || 0xCD || latin capital letter i with acute ||
|-

| U+00CE || Î || 0xCE || 0xCE || 0xCE || 0xCE || 0xCE || 0xCE || latin capital letter i with circumflex ||
|-

| U+00CF || Ï || 0xCF || 0xCF || || 0xCF || 0xCF || 0xCF || latin capital letter i with diaeresis ||
|-

| U+00D0 || Ð || 0xD0 || 0xD0 || || style="color:#ff0000; font-weight:bold;" | n/a || 0xD0 || || latin capital letter eth || Same glyph as U+0110 latin capital letter d with stroke
|-

| U+00D1 || Ñ || 0xD1 || 0xD1 || || 0xD1 || 0xD1 || || latin capital letter n with tilde ||
|-

| U+00D2 || Ò || 0xD2 || 0xD2 || || 0xD2 || 0xD2 || 0xD2 || latin capital letter o with grave ||
|-

| U+00D3 || Ó || 0xD3 || 0xD3 || 0xC1 || 0xD3 || 0xD3 || 0xD3 || latin capital letter o with acute ||
|-

| U+00D4 || Ô || 0xD4 || 0xD4 || 0xD4 || 0xD4 || 0xD4 || 0xD4 || latin capital letter o with circumflex || Formerly also mapped from 0x88; redundant, Ğ has 0x88 codepoint now
|-

| U+00D5 || Õ || 0xD5 || 0xD5 || || 0xD5 || 0xD5 || || latin capital letter o with tilde ||
|-

| U+00D6 || Ö || 0xD6 || 0xD6 || 0xD6 || 0xD6 || 0xD6 || 0xD6 || latin capital letter o with diaeresis ||
|- style="color:#8c8c8c;"

| U+00D7 || × || || 0xD7 || 0xD7 || 0xD7 || 0xD7 || || multiplication sign ||
|-

| U+00D8 || Ø || 0xD8 || 0xD8 || || 0xD8 || 0xD8 || || latin capital letter o with stroke ||
|-

| U+00D9 || Ù || 0xD9 || 0xD9 || || 0xD9 || 0xD9 || 0xD9 || latin capital letter u with grave ||
|-

| U+00DA || Ú || 0xDA || 0xDA || 0xDA || 0xDA || 0xDA || 0xDA || latin capital letter u with acute ||
|-

| U+00DB || Û || 0xDB || 0xDB || || 0xDB || 0xDB || 0xDB || latin capital letter u with circumflex ||
|-

| U+00DC || Ü || 0xDC || 0xDC || 0xDC || 0xDC || 0xDC || 0xDC || latin capital letter u with diaeresis ||
|-

| U+00DD || Ý || 0xDD || 0xDD || 0xDD || || 0xDD || || latin capital letter y with acute ||
|-

| U+00DE || Þ || 0xDE || 0xDE || || || 0xDE || || latin capital letter thorn ||
|-

| U+00DF || ß || 0xDF || 0xDF || 0xDF || 0xDF || 0xDF || 0xDF || latin small letter sharp s ||
|-

| U+00E0 || à || 0xE0 || 0xE0 || || 0xE0 || 0xE0 || 0xE0 || latin small letter a with grave ||
|-

| U+00E1 || á || 0xE1 || 0xE1 || 0xE1 || 0xE1 || 0xE1 || 0xE1 || latin small letter a with acute ||
|-

| U+00E2 || â || 0xE2 || 0xE2 || 0xE2 || 0xE2 || 0xE2 || 0xE2 || latin small letter a with circumflex ||
|-

| U+00E3 || ã || 0xE3 || 0xE3 || || 0xE3 || 0xE3 || || latin small letter a with tilde ||
|-

| U+00E4 || ä || 0xE4 || 0xE4 || 0xE4 || 0xE4 || 0xE4 || 0xE4 || latin small letter a with diaeresis ||
|-

| U+00E5 || å || 0xE5 || 0xE5 || || 0xE5 || 0xE5 || || latin small letter a with ring above ||
|-

| U+00E6 || æ || 0xE6 || 0xE6 || || 0xE6 || 0xE6 || 0xE6 || latin small letter ae ||
|-

| U+00E7 || ç || 0xE7 || 0xE7 || 0xE7 || 0xE7 || 0xE7 || 0xE7 || latin small letter c with cedilla ||
|-

| U+00E8 || è || 0xE8 || 0xE8 || || 0xE8 || 0xE8 || 0xE8 || latin small letter e with grave ||
|-

| U+00E9 || é || 0xE9 || 0xE9 || 0xE9 || 0xE9 || 0xE9 || 0xE9 || latin small letter e with acute ||
|-

| U+00EA || ê || 0xEA || 0xEA || style="background:#ffe4b5;" | 0xBD || 0xEA || 0xEA || 0xEA || latin small letter e with circumflex || Hack for iso 2: Put ´ (acute accent, 0xBD) to get ê for "Português"
|-

| U+00EB || ë || 0xEB || 0xEB || 0xEB || 0xEB || 0xEB || 0xEB || latin small letter e with diaeresis ||
|-

| U+00EC || ì || 0xEC || 0xEC || || 0xEC || 0xEC || 0xEC || latin small letter i with grave ||
|-

| U+00ED || í || 0xED || 0xED || 0xED || 0xED || 0xED || 0xED || latin small letter i with acute ||
|-

| U+00EE || î || 0xEE || 0xEE || 0xEE || 0xEE || 0xEE || 0xEE || latin small letter i with circumflex ||
|-

| U+00EF || ï || 0xEF || 0xEF || || 0xEF || 0xEF || 0xEF || latin small letter i with diaeresis ||
|-

| U+00F0 || ð || 0xF0 || 0xF0 || || || 0xF0 || || latin small letter eth ||
|-

| U+00F1 || ñ || 0xF1 || 0xF1 || style="background:#ffe4b5;" | 0xA8 || 0xF1 || 0xF1 || style="background:#ffe4b5;" | 0xB6 || latin small letter n with tilde || Hacks to get ñ for "Español": for iso 2, put ¨ (diaeresis 0xA8); for iso 16, put ¶ (0xB6)
|-

| U+00F2 || ò || 0xF2 || 0xF2 || || 0xF2 || 0xF2 || 0xF2 || latin small letter o with grave ||
|-

| U+00F3 || ó || 0xF3 || 0xF3 || 0xF3 || 0xF3 || 0xF3 || 0xF3 || latin small letter o with acute ||
|-

| U+00F4 || ô || 0xF4 || 0xF4 || 0xF4 || 0xF4 || 0xF4 || 0xF4 || latin small letter o with circumflex || Formerly also mapped from 0x88; redundant, ğ has TDM 0x88 codepoint now
|-

| U+00F5 || õ || 0xF5 || 0xF5 || || 0xF5 || 0xF5 || || latin small letter o with tilde ||
|-

| U+00F6 || ö || 0xF6 || 0xF6 || 0xF6 || 0xF6 || 0xF6 || 0xF6 || latin small letter o with diaeresis ||
|- style="color:#8c8c8c;"

| U+00F7 || ÷ || || 0xF7 || 0xF7 || 0xF7 || 0xF7 || || division sign ||
|-

| U+00F8 || ø || 0xF8 || 0xF8 || || 0xF8 || 0xF8 || || latin small letter o with stroke ||
|-

| U+00F9 || ù || 0xF9 || 0xF9 || || 0xF9 || 0xF9 || 0xF9 || latin small letter u with grave ||
|-

| U+00FA || ú || 0xFA || 0xFA || 0xFA || 0xFA || 0xFA || 0xFA || latin small letter u with acute ||
|-

| U+00FB || û || 0xFB || 0xFB || || 0xFB || 0xFB || 0xFB || latin small letter u with circumflex ||
|-

| U+00FC || ü || 0xFC || 0xFC || 0xFC || 0xFC || 0xFC || 0xFC || latin small letter u with diaeresis ||
|-

| U+00FD || ý || 0xFD || 0xFD || 0xFD || || 0xFD || || latin small letter y with acute ||
|-

| U+00FE || þ || 0xFE || 0xFE || || || 0xFE || || latin small letter thorn ||
|-

| U+00FF || ÿ || 0xFF || 0xFF || || 0xFF || 0xFF || 0xFF || latin small letter y with diaeresis ||
|-

| U+0102 || Ă || 0x8B || || style="background:#ffe4b5;" | 0xC3 || || || style="background:#ffe4b5;" | 0xC3 || latin capital letter a with breve ||
|-

| U+0103 || ă || 0x9B || || style="background:#ffe4b5;" | 0xE3 || || || style="background:#ffe4b5;" | 0xE3 || latin small letter a with breve ||
|-

| U+0104 || Ą || 0xAA || style="color:#7a7a7a; font-style:italic;" | ª || 0xA1 || style="color:#7a7a7a; font-style:italic;" | ª || style="color:#7a7a7a; font-style:italic;" | ª || 0xA1 || latin capital letter a with ogonek ||
|-

| U+0105 || ą || 0xBA || style="color:#7a7a7a; font-style:italic;" | º || 0xB1 || style="color:#7a7a7a; font-style:italic;" | º || style="color:#7a7a7a; font-style:italic;" | º || 0xA2 || latin small letter a with ogonek ||
|-

| U+0106 || Ć || 0x82 || || 0xC6 || || || 0xC5 || latin capital letter c with acute ||
|-

| U+0107 || ć || 0x92 || || 0xE6 || || || 0xE5 || latin small letter c with acute ||
|-

| U+0108 || Ĉ || 0x86 || || || || || || latin capital c with circumflex || Only in ISO-8859-3 (for Esperanto) at 0xC6
|-

| U+0109 || ĉ || 0x96 || || || || || || latin small c with circumflex || Only in ISO-8859-3 (for Esperanto) at 0xE6
|-

| U+010C || Č || 0xAC || style="color:#7a7a7a; font-style:italic;" | ¬ || 0xC8 || style="color:#7a7a7a; font-style:italic;" | ¬ || style="color:#7a7a7a; font-style:italic;" | ¬ || 0xB2 || latin capital letter c with caron || Substitute char "not sign" at 0xAC
|-

| U+010D || č || 0xAE || style="color:#7a7a7a; font-style:italic;" | ® || 0xE8 || style="color:#7a7a7a; font-style:italic;" | ® || style="color:#7a7a7a; font-style:italic;" | ® || 0xB9 || latin small letter c with caron || Substitute char "registration sign" at 0xAE
|-

| U+010E || Ď || 0xB3 || style="color:#7a7a7a; font-style:italic;" | ³ || 0xCF || style="color:#7a7a7a; font-style:italic;" | ³ || style="color:#7a7a7a; font-style:italic;" | ³ || || latin capital letter d with caron || Substitute char "superscript three" at 0xB3
|-

| U+010F || ď || 0xB7 || style="color:#7a7a7a; font-style:italic;" | · || 0xEF || style="color:#7a7a7a; font-style:italic;" | · || style="color:#7a7a7a; font-style:italic;" | · || || latin small letter d with caron || Substitute char "middle dot" at 0xB7
|-

| U+0110 || Đ || 0xD0 || 0xD0 || 0xD0 || style="color:#ff0000; font-weight:bold;" | n/a || || 0xD0 || latin capital letter d with stroke || Same glyph as U+00D0 latin capital letter eth
|-

| U+0111 || đ || 0x90 || || 0xF0 || style="color:#ff0000; font-weight:bold;" | n/a || || 0xF0 || latin small letter d with stroke ||
|-

| U+0118 || Ę || 0xAB || style="color:#7a7a7a; font-style:italic;" | « || style="background:#ffe4b5;" | 0xCA || style="color:#7a7a7a; font-style:italic;" | « || style="color:#7a7a7a; font-style:italic;" | « || 0xDD || latin capital letter e with ogonek || Substitute char "left-pointing double angle quotation mark" at 0xAB
|-

| U+0119 || ę || 0xBB || style="color:#7a7a7a; font-style:italic;" | » || style="background:#ffe4b5;" | 0xEA || style="color:#7a7a7a; font-style:italic;" | » || style="color:#7a7a7a; font-style:italic;" | » || 0xFD || latin small letter e with ogonek || Substitute char "right-pointing double angle quotation mark" at 0xBB
|-

| U+011A || Ě || 0xA5 || style="color:#7a7a7a; font-style:italic;" | ¥ || 0xCC || style="color:#7a7a7a; font-style:italic;" | ¥ || style="color:#7a7a7a; font-style:italic;" | ¥ || || latin capital letter e with caron || Substitute char "yen sign" at 0xA5
|-

| U+011B || ě || 0xA3 || style="color:#7a7a7a; font-style:italic;" | £ || 0xEC || style="color:#7a7a7a; font-style:italic;" | £ || style="color:#7a7a7a; font-style:italic;" | £ || || latin small letter e with caron || Substitute char "pound sign" at 0xA3
|-

| U+011E || Ğ || 0x88 || || || 0xD0 || || || latin capital letter g with breve || As of TDM 2.13
|-

| U+011F || ğ || 0x98 || || || 0xF0 || || || latin small letter g with breve || As of TDM 2.13
|- style="color:#8c8c8c;"

| U+0130 || İ || || || || style="background:#ffe4b5;" | 0xDD || || || latin capital letter i with dot above || Turkish: utf8 "İ" will be mapped to "Î" (0xCE)
|- style="color:#8c8c8c;"

| U+0131 || ı || || || || style="background:#ffe4b5;" | 0xFD || || || latin small letter dotless i || Turkish: utf8 "ı" will be mapped to ASCII "i" (0x69)
|- style="color:#8c8c8c;"

| U+0139 || Ĺ || || || 0xC5 || || || || latin capital letter l with acute ||
|- style="color:#8c8c8c;"

| U+013A || ĺ || || || 0xE5 || || || || latin small letter l with acute ||
|- style="color:#8c8c8c;"

| U+013D || Ľ || || || 0xA5 || || || || latin capital letter l with caron ||
|- style="color:#8c8c8c;"

| U+013E || ľ || || || 0xB5 || || || || latin small letter l with caron ||
|-

| U+0141 || Ł || 0xB1 || style="color:#7a7a7a; font-style:italic;" | ± || 0xA3 || style="color:#7a7a7a; font-style:italic;" | ± || style="color:#7a7a7a; font-style:italic;" | ± || 0xA3 || latin capital letter l with stroke || Substitute char "plus-minus sign" at 0xB1
|-

| U+0142 || ł || 0xB5 || style="color:#7a7a7a; font-style:italic;" | µ || 0xB3 || style="color:#7a7a7a; font-style:italic;" | µ || style="color:#7a7a7a; font-style:italic;" | µ || 0xB3 || latin small letter l with stroke || Substitute char "micro sign" at 0xB5
|-

| U+0143 || Ń || 0x8C || || 0xD1 || || || 0xD1 || latin capital letter n with acute ||
|-

| U+0144 || ń || 0x9C || || 0xF1 || || || 0xF1 || latin small letter n with acute ||
|-

| U+0147 || Ň || 0x80 || || 0xD2 || || || || latin capital letter n with caron ||
|-

| U+0148 || ň || 0xA1 || style="color:#7a7a7a; font-style:italic;" | ¡ || 0xF2 || style="color:#7a7a7a; font-style:italic;" | ¡ || style="color:#7a7a7a; font-style:italic;" | ¡ || || latin small letter n with caron || Substitute char "inverted exclamation mark" at 0xA1
|-

| U+0150 || Ő || 0xB0 || style="color:#7a7a7a; font-style:italic;" | ° || style="background:#ffe4b5;" | 0xD5 || style="color:#7a7a7a; font-style:italic;" | ° || style="color:#7a7a7a; font-style:italic;" | ° || style="background:#ffe4b5;" | 0xD5 || latin capital letter o with double acute || Similiar to Ö, used in Hungarian. Substitute char "degree sign" at 0xB0
|-

| U+0151 || ő || 0xB9 || style="color:#7a7a7a; font-style:italic;" | ¹ || style="background:#ffe4b5;" | 0xF5 || style="color:#7a7a7a; font-style:italic;" | ¹ || style="color:#7a7a7a; font-style:italic;" | ¹ || style="background:#ffe4b5;" | 0xF5 || latin small letter o with double acute || Similiar to ö, used in Hungarian. Substitute char "superscript 1" at 0xB9
|-

| U+0152 || Œ || 0xBC || style="color:#7a7a7a; font-style:italic;" | ¼ || || style="color:#7a7a7a; font-style:italic;" | ¼ || 0xBC || 0xBC || latin capital ligature oe || Substitute char "vulgar fraction one quarter" at 0xBC
|-

| U+0153 || œ || 0xBD || style="color:#7a7a7a; font-style:italic;" | ½ || || style="color:#7a7a7a; font-style:italic;" | ½ || 0xBD || 0xBD || latin small ligature oe || Substitute char "vulgar fraction one half" at 0xBD
|-

| U+0154 || Ŕ || 0x89 || || 0xC0 || || || || latin capital letter r with acute ||
|-

| U+0155 || ŕ || 0x99 || || 0xE0 || || || || latin small letter r with acute ||
|-

| U+0158 || Ř || 0xD7 || style="color:#7a7a7a; font-style:italic;" | × || style="background:#ffe4b5;" | 0xD8 || style="color:#7a7a7a; font-style:italic;" | × || style="color:#7a7a7a; font-style:italic;" | × || || latin capital letter r with caron || Substitute char "multiple sign" at 0xD7
|-

| U+0159 || ř || 0xF7 || style="color:#7a7a7a; font-style:italic;" | ÷ || style="background:#ffe4b5;" | 0xF8 || style="color:#7a7a7a; font-style:italic;" | ÷ || style="color:#7a7a7a; font-style:italic;" | ÷ || || latin small letter r with caron || Substitute char "divide sign" at 0xF7
|-

| U+015A || Ś || 0x81 || || 0xA6 || || || style="background:#ffe4b5;" | 0xD7 || latin capital letter s with acute ||
|-

| U+015B || ś || 0x91 || || 0xB6 || || || style="background:#ffe4b5;" | 0xF7 || latin small letter s with acute ||
|-

| U+015C || Ŝ || 0x85 || || || || || || latin capital letter s with circumflex || Only in ISO-8859-3 (for Esperanto) at 0xDE
|-

| U+015D || ŝ || 0x95 || || || || || || latin small letter s with circumflex || Only in ISO-8859-3 (for Esperanto) at 0xFE
|-

| U+015E || Ş || 0x8D || || 0xAA || style="background:#ffe4b5;" | 0xDE || || || latin capital letter s with cedilla || Can stand in for "...comma under"
|-

| U+015F || ş || 0x9D || || 0xBA || style="background:#ffe4b5;" | 0xFE || || || latin small letter s with cedilla || Can stand in for "...comma under"
|-

| U+0160 || Š || 0xA6 || style="color:#7a7a7a; font-style:italic;" | ¦ || 0xA9 || style="color:#7a7a7a; font-style:italic;" | ¦ || 0xA6 || 0xA6 || latin capital letter s with caron || Substitute char "broken bar" at 0xA6
|-

| U+0161 || š || 0xA8 || style="color:#7a7a7a; font-style:italic;" | ¨ || 0xB9 || style="color:#7a7a7a; font-style:italic;" | ¨ || 0xA8 || 0xA8 || latin small letter s with caron || Substitute char "diaeresis" at 0xA8
|-

| U+0162 || Ţ || 0x8E || || style="background:#ffe4b5;" | 0xDE || || || || latin capital letter t with cedilla || Can stand in for "...comma under"
|-

| U+0163 || ţ || 0x9E || || style="background:#ffe4b5;" | 0xFE || || || || latin small letter t with cedilla || Can stand in for "...comma under"
|-

| U+0164 || Ť || 0xB2 || style="color:#7a7a7a; font-style:italic;" | ² || 0xAB || style="color:#7a7a7a; font-style:italic;" | ² || style="color:#7a7a7a; font-style:italic;" | ² || || latin capital letter t with caron || Substitute char "superscript two" at 0xB2
|-

| U+0165 || ť || 0xB6 || style="color:#7a7a7a; font-style:italic;" | ¶ || 0xBB || style="color:#7a7a7a; font-style:italic;" | ¶ || style="color:#7a7a7a; font-style:italic;" | ¶ || || latin small letter t with caron || Substitute char "pilcrow sign" at 0xB6
|-

| U+016E || Ů || 0xA9 || style="color:#7a7a7a; font-style:italic;" | © || 0xD9 || style="color:#7a7a7a; font-style:italic;" | © || style="color:#7a7a7a; font-style:italic;" | © || || latin capital letter u with ring above || Substitute char "copyright sign" at 0xA9
|-

| U+016F || ů || 0xAF || style="color:#7a7a7a; font-style:italic;" | ¯ || 0xF9 || style="color:#7a7a7a; font-style:italic;" | ¯ || style="color:#7a7a7a; font-style:italic;" | ¯ || || latin small letter u with ring above || Substitute char "macron" at 0xAF
|-

| U+0170 || Ű || 0xA2 || style="color:#7a7a7a; font-style:italic;" | ¢ || 0xDB || style="color:#7a7a7a; font-style:italic;" | ¢ || style="color:#7a7a7a; font-style:italic;" | ¢ || style="background:#ffe4b5;" | 0xD8 || latin capital letter u with double acute || Similiar to Ü, used in Hungarian. Substitute char "cent sign" at 0xA2
|-

| U+0171 || ű || 0xA4 || style="color:#7a7a7a; font-style:italic;" | ¤ || 0xFB || style="color:#7a7a7a; font-style:italic;" | ¤ || style="color:#7a7a7a; font-style:italic;" | ¤ || style="background:#ffe4b5;" | 0xF8 || latin small letter u with double acute || Similiar to Ü, used in Hungarian. Substitute char "currency sign" at 0xA4
|-

| U+0178 || Ÿ || 0xBE || style="color:#7a7a7a; font-style:italic;" | ¾ || || style="color:#7a7a7a; font-style:italic;" | ¾ || 0xBE || 0xBE || latin capital letter y with diaeresis || Substitute char "vulgar fraction three quarters" at 0xBE
|-

| U+0179 || Ź || 0x84 || || 0xAC || || || style="color:#7a7a7a; font-style:italic;" | 0xAC || latin capital letter z with acute ||
|-

| U+017A || ź || 0x94 || || 0xBC || || || style="background:#ffe4b5;" | 0xAE || latin small letter z with acute ||
|-

| U+017B || Ż || 0x83 || || 0xAF || || || style="background:#ffe4b5;" | 0xAF || latin capital letter z with dot above ||
|-

| U+017C || ż || 0x93 || || 0xBF || || || style="background:#ffe4b5;" | 0xBF || latin small letter z with dot above ||
|-

| U+017D || Ž || 0xB4 || style="color:#7a7a7a; font-style:italic;" | ´ || 0xAE || style="color:#7a7a7a; font-style:italic;" | ´ || 0xB4 || 0xB4 || latin capital letter z with caron || Substitute char "accute accent" at 0xB4
|-

| U+017E || ž || 0xB8 || style="color:#7a7a7a; font-style:italic;" | ¸ || 0xBE || style="color:#7a7a7a; font-style:italic;" | ¸ || 0xB8 || 0xB8 || latin small letter z with caron || Substitute char "cedilla" at 0xB8
|-

| U+01D3 || Ǔ || 0x8A || || || || || || latin capital u with caron || Not found in ISO-8859. Pinyin tone marking
|-

| U+01D4 || ǔ || 0x9A || || || || || || latin small u with caron || Not found in ISO-8859. Pinyin tone marking
|-

| U+0218 || Ș || 0x8D || || || || || style="background:#ffe4b5;" | 0xAA || latin capital letter s with comma below || See also "...with cedilla"
|-

| U+0219 || ș || 0x9D || || || || || style="background:#ffe4b5;" | 0xBA || latin small letter s with comma below || See also "...with cedilla"
|-

| U+021A || Ț || 0x8E || || || || || style="background:#ffe4b5;" | 0xDE || latin capital letter t with comma below || See also "...with cedilla"
|-

| U+021B || ț || 0x9E || || || || || style="background:#ffe4b5;" | 0xFE || latin small letter t with comma below || See also "...with cedilla"
|- style="color:#8c8c8c;"

| U+02C7 || ˇ || || || || 0xB7 || || || caron ||
|- style="color:#8c8c8c;"

| U+02D8 || ˘ || || || || 0xA2 || || || breve ||
|- style="color:#8c8c8c;"

| U+02D9 || ˙ || || || || style="background:#ffe4b5;" | 0xFF || || || dot above ||
|- style="color:#8c8c8c;"

| U+02DB || ˛ || || || || 0xB2 || || || ogonek ||
|- style="color:#8c8c8c;"

| U+02DD || ˝ || || || || style="background:#ffe4b5;" | 0xBD || || || double acute accent ||
|-

| U+1E90 || Ẑ || 0x87 || || || || || || latin capital z with circumflex || Not found in ISO-8859. Rare use in Cyrillic-to-Latin transliteration, or Pinyin
|-

| U+1E91 || ẑ || 0x97 || || || || || || latin small z with circumflex || Not found in ISO-8859. Rare use in Cyrillic-to-Latin transliteration, or Pinyin
|- style="color:#8c8c8c;"

| U+201D || ” || || || || || || style="background:#ffe4b5;" | 0xB5 || right double quotation mark ||
|- style="color:#8c8c8c;"

| U+201E || „ || || || || || || style="background:#ffe4b5;" | 0xA5 || double low-9 quotation mark ||
|- style="color:#8c8c8c;"

| U+20AC || € || || || || || 0xA4 || 0xA4 || euro sign ||
|}

Multilanguage Display

2026-06-18T19:18:13Z

Geep: create article

Title: Multilanguage Display
[PAGE IN PROGRESS]

== Background ==
''This describes a particular challenging use case of a TDM methodology that has been around for some time. The motivation was a 2026 update by Geep to the language map files, following a revision of Carleton 24pt font used throughout the Main Menu.''

In TDM main menu, the Settings/Video/Language page attempts to list all the supported languages in their native form with respect to character set, that is, untranslated. Showing multiple language strings together is difficult, but some tricks are available. The result has been a reasonable near-term workaround for this particular page, applicable to comparable cases. (Comprehensive support for multilanguage display likely involves a major restructuring, for instance, moving to a native Unicode architecture with combined Latin and Cyrillic bitmaps.)

Recall that strings for the main menu are found in the utf8 file tdm_base01.pk4/strings/all.lang, where there is are sections for [English], [German], etc. A particular section is used to generate for distribution the corresponding language-specific file, e.g., french.lang, german.lang, etc. When you play TDM, and select a given language, the corresponding .lang file (if needed) is read.

Except for Russian, these files use a specific 8-bit encoding within the ISO-8859 family. (The i18n – Char page has specifics here.) This specific encoding is a bottleneck... by design, not all characters in any one member of the ISO-8859 family will be accessible by some other members.

== Language Names in Idealized UTF8 Form ==
Only the TDM-exposed languages are shown here. The all.lang file has additional strings for other potential Latin and Cyrillic languages. For reference, the generated encoding for the <language>.lang file is shown in the comment.

"#str_02460" "English" // English [ISO-8859-1]
"#str_02461" "Deutsch" // German [ISO-8859-1]
"#str_02462" "Español" // Spanish [ISO-8859-1]
"#str_02463" "Français" // French [ISO-8859-15]
"#str_02464" "Português" // Portuguese [ISO-8859-1]
"#str_02465" "Polski" // Polish [ISO-8859-2]
"#str_02466" "Italiano" // Italian [ISO-8859-1]
"#str_02467" "Česky" // Czech [ISO-8859-2]
"#str_02468" "Русский" // Russian [WIN-1251]
"#str_02469" "Català" // Catalan [ISO-8859-1]
"#str_02470" "Dansk" // Danish [ISO-8859-1]
"#str_02472" "Nederlands" // Dutch [ISO-8859-1]
"#str_02474" "Magyar" // Hungarian [ISO-8859-2]
"#str_02476" "Svenska" // Swedish [ISO-8859-1]
"#str_02477" "Türkçe" // Turkish [ISO-8859-9]
"#str_02479" "Română" // Romanian [ISO-8859-16]
"#str_02480" "Slovenčina" // Slovak [ISO-8859-2]

== First Compromise – Cyrillic vs. Latin Font ==
While there is some overlap in characters between Cyrillic and Latin encodings, it is insufficient for our purposes. So, for [English] and other European sections, a Latin transliteration from Cyrillic is used:

"#str_02468" "Russkiy" // Russian

Going the other way, for [Russian], the current treatment is not to do a Cyrillic transliteration from Latin, but instead to drop accents, rendering just in ASCII (except of course “Russian”), e.g.:

"#str_02460" "English" // English
"#str_02461" "Deutsch" // German
"#str_02462" "Espanol" // Spanish
"#str_02463" "Francais" // French
"#str_02464" "Portugues" // Portuguese
"#str_02465" "Polski" // Polish
"#str_02466" "Italiano" // Italian
"#str_02467" "Cesky" // Czech
"#str_02468" "Русский" // Russian
"#str_02469" "Catala" // Catalan
"#str_02470" "Dansk" // Danish
"#str_02472" "Nederlands" // Dutch
"#str_02474" "Magyar" // Hungarian
"#str_02476" "Svenska" // Swedish
"#str_02477" "Turkce" // Turkish
"#str_02479" "Romana" // Romanian
"#str_02480" "Slovencina" // Slovak

== Moving between ISO-8859 Members ==
In the discussion here, let “L1” be the current language (from the player’s perspective) or the [language] section of interest in all.lang (from the translator’s perspective). Let “L2” be the language of the foreign word, i.e., L1 and L2 differ.

=== Type and Go ===
In several cases, the translator merely puts the ideal character in the all.lang strings. After <language>.lang generation, everything works. Cases are:

# L1 and L2 are both use the same ISO-8859 encoding. (Specifically, they are either both ISO-8859-1, which doesn’t need <language>.map files, or both ISO-8859-2, and have <language>.map files with, by convention, identical contents.) NOTE: For TDM’s purposes, ISO-8859-15 (French) can be considered part of the ISO-8859-1 family.
# L2 character is ASCII (i.e., in ISO range 0x00-0x7f). This is always the case if L2 = English. Characters in this range have identical codepoints in all five TDM-supported ISO-8859 and in the TDM target encoding.
# L2 character is in the ISO range 0xA0-0xFF, with additional constraints.

For the last case, the L2 character must be either:
* present at the same codepoint in all five TDM-supported ISO-8859 encodings, and in the TDM target encoding. For our Latin language names, these accented characters are like that:
ç in "Français" and "Türkçe" at 0xE7
à in "Català" at 0xEA
â in "Română" at 0xE2
ü in "Türkçe" at 0xFC
* present at the same codepoint in ISO-8859 encodings for L1 and L2, and in the TDM target encoding.
* present in different codepoints in ISO-8859 encodings for L1 and L2, but with each being either the same as the TDM target encoding, or mapped to the TDM target encoding by the <language>.map file.

=== Tricks ===
If the L2 character is not represented in the ISO encoding for L1, then at <L1>.lang generation time, it will be replaced by a “?”. To work around this, the translator has two methods:

====Trick Method 1 – Direct Stuffing====
When L1 encoding is ISO-8859-1 (or -9 or -15, which all have identical encodings for the 0xA0-BF ranges) and L2 character is in TDM’s 0xA0-0xBF range (or D7, F7), then you can lookup the ISO character associated with that codepoint (shown in parentheses in cells of the i18n- charmap table), and type it. Examples:

[English] // and other ISO-8859-1, -9, or -15
"#str_02467" "¬esky" // our default mapping is ISO 8859-1, so ¬ is shown as Č (¬)
"#str_02480" "Sloven®ina" // Slovak (® in ISO-8859-1 is č in our font)

Here’s another example of that last stuffing from a TDM-unexposed language, showing also a diaresis (0xA8):

"#str_02481" "Sloven¨®ina" // Slovenian (southern slovenia) (¨ => š)

In this case, ISO-8859-1 would need to use the diaresis, but ISO-8859-15 (French) would not, i.e., could type and go with š.
The spreadsheet shows all available substitutions in light blue.

====Trick Method 2 – Special Mapping with Repurposed Character====
If all else fails, a little-used character in L1 can be redirected to the L2 codepoint TDM wants, by an extra mapping command in the <L1>.map file. Current such tricks are...

To get ñ for "Español":

* for iso 2, put ¨ (diaeresis 0xA8)
* for iso 16, put ¶ (pilcrow 0xB6)

To get ê for "Português":

*for iso 2: Put ´ (acute accent 0xBD)

== Details of TDM and ISO Char Sets and Potential Tricks and Limitations ==
[TO DO – Insert big table]

I18N - Charset

2026-06-11T19:59:49Z

Geep: /* Font Encoding for European Languages */ Note at top about 0x80-0x9f range

== Introduction ==

The D3 code that handles the GUI bitmap font can only load a specific range of bytes as characters. To get the most out of the available entries, special charsets are used. The fonts (Carleton for the menu f.i.) are build/patched so that the right characters appear in the right place.

== LANG File Encodings ==

=== all.lang ===

This file is in '''UTF-8''', and converted with the help of either the script '''devel/gen_lang.pl''':

perl devel/gen_lang.pl

or, more recently, the Windows C++ utility program '''gen_lang_plus'''. [[Gen_Lang_Programs]] has details of these.

This process ensures that the generated language files are in their proper encodings (see below).

=== All other language files ===

Language-specific files (f.i. '''german.lang''') provide string dictionaries. A system-wide set is provided in tdm_base01.pk4/strings/. A deployed FM may offer similar files in its /strings/ folder... at the very least '''english.lang'''. All such files are expected to be in the following 8-bit encodings:

* '''Czech, Hungarian, Slovak, Polish:''' [https://secure.wikimedia.org/wikipedia/en/wiki/ISO/IEC_8859-2 ISO-8859-2] ('''not WIN-1250!)
* '''Russian:''' [https://secure.wikimedia.org/wikipedia/en/wiki/Win-1251 WIN-1251]
* '''French:''' [https://secure.wikimedia.org/wikipedia/en/wiki/ISO/IEC_8859-15 ISO-8859-15]
* '''Romanian:''' [https://secure.wikimedia.org/wikipedia/en/wiki/ISO/IEC_8859-16 ISO-8859-16]
* '''Turkish:''' [https://secure.wikimedia.org/wikipedia/en/wiki/ISO/IEC_8859-9 ISO-8859-9]
* '''All other languages:''' [https://secure.wikimedia.org/wikipedia/en/wiki/ISO/IEC_8859-1 ISO-8859-1]. This covers TDM-supported languages English, German, Italian, Spanish, Portuguese, Swedish, Danish, Dutch, and Catalan.

{{infobox|The core dictionaries are automatically generated in the right encoding, but make sure that you use the right encoding for the FM dictionary, too!}}

== Character Remapping ==

The characters are remapped upon loading the dictionary/readable, from their native encoding to the two special ones (respectively for Latin and Cyrillic) that TDM uses and that are described next. Responsible for the remapping are [[I18N - Character mapping|mapping files]], f.i. "strings/czech.map". If a map file for a specific language is not found in "tdm_base01.pk4/strings" (and there is no "default.map" there, which is the case these days), then no remapping takes place. Generally, ISO-8859-1 languages do not require remapping. The map files for the four ISO-8859-2 languages have identical content.

See '''[[I18N - Character mapping|Character mapping]]''' for more information.

== Font Encoding for European Languages ==

This TDM-specific 8-bit encoding applies to all TDM fonts for English/European languages, that is, everything except the Cyrillic-based Russian. This encoding controls the ordering within a font's binary DAT file.

Note that the double accented characters in Hungarian '''Ő, ő, Ű and ű''' look a bit different from '''Ö, ö, Ü and ü'''!

In the table below, the original ISO 8859-1 characters are given in ''()'' below the TDM character. In addition, printable characters in the range 0x80-0x9f, shown in light or dark green, are also TDM characters, replacing ISO-8859 control characters (not shown).

'''Color code:'''

{{box|#f0d0d0|Character not usable by TDM|Unusable}}{{box|#d0e0d0|Character not yet used in TDM|Unused}}{{box|#c0ffc0|Character displayed in v1.08 or newer|Usable in v1.08}}{{box|#80f080|Character displayed in v2.03 or newer|Usable in v2.03}}{{box|#d0d0f0|Changed from the ISO-8859-1 default, usable by TDM 1.0 or newer|Changed from ISO 8859-1}}

{|class="wikitable" border=1 style="border-collapse: collapse; font-size: 95%" cellspacing=0 cellpadding=2 width=100%

|-
!
!…0
!…1
!…2
!…3
!…4
!…5
!…6
!…7
!…8
!…9
!…A
!…B
!…C
!…D
!…E
!…F

|-
!0…
|align='center' style='background: #f0d0d0'|00 '''–'''
|align='center' style='background: #f0d0d0'|01 '''–'''
|align='center' style='background: #f0d0d0'|02 '''–'''
|align='center' style='background: #f0d0d0'|03 '''–'''
|align='center' style='background: #f0d0d0'|04 '''–'''
|align='center' style='background: #f0d0d0'|05 '''–'''
|align='center' style='background: #f0d0d0'|06 '''–'''
|align='center' style='background: #f0d0d0'|07 '''–'''
|align='center' style='background: #f0d0d0'|08 '''–'''
|align='center' style='background: #f0d0d0'|09 '''–'''
|align='center' style='background: #f0d0d0'|0A '''–'''
|align='center' style='background: #f0d0d0'|0B '''–'''
|align='center' style='background: #f0d0d0'|0C '''–'''
|align='center' style='background: #f0d0d0'|0D '''–'''
|align='center' style='background: #f0d0d0'|0E '''–'''
|align='center' style='background: #f0d0d0'|0F '''–'''

|-
!1…
|align='center' style='background: #f0d0d0'|10 '''–'''
|align='center' style='background: #f0d0d0'|11 '''–'''
|align='center' style='background: #f0d0d0'|12 '''–'''
|align='center' style='background: #f0d0d0'|13 '''–'''
|align='center' style='background: #f0d0d0'|14 '''–'''
|align='center' style='background: #f0d0d0'|15 '''–'''
|align='center' style='background: #f0d0d0'|16 '''–'''
|align='center' style='background: #f0d0d0'|17 '''–'''
|align='center' style='background: #f0d0d0'|18 '''–'''
|align='center' style='background: #f0d0d0'|19 '''–'''
|align='center' style='background: #f0d0d0'|1A '''–'''
|align='center' style='background: #f0d0d0'|1B '''–'''
|align='center' style='background: #f0d0d0'|1C '''–'''
|align='center' style='background: #f0d0d0'|1D '''–'''
|align='center' style='background: #f0d0d0'|1E '''–'''
|align='center' style='background: #f0d0d0'|1F '''–'''

|-
!2…
|align='center'|20 ''' '''
|align='center'|21 '''!'''
|align='center'|22 '''"'''
|align='center'|23 '''#'''
|align='center'|24 '''$'''
|align='center'|25 '''%'''
|align='center'|26 '''&'''
|align='center'|27 '''''''
|align='center'|28 '''('''
|align='center'|29 ''')'''
|align='center'|2A '''*'''
|align='center'|2B '''+'''
|align='center'|2C ''','''
|align='center'|2D '''-'''
|align='center'|2E '''.'''
|align='center'|2F '''/'''

|-
!3…
|align='center'|30 '''0'''
|align='center'|31 '''1'''
|align='center'|32 '''2'''
|align='center'|33 '''3'''
|align='center'|34 '''4'''
|align='center'|35 '''5'''
|align='center'|36 '''6'''
|align='center'|37 '''7'''
|align='center'|38 '''8'''
|align='center'|39 '''9'''
|align='center'|3A ''':'''
|align='center'|3B ''';'''
|align='center'|3C '''<'''
|align='center'|3D '''='''
|align='center'|3E '''>'''
|align='center'|3F '''?'''

|-
!4…
|align='center'|40 '''@'''
|align='center'|41 '''A'''
|align='center'|42 '''B'''
|align='center'|43 '''C'''
|align='center'|44 '''D'''
|align='center'|45 '''E'''
|align='center'|46 '''F'''
|align='center'|47 '''G'''
|align='center'|48 '''H'''
|align='center'|49 '''I'''
|align='center'|4A '''J'''
|align='center'|4B '''K'''
|align='center'|4C '''L'''
|align='center'|4D '''M'''
|align='center'|4E '''N'''
|align='center'|4F '''O'''

|-
!5…
|align='center'|50 '''P'''
|align='center'|51 '''Q'''
|align='center'|52 '''R'''
|align='center'|53 '''S'''
|align='center'|54 '''T'''
|align='center'|55 '''U'''
|align='center'|56 '''V'''
|align='center'|57 '''W'''
|align='center'|58 '''X'''
|align='center'|59 '''Y'''
|align='center'|5A '''Z'''
|align='center'|5B '''['''
|align='center'|5C '''\'''
|align='center'|5D ''']'''
|align='center'|5E '''^'''
|align='center'|5F '''_'''

|-
!6…
|align='center'|60 '''`'''
|align='center'|61 '''a'''
|align='center'|62 '''b'''
|align='center'|63 '''c'''
|align='center'|64 '''d'''
|align='center'|65 '''e'''
|align='center'|66 '''f'''
|align='center'|67 '''g'''
|align='center'|68 '''h'''
|align='center'|69 '''i'''
|align='center'|6A '''j'''
|align='center'|6B '''k'''
|align='center'|6C '''l'''
|align='center'|6D '''m'''
|align='center'|6E '''n'''
|align='center'|6F '''o'''

|-
!7…
|align='center'|70 '''p'''
|align='center'|71 '''q'''
|align='center'|72 '''r'''
|align='center'|73 '''s'''
|align='center'|74 '''t'''
|align='center'|75 '''u'''
|align='center'|76 '''v'''
|align='center'|77 '''w'''
|align='center'|78 '''x'''
|align='center'|79 '''y'''
|align='center'|7A '''z'''
|align='center'|7B '''{'''
|align='center'|7C '''|'''
|align='center'|7D '''}'''
|align='center'|7E '''~'''
|align='center' style='background: #d0e0d0'|7F '''�'''

|-
!8…
|align='center' style='background: #c0ffc0'|80 '''Ň'''
|align='center' style='background: #c0ffc0'|81 '''Ś'''
|align='center' style='background: #c0ffc0'|82 '''Ć'''
|align='center' style='background: #c0ffc0'|83 '''Ż'''
|align='center' style='background: #c0ffc0'|84 '''Ź'''
|align='center' style='background: #c0ffc0'|85 '''Ŝ'''
|align='center' style='background: #c0ffc0'|86 '''Ĉ'''
|align='center' style='background: #c0ffc0'|87 '''Ẑ'''
|align='center' style='background: #c0ffc0'|88 '''Ô''' [1]
|align='center' style='background: #c0ffc0'|89 '''Ŕ'''
|align='center' style='background: #c0ffc0'|8A '''Ǔ'''
|align='center' style='background: #c0ffc0'|8B '''Ă'''
|align='center' style='background: #c0ffc0'|8C '''Ń'''
|align='center' style='background: #80f080'|8D '''Ș'''
|align='center' style='background: #80f080'|8E '''Ț'''
|align='center' style='background: #d0e0d0'|8F '''�'''

|-
!9…
|align='center' style='background: #80f080'|90 '''đ'''
|align='center' style='background: #c0ffc0'|91 '''ś'''
|align='center' style='background: #c0ffc0'|92 '''ć'''
|align='center' style='background: #c0ffc0'|93 '''ż'''
|align='center' style='background: #c0ffc0'|94 '''ź'''
|align='center' style='background: #c0ffc0'|95 '''ŝ'''
|align='center' style='background: #c0ffc0'|96 '''ĉ'''
|align='center' style='background: #c0ffc0'|97 '''ẑ'''
|align='center' style='background: #c0ffc0'|98 '''ô''' [1]
|align='center' style='background: #c0ffc0'|99 '''ŕ'''
|align='center' style='background: #c0ffc0'|9A '''ǔ'''
|align='center' style='background: #c0ffc0'|9B '''ă'''
|align='center' style='background: #c0ffc0'|9C '''ń'''
|align='center' style='background: #80f080'|9D '''ș'''
|align='center' style='background: #80f080'|9E '''ț'''
|align='center' style='background: #d0e0d0'|9F '''�'''

|-
!A…
|align='center'|A0 '''[https://secure.wikimedia.org/wikipedia/en/wiki/Non-breaking_space NBSP]''' [2]
|align='center' style='background: #d0d0f0'|A1 '''ň''' (¡)'''
|align='center' style='background: #d0d0f0'|A2 '''Ű''' (¢)'''
|align='center' style='background: #d0d0f0'|A3 '''ě''' (£)'''
|align='center' style='background: #d0d0f0'|A4 '''ű''' (¤)'''
|align='center' style='background: #d0d0f0'|A5 '''Ě''' (¥)'''
|align='center' style='background: #d0d0f0'|A6 '''Š''' (¦)'''
|align='center'|A7 '''§'''
|align='center' style='background: #d0d0f0'|A8 '''š''' (¨)'''
|align='center' style='background: #d0d0f0'|A9 '''Ů''' (©)'''
|align='center' style='background: #d0d0f0'|AA '''Ą''' (ª)'''
|align='center' style='background: #d0d0f0'|AB '''Ę''' («)'''
|align='center' style='background: #d0d0f0'|AC '''Č''' (¬)'''
|align='center'|AD '''[https://secure.wikimedia.org/wikipedia/en/wiki/Soft_hyphen SHY]''' [2]
|align='center' style='background: #d0d0f0'|AE '''č''' (®)'''
|align='center' style='background: #d0d0f0'|AF '''ů''' (¯)'''

|-
!B…
|align='center' style='background: #d0d0f0'|B0 '''Ő''' (°)'''
|align='center' style='background: #d0d0f0'|B1 '''Ł''' (±)'''
|align='center' style='background: #d0d0f0'|B2 '''Ť''' (²)'''
|align='center' style='background: #d0d0f0'|B3 '''Ď''' (³)'''
|align='center' style='background: #d0d0f0'|B4 '''Ž''' (´)'''
|align='center' style='background: #d0d0f0'|B5 '''ł''' (µ)'''
|align='center' style='background: #d0d0f0'|B6 '''ť''' (¶)'''
|align='center' style='background: #d0d0f0'|B7 '''ď''' (·)'''
|align='center' style='background: #d0d0f0'|B8 '''ž''' (¸)'''
|align='center' style='background: #d0d0f0'|B9 '''ő''' (¹)'''
|align='center' style='background: #d0d0f0'|BA '''ą''' (º)'''
|align='center' style='background: #d0d0f0'|BB '''ę''' (»)'''
|align='center' style='background: #d0d0f0'|BC '''Œ''' (¼)'''
|align='center' style='background: #d0d0f0'|BD '''œ''' (½)'''
|align='center' style='background: #d0d0f0'|BE '''Ÿ''' (¾)'''
|align='center'|BF '''¿'''

|-
!C…
|align='center'|C0 '''À'''
|align='center'|C1 '''Á'''
|align='center'|C2 '''Â'''
|align='center'|C3 '''Ã'''
|align='center'|C4 '''Ä'''
|align='center'|C5 '''Å'''
|align='center'|C6 '''Æ'''
|align='center'|C7 '''Ç'''
|align='center'|C8 '''È'''
|align='center'|C9 '''É'''
|align='center'|CA '''Ê'''
|align='center'|CB '''Ë'''
|align='center'|CC '''Ì'''
|align='center'|CD '''Í'''
|align='center'|CE '''Î'''
|align='center'|CF '''Ï'''

|-
!D…
|align='center'|D0 '''Ð'''
|align='center'|D1 '''Ñ'''
|align='center'|D2 '''Ò'''
|align='center'|D3 '''Ó'''
|align='center'|D4 '''Ô'''
|align='center'|D5 '''Õ'''
|align='center'|D6 '''Ö'''
|align='center' style='background: #d0d0f0'|D7 '''Ř''' (×)'''
|align='center'|D8 '''Ø'''
|align='center'|D9 '''Ù'''
|align='center'|DA '''Ú'''
|align='center'|DB '''Û'''
|align='center'|DC '''Ü'''
|align='center'|DD '''Ý'''
|align='center'|DE '''Þ'''
|align='center'|DF '''ß'''

|-
!E…
|align='center'|E0 '''à'''
|align='center'|E1 '''á'''
|align='center'|E2 '''â'''
|align='center'|E3 '''ã'''
|align='center'|E4 '''ä'''
|align='center'|E5 '''å'''
|align='center'|E6 '''æ'''
|align='center'|E7 '''ç'''
|align='center'|E8 '''è'''
|align='center'|E9 '''é'''
|align='center'|EA '''ê'''
|align='center'|EB '''ë'''
|align='center'|EC '''ì'''
|align='center'|ED '''í'''
|align='center'|EE '''î'''
|align='center'|EF '''ï'''

|-
!F…
|align='center'|F0 '''ð'''
|align='center'|F1 '''ñ'''
|align='center'|F2 '''ò'''
|align='center'|F3 '''ó'''
|align='center'|F4 '''ô'''
|align='center'|F5 '''õ'''
|align='center'|F6 '''ö'''
|align='center' style='background: #d0d0f0'|F7 '''ř''' (÷)'''
|align='center'|F8 '''ø'''
|align='center'|F9 '''ù'''
|align='center'|FA '''ú'''
|align='center'|FB '''û'''
|align='center'|FC '''ü'''
|align='center'|FD '''ý'''
|align='center'|FE '''þ'''
|align='center'|FF '''ÿ'''

|}

==== Table Notes ====

'''[1]''' As discussed [https://forums.thedarkmod.com/index.php?/topic/22427-analysis-of-212-tdm-fonts/&do=findComment&comment=494855 here], the TDM char set has a redundant treatment of 2 characters:

* Ô appears at 0x88 and 0xD4
* ô appears at 0x98 and 0xF4

Starting with TDM 2.13, the redundancy can be removed and these new characters (from ISO-8859-3) introduced:

* Ğ appears at 0x88
* ğ appears at 0x98

'''[2]''' Avoid using the non-breaking space (NBSP, 0xA0) and the soft hyphen (SHY, 0xAD) in your strings. The TDM engine has no code to respect these during word wrap. Font maintainers: probably map NBSP to the <space> glyph, SHY to undefined/hollow box or zero-sized box.

==== Corresponding Unicode ====

For a mapping of these 256 codepoints to Unicode U+NNNN values and formal names, download 'TDM 8859-Style Font Map to Unicode-16.txt':

* [https://drive.google.com/file/d/1wLEtuFvnrZ-WHK8ign8i3diIXZdriZ4F/view?usp=sharing for TDM 2.13]
* [https://drive.google.com/file/d/1UAz9jSZpT_j33STP3So_Re8JWa8QuAmz/view?usp=sharing for TDM 2.12 and earlier]

Each of these files (by Geep, 2024) is in a standardized format so that it can also be imported into font design programs like FontForge as a custom 256-position map. In the comments, there is additional information about:
* ISO 8859-x sourcing of each character.
* alternative representations of some European and control characters.

==== Fonts with Special Characters ====
Certain fonts have a few codepoints that purposefully diverge from the table entry.

* Carleton font (regular, bold, glow) uses codepoint 0x23, ordinarily "#", to represent "superscript #", which is used in the main menu system to indicate FMs for which a translation pack is available.
* Treasure Map font has characters for "pirate skull and crossbones" and "bottle of booze (or poison)".

== European Character Implementation ==
=== Priority Early-On - the "Top 50" ===

Some of the special characters are used more often than others. Here is a statistic over the entire string set of the TDM core, from TDM v1.08, showing the top 50 most-used characters (excluding a-z, 0-9 and russian characters):

{|class="wikitable" border=1 style="border-collapse: collapse; font-size: 85%" cellspacing=0 cellpadding=2

|-
|Rank
|Occurances
|Letter
|Remarks
|Rank
|Occurances
|Letter
|Remarks

|-
|1
|í
|715
|
|25
|ć
|67
|

|-
|2
|é
|674
|
|26
|è
|65
|

|-
|3
|á
|524
|
|27
|ú
|56
|

|-
|4
|ø
|303
|Danish
|28
|ê
|52
|

|-
|5
|č
|288
|
|29
|ö
|48
|German

|-
|6
|ó
|283
|
|30
|É
|46
|

|-
|7
|ü
|270
|German
|31
|ñ
|37
|

|-
|8
|ł
|203
|Polish
|32
|õ
|32
|

|-
|9
|æ
|200
|Danish
|33
|ń
|26
|

|-
|10
|ě
|182
|
|34
|Ł
|24
|

|-
|11
|ř
|175
|Czech
|35
|Š
|21
|

|-
|12
|ã
|168
|
|36
|â
|21
|

|-
|13
|ž
|148
|Czech
|37
|ź
|20
|

|-
|14
|ý
|142
|
|38
|ß
|18
|German

|-
|15
|ę
|141
|
|39
|Ó
|18
|

|-
|16
|ą
|140
|
|40
|ň
|15
|

|-
|17
|ż
|119
|
|41
|Ú
|15
|

|-
|18
|å
|109
|Danish
|42
|Á
|13
|

|-
|19
|š
|99
|
|43
|î
|12
|

|-
|20
|ś
|97
|
|44
|ť
|11
|

|-
|21
|ç
|91
|
|45
|ô
|9
|

|-
|22
|ä
|86
|German
|46
|Ž
|8
|

|-
|23
|à
|83
|
|47
|Ż
|7
|

|-
|24
|ů
|77
|
|48
|Č
|7
|

|-
|25
|ć
|67
|
|49
|ù
|6
|

|}

Although ö, ä and ü do not appear that often, with only these and Ü, Ö, Ä and ß, the entire German language works. So adding these letters to the fonts is quite important.

Preferably, all foreign letters would be added to the fonts (see [[Font Patcher]] or [[Refont]]). However, if time permits only adding a few, '''í''' would be more important than, say, '''ô'''.

It is commonplace for missing accented letters to be redirected in the .dat file to the corresponding unaccented base letter.

=== Coverage Expansion & Remaining Limitations ===

By 2014, all the system (e.g., main menu) fonts (Carleton, Carleton_condensed, Stone in sizes 24pt and 48pt; Mason and Mason_glow in 48pt) had good coverage of the "Top 50" and beyond, although not all 256 codepoints.
This was confirmed more specifically in 2024, as part of an [https://forums.thedarkmod.com/index.php?/topic/22427-analysis-of-212-tdm-fonts/ Analysis of 2.12 Fonts]. This analysis indicated that, unlike the system fonts, the FM fonts generally did not provide specific glyphs beyond ASCII.

In 2024, Stone 24pt, important for subtitles and a number of readables, was further extended to cover all 256 codepoints. This was tested with TDM 2.13[betas] and released with 2.14.

In 2026, English/European Carleton 24pt, widely used in the main menu and also some readables, was improved to:
* extend coverage to all codepoints
* replace sloppy hand-drawn Latin-1 glyphs with fresh glyphs, most of them generated from TTF then edge-darkened
* for simplicity, re-implement the red "glow" effect as if a drop-shadow.

Testing of this is planned with TDM 2.15 betas.

Stone 48pt improvements are under consideration for TDM 2.15.

== Font Encoding for Russian Cyrillic ==

Characters conform to the [https://en.wikipedia.org/wiki/Win-1251 WIN-1251 native encoding, shown in the Wikipedia article]. Exception: the character '''0xFF''' (я) is mapped to '''0xB6''' upon loading. Therefore any Russian font must contain я at the place 0xB6. (This was to overcome a historical Doom3 bug that is now fixed. But to date "the remapping for Russian is still in place, tho, to avoid having to patch all the russian fonts", says bug report [https://bugs.thedarkmod.com/view.php?id=2812 "0002812: Character 0xFF does not work in fonts"]).

=== Cyrillic Character Implementation ===
Within any given font, character coverage may be incomplete.

In 2025, the Russian Mason 48pt font was improved and extended to cover all TDM Russian codepoints, and included in TDM 2.14.

== Future Extensions to Unicode and/or Asian Languages (Korean, Chinese, Japanese)? ==

It is possible to visualize a transition to a DAT format (and engine code) that supported UCS (16-bit) Unicode, allowing the existing fonts to then be expanded to cover more characters. Then perhaps all.lang would be the only .lang needed.

As for Asian languages, the original D3 had support for them, so it might be possible to add them to TDM, too, but with a heavy burden on font development and translation. Also, writing from right-to-left (Hebrew) or top-down (Japanese) might be tricky or outright impossible in our GUI without more work in the C++ code. Plus, these languages use more than 256 different characters, and an 8 bit table will not hold these.

[[Category:Fonts]]

{{i18n}}

I18N - Charset

2026-05-31T21:35:16Z

Geep: /* Character Remapping */ mention ISO-8859-2

== Introduction ==

The D3 code that handles the GUI bitmap font can only load a specific range of bytes as characters. To get the most out of the available entries, special charsets are used. The fonts (Carleton for the menu f.i.) are build/patched so that the right characters appear in the right place.

== LANG File Encodings ==

=== all.lang ===

This file is in '''UTF-8''', and converted with the help of either the script '''devel/gen_lang.pl''':

perl devel/gen_lang.pl

or, more recently, the Windows C++ utility program '''gen_lang_plus'''. [[Gen_Lang_Programs]] has details of these.

This process ensures that the generated language files are in their proper encodings (see below).

=== All other language files ===

Language-specific files (f.i. '''german.lang''') provide string dictionaries. A system-wide set is provided in tdm_base01.pk4/strings/. A deployed FM may offer similar files in its /strings/ folder... at the very least '''english.lang'''. All such files are expected to be in the following 8-bit encodings:

* '''Czech, Hungarian, Slovak, Polish:''' [https://secure.wikimedia.org/wikipedia/en/wiki/ISO/IEC_8859-2 ISO-8859-2] ('''not WIN-1250!)
* '''Russian:''' [https://secure.wikimedia.org/wikipedia/en/wiki/Win-1251 WIN-1251]
* '''French:''' [https://secure.wikimedia.org/wikipedia/en/wiki/ISO/IEC_8859-15 ISO-8859-15]
* '''Romanian:''' [https://secure.wikimedia.org/wikipedia/en/wiki/ISO/IEC_8859-16 ISO-8859-16]
* '''Turkish:''' [https://secure.wikimedia.org/wikipedia/en/wiki/ISO/IEC_8859-9 ISO-8859-9]
* '''All other languages:''' [https://secure.wikimedia.org/wikipedia/en/wiki/ISO/IEC_8859-1 ISO-8859-1]. This covers TDM-supported languages English, German, Italian, Spanish, Portuguese, Swedish, Danish, Dutch, and Catalan.

{{infobox|The core dictionaries are automatically generated in the right encoding, but make sure that you use the right encoding for the FM dictionary, too!}}

== Character Remapping ==

The characters are remapped upon loading the dictionary/readable, from their native encoding to the two special ones (respectively for Latin and Cyrillic) that TDM uses and that are described next. Responsible for the remapping are [[I18N - Character mapping|mapping files]], f.i. "strings/czech.map". If a map file for a specific language is not found in "tdm_base01.pk4/strings" (and there is no "default.map" there, which is the case these days), then no remapping takes place. Generally, ISO-8859-1 languages do not require remapping. The map files for the four ISO-8859-2 languages have identical content.

See '''[[I18N - Character mapping|Character mapping]]''' for more information.

== Font Encoding for European Languages ==

This TDM-specific 8-bit encoding applies to all TDM fonts for English/European languages, that is, everything except the Cyrillic-based Russian. This encoding controls the ordering within a font's binary DAT file.

Note that the double accented characters in Hungarian '''Ő, ő, Ű and ű''' look a bit different from '''Ö, ö, Ü and ü'''!

In the table below, the original ISO 8859-1 characters are given in ''()'' below the TDM character.

'''Color code:'''

{{box|#f0d0d0|Character not usable by TDM|Unusable}}{{box|#d0e0d0|Character not yet used in TDM|Unused}}{{box|#c0ffc0|Character displayed in v1.08 or newer|Usable in v1.08}}{{box|#80f080|Character displayed in v2.03 or newer|Usable in v2.03}}{{box|#d0d0f0|Changed from the ISO-8859-1 default, usable by TDM 1.0 or newer|Changed from ISO 8859-1}}

{|class="wikitable" border=1 style="border-collapse: collapse; font-size: 95%" cellspacing=0 cellpadding=2 width=100%

|-
!
!…0
!…1
!…2
!…3
!…4
!…5
!…6
!…7
!…8
!…9
!…A
!…B
!…C
!…D
!…E
!…F

|-
!0…
|align='center' style='background: #f0d0d0'|00 '''–'''
|align='center' style='background: #f0d0d0'|01 '''–'''
|align='center' style='background: #f0d0d0'|02 '''–'''
|align='center' style='background: #f0d0d0'|03 '''–'''
|align='center' style='background: #f0d0d0'|04 '''–'''
|align='center' style='background: #f0d0d0'|05 '''–'''
|align='center' style='background: #f0d0d0'|06 '''–'''
|align='center' style='background: #f0d0d0'|07 '''–'''
|align='center' style='background: #f0d0d0'|08 '''–'''
|align='center' style='background: #f0d0d0'|09 '''–'''
|align='center' style='background: #f0d0d0'|0A '''–'''
|align='center' style='background: #f0d0d0'|0B '''–'''
|align='center' style='background: #f0d0d0'|0C '''–'''
|align='center' style='background: #f0d0d0'|0D '''–'''
|align='center' style='background: #f0d0d0'|0E '''–'''
|align='center' style='background: #f0d0d0'|0F '''–'''

|-
!1…
|align='center' style='background: #f0d0d0'|10 '''–'''
|align='center' style='background: #f0d0d0'|11 '''–'''
|align='center' style='background: #f0d0d0'|12 '''–'''
|align='center' style='background: #f0d0d0'|13 '''–'''
|align='center' style='background: #f0d0d0'|14 '''–'''
|align='center' style='background: #f0d0d0'|15 '''–'''
|align='center' style='background: #f0d0d0'|16 '''–'''
|align='center' style='background: #f0d0d0'|17 '''–'''
|align='center' style='background: #f0d0d0'|18 '''–'''
|align='center' style='background: #f0d0d0'|19 '''–'''
|align='center' style='background: #f0d0d0'|1A '''–'''
|align='center' style='background: #f0d0d0'|1B '''–'''
|align='center' style='background: #f0d0d0'|1C '''–'''
|align='center' style='background: #f0d0d0'|1D '''–'''
|align='center' style='background: #f0d0d0'|1E '''–'''
|align='center' style='background: #f0d0d0'|1F '''–'''

|-
!2…
|align='center'|20 ''' '''
|align='center'|21 '''!'''
|align='center'|22 '''"'''
|align='center'|23 '''#'''
|align='center'|24 '''$'''
|align='center'|25 '''%'''
|align='center'|26 '''&'''
|align='center'|27 '''''''
|align='center'|28 '''('''
|align='center'|29 ''')'''
|align='center'|2A '''*'''
|align='center'|2B '''+'''
|align='center'|2C ''','''
|align='center'|2D '''-'''
|align='center'|2E '''.'''
|align='center'|2F '''/'''

|-
!3…
|align='center'|30 '''0'''
|align='center'|31 '''1'''
|align='center'|32 '''2'''
|align='center'|33 '''3'''
|align='center'|34 '''4'''
|align='center'|35 '''5'''
|align='center'|36 '''6'''
|align='center'|37 '''7'''
|align='center'|38 '''8'''
|align='center'|39 '''9'''
|align='center'|3A ''':'''
|align='center'|3B ''';'''
|align='center'|3C '''<'''
|align='center'|3D '''='''
|align='center'|3E '''>'''
|align='center'|3F '''?'''

|-
!4…
|align='center'|40 '''@'''
|align='center'|41 '''A'''
|align='center'|42 '''B'''
|align='center'|43 '''C'''
|align='center'|44 '''D'''
|align='center'|45 '''E'''
|align='center'|46 '''F'''
|align='center'|47 '''G'''
|align='center'|48 '''H'''
|align='center'|49 '''I'''
|align='center'|4A '''J'''
|align='center'|4B '''K'''
|align='center'|4C '''L'''
|align='center'|4D '''M'''
|align='center'|4E '''N'''
|align='center'|4F '''O'''

|-
!5…
|align='center'|50 '''P'''
|align='center'|51 '''Q'''
|align='center'|52 '''R'''
|align='center'|53 '''S'''
|align='center'|54 '''T'''
|align='center'|55 '''U'''
|align='center'|56 '''V'''
|align='center'|57 '''W'''
|align='center'|58 '''X'''
|align='center'|59 '''Y'''
|align='center'|5A '''Z'''
|align='center'|5B '''['''
|align='center'|5C '''\'''
|align='center'|5D ''']'''
|align='center'|5E '''^'''
|align='center'|5F '''_'''

|-
!6…
|align='center'|60 '''`'''
|align='center'|61 '''a'''
|align='center'|62 '''b'''
|align='center'|63 '''c'''
|align='center'|64 '''d'''
|align='center'|65 '''e'''
|align='center'|66 '''f'''
|align='center'|67 '''g'''
|align='center'|68 '''h'''
|align='center'|69 '''i'''
|align='center'|6A '''j'''
|align='center'|6B '''k'''
|align='center'|6C '''l'''
|align='center'|6D '''m'''
|align='center'|6E '''n'''
|align='center'|6F '''o'''

|-
!7…
|align='center'|70 '''p'''
|align='center'|71 '''q'''
|align='center'|72 '''r'''
|align='center'|73 '''s'''
|align='center'|74 '''t'''
|align='center'|75 '''u'''
|align='center'|76 '''v'''
|align='center'|77 '''w'''
|align='center'|78 '''x'''
|align='center'|79 '''y'''
|align='center'|7A '''z'''
|align='center'|7B '''{'''
|align='center'|7C '''|'''
|align='center'|7D '''}'''
|align='center'|7E '''~'''
|align='center' style='background: #d0e0d0'|7F '''�'''

|-
!8…
|align='center' style='background: #c0ffc0'|80 '''Ň'''
|align='center' style='background: #c0ffc0'|81 '''Ś'''
|align='center' style='background: #c0ffc0'|82 '''Ć'''
|align='center' style='background: #c0ffc0'|83 '''Ż'''
|align='center' style='background: #c0ffc0'|84 '''Ź'''
|align='center' style='background: #c0ffc0'|85 '''Ŝ'''
|align='center' style='background: #c0ffc0'|86 '''Ĉ'''
|align='center' style='background: #c0ffc0'|87 '''Ẑ'''
|align='center' style='background: #c0ffc0'|88 '''Ô''' [1]
|align='center' style='background: #c0ffc0'|89 '''Ŕ'''
|align='center' style='background: #c0ffc0'|8A '''Ǔ'''
|align='center' style='background: #c0ffc0'|8B '''Ă'''
|align='center' style='background: #c0ffc0'|8C '''Ń'''
|align='center' style='background: #80f080'|8D '''Ș'''
|align='center' style='background: #80f080'|8E '''Ț'''
|align='center' style='background: #d0e0d0'|8F '''�'''

|-
!9…
|align='center' style='background: #80f080'|90 '''đ'''
|align='center' style='background: #c0ffc0'|91 '''ś'''
|align='center' style='background: #c0ffc0'|92 '''ć'''
|align='center' style='background: #c0ffc0'|93 '''ż'''
|align='center' style='background: #c0ffc0'|94 '''ź'''
|align='center' style='background: #c0ffc0'|95 '''ŝ'''
|align='center' style='background: #c0ffc0'|96 '''ĉ'''
|align='center' style='background: #c0ffc0'|97 '''ẑ'''
|align='center' style='background: #c0ffc0'|98 '''ô''' [1]
|align='center' style='background: #c0ffc0'|99 '''ŕ'''
|align='center' style='background: #c0ffc0'|9A '''ǔ'''
|align='center' style='background: #c0ffc0'|9B '''ă'''
|align='center' style='background: #c0ffc0'|9C '''ń'''
|align='center' style='background: #80f080'|9D '''ș'''
|align='center' style='background: #80f080'|9E '''ț'''
|align='center' style='background: #d0e0d0'|9F '''�'''

|-
!A…
|align='center'|A0 '''[https://secure.wikimedia.org/wikipedia/en/wiki/Non-breaking_space NBSP]''' [2]
|align='center' style='background: #d0d0f0'|A1 '''ň''' (¡)'''
|align='center' style='background: #d0d0f0'|A2 '''Ű''' (¢)'''
|align='center' style='background: #d0d0f0'|A3 '''ě''' (£)'''
|align='center' style='background: #d0d0f0'|A4 '''ű''' (¤)'''
|align='center' style='background: #d0d0f0'|A5 '''Ě''' (¥)'''
|align='center' style='background: #d0d0f0'|A6 '''Š''' (¦)'''
|align='center'|A7 '''§'''
|align='center' style='background: #d0d0f0'|A8 '''š''' (¨)'''
|align='center' style='background: #d0d0f0'|A9 '''Ů''' (©)'''
|align='center' style='background: #d0d0f0'|AA '''Ą''' (ª)'''
|align='center' style='background: #d0d0f0'|AB '''Ę''' («)'''
|align='center' style='background: #d0d0f0'|AC '''Č''' (¬)'''
|align='center'|AD '''[https://secure.wikimedia.org/wikipedia/en/wiki/Soft_hyphen SHY]''' [2]
|align='center' style='background: #d0d0f0'|AE '''č''' (®)'''
|align='center' style='background: #d0d0f0'|AF '''ů''' (¯)'''

|-
!B…
|align='center' style='background: #d0d0f0'|B0 '''Ő''' (°)'''
|align='center' style='background: #d0d0f0'|B1 '''Ł''' (±)'''
|align='center' style='background: #d0d0f0'|B2 '''Ť''' (²)'''
|align='center' style='background: #d0d0f0'|B3 '''Ď''' (³)'''
|align='center' style='background: #d0d0f0'|B4 '''Ž''' (´)'''
|align='center' style='background: #d0d0f0'|B5 '''ł''' (µ)'''
|align='center' style='background: #d0d0f0'|B6 '''ť''' (¶)'''
|align='center' style='background: #d0d0f0'|B7 '''ď''' (·)'''
|align='center' style='background: #d0d0f0'|B8 '''ž''' (¸)'''
|align='center' style='background: #d0d0f0'|B9 '''ő''' (¹)'''
|align='center' style='background: #d0d0f0'|BA '''ą''' (º)'''
|align='center' style='background: #d0d0f0'|BB '''ę''' (»)'''
|align='center' style='background: #d0d0f0'|BC '''Œ''' (¼)'''
|align='center' style='background: #d0d0f0'|BD '''œ''' (½)'''
|align='center' style='background: #d0d0f0'|BE '''Ÿ''' (¾)'''
|align='center'|BF '''¿'''

|-
!C…
|align='center'|C0 '''À'''
|align='center'|C1 '''Á'''
|align='center'|C2 '''Â'''
|align='center'|C3 '''Ã'''
|align='center'|C4 '''Ä'''
|align='center'|C5 '''Å'''
|align='center'|C6 '''Æ'''
|align='center'|C7 '''Ç'''
|align='center'|C8 '''È'''
|align='center'|C9 '''É'''
|align='center'|CA '''Ê'''
|align='center'|CB '''Ë'''
|align='center'|CC '''Ì'''
|align='center'|CD '''Í'''
|align='center'|CE '''Î'''
|align='center'|CF '''Ï'''

|-
!D…
|align='center'|D0 '''Ð'''
|align='center'|D1 '''Ñ'''
|align='center'|D2 '''Ò'''
|align='center'|D3 '''Ó'''
|align='center'|D4 '''Ô'''
|align='center'|D5 '''Õ'''
|align='center'|D6 '''Ö'''
|align='center' style='background: #d0d0f0'|D7 '''Ř''' (×)'''
|align='center'|D8 '''Ø'''
|align='center'|D9 '''Ù'''
|align='center'|DA '''Ú'''
|align='center'|DB '''Û'''
|align='center'|DC '''Ü'''
|align='center'|DD '''Ý'''
|align='center'|DE '''Þ'''
|align='center'|DF '''ß'''

|-
!E…
|align='center'|E0 '''à'''
|align='center'|E1 '''á'''
|align='center'|E2 '''â'''
|align='center'|E3 '''ã'''
|align='center'|E4 '''ä'''
|align='center'|E5 '''å'''
|align='center'|E6 '''æ'''
|align='center'|E7 '''ç'''
|align='center'|E8 '''è'''
|align='center'|E9 '''é'''
|align='center'|EA '''ê'''
|align='center'|EB '''ë'''
|align='center'|EC '''ì'''
|align='center'|ED '''í'''
|align='center'|EE '''î'''
|align='center'|EF '''ï'''

|-
!F…
|align='center'|F0 '''ð'''
|align='center'|F1 '''ñ'''
|align='center'|F2 '''ò'''
|align='center'|F3 '''ó'''
|align='center'|F4 '''ô'''
|align='center'|F5 '''õ'''
|align='center'|F6 '''ö'''
|align='center' style='background: #d0d0f0'|F7 '''ř''' (÷)'''
|align='center'|F8 '''ø'''
|align='center'|F9 '''ù'''
|align='center'|FA '''ú'''
|align='center'|FB '''û'''
|align='center'|FC '''ü'''
|align='center'|FD '''ý'''
|align='center'|FE '''þ'''
|align='center'|FF '''ÿ'''

|}

==== Table Notes ====

'''[1]''' As discussed [https://forums.thedarkmod.com/index.php?/topic/22427-analysis-of-212-tdm-fonts/&do=findComment&comment=494855 here], the TDM char set has a redundant treatment of 2 characters:

* Ô appears at 0x88 and 0xD4
* ô appears at 0x98 and 0xF4

Starting with TDM 2.13, the redundancy can be removed and these new characters (from ISO-8859-3) introduced:

* Ğ appears at 0x88
* ğ appears at 0x98

'''[2]''' Avoid using the non-breaking space (NBSP, 0xA0) and the soft hyphen (SHY, 0xAD) in your strings. The TDM engine has no code to respect these during word wrap. Font maintainers: probably map NBSP to the <space> glyph, SHY to undefined/hollow box or zero-sized box.

==== Corresponding Unicode ====

For a mapping of these 256 codepoints to Unicode U+NNNN values and formal names, download 'TDM 8859-Style Font Map to Unicode-16.txt':

* [https://drive.google.com/file/d/1wLEtuFvnrZ-WHK8ign8i3diIXZdriZ4F/view?usp=sharing for TDM 2.13]
* [https://drive.google.com/file/d/1UAz9jSZpT_j33STP3So_Re8JWa8QuAmz/view?usp=sharing for TDM 2.12 and earlier]

Each of these files (by Geep, 2024) is in a standardized format so that it can also be imported into font design programs like FontForge as a custom 256-position map. In the comments, there is additional information about:
* ISO 8859-x sourcing of each character.
* alternative representations of some European and control characters.

==== Fonts with Special Characters ====
Certain fonts have a few codepoints that purposefully diverge from the table entry.

* Carleton font (regular, bold, glow) uses codepoint 0x23, ordinarily "#", to represent "superscript #", which is used in the main menu system to indicate FMs for which a translation pack is available.
* Treasure Map font has characters for "pirate skull and crossbones" and "bottle of booze (or poison)".

== European Character Implementation ==
=== Priority Early-On - the "Top 50" ===

Some of the special characters are used more often than others. Here is a statistic over the entire string set of the TDM core, from TDM v1.08, showing the top 50 most-used characters (excluding a-z, 0-9 and russian characters):

{|class="wikitable" border=1 style="border-collapse: collapse; font-size: 85%" cellspacing=0 cellpadding=2

|-
|Rank
|Occurances
|Letter
|Remarks
|Rank
|Occurances
|Letter
|Remarks

|-
|1
|í
|715
|
|25
|ć
|67
|

|-
|2
|é
|674
|
|26
|è
|65
|

|-
|3
|á
|524
|
|27
|ú
|56
|

|-
|4
|ø
|303
|Danish
|28
|ê
|52
|

|-
|5
|č
|288
|
|29
|ö
|48
|German

|-
|6
|ó
|283
|
|30
|É
|46
|

|-
|7
|ü
|270
|German
|31
|ñ
|37
|

|-
|8
|ł
|203
|Polish
|32
|õ
|32
|

|-
|9
|æ
|200
|Danish
|33
|ń
|26
|

|-
|10
|ě
|182
|
|34
|Ł
|24
|

|-
|11
|ř
|175
|Czech
|35
|Š
|21
|

|-
|12
|ã
|168
|
|36
|â
|21
|

|-
|13
|ž
|148
|Czech
|37
|ź
|20
|

|-
|14
|ý
|142
|
|38
|ß
|18
|German

|-
|15
|ę
|141
|
|39
|Ó
|18
|

|-
|16
|ą
|140
|
|40
|ň
|15
|

|-
|17
|ż
|119
|
|41
|Ú
|15
|

|-
|18
|å
|109
|Danish
|42
|Á
|13
|

|-
|19
|š
|99
|
|43
|î
|12
|

|-
|20
|ś
|97
|
|44
|ť
|11
|

|-
|21
|ç
|91
|
|45
|ô
|9
|

|-
|22
|ä
|86
|German
|46
|Ž
|8
|

|-
|23
|à
|83
|
|47
|Ż
|7
|

|-
|24
|ů
|77
|
|48
|Č
|7
|

|-
|25
|ć
|67
|
|49
|ù
|6
|

|}

Although ö, ä and ü do not appear that often, with only these and Ü, Ö, Ä and ß, the entire German language works. So adding these letters to the fonts is quite important.

Preferably, all foreign letters would be added to the fonts (see [[Font Patcher]] or [[Refont]]). However, if time permits only adding a few, '''í''' would be more important than, say, '''ô'''.

It is commonplace for missing accented letters to be redirected in the .dat file to the corresponding unaccented base letter.

=== Coverage Expansion & Remaining Limitations ===

By 2014, all the system (e.g., main menu) fonts (Carleton, Carleton_condensed, Stone in sizes 24pt and 48pt; Mason and Mason_glow in 48pt) had good coverage of the "Top 50" and beyond, although not all 256 codepoints.
This was confirmed more specifically in 2024, as part of an [https://forums.thedarkmod.com/index.php?/topic/22427-analysis-of-212-tdm-fonts/ Analysis of 2.12 Fonts]. This analysis indicated that, unlike the system fonts, the FM fonts generally did not provide specific glyphs beyond ASCII.

In 2024, Stone 24pt, important for subtitles and a number of readables, was further extended to cover all 256 codepoints. This was tested with TDM 2.13[betas] and released with 2.14.

In 2026, English/European Carleton 24pt, widely used in the main menu and also some readables, was improved to:
* extend coverage to all codepoints
* replace sloppy hand-drawn Latin-1 glyphs with fresh glyphs, most of them generated from TTF then edge-darkened
* for simplicity, re-implement the red "glow" effect as if a drop-shadow.

Testing of this is planned with TDM 2.15 betas.

Stone 48pt improvements are under consideration for TDM 2.15.

== Font Encoding for Russian Cyrillic ==

Characters conform to the [https://en.wikipedia.org/wiki/Win-1251 WIN-1251 native encoding, shown in the Wikipedia article]. Exception: the character '''0xFF''' (я) is mapped to '''0xB6''' upon loading. Therefore any Russian font must contain я at the place 0xB6. (This was to overcome a historical Doom3 bug that is now fixed. But to date "the remapping for Russian is still in place, tho, to avoid having to patch all the russian fonts", says bug report [https://bugs.thedarkmod.com/view.php?id=2812 "0002812: Character 0xFF does not work in fonts"]).

=== Cyrillic Character Implementation ===
Within any given font, character coverage may be incomplete.

In 2025, the Russian Mason 48pt font was improved and extended to cover all TDM Russian codepoints, and included in TDM 2.14.

== Future Extensions to Unicode and/or Asian Languages (Korean, Chinese, Japanese)? ==

It is possible to visualize a transition to a DAT format (and engine code) that supported UCS (16-bit) Unicode, allowing the existing fonts to then be expanded to cover more characters. Then perhaps all.lang would be the only .lang needed.

As for Asian languages, the original D3 had support for them, so it might be possible to add them to TDM, too, but with a heavy burden on font development and translation. Also, writing from right-to-left (Hebrew) or top-down (Japanese) might be tricky or outright impossible in our GUI without more work in the C++ code. Plus, these languages use more than 256 different characters, and an 8 bit table will not hold these.

[[Category:Fonts]]

{{i18n}}

I18N - Charset

2026-05-31T20:54:10Z

Geep: Rearrange sections

== Introduction ==

The D3 code that handles the GUI bitmap font can only load a specific range of bytes as characters. To get the most out of the available entries, special charsets are used. The fonts (Carleton for the menu f.i.) are build/patched so that the right characters appear in the right place.

== LANG File Encodings ==

=== all.lang ===

This file is in '''UTF-8''', and converted with the help of either the script '''devel/gen_lang.pl''':

perl devel/gen_lang.pl

or, more recently, the Windows C++ utility program '''gen_lang_plus'''. [[Gen_Lang_Programs]] has details of these.

This process ensures that the generated language files are in their proper encodings (see below).

=== All other language files ===

Language-specific files (f.i. '''german.lang''') provide string dictionaries. A system-wide set is provided in tdm_base01.pk4/strings/. A deployed FM may offer similar files in its /strings/ folder... at the very least '''english.lang'''. All such files are expected to be in the following 8-bit encodings:

* '''Czech, Hungarian, Slovak, Polish:''' [https://secure.wikimedia.org/wikipedia/en/wiki/ISO/IEC_8859-2 ISO-8859-2] ('''not WIN-1250!)
* '''Russian:''' [https://secure.wikimedia.org/wikipedia/en/wiki/Win-1251 WIN-1251]
* '''French:''' [https://secure.wikimedia.org/wikipedia/en/wiki/ISO/IEC_8859-15 ISO-8859-15]
* '''Romanian:''' [https://secure.wikimedia.org/wikipedia/en/wiki/ISO/IEC_8859-16 ISO-8859-16]
* '''Turkish:''' [https://secure.wikimedia.org/wikipedia/en/wiki/ISO/IEC_8859-9 ISO-8859-9]
* '''All other languages:''' [https://secure.wikimedia.org/wikipedia/en/wiki/ISO/IEC_8859-1 ISO-8859-1]. This covers TDM-supported languages English, German, Italian, Spanish, Portuguese, Swedish, Danish, Dutch, and Catalan.

{{infobox|The core dictionaries are automatically generated in the right encoding, but make sure that you use the right encoding for the FM dictionary, too!}}

== Character Remapping ==

The characters are remapped upon loading the dictionary/readable, from their native encoding to the two special ones (respectively for Latin and Cyrillic) that TDM uses and that are described next. Responsible for the remapping are [[I18N - Character mapping|mapping files]], f.i. "strings/czech.map". If a map file for a specific language is not found in "tdm_base01.pk4/strings" (and there is no "default.map" there, which is the case these days), then no remapping takes place. Generally, ISO-8859-1 languages do not require remapping.

See '''[[I18N - Character mapping|Character mapping]]''' for more information.

== Font Encoding for European Languages ==

This TDM-specific 8-bit encoding applies to all TDM fonts for English/European languages, that is, everything except the Cyrillic-based Russian. This encoding controls the ordering within a font's binary DAT file.

Note that the double accented characters in Hungarian '''Ő, ő, Ű and ű''' look a bit different from '''Ö, ö, Ü and ü'''!

In the table below, the original ISO 8859-1 characters are given in ''()'' below the TDM character.

'''Color code:'''

{{box|#f0d0d0|Character not usable by TDM|Unusable}}{{box|#d0e0d0|Character not yet used in TDM|Unused}}{{box|#c0ffc0|Character displayed in v1.08 or newer|Usable in v1.08}}{{box|#80f080|Character displayed in v2.03 or newer|Usable in v2.03}}{{box|#d0d0f0|Changed from the ISO-8859-1 default, usable by TDM 1.0 or newer|Changed from ISO 8859-1}}

{|class="wikitable" border=1 style="border-collapse: collapse; font-size: 95%" cellspacing=0 cellpadding=2 width=100%

|-
!
!…0
!…1
!…2
!…3
!…4
!…5
!…6
!…7
!…8
!…9
!…A
!…B
!…C
!…D
!…E
!…F

|-
!0…
|align='center' style='background: #f0d0d0'|00 '''–'''
|align='center' style='background: #f0d0d0'|01 '''–'''
|align='center' style='background: #f0d0d0'|02 '''–'''
|align='center' style='background: #f0d0d0'|03 '''–'''
|align='center' style='background: #f0d0d0'|04 '''–'''
|align='center' style='background: #f0d0d0'|05 '''–'''
|align='center' style='background: #f0d0d0'|06 '''–'''
|align='center' style='background: #f0d0d0'|07 '''–'''
|align='center' style='background: #f0d0d0'|08 '''–'''
|align='center' style='background: #f0d0d0'|09 '''–'''
|align='center' style='background: #f0d0d0'|0A '''–'''
|align='center' style='background: #f0d0d0'|0B '''–'''
|align='center' style='background: #f0d0d0'|0C '''–'''
|align='center' style='background: #f0d0d0'|0D '''–'''
|align='center' style='background: #f0d0d0'|0E '''–'''
|align='center' style='background: #f0d0d0'|0F '''–'''

|-
!1…
|align='center' style='background: #f0d0d0'|10 '''–'''
|align='center' style='background: #f0d0d0'|11 '''–'''
|align='center' style='background: #f0d0d0'|12 '''–'''
|align='center' style='background: #f0d0d0'|13 '''–'''
|align='center' style='background: #f0d0d0'|14 '''–'''
|align='center' style='background: #f0d0d0'|15 '''–'''
|align='center' style='background: #f0d0d0'|16 '''–'''
|align='center' style='background: #f0d0d0'|17 '''–'''
|align='center' style='background: #f0d0d0'|18 '''–'''
|align='center' style='background: #f0d0d0'|19 '''–'''
|align='center' style='background: #f0d0d0'|1A '''–'''
|align='center' style='background: #f0d0d0'|1B '''–'''
|align='center' style='background: #f0d0d0'|1C '''–'''
|align='center' style='background: #f0d0d0'|1D '''–'''
|align='center' style='background: #f0d0d0'|1E '''–'''
|align='center' style='background: #f0d0d0'|1F '''–'''

|-
!2…
|align='center'|20 ''' '''
|align='center'|21 '''!'''
|align='center'|22 '''"'''
|align='center'|23 '''#'''
|align='center'|24 '''$'''
|align='center'|25 '''%'''
|align='center'|26 '''&'''
|align='center'|27 '''''''
|align='center'|28 '''('''
|align='center'|29 ''')'''
|align='center'|2A '''*'''
|align='center'|2B '''+'''
|align='center'|2C ''','''
|align='center'|2D '''-'''
|align='center'|2E '''.'''
|align='center'|2F '''/'''

|-
!3…
|align='center'|30 '''0'''
|align='center'|31 '''1'''
|align='center'|32 '''2'''
|align='center'|33 '''3'''
|align='center'|34 '''4'''
|align='center'|35 '''5'''
|align='center'|36 '''6'''
|align='center'|37 '''7'''
|align='center'|38 '''8'''
|align='center'|39 '''9'''
|align='center'|3A ''':'''
|align='center'|3B ''';'''
|align='center'|3C '''<'''
|align='center'|3D '''='''
|align='center'|3E '''>'''
|align='center'|3F '''?'''

|-
!4…
|align='center'|40 '''@'''
|align='center'|41 '''A'''
|align='center'|42 '''B'''
|align='center'|43 '''C'''
|align='center'|44 '''D'''
|align='center'|45 '''E'''
|align='center'|46 '''F'''
|align='center'|47 '''G'''
|align='center'|48 '''H'''
|align='center'|49 '''I'''
|align='center'|4A '''J'''
|align='center'|4B '''K'''
|align='center'|4C '''L'''
|align='center'|4D '''M'''
|align='center'|4E '''N'''
|align='center'|4F '''O'''

|-
!5…
|align='center'|50 '''P'''
|align='center'|51 '''Q'''
|align='center'|52 '''R'''
|align='center'|53 '''S'''
|align='center'|54 '''T'''
|align='center'|55 '''U'''
|align='center'|56 '''V'''
|align='center'|57 '''W'''
|align='center'|58 '''X'''
|align='center'|59 '''Y'''
|align='center'|5A '''Z'''
|align='center'|5B '''['''
|align='center'|5C '''\'''
|align='center'|5D ''']'''
|align='center'|5E '''^'''
|align='center'|5F '''_'''

|-
!6…
|align='center'|60 '''`'''
|align='center'|61 '''a'''
|align='center'|62 '''b'''
|align='center'|63 '''c'''
|align='center'|64 '''d'''
|align='center'|65 '''e'''
|align='center'|66 '''f'''
|align='center'|67 '''g'''
|align='center'|68 '''h'''
|align='center'|69 '''i'''
|align='center'|6A '''j'''
|align='center'|6B '''k'''
|align='center'|6C '''l'''
|align='center'|6D '''m'''
|align='center'|6E '''n'''
|align='center'|6F '''o'''

|-
!7…
|align='center'|70 '''p'''
|align='center'|71 '''q'''
|align='center'|72 '''r'''
|align='center'|73 '''s'''
|align='center'|74 '''t'''
|align='center'|75 '''u'''
|align='center'|76 '''v'''
|align='center'|77 '''w'''
|align='center'|78 '''x'''
|align='center'|79 '''y'''
|align='center'|7A '''z'''
|align='center'|7B '''{'''
|align='center'|7C '''|'''
|align='center'|7D '''}'''
|align='center'|7E '''~'''
|align='center' style='background: #d0e0d0'|7F '''�'''

|-
!8…
|align='center' style='background: #c0ffc0'|80 '''Ň'''
|align='center' style='background: #c0ffc0'|81 '''Ś'''
|align='center' style='background: #c0ffc0'|82 '''Ć'''
|align='center' style='background: #c0ffc0'|83 '''Ż'''
|align='center' style='background: #c0ffc0'|84 '''Ź'''
|align='center' style='background: #c0ffc0'|85 '''Ŝ'''
|align='center' style='background: #c0ffc0'|86 '''Ĉ'''
|align='center' style='background: #c0ffc0'|87 '''Ẑ'''
|align='center' style='background: #c0ffc0'|88 '''Ô''' [1]
|align='center' style='background: #c0ffc0'|89 '''Ŕ'''
|align='center' style='background: #c0ffc0'|8A '''Ǔ'''
|align='center' style='background: #c0ffc0'|8B '''Ă'''
|align='center' style='background: #c0ffc0'|8C '''Ń'''
|align='center' style='background: #80f080'|8D '''Ș'''
|align='center' style='background: #80f080'|8E '''Ț'''
|align='center' style='background: #d0e0d0'|8F '''�'''

|-
!9…
|align='center' style='background: #80f080'|90 '''đ'''
|align='center' style='background: #c0ffc0'|91 '''ś'''
|align='center' style='background: #c0ffc0'|92 '''ć'''
|align='center' style='background: #c0ffc0'|93 '''ż'''
|align='center' style='background: #c0ffc0'|94 '''ź'''
|align='center' style='background: #c0ffc0'|95 '''ŝ'''
|align='center' style='background: #c0ffc0'|96 '''ĉ'''
|align='center' style='background: #c0ffc0'|97 '''ẑ'''
|align='center' style='background: #c0ffc0'|98 '''ô''' [1]
|align='center' style='background: #c0ffc0'|99 '''ŕ'''
|align='center' style='background: #c0ffc0'|9A '''ǔ'''
|align='center' style='background: #c0ffc0'|9B '''ă'''
|align='center' style='background: #c0ffc0'|9C '''ń'''
|align='center' style='background: #80f080'|9D '''ș'''
|align='center' style='background: #80f080'|9E '''ț'''
|align='center' style='background: #d0e0d0'|9F '''�'''

|-
!A…
|align='center'|A0 '''[https://secure.wikimedia.org/wikipedia/en/wiki/Non-breaking_space NBSP]''' [2]
|align='center' style='background: #d0d0f0'|A1 '''ň''' (¡)'''
|align='center' style='background: #d0d0f0'|A2 '''Ű''' (¢)'''
|align='center' style='background: #d0d0f0'|A3 '''ě''' (£)'''
|align='center' style='background: #d0d0f0'|A4 '''ű''' (¤)'''
|align='center' style='background: #d0d0f0'|A5 '''Ě''' (¥)'''
|align='center' style='background: #d0d0f0'|A6 '''Š''' (¦)'''
|align='center'|A7 '''§'''
|align='center' style='background: #d0d0f0'|A8 '''š''' (¨)'''
|align='center' style='background: #d0d0f0'|A9 '''Ů''' (©)'''
|align='center' style='background: #d0d0f0'|AA '''Ą''' (ª)'''
|align='center' style='background: #d0d0f0'|AB '''Ę''' («)'''
|align='center' style='background: #d0d0f0'|AC '''Č''' (¬)'''
|align='center'|AD '''[https://secure.wikimedia.org/wikipedia/en/wiki/Soft_hyphen SHY]''' [2]
|align='center' style='background: #d0d0f0'|AE '''č''' (®)'''
|align='center' style='background: #d0d0f0'|AF '''ů''' (¯)'''

|-
!B…
|align='center' style='background: #d0d0f0'|B0 '''Ő''' (°)'''
|align='center' style='background: #d0d0f0'|B1 '''Ł''' (±)'''
|align='center' style='background: #d0d0f0'|B2 '''Ť''' (²)'''
|align='center' style='background: #d0d0f0'|B3 '''Ď''' (³)'''
|align='center' style='background: #d0d0f0'|B4 '''Ž''' (´)'''
|align='center' style='background: #d0d0f0'|B5 '''ł''' (µ)'''
|align='center' style='background: #d0d0f0'|B6 '''ť''' (¶)'''
|align='center' style='background: #d0d0f0'|B7 '''ď''' (·)'''
|align='center' style='background: #d0d0f0'|B8 '''ž''' (¸)'''
|align='center' style='background: #d0d0f0'|B9 '''ő''' (¹)'''
|align='center' style='background: #d0d0f0'|BA '''ą''' (º)'''
|align='center' style='background: #d0d0f0'|BB '''ę''' (»)'''
|align='center' style='background: #d0d0f0'|BC '''Œ''' (¼)'''
|align='center' style='background: #d0d0f0'|BD '''œ''' (½)'''
|align='center' style='background: #d0d0f0'|BE '''Ÿ''' (¾)'''
|align='center'|BF '''¿'''

|-
!C…
|align='center'|C0 '''À'''
|align='center'|C1 '''Á'''
|align='center'|C2 '''Â'''
|align='center'|C3 '''Ã'''
|align='center'|C4 '''Ä'''
|align='center'|C5 '''Å'''
|align='center'|C6 '''Æ'''
|align='center'|C7 '''Ç'''
|align='center'|C8 '''È'''
|align='center'|C9 '''É'''
|align='center'|CA '''Ê'''
|align='center'|CB '''Ë'''
|align='center'|CC '''Ì'''
|align='center'|CD '''Í'''
|align='center'|CE '''Î'''
|align='center'|CF '''Ï'''

|-
!D…
|align='center'|D0 '''Ð'''
|align='center'|D1 '''Ñ'''
|align='center'|D2 '''Ò'''
|align='center'|D3 '''Ó'''
|align='center'|D4 '''Ô'''
|align='center'|D5 '''Õ'''
|align='center'|D6 '''Ö'''
|align='center' style='background: #d0d0f0'|D7 '''Ř''' (×)'''
|align='center'|D8 '''Ø'''
|align='center'|D9 '''Ù'''
|align='center'|DA '''Ú'''
|align='center'|DB '''Û'''
|align='center'|DC '''Ü'''
|align='center'|DD '''Ý'''
|align='center'|DE '''Þ'''
|align='center'|DF '''ß'''

|-
!E…
|align='center'|E0 '''à'''
|align='center'|E1 '''á'''
|align='center'|E2 '''â'''
|align='center'|E3 '''ã'''
|align='center'|E4 '''ä'''
|align='center'|E5 '''å'''
|align='center'|E6 '''æ'''
|align='center'|E7 '''ç'''
|align='center'|E8 '''è'''
|align='center'|E9 '''é'''
|align='center'|EA '''ê'''
|align='center'|EB '''ë'''
|align='center'|EC '''ì'''
|align='center'|ED '''í'''
|align='center'|EE '''î'''
|align='center'|EF '''ï'''

|-
!F…
|align='center'|F0 '''ð'''
|align='center'|F1 '''ñ'''
|align='center'|F2 '''ò'''
|align='center'|F3 '''ó'''
|align='center'|F4 '''ô'''
|align='center'|F5 '''õ'''
|align='center'|F6 '''ö'''
|align='center' style='background: #d0d0f0'|F7 '''ř''' (÷)'''
|align='center'|F8 '''ø'''
|align='center'|F9 '''ù'''
|align='center'|FA '''ú'''
|align='center'|FB '''û'''
|align='center'|FC '''ü'''
|align='center'|FD '''ý'''
|align='center'|FE '''þ'''
|align='center'|FF '''ÿ'''

|}

==== Table Notes ====

'''[1]''' As discussed [https://forums.thedarkmod.com/index.php?/topic/22427-analysis-of-212-tdm-fonts/&do=findComment&comment=494855 here], the TDM char set has a redundant treatment of 2 characters:

* Ô appears at 0x88 and 0xD4
* ô appears at 0x98 and 0xF4

Starting with TDM 2.13, the redundancy can be removed and these new characters (from ISO-8859-3) introduced:

* Ğ appears at 0x88
* ğ appears at 0x98

'''[2]''' Avoid using the non-breaking space (NBSP, 0xA0) and the soft hyphen (SHY, 0xAD) in your strings. The TDM engine has no code to respect these during word wrap. Font maintainers: probably map NBSP to the <space> glyph, SHY to undefined/hollow box or zero-sized box.

==== Corresponding Unicode ====

For a mapping of these 256 codepoints to Unicode U+NNNN values and formal names, download 'TDM 8859-Style Font Map to Unicode-16.txt':

* [https://drive.google.com/file/d/1wLEtuFvnrZ-WHK8ign8i3diIXZdriZ4F/view?usp=sharing for TDM 2.13]
* [https://drive.google.com/file/d/1UAz9jSZpT_j33STP3So_Re8JWa8QuAmz/view?usp=sharing for TDM 2.12 and earlier]

Each of these files (by Geep, 2024) is in a standardized format so that it can also be imported into font design programs like FontForge as a custom 256-position map. In the comments, there is additional information about:
* ISO 8859-x sourcing of each character.
* alternative representations of some European and control characters.

==== Fonts with Special Characters ====
Certain fonts have a few codepoints that purposefully diverge from the table entry.

* Carleton font (regular, bold, glow) uses codepoint 0x23, ordinarily "#", to represent "superscript #", which is used in the main menu system to indicate FMs for which a translation pack is available.
* Treasure Map font has characters for "pirate skull and crossbones" and "bottle of booze (or poison)".

== European Character Implementation ==
=== Priority Early-On - the "Top 50" ===

Some of the special characters are used more often than others. Here is a statistic over the entire string set of the TDM core, from TDM v1.08, showing the top 50 most-used characters (excluding a-z, 0-9 and russian characters):

{|class="wikitable" border=1 style="border-collapse: collapse; font-size: 85%" cellspacing=0 cellpadding=2

|-
|Rank
|Occurances
|Letter
|Remarks
|Rank
|Occurances
|Letter
|Remarks

|-
|1
|í
|715
|
|25
|ć
|67
|

|-
|2
|é
|674
|
|26
|è
|65
|

|-
|3
|á
|524
|
|27
|ú
|56
|

|-
|4
|ø
|303
|Danish
|28
|ê
|52
|

|-
|5
|č
|288
|
|29
|ö
|48
|German

|-
|6
|ó
|283
|
|30
|É
|46
|

|-
|7
|ü
|270
|German
|31
|ñ
|37
|

|-
|8
|ł
|203
|Polish
|32
|õ
|32
|

|-
|9
|æ
|200
|Danish
|33
|ń
|26
|

|-
|10
|ě
|182
|
|34
|Ł
|24
|

|-
|11
|ř
|175
|Czech
|35
|Š
|21
|

|-
|12
|ã
|168
|
|36
|â
|21
|

|-
|13
|ž
|148
|Czech
|37
|ź
|20
|

|-
|14
|ý
|142
|
|38
|ß
|18
|German

|-
|15
|ę
|141
|
|39
|Ó
|18
|

|-
|16
|ą
|140
|
|40
|ň
|15
|

|-
|17
|ż
|119
|
|41
|Ú
|15
|

|-
|18
|å
|109
|Danish
|42
|Á
|13
|

|-
|19
|š
|99
|
|43
|î
|12
|

|-
|20
|ś
|97
|
|44
|ť
|11
|

|-
|21
|ç
|91
|
|45
|ô
|9
|

|-
|22
|ä
|86
|German
|46
|Ž
|8
|

|-
|23
|à
|83
|
|47
|Ż
|7
|

|-
|24
|ů
|77
|
|48
|Č
|7
|

|-
|25
|ć
|67
|
|49
|ù
|6
|

|}

Although ö, ä and ü do not appear that often, with only these and Ü, Ö, Ä and ß, the entire German language works. So adding these letters to the fonts is quite important.

Preferably, all foreign letters would be added to the fonts (see [[Font Patcher]] or [[Refont]]). However, if time permits only adding a few, '''í''' would be more important than, say, '''ô'''.

It is commonplace for missing accented letters to be redirected in the .dat file to the corresponding unaccented base letter.

=== Coverage Expansion & Remaining Limitations ===

By 2014, all the system (e.g., main menu) fonts (Carleton, Carleton_condensed, Stone in sizes 24pt and 48pt; Mason and Mason_glow in 48pt) had good coverage of the "Top 50" and beyond, although not all 256 codepoints.
This was confirmed more specifically in 2024, as part of an [https://forums.thedarkmod.com/index.php?/topic/22427-analysis-of-212-tdm-fonts/ Analysis of 2.12 Fonts]. This analysis indicated that, unlike the system fonts, the FM fonts generally did not provide specific glyphs beyond ASCII.

In 2024, Stone 24pt, important for subtitles and a number of readables, was further extended to cover all 256 codepoints. This was tested with TDM 2.13[betas] and released with 2.14.

In 2026, English/European Carleton 24pt, widely used in the main menu and also some readables, was improved to:
* extend coverage to all codepoints
* replace sloppy hand-drawn Latin-1 glyphs with fresh glyphs, most of them generated from TTF then edge-darkened
* for simplicity, re-implement the red "glow" effect as if a drop-shadow.

Testing of this is planned with TDM 2.15 betas.

Stone 48pt improvements are under consideration for TDM 2.15.

== Font Encoding for Russian Cyrillic ==

Characters conform to the [https://en.wikipedia.org/wiki/Win-1251 WIN-1251 native encoding, shown in the Wikipedia article]. Exception: the character '''0xFF''' (я) is mapped to '''0xB6''' upon loading. Therefore any Russian font must contain я at the place 0xB6. (This was to overcome a historical Doom3 bug that is now fixed. But to date "the remapping for Russian is still in place, tho, to avoid having to patch all the russian fonts", says bug report [https://bugs.thedarkmod.com/view.php?id=2812 "0002812: Character 0xFF does not work in fonts"]).

=== Cyrillic Character Implementation ===
Within any given font, character coverage may be incomplete.

In 2025, the Russian Mason 48pt font was improved and extended to cover all TDM Russian codepoints, and included in TDM 2.14.

== Future Extensions to Unicode and/or Asian Languages (Korean, Chinese, Japanese)? ==

It is possible to visualize a transition to a DAT format (and engine code) that supported UCS (16-bit) Unicode, allowing the existing fonts to then be expanded to cover more characters. Then perhaps all.lang would be the only .lang needed.

As for Asian languages, the original D3 had support for them, so it might be possible to add them to TDM, too, but with a heavy burden on font development and translation. Also, writing from right-to-left (Hebrew) or top-down (Japanese) might be tricky or outright impossible in our GUI without more work in the C++ code. Plus, these languages use more than 256 different characters, and an 8 bit table will not hold these.

[[Category:Fonts]]

{{i18n}}

I18N - Charset

2026-05-31T20:29:59Z

Geep: /* Character remapping */ Rewrite intro & future extensions, change heading nesting

== Introduction ==

The D3 code that handles the GUI bitmap font can only load a specific range of bytes as characters. To get the most out of the available entries, special charsets are used. The fonts (Carleton for the menu f.i.) are build/patched so that the right characters appear in the right place.

== Encodings ==

=== all.lang ===

This file is in '''UTF-8''', and converted with the help of either the script '''devel/gen_lang.pl''':

perl devel/gen_lang.pl

or, more recently, the Windows C++ utility program '''gen_lang_plus'''. [[Gen_Lang_Programs]] has details of these.

This process ensures that the generated language files are in their proper encodings (see below).

=== All other language files ===

Language-specific files (f.i. '''german.lang''') provide string dictionaries. A system-wide set is provided in tdm_base01.pk4/strings/. A deployed FM may offer similar files in its /strings/ folder... at the very least '''english.lang'''. All such files are expected to be in the following 8-bit encodings:

* '''Czech, Hungarian, Slovak, Polish:''' [https://secure.wikimedia.org/wikipedia/en/wiki/ISO/IEC_8859-2 ISO-8859-2] ('''not WIN-1250!)
* '''Russian:''' [https://secure.wikimedia.org/wikipedia/en/wiki/Win-1251 WIN-1251]
* '''French:''' [https://secure.wikimedia.org/wikipedia/en/wiki/ISO/IEC_8859-15 ISO-8859-15]
* '''Romanian:''' [https://secure.wikimedia.org/wikipedia/en/wiki/ISO/IEC_8859-16 ISO-8859-16]
* '''Turkish:''' [https://secure.wikimedia.org/wikipedia/en/wiki/ISO/IEC_8859-9 ISO-8859-9]
* '''All other languages:''' [https://secure.wikimedia.org/wikipedia/en/wiki/ISO/IEC_8859-1 ISO-8859-1]. This covers TDM-supported languages English, German, Italian, Spanish, Portuguese, Swedish, Danish, Dutch, and Catalan.

{{infobox|The core dictionaries are automatically generated in the right encoding, but make sure that you use the right encoding for the FM dictionary, too!}}

== Character Remapping ==

The characters are remapped upon loading the dictionary/readable, from their native encoding to the two special ones (respectively for Latin and Cyrillic) that TDM uses and that are described next. Responsible for the remapping are [[I18N - Character mapping|mapping files]], f.i. "strings/czech.map". If a map file for a specific language is not found in "tdm_base01.pk4/strings" (and there is no "default.map" there, which is the case these days), then no remapping takes place. Generally, ISO-8859-1 languages do not require remapping.

See '''[[I18N - Character mapping|Character mapping]]''' for more information.

== Encoding for European Languages ==

This TDM-specific 8-bit encoding applies to all TDM fonts for English/European languages, that is, everything except the Cyrillic-based Russian.

Note that the double accented characters in Hungarian '''Ő, ő, Ű and ű''' look a bit different from '''Ö, ö, Ü and ü'''!

In the table below, the original ISO 8859-1 characters are given in ''()'' below the TDM character.

'''Color code:'''

{{box|#f0d0d0|Character not usable by TDM|Unusable}}{{box|#d0e0d0|Character not yet used in TDM|Unused}}{{box|#c0ffc0|Character displayed in v1.08 or newer|Usable in v1.08}}{{box|#80f080|Character displayed in v2.03 or newer|Usable in v2.03}}{{box|#d0d0f0|Changed from the ISO-8859-1 default, usable by TDM 1.0 or newer|Changed from ISO 8859-1}}

{|class="wikitable" border=1 style="border-collapse: collapse; font-size: 95%" cellspacing=0 cellpadding=2 width=100%

|-
!
!…0
!…1
!…2
!…3
!…4
!…5
!…6
!…7
!…8
!…9
!…A
!…B
!…C
!…D
!…E
!…F

|-
!0…
|align='center' style='background: #f0d0d0'|00 '''–'''
|align='center' style='background: #f0d0d0'|01 '''–'''
|align='center' style='background: #f0d0d0'|02 '''–'''
|align='center' style='background: #f0d0d0'|03 '''–'''
|align='center' style='background: #f0d0d0'|04 '''–'''
|align='center' style='background: #f0d0d0'|05 '''–'''
|align='center' style='background: #f0d0d0'|06 '''–'''
|align='center' style='background: #f0d0d0'|07 '''–'''
|align='center' style='background: #f0d0d0'|08 '''–'''
|align='center' style='background: #f0d0d0'|09 '''–'''
|align='center' style='background: #f0d0d0'|0A '''–'''
|align='center' style='background: #f0d0d0'|0B '''–'''
|align='center' style='background: #f0d0d0'|0C '''–'''
|align='center' style='background: #f0d0d0'|0D '''–'''
|align='center' style='background: #f0d0d0'|0E '''–'''
|align='center' style='background: #f0d0d0'|0F '''–'''

|-
!1…
|align='center' style='background: #f0d0d0'|10 '''–'''
|align='center' style='background: #f0d0d0'|11 '''–'''
|align='center' style='background: #f0d0d0'|12 '''–'''
|align='center' style='background: #f0d0d0'|13 '''–'''
|align='center' style='background: #f0d0d0'|14 '''–'''
|align='center' style='background: #f0d0d0'|15 '''–'''
|align='center' style='background: #f0d0d0'|16 '''–'''
|align='center' style='background: #f0d0d0'|17 '''–'''
|align='center' style='background: #f0d0d0'|18 '''–'''
|align='center' style='background: #f0d0d0'|19 '''–'''
|align='center' style='background: #f0d0d0'|1A '''–'''
|align='center' style='background: #f0d0d0'|1B '''–'''
|align='center' style='background: #f0d0d0'|1C '''–'''
|align='center' style='background: #f0d0d0'|1D '''–'''
|align='center' style='background: #f0d0d0'|1E '''–'''
|align='center' style='background: #f0d0d0'|1F '''–'''

|-
!2…
|align='center'|20 ''' '''
|align='center'|21 '''!'''
|align='center'|22 '''"'''
|align='center'|23 '''#'''
|align='center'|24 '''$'''
|align='center'|25 '''%'''
|align='center'|26 '''&'''
|align='center'|27 '''''''
|align='center'|28 '''('''
|align='center'|29 ''')'''
|align='center'|2A '''*'''
|align='center'|2B '''+'''
|align='center'|2C ''','''
|align='center'|2D '''-'''
|align='center'|2E '''.'''
|align='center'|2F '''/'''

|-
!3…
|align='center'|30 '''0'''
|align='center'|31 '''1'''
|align='center'|32 '''2'''
|align='center'|33 '''3'''
|align='center'|34 '''4'''
|align='center'|35 '''5'''
|align='center'|36 '''6'''
|align='center'|37 '''7'''
|align='center'|38 '''8'''
|align='center'|39 '''9'''
|align='center'|3A ''':'''
|align='center'|3B ''';'''
|align='center'|3C '''<'''
|align='center'|3D '''='''
|align='center'|3E '''>'''
|align='center'|3F '''?'''

|-
!4…
|align='center'|40 '''@'''
|align='center'|41 '''A'''
|align='center'|42 '''B'''
|align='center'|43 '''C'''
|align='center'|44 '''D'''
|align='center'|45 '''E'''
|align='center'|46 '''F'''
|align='center'|47 '''G'''
|align='center'|48 '''H'''
|align='center'|49 '''I'''
|align='center'|4A '''J'''
|align='center'|4B '''K'''
|align='center'|4C '''L'''
|align='center'|4D '''M'''
|align='center'|4E '''N'''
|align='center'|4F '''O'''

|-
!5…
|align='center'|50 '''P'''
|align='center'|51 '''Q'''
|align='center'|52 '''R'''
|align='center'|53 '''S'''
|align='center'|54 '''T'''
|align='center'|55 '''U'''
|align='center'|56 '''V'''
|align='center'|57 '''W'''
|align='center'|58 '''X'''
|align='center'|59 '''Y'''
|align='center'|5A '''Z'''
|align='center'|5B '''['''
|align='center'|5C '''\'''
|align='center'|5D ''']'''
|align='center'|5E '''^'''
|align='center'|5F '''_'''

|-
!6…
|align='center'|60 '''`'''
|align='center'|61 '''a'''
|align='center'|62 '''b'''
|align='center'|63 '''c'''
|align='center'|64 '''d'''
|align='center'|65 '''e'''
|align='center'|66 '''f'''
|align='center'|67 '''g'''
|align='center'|68 '''h'''
|align='center'|69 '''i'''
|align='center'|6A '''j'''
|align='center'|6B '''k'''
|align='center'|6C '''l'''
|align='center'|6D '''m'''
|align='center'|6E '''n'''
|align='center'|6F '''o'''

|-
!7…
|align='center'|70 '''p'''
|align='center'|71 '''q'''
|align='center'|72 '''r'''
|align='center'|73 '''s'''
|align='center'|74 '''t'''
|align='center'|75 '''u'''
|align='center'|76 '''v'''
|align='center'|77 '''w'''
|align='center'|78 '''x'''
|align='center'|79 '''y'''
|align='center'|7A '''z'''
|align='center'|7B '''{'''
|align='center'|7C '''|'''
|align='center'|7D '''}'''
|align='center'|7E '''~'''
|align='center' style='background: #d0e0d0'|7F '''�'''

|-
!8…
|align='center' style='background: #c0ffc0'|80 '''Ň'''
|align='center' style='background: #c0ffc0'|81 '''Ś'''
|align='center' style='background: #c0ffc0'|82 '''Ć'''
|align='center' style='background: #c0ffc0'|83 '''Ż'''
|align='center' style='background: #c0ffc0'|84 '''Ź'''
|align='center' style='background: #c0ffc0'|85 '''Ŝ'''
|align='center' style='background: #c0ffc0'|86 '''Ĉ'''
|align='center' style='background: #c0ffc0'|87 '''Ẑ'''
|align='center' style='background: #c0ffc0'|88 '''Ô''' [1]
|align='center' style='background: #c0ffc0'|89 '''Ŕ'''
|align='center' style='background: #c0ffc0'|8A '''Ǔ'''
|align='center' style='background: #c0ffc0'|8B '''Ă'''
|align='center' style='background: #c0ffc0'|8C '''Ń'''
|align='center' style='background: #80f080'|8D '''Ș'''
|align='center' style='background: #80f080'|8E '''Ț'''
|align='center' style='background: #d0e0d0'|8F '''�'''

|-
!9…
|align='center' style='background: #80f080'|90 '''đ'''
|align='center' style='background: #c0ffc0'|91 '''ś'''
|align='center' style='background: #c0ffc0'|92 '''ć'''
|align='center' style='background: #c0ffc0'|93 '''ż'''
|align='center' style='background: #c0ffc0'|94 '''ź'''
|align='center' style='background: #c0ffc0'|95 '''ŝ'''
|align='center' style='background: #c0ffc0'|96 '''ĉ'''
|align='center' style='background: #c0ffc0'|97 '''ẑ'''
|align='center' style='background: #c0ffc0'|98 '''ô''' [1]
|align='center' style='background: #c0ffc0'|99 '''ŕ'''
|align='center' style='background: #c0ffc0'|9A '''ǔ'''
|align='center' style='background: #c0ffc0'|9B '''ă'''
|align='center' style='background: #c0ffc0'|9C '''ń'''
|align='center' style='background: #80f080'|9D '''ș'''
|align='center' style='background: #80f080'|9E '''ț'''
|align='center' style='background: #d0e0d0'|9F '''�'''

|-
!A…
|align='center'|A0 '''[https://secure.wikimedia.org/wikipedia/en/wiki/Non-breaking_space NBSP]''' [2]
|align='center' style='background: #d0d0f0'|A1 '''ň''' (¡)'''
|align='center' style='background: #d0d0f0'|A2 '''Ű''' (¢)'''
|align='center' style='background: #d0d0f0'|A3 '''ě''' (£)'''
|align='center' style='background: #d0d0f0'|A4 '''ű''' (¤)'''
|align='center' style='background: #d0d0f0'|A5 '''Ě''' (¥)'''
|align='center' style='background: #d0d0f0'|A6 '''Š''' (¦)'''
|align='center'|A7 '''§'''
|align='center' style='background: #d0d0f0'|A8 '''š''' (¨)'''
|align='center' style='background: #d0d0f0'|A9 '''Ů''' (©)'''
|align='center' style='background: #d0d0f0'|AA '''Ą''' (ª)'''
|align='center' style='background: #d0d0f0'|AB '''Ę''' («)'''
|align='center' style='background: #d0d0f0'|AC '''Č''' (¬)'''
|align='center'|AD '''[https://secure.wikimedia.org/wikipedia/en/wiki/Soft_hyphen SHY]''' [2]
|align='center' style='background: #d0d0f0'|AE '''č''' (®)'''
|align='center' style='background: #d0d0f0'|AF '''ů''' (¯)'''

|-
!B…
|align='center' style='background: #d0d0f0'|B0 '''Ő''' (°)'''
|align='center' style='background: #d0d0f0'|B1 '''Ł''' (±)'''
|align='center' style='background: #d0d0f0'|B2 '''Ť''' (²)'''
|align='center' style='background: #d0d0f0'|B3 '''Ď''' (³)'''
|align='center' style='background: #d0d0f0'|B4 '''Ž''' (´)'''
|align='center' style='background: #d0d0f0'|B5 '''ł''' (µ)'''
|align='center' style='background: #d0d0f0'|B6 '''ť''' (¶)'''
|align='center' style='background: #d0d0f0'|B7 '''ď''' (·)'''
|align='center' style='background: #d0d0f0'|B8 '''ž''' (¸)'''
|align='center' style='background: #d0d0f0'|B9 '''ő''' (¹)'''
|align='center' style='background: #d0d0f0'|BA '''ą''' (º)'''
|align='center' style='background: #d0d0f0'|BB '''ę''' (»)'''
|align='center' style='background: #d0d0f0'|BC '''Œ''' (¼)'''
|align='center' style='background: #d0d0f0'|BD '''œ''' (½)'''
|align='center' style='background: #d0d0f0'|BE '''Ÿ''' (¾)'''
|align='center'|BF '''¿'''

|-
!C…
|align='center'|C0 '''À'''
|align='center'|C1 '''Á'''
|align='center'|C2 '''Â'''
|align='center'|C3 '''Ã'''
|align='center'|C4 '''Ä'''
|align='center'|C5 '''Å'''
|align='center'|C6 '''Æ'''
|align='center'|C7 '''Ç'''
|align='center'|C8 '''È'''
|align='center'|C9 '''É'''
|align='center'|CA '''Ê'''
|align='center'|CB '''Ë'''
|align='center'|CC '''Ì'''
|align='center'|CD '''Í'''
|align='center'|CE '''Î'''
|align='center'|CF '''Ï'''

|-
!D…
|align='center'|D0 '''Ð'''
|align='center'|D1 '''Ñ'''
|align='center'|D2 '''Ò'''
|align='center'|D3 '''Ó'''
|align='center'|D4 '''Ô'''
|align='center'|D5 '''Õ'''
|align='center'|D6 '''Ö'''
|align='center' style='background: #d0d0f0'|D7 '''Ř''' (×)'''
|align='center'|D8 '''Ø'''
|align='center'|D9 '''Ù'''
|align='center'|DA '''Ú'''
|align='center'|DB '''Û'''
|align='center'|DC '''Ü'''
|align='center'|DD '''Ý'''
|align='center'|DE '''Þ'''
|align='center'|DF '''ß'''

|-
!E…
|align='center'|E0 '''à'''
|align='center'|E1 '''á'''
|align='center'|E2 '''â'''
|align='center'|E3 '''ã'''
|align='center'|E4 '''ä'''
|align='center'|E5 '''å'''
|align='center'|E6 '''æ'''
|align='center'|E7 '''ç'''
|align='center'|E8 '''è'''
|align='center'|E9 '''é'''
|align='center'|EA '''ê'''
|align='center'|EB '''ë'''
|align='center'|EC '''ì'''
|align='center'|ED '''í'''
|align='center'|EE '''î'''
|align='center'|EF '''ï'''

|-
!F…
|align='center'|F0 '''ð'''
|align='center'|F1 '''ñ'''
|align='center'|F2 '''ò'''
|align='center'|F3 '''ó'''
|align='center'|F4 '''ô'''
|align='center'|F5 '''õ'''
|align='center'|F6 '''ö'''
|align='center' style='background: #d0d0f0'|F7 '''ř''' (÷)'''
|align='center'|F8 '''ø'''
|align='center'|F9 '''ù'''
|align='center'|FA '''ú'''
|align='center'|FB '''û'''
|align='center'|FC '''ü'''
|align='center'|FD '''ý'''
|align='center'|FE '''þ'''
|align='center'|FF '''ÿ'''

|}

==== Table Notes ====

'''[1]''' As discussed [https://forums.thedarkmod.com/index.php?/topic/22427-analysis-of-212-tdm-fonts/&do=findComment&comment=494855 here], the TDM char set has a redundant treatment of 2 characters:

* Ô appears at 0x88 and 0xD4
* ô appears at 0x98 and 0xF4

Starting with TDM 2.13, the redundancy can be removed and these new characters (from ISO-8859-3) introduced:

* Ğ appears at 0x88
* ğ appears at 0x98

'''[2]''' Avoid using the non-breaking space (NBSP, 0xA0) and the soft hyphen (SHY, 0xAD) in your strings. The TDM engine has no code to respect these during word wrap. Font maintainers: probably map NBSP to the <space> glyph, SHY to undefined/hollow box or zero-sized box.

==== Corresponding Unicode ====

For a mapping of these 256 codepoints to Unicode U+NNNN values and formal names, download 'TDM 8859-Style Font Map to Unicode-16.txt':

* [https://drive.google.com/file/d/1wLEtuFvnrZ-WHK8ign8i3diIXZdriZ4F/view?usp=sharing for TDM 2.13]
* [https://drive.google.com/file/d/1UAz9jSZpT_j33STP3So_Re8JWa8QuAmz/view?usp=sharing for TDM 2.12 and earlier]

Each of these files (by Geep, 2024) is in a standardized format so that it can also be imported into font design programs like FontForge as a custom 256-position map. In the comments, there is additional information about:
* ISO 8859-x sourcing of each character.
* alternative representations of some European and control characters.

==== Fonts with Special Characters ====
Certain fonts have a few codepoints that purposefully diverge from the table entry.

* Carleton font (regular, bold, glow) uses codepoint 0x23, ordinarily "#", to represent "superscript #", which is used in the main menu system to indicate FMs for which a translation pack is available.
* Treasure Map font has characters for "pirate skull and crossbones" and "bottle of booze (or poison)".

== Encoding for Russian Cyrillic ==

Characters conform to the [https://en.wikipedia.org/wiki/Win-1251 WIN-1251 native encoding, shown in the Wikipedia article]. Exception: the character '''0xFF''' (я) is mapped to '''0xB6''' upon loading. Therefore any Russian font must contain я at the place 0xB6. (This was to overcome a historical Doom3 bug that is now fixed. But to date "the remapping for Russian is still in place, tho, to avoid having to patch all the russian fonts", says bug report [https://bugs.thedarkmod.com/view.php?id=2812 "0002812: Character 0xFF does not work in fonts"]).

Within any given font, character coverage may be incomplete. A 2025 effort extended the Mason 48pt font to all 256 codepoints.

== Future Extensions to Unicode and/or Asian Languages (Korean, Chinese, Japanese)? ==

It is possible to visualize a transition to a DAT format (and engine code) that supported UCS (16-bit) Unicode, allowing the existing fonts to then be expanded to cover more characters. Then perhaps all.lang would be the only .lang needed.

As for Asian languages, the original D3 had support for them, so it might be possible to add them to TDM, too, but with a heavy burden on font development and translation. Also, writing from right-to-left (Hebrew) or top-down (Japanese) might be tricky or outright impossible in our GUI without more work in the C++ code. Plus, these languages use more than 256 different characters, and an 8 bit table will not hold these.

== European Character Implementation ==
=== Priority Early-On - the "Top 50" ===

Some of the special characters are used more often than others. Here is a statistic over the entire string set of the TDM core, from TDM v1.08, showing the top 50 most-used characters (excluding a-z, 0-9 and russian characters):

{|class="wikitable" border=1 style="border-collapse: collapse; font-size: 85%" cellspacing=0 cellpadding=2

|-
|Rank
|Occurances
|Letter
|Remarks
|Rank
|Occurances
|Letter
|Remarks

|-
|1
|í
|715
|
|25
|ć
|67
|

|-
|2
|é
|674
|
|26
|è
|65
|

|-
|3
|á
|524
|
|27
|ú
|56
|

|-
|4
|ø
|303
|Danish
|28
|ê
|52
|

|-
|5
|č
|288
|
|29
|ö
|48
|German

|-
|6
|ó
|283
|
|30
|É
|46
|

|-
|7
|ü
|270
|German
|31
|ñ
|37
|

|-
|8
|ł
|203
|Polish
|32
|õ
|32
|

|-
|9
|æ
|200
|Danish
|33
|ń
|26
|

|-
|10
|ě
|182
|
|34
|Ł
|24
|

|-
|11
|ř
|175
|Czech
|35
|Š
|21
|

|-
|12
|ã
|168
|
|36
|â
|21
|

|-
|13
|ž
|148
|Czech
|37
|ź
|20
|

|-
|14
|ý
|142
|
|38
|ß
|18
|German

|-
|15
|ę
|141
|
|39
|Ó
|18
|

|-
|16
|ą
|140
|
|40
|ň
|15
|

|-
|17
|ż
|119
|
|41
|Ú
|15
|

|-
|18
|å
|109
|Danish
|42
|Á
|13
|

|-
|19
|š
|99
|
|43
|î
|12
|

|-
|20
|ś
|97
|
|44
|ť
|11
|

|-
|21
|ç
|91
|
|45
|ô
|9
|

|-
|22
|ä
|86
|German
|46
|Ž
|8
|

|-
|23
|à
|83
|
|47
|Ż
|7
|

|-
|24
|ů
|77
|
|48
|Č
|7
|

|-
|25
|ć
|67
|
|49
|ù
|6
|

|}

Although ö, ä and ü do not appear that often, with only these and Ü, Ö, Ä and ß, the entire German language works. So adding these letters to the fonts is quite important.

Preferably, all foreign letters would be added to the fonts (see [[Font Patcher]] or [[Refont]]). However, if time permits only adding a few, '''í''' would be more important than, say, '''ô'''.

It is commonplace for missing accented letters to be redirected in the .dat file to the corresponding unaccented base letter.

=== Coverage Expansion & Remaining Limitations ===

By 2014, all the system (e.g., main menu) fonts (Carleton, Carleton_condensed, Stone in sizes 24pt and 48pt; Mason and Mason_glow in 48pt) had good coverage of the "Top 50" and beyond, although not all 256 codepoints.
This was confirmed more specifically in 2024, as part of an [https://forums.thedarkmod.com/index.php?/topic/22427-analysis-of-212-tdm-fonts/ Analysis of 2.12 Fonts]. This analysis indicated that, unlike the system fonts, the FM fonts generally did not provide specific glyphs beyond ASCII.

In 2024, Stone 24pt, important for subtitles and a number of readables, was further extended to cover all 256 codepoints. This was tested with TDM 2.13[betas] and released with 2.14.

In 2025, the Russian Mason 48pt font was improved and extended to cover all TDM Russian codepoints, and included in TDM 2.14.

In 2026, English/European Carleton 24pt, widely used in the main menu and also some readables, was improved to:
* extend coverage to all codepoints
* replace sloppy hand-drawn Latin-1 glyphs with fresh glyphs, most of them generated from TTF then edge-darkened
* for simplicity, re-implement the red "glow" effect as if a drop-shadow.

Testing of this is planned with TDM 2.15 betas.

Stone 48pt improvements are under consideration for TDM 2.15.

[[Category:Fonts]]

{{i18n}}

I18N - Charset

2026-05-31T19:42:25Z

Geep: /* All other language files */ Update/correct language list

== Introduction ==

The D3 code that handles the GUI bitmap font can only load a specific range of bytes as characters. To get the most out of the available entries, special charsets are used. The fonts (Carleton for the menu f.i.) are build/patched so that the right characters appear in the right place.

== Encodings ==

=== all.lang ===

This file is in '''UTF-8''', and converted with the help of either the script '''devel/gen_lang.pl''':

perl devel/gen_lang.pl

or, more recently, the Windows C++ utility program '''gen_lang_plus'''. [[Gen_Lang_Programs]] has details of these.

This process ensures that the generated language files are in their proper encodings (see below).

=== All other language files ===

Language-specific files (f.i. '''german.lang''') provide string dictionaries. A system-wide set is provided in tdm_base01.pk4/strings/. A deployed FM may offer similar files in its /strings/ folder... at the very least '''english.lang'''. All such files are expected to be in the following 8-bit encodings:

* '''Czech, Hungarian, Slovak, Polish:''' [https://secure.wikimedia.org/wikipedia/en/wiki/ISO/IEC_8859-2 ISO-8859-2] ('''not WIN-1250!)
* '''Russian:''' [https://secure.wikimedia.org/wikipedia/en/wiki/Win-1251 WIN-1251]
* '''French:''' [https://secure.wikimedia.org/wikipedia/en/wiki/ISO/IEC_8859-15 ISO-8859-15]
* '''Romanian:''' [https://secure.wikimedia.org/wikipedia/en/wiki/ISO/IEC_8859-16 ISO-8859-16]
* '''Turkish:''' [https://secure.wikimedia.org/wikipedia/en/wiki/ISO/IEC_8859-9 ISO-8859-9]
* '''All other languages:''' [https://secure.wikimedia.org/wikipedia/en/wiki/ISO/IEC_8859-1 ISO-8859-1]. This covers TDM-supported languages English, German, Italian, Spanish, Portuguese, Swedish, Danish, Dutch, and Catalan.

{{infobox|The core dictionaries are automatically generated in the right encoding, but make sure that you use the right encoding for the FM dictionary, too!}}

== Character remapping ==

The characters are remapped upon loading the dictionary/readable, from their native encoding to the special one that TDM uses and that is described here. Responsible for the remapping are [[I18N - Character mapping|mapping files]], f.i. "strings/czech.map". If a map file for a specific language is not found, "strings/default.map" is used instead, if this is not found, no remapping takes place.

See '''[[I18N - Character mapping|Character mapping]]''' for more information.

=== European Languages ===

This mapping is used for European languages, f.i. '''Czech''', '''French''', '''German''', '''Spanish''', '''Portuguese''', '''Polish'''. Note that the double accented characters in Hungarian '''Ő, ő, Ű and ű''' look a bit different from '''Ö, ö, Ü and ü'''!

In the table below, the original ISO 8859-1 characters are given in ''()'' below the TDM character.

'''Color code:'''

{{box|#f0d0d0|Character not usable by TDM|Unusable}}{{box|#d0e0d0|Character not yet used in TDM|Unused}}{{box|#c0ffc0|Character displayed in v1.08 or newer|Usable in v1.08}}{{box|#80f080|Character displayed in v2.03 or newer|Usable in v2.03}}{{box|#d0d0f0|Changed from the ISO-8859-1 default, usable by TDM 1.0 or newer|Changed from ISO 8859-1}}

{|class="wikitable" border=1 style="border-collapse: collapse; font-size: 95%" cellspacing=0 cellpadding=2 width=100%

|-
!
!…0
!…1
!…2
!…3
!…4
!…5
!…6
!…7
!…8
!…9
!…A
!…B
!…C
!…D
!…E
!…F

|-
!0…
|align='center' style='background: #f0d0d0'|00 '''–'''
|align='center' style='background: #f0d0d0'|01 '''–'''
|align='center' style='background: #f0d0d0'|02 '''–'''
|align='center' style='background: #f0d0d0'|03 '''–'''
|align='center' style='background: #f0d0d0'|04 '''–'''
|align='center' style='background: #f0d0d0'|05 '''–'''
|align='center' style='background: #f0d0d0'|06 '''–'''
|align='center' style='background: #f0d0d0'|07 '''–'''
|align='center' style='background: #f0d0d0'|08 '''–'''
|align='center' style='background: #f0d0d0'|09 '''–'''
|align='center' style='background: #f0d0d0'|0A '''–'''
|align='center' style='background: #f0d0d0'|0B '''–'''
|align='center' style='background: #f0d0d0'|0C '''–'''
|align='center' style='background: #f0d0d0'|0D '''–'''
|align='center' style='background: #f0d0d0'|0E '''–'''
|align='center' style='background: #f0d0d0'|0F '''–'''

|-
!1…
|align='center' style='background: #f0d0d0'|10 '''–'''
|align='center' style='background: #f0d0d0'|11 '''–'''
|align='center' style='background: #f0d0d0'|12 '''–'''
|align='center' style='background: #f0d0d0'|13 '''–'''
|align='center' style='background: #f0d0d0'|14 '''–'''
|align='center' style='background: #f0d0d0'|15 '''–'''
|align='center' style='background: #f0d0d0'|16 '''–'''
|align='center' style='background: #f0d0d0'|17 '''–'''
|align='center' style='background: #f0d0d0'|18 '''–'''
|align='center' style='background: #f0d0d0'|19 '''–'''
|align='center' style='background: #f0d0d0'|1A '''–'''
|align='center' style='background: #f0d0d0'|1B '''–'''
|align='center' style='background: #f0d0d0'|1C '''–'''
|align='center' style='background: #f0d0d0'|1D '''–'''
|align='center' style='background: #f0d0d0'|1E '''–'''
|align='center' style='background: #f0d0d0'|1F '''–'''

|-
!2…
|align='center'|20 ''' '''
|align='center'|21 '''!'''
|align='center'|22 '''"'''
|align='center'|23 '''#'''
|align='center'|24 '''$'''
|align='center'|25 '''%'''
|align='center'|26 '''&'''
|align='center'|27 '''''''
|align='center'|28 '''('''
|align='center'|29 ''')'''
|align='center'|2A '''*'''
|align='center'|2B '''+'''
|align='center'|2C ''','''
|align='center'|2D '''-'''
|align='center'|2E '''.'''
|align='center'|2F '''/'''

|-
!3…
|align='center'|30 '''0'''
|align='center'|31 '''1'''
|align='center'|32 '''2'''
|align='center'|33 '''3'''
|align='center'|34 '''4'''
|align='center'|35 '''5'''
|align='center'|36 '''6'''
|align='center'|37 '''7'''
|align='center'|38 '''8'''
|align='center'|39 '''9'''
|align='center'|3A ''':'''
|align='center'|3B ''';'''
|align='center'|3C '''<'''
|align='center'|3D '''='''
|align='center'|3E '''>'''
|align='center'|3F '''?'''

|-
!4…
|align='center'|40 '''@'''
|align='center'|41 '''A'''
|align='center'|42 '''B'''
|align='center'|43 '''C'''
|align='center'|44 '''D'''
|align='center'|45 '''E'''
|align='center'|46 '''F'''
|align='center'|47 '''G'''
|align='center'|48 '''H'''
|align='center'|49 '''I'''
|align='center'|4A '''J'''
|align='center'|4B '''K'''
|align='center'|4C '''L'''
|align='center'|4D '''M'''
|align='center'|4E '''N'''
|align='center'|4F '''O'''

|-
!5…
|align='center'|50 '''P'''
|align='center'|51 '''Q'''
|align='center'|52 '''R'''
|align='center'|53 '''S'''
|align='center'|54 '''T'''
|align='center'|55 '''U'''
|align='center'|56 '''V'''
|align='center'|57 '''W'''
|align='center'|58 '''X'''
|align='center'|59 '''Y'''
|align='center'|5A '''Z'''
|align='center'|5B '''['''
|align='center'|5C '''\'''
|align='center'|5D ''']'''
|align='center'|5E '''^'''
|align='center'|5F '''_'''

|-
!6…
|align='center'|60 '''`'''
|align='center'|61 '''a'''
|align='center'|62 '''b'''
|align='center'|63 '''c'''
|align='center'|64 '''d'''
|align='center'|65 '''e'''
|align='center'|66 '''f'''
|align='center'|67 '''g'''
|align='center'|68 '''h'''
|align='center'|69 '''i'''
|align='center'|6A '''j'''
|align='center'|6B '''k'''
|align='center'|6C '''l'''
|align='center'|6D '''m'''
|align='center'|6E '''n'''
|align='center'|6F '''o'''

|-
!7…
|align='center'|70 '''p'''
|align='center'|71 '''q'''
|align='center'|72 '''r'''
|align='center'|73 '''s'''
|align='center'|74 '''t'''
|align='center'|75 '''u'''
|align='center'|76 '''v'''
|align='center'|77 '''w'''
|align='center'|78 '''x'''
|align='center'|79 '''y'''
|align='center'|7A '''z'''
|align='center'|7B '''{'''
|align='center'|7C '''|'''
|align='center'|7D '''}'''
|align='center'|7E '''~'''
|align='center' style='background: #d0e0d0'|7F '''�'''

|-
!8…
|align='center' style='background: #c0ffc0'|80 '''Ň'''
|align='center' style='background: #c0ffc0'|81 '''Ś'''
|align='center' style='background: #c0ffc0'|82 '''Ć'''
|align='center' style='background: #c0ffc0'|83 '''Ż'''
|align='center' style='background: #c0ffc0'|84 '''Ź'''
|align='center' style='background: #c0ffc0'|85 '''Ŝ'''
|align='center' style='background: #c0ffc0'|86 '''Ĉ'''
|align='center' style='background: #c0ffc0'|87 '''Ẑ'''
|align='center' style='background: #c0ffc0'|88 '''Ô''' [1]
|align='center' style='background: #c0ffc0'|89 '''Ŕ'''
|align='center' style='background: #c0ffc0'|8A '''Ǔ'''
|align='center' style='background: #c0ffc0'|8B '''Ă'''
|align='center' style='background: #c0ffc0'|8C '''Ń'''
|align='center' style='background: #80f080'|8D '''Ș'''
|align='center' style='background: #80f080'|8E '''Ț'''
|align='center' style='background: #d0e0d0'|8F '''�'''

|-
!9…
|align='center' style='background: #80f080'|90 '''đ'''
|align='center' style='background: #c0ffc0'|91 '''ś'''
|align='center' style='background: #c0ffc0'|92 '''ć'''
|align='center' style='background: #c0ffc0'|93 '''ż'''
|align='center' style='background: #c0ffc0'|94 '''ź'''
|align='center' style='background: #c0ffc0'|95 '''ŝ'''
|align='center' style='background: #c0ffc0'|96 '''ĉ'''
|align='center' style='background: #c0ffc0'|97 '''ẑ'''
|align='center' style='background: #c0ffc0'|98 '''ô''' [1]
|align='center' style='background: #c0ffc0'|99 '''ŕ'''
|align='center' style='background: #c0ffc0'|9A '''ǔ'''
|align='center' style='background: #c0ffc0'|9B '''ă'''
|align='center' style='background: #c0ffc0'|9C '''ń'''
|align='center' style='background: #80f080'|9D '''ș'''
|align='center' style='background: #80f080'|9E '''ț'''
|align='center' style='background: #d0e0d0'|9F '''�'''

|-
!A…
|align='center'|A0 '''[https://secure.wikimedia.org/wikipedia/en/wiki/Non-breaking_space NBSP]''' [2]
|align='center' style='background: #d0d0f0'|A1 '''ň''' (¡)'''
|align='center' style='background: #d0d0f0'|A2 '''Ű''' (¢)'''
|align='center' style='background: #d0d0f0'|A3 '''ě''' (£)'''
|align='center' style='background: #d0d0f0'|A4 '''ű''' (¤)'''
|align='center' style='background: #d0d0f0'|A5 '''Ě''' (¥)'''
|align='center' style='background: #d0d0f0'|A6 '''Š''' (¦)'''
|align='center'|A7 '''§'''
|align='center' style='background: #d0d0f0'|A8 '''š''' (¨)'''
|align='center' style='background: #d0d0f0'|A9 '''Ů''' (©)'''
|align='center' style='background: #d0d0f0'|AA '''Ą''' (ª)'''
|align='center' style='background: #d0d0f0'|AB '''Ę''' («)'''
|align='center' style='background: #d0d0f0'|AC '''Č''' (¬)'''
|align='center'|AD '''[https://secure.wikimedia.org/wikipedia/en/wiki/Soft_hyphen SHY]''' [2]
|align='center' style='background: #d0d0f0'|AE '''č''' (®)'''
|align='center' style='background: #d0d0f0'|AF '''ů''' (¯)'''

|-
!B…
|align='center' style='background: #d0d0f0'|B0 '''Ő''' (°)'''
|align='center' style='background: #d0d0f0'|B1 '''Ł''' (±)'''
|align='center' style='background: #d0d0f0'|B2 '''Ť''' (²)'''
|align='center' style='background: #d0d0f0'|B3 '''Ď''' (³)'''
|align='center' style='background: #d0d0f0'|B4 '''Ž''' (´)'''
|align='center' style='background: #d0d0f0'|B5 '''ł''' (µ)'''
|align='center' style='background: #d0d0f0'|B6 '''ť''' (¶)'''
|align='center' style='background: #d0d0f0'|B7 '''ď''' (·)'''
|align='center' style='background: #d0d0f0'|B8 '''ž''' (¸)'''
|align='center' style='background: #d0d0f0'|B9 '''ő''' (¹)'''
|align='center' style='background: #d0d0f0'|BA '''ą''' (º)'''
|align='center' style='background: #d0d0f0'|BB '''ę''' (»)'''
|align='center' style='background: #d0d0f0'|BC '''Œ''' (¼)'''
|align='center' style='background: #d0d0f0'|BD '''œ''' (½)'''
|align='center' style='background: #d0d0f0'|BE '''Ÿ''' (¾)'''
|align='center'|BF '''¿'''

|-
!C…
|align='center'|C0 '''À'''
|align='center'|C1 '''Á'''
|align='center'|C2 '''Â'''
|align='center'|C3 '''Ã'''
|align='center'|C4 '''Ä'''
|align='center'|C5 '''Å'''
|align='center'|C6 '''Æ'''
|align='center'|C7 '''Ç'''
|align='center'|C8 '''È'''
|align='center'|C9 '''É'''
|align='center'|CA '''Ê'''
|align='center'|CB '''Ë'''
|align='center'|CC '''Ì'''
|align='center'|CD '''Í'''
|align='center'|CE '''Î'''
|align='center'|CF '''Ï'''

|-
!D…
|align='center'|D0 '''Ð'''
|align='center'|D1 '''Ñ'''
|align='center'|D2 '''Ò'''
|align='center'|D3 '''Ó'''
|align='center'|D4 '''Ô'''
|align='center'|D5 '''Õ'''
|align='center'|D6 '''Ö'''
|align='center' style='background: #d0d0f0'|D7 '''Ř''' (×)'''
|align='center'|D8 '''Ø'''
|align='center'|D9 '''Ù'''
|align='center'|DA '''Ú'''
|align='center'|DB '''Û'''
|align='center'|DC '''Ü'''
|align='center'|DD '''Ý'''
|align='center'|DE '''Þ'''
|align='center'|DF '''ß'''

|-
!E…
|align='center'|E0 '''à'''
|align='center'|E1 '''á'''
|align='center'|E2 '''â'''
|align='center'|E3 '''ã'''
|align='center'|E4 '''ä'''
|align='center'|E5 '''å'''
|align='center'|E6 '''æ'''
|align='center'|E7 '''ç'''
|align='center'|E8 '''è'''
|align='center'|E9 '''é'''
|align='center'|EA '''ê'''
|align='center'|EB '''ë'''
|align='center'|EC '''ì'''
|align='center'|ED '''í'''
|align='center'|EE '''î'''
|align='center'|EF '''ï'''

|-
!F…
|align='center'|F0 '''ð'''
|align='center'|F1 '''ñ'''
|align='center'|F2 '''ò'''
|align='center'|F3 '''ó'''
|align='center'|F4 '''ô'''
|align='center'|F5 '''õ'''
|align='center'|F6 '''ö'''
|align='center' style='background: #d0d0f0'|F7 '''ř''' (÷)'''
|align='center'|F8 '''ø'''
|align='center'|F9 '''ù'''
|align='center'|FA '''ú'''
|align='center'|FB '''û'''
|align='center'|FC '''ü'''
|align='center'|FD '''ý'''
|align='center'|FE '''þ'''
|align='center'|FF '''ÿ'''

|}

==== Table Notes ====

'''[1]''' As discussed [https://forums.thedarkmod.com/index.php?/topic/22427-analysis-of-212-tdm-fonts/&do=findComment&comment=494855 here], the TDM char set has a redundant treatment of 2 characters:

* Ô appears at 0x88 and 0xD4
* ô appears at 0x98 and 0xF4

Starting with TDM 2.13, the redundancy can be removed and these new characters (from ISO-8859-3) introduced:

* Ğ appears at 0x88
* ğ appears at 0x98

'''[2]''' Avoid using the non-breaking space (NBSP, 0xA0) and the soft hyphen (SHY, 0xAD) in your strings. The TDM engine has no code to respect these during word wrap. Font maintainers: probably map NBSP to the <space> glyph, SHY to undefined/hollow box or zero-sized box.

==== Corresponding Unicode ====

For a mapping of these 256 codepoints to Unicode U+NNNN values and formal names, download 'TDM 8859-Style Font Map to Unicode-16.txt':

* [https://drive.google.com/file/d/1wLEtuFvnrZ-WHK8ign8i3diIXZdriZ4F/view?usp=sharing for TDM 2.13]
* [https://drive.google.com/file/d/1UAz9jSZpT_j33STP3So_Re8JWa8QuAmz/view?usp=sharing for TDM 2.12 and earlier]

Each of these files (by Geep, 2024) is in a standardized format so that it can also be imported into font design programs like FontForge as a custom 256-position map. In the comments, there is additional information about:
* ISO 8859-x sourcing of each character.
* alternative representations of some European and control characters.

==== Fonts with Special Characters ====
Certain fonts have a few codepoints that purposefully diverge from the table entry.

* Carleton font (regular, bold, glow) uses codepoint 0x23, ordinarily "#", to represent "superscript #", which is used in the main menu system to indicate FMs for which a translation pack is available.
* Treasure Map font has characters for "pirate skull and crossbones" and "bottle of booze (or poison)".

=== Russian ===

Characters conform to the [https://en.wikipedia.org/wiki/Win-1251 WIN-1251 native encoding, shown in the Wikipedia article]. Exception: the character '''0xFF''' (я) is mapped to '''0xB6''' upon loading. Therefore any Russian font must contain я at the place 0xB6. (This was to overcome a historical Doom3 bug that is now fixed. But to date "the remapping for Russian is still in place, tho, to avoid having to patch all the russian fonts", says bug report [https://bugs.thedarkmod.com/view.php?id=2812 "0002812: Character 0xFF does not work in fonts"]).

Within any given font, character overage may be incomplete. A 2025 effort extended the Mason 48pt font to all 256 codepoints.

=== Asian Languages (Korean, Chinese, Japanese) ===

The original D3 had support for these languages, so it might be possible to add them to TDM, too. At the moment, however, we lack the fonts and translators. Also, writing from right-to-left (Hebrew) or top-down (Japanese) might be tricky or outright impossible in our GUI without more work in the C++ code. Plus, these languages use more than 256 different characters, and an 8 bit table will not hold these.

== European Character Implementation ==
=== Priority Early-On - the "Top 50" ===

Some of the special characters are used more often than others. Here is a statistic over the entire string set of the TDM core, from TDM v1.08, showing the top 50 most-used characters (excluding a-z, 0-9 and russian characters):

{|class="wikitable" border=1 style="border-collapse: collapse; font-size: 85%" cellspacing=0 cellpadding=2

|-
|Rank
|Occurances
|Letter
|Remarks
|Rank
|Occurances
|Letter
|Remarks

|-
|1
|í
|715
|
|25
|ć
|67
|

|-
|2
|é
|674
|
|26
|è
|65
|

|-
|3
|á
|524
|
|27
|ú
|56
|

|-
|4
|ø
|303
|Danish
|28
|ê
|52
|

|-
|5
|č
|288
|
|29
|ö
|48
|German

|-
|6
|ó
|283
|
|30
|É
|46
|

|-
|7
|ü
|270
|German
|31
|ñ
|37
|

|-
|8
|ł
|203
|Polish
|32
|õ
|32
|

|-
|9
|æ
|200
|Danish
|33
|ń
|26
|

|-
|10
|ě
|182
|
|34
|Ł
|24
|

|-
|11
|ř
|175
|Czech
|35
|Š
|21
|

|-
|12
|ã
|168
|
|36
|â
|21
|

|-
|13
|ž
|148
|Czech
|37
|ź
|20
|

|-
|14
|ý
|142
|
|38
|ß
|18
|German

|-
|15
|ę
|141
|
|39
|Ó
|18
|

|-
|16
|ą
|140
|
|40
|ň
|15
|

|-
|17
|ż
|119
|
|41
|Ú
|15
|

|-
|18
|å
|109
|Danish
|42
|Á
|13
|

|-
|19
|š
|99
|
|43
|î
|12
|

|-
|20
|ś
|97
|
|44
|ť
|11
|

|-
|21
|ç
|91
|
|45
|ô
|9
|

|-
|22
|ä
|86
|German
|46
|Ž
|8
|

|-
|23
|à
|83
|
|47
|Ż
|7
|

|-
|24
|ů
|77
|
|48
|Č
|7
|

|-
|25
|ć
|67
|
|49
|ù
|6
|

|}

Although ö, ä and ü do not appear that often, with only these and Ü, Ö, Ä and ß, the entire German language works. So adding these letters to the fonts is quite important.

Preferably, all foreign letters would be added to the fonts (see [[Font Patcher]] or [[Refont]]). However, if time permits only adding a few, '''í''' would be more important than, say, '''ô'''.

It is commonplace for missing accented letters to be redirected in the .dat file to the corresponding unaccented base letter.

=== Coverage Expansion & Remaining Limitations ===

By 2014, all the system (e.g., main menu) fonts (Carleton, Carleton_condensed, Stone in sizes 24pt and 48pt; Mason and Mason_glow in 48pt) had good coverage of the "Top 50" and beyond, although not all 256 codepoints.
This was confirmed more specifically in 2024, as part of an [https://forums.thedarkmod.com/index.php?/topic/22427-analysis-of-212-tdm-fonts/ Analysis of 2.12 Fonts]. This analysis indicated that, unlike the system fonts, the FM fonts generally did not provide specific glyphs beyond ASCII.

In 2024, Stone 24pt, important for subtitles and a number of readables, was further extended to cover all 256 codepoints. This was tested with TDM 2.13[betas] and released with 2.14.

In 2025, the Russian Mason 48pt font was improved and extended to cover all TDM Russian codepoints, and included in TDM 2.14.

In 2026, English/European Carleton 24pt, widely used in the main menu and also some readables, was improved to:
* extend coverage to all codepoints
* replace sloppy hand-drawn Latin-1 glyphs with fresh glyphs, most of them generated from TTF then edge-darkened
* for simplicity, re-implement the red "glow" effect as if a drop-shadow.

Testing of this is planned with TDM 2.15 betas.

Stone 48pt improvements are under consideration for TDM 2.15.

[[Category:Fonts]]

{{i18n}}

I18N - Character mapping

2026-05-31T18:08:57Z

Geep: /* Encodings */ Update/correct language encodings, default file info

The D3 code that handles the GUI bitmap font can only load a specific range of bytes as characters. To get the most out of the available entries, a special font is used (Carleton for the menu f.i.). These fonts are build/patched so that the right characters appear in the right place.

== Encodings ==

Whether used to define translation dictionaries that are system-wide (in tdm_base01.pk4/strings/) or FM-specific (in <FM>/strings/), language files (f.i. german.lang), derived from Unicode all.lang, are expected to be in the following encodings:

* '''Czech, Polish, Hungarian, Slovak:''' [https://secure.wikimedia.org/wikipedia/en/wiki/ISO/IEC_8859-2 ISO-8859-2] ('''not WIN-1250!)
* '''Russian:''' [https://secure.wikimedia.org/wikipedia/en/wiki/Win-1251 WIN-1251]
* '''Romanian:''' ISO-8859-16
* '''French:''' ISO-8859-15
* '''Turkish:''' ISO-8859-9
* '''All other languages:''' [https://secure.wikimedia.org/wikipedia/en/wiki/ISO/IEC_8859-1 ISO-8859-1]. This covers English, German, Italian, Spanish, Portuguese, Swedish, Danish, Dutch, and Catalan.

=== Remapping ===

The characters are remapped upon loading the dictionary/readable from their source encoding (e.g. ISO 8859-2) to the special character map TDM uses. Responsible for this are mapping files, f.i. "strings/czech.map". If a map file for a specific language is not found, "strings/default.map" is used instead. (Note: a default map is no longer shipped, at least since TDM 2.10 and probably much earlier. Generally, ISO-8859-1 languages don't need remapping.)

Remapping files are only looked for in the tdm_base01.pk4/strings directory. So they cannot be overwritten in any .map file placed in an FM's string directory.

The content of a map file is wrapped in '''{''' and '''}''', and each mapping consists of two hexadecimal numbers, the source and the target character number.

== Examples ==

For russian:

<pre>
{
0xFF 0xB6 // я
}
</pre>

For European languages in ISO 8859-2 charset (f.i. Czech):

<pre>
// a comment
{
0xF2 0xA1 // ň
0xDB 0xA2 // Ű (similiar to Ü, used in Hungarian)
0xFB 0xA4 // ű
0xA9 0xA6 // Š
0xB9 0xA8 // š
0xA1 0xAA // Ą
0xC8 0xAC // Č
0xCA 0xAB // Ę
0xE8 0xAE // č
0xD5 0xB0 // Ő (similiar to Ö, used in Hungarian)
0xA3 0xB1 // Ł
0xAb 0xB2 // Ť
0xCF 0xB3 // Ď
0xAC 0xB4 // Ž
0xB3 0xB5 // ł
0xBf 0xB6 // ż
0xEF 0xB7 // ď
0xBE 0xB8 // ž
0xF5 0xB9 // ő (similiar to ö, used in Hungarian)
0xB1 0xBA // ą
0xEA 0xBB // ę
0xF8 0xF7 // ř
0xD8 0xD7 // Ř
0xEC 0xA3 // ě
0xCC 0xA5 // Ě
0xD9 0xA9 // Ů
0xF9 0xAF // ů
0xBB 0xB6 // ť
}
</pre>
{{i18n}}* [[Font Patcher]]

[[Category:fonts]]

I18N - Charset

2026-05-31T16:42:46Z

Geep: /* Russian */ explain remapping, link to bug report

== Introduction ==

The D3 code that handles the GUI bitmap font can only load a specific range of bytes as characters. To get the most out of the available entries, special charsets are used. The fonts (Carleton for the menu f.i.) are build/patched so that the right characters appear in the right place.

== Encodings ==

=== all.lang ===

This file is in '''UTF-8''', and converted with the help of either the script '''devel/gen_lang.pl''':

perl devel/gen_lang.pl

or, more recently, the Windows C++ utility program '''gen_lang_plus'''. [[Gen_Lang_Programs]] has details of these.

This process ensures that the generated language files are in their proper encodings (see below).

=== All other language files ===

Note that the language files (f.i. '''strings/german.lang''') as well as the readables and the FM dictionariaries are expected to be in the following encodings:

* '''Czech''', '''Hungarian''', '''Slovak''', '''Polish:''' [https://secure.wikimedia.org/wikipedia/en/wiki/ISO/IEC_8859-2 ISO-8859-2] ('''not WIN-1250!)
* '''Russian:''' [https://secure.wikimedia.org/wikipedia/en/wiki/Win-1251 WIN-1251]
* '''French:''' [https://secure.wikimedia.org/wikipedia/en/wiki/ISO/IEC_8859-15 ISO-8859-15]
* '''Romanian:''' [https://secure.wikimedia.org/wikipedia/en/wiki/ISO/IEC_8859-16 ISO-8859-16]
* '''All other languages:''' [https://secure.wikimedia.org/wikipedia/en/wiki/ISO/IEC_8859-1 ISO-8859-1] (German, Dutch, Danish, Swedish, Portuguese, etc.)

{{infobox|The core dictionaries are automatically generated in the right encoding, but make sure that you use the right encoding for the FM dictionary, too!}}

== Character remapping ==

The characters are remapped upon loading the dictionary/readable, from their native encoding to the special one that TDM uses and that is described here. Responsible for the remapping are [[I18N - Character mapping|mapping files]], f.i. "strings/czech.map". If a map file for a specific language is not found, "strings/default.map" is used instead, if this is not found, no remapping takes place.

See '''[[I18N - Character mapping|Character mapping]]''' for more information.

=== European Languages ===

This mapping is used for European languages, f.i. '''Czech''', '''French''', '''German''', '''Spanish''', '''Portuguese''', '''Polish'''. Note that the double accented characters in Hungarian '''Ő, ő, Ű and ű''' look a bit different from '''Ö, ö, Ü and ü'''!

In the table below, the original ISO 8859-1 characters are given in ''()'' below the TDM character.

'''Color code:'''

{{box|#f0d0d0|Character not usable by TDM|Unusable}}{{box|#d0e0d0|Character not yet used in TDM|Unused}}{{box|#c0ffc0|Character displayed in v1.08 or newer|Usable in v1.08}}{{box|#80f080|Character displayed in v2.03 or newer|Usable in v2.03}}{{box|#d0d0f0|Changed from the ISO-8859-1 default, usable by TDM 1.0 or newer|Changed from ISO 8859-1}}

{|class="wikitable" border=1 style="border-collapse: collapse; font-size: 95%" cellspacing=0 cellpadding=2 width=100%

|-
!
!…0
!…1
!…2
!…3
!…4
!…5
!…6
!…7
!…8
!…9
!…A
!…B
!…C
!…D
!…E
!…F

|-
!0…
|align='center' style='background: #f0d0d0'|00 '''–'''
|align='center' style='background: #f0d0d0'|01 '''–'''
|align='center' style='background: #f0d0d0'|02 '''–'''
|align='center' style='background: #f0d0d0'|03 '''–'''
|align='center' style='background: #f0d0d0'|04 '''–'''
|align='center' style='background: #f0d0d0'|05 '''–'''
|align='center' style='background: #f0d0d0'|06 '''–'''
|align='center' style='background: #f0d0d0'|07 '''–'''
|align='center' style='background: #f0d0d0'|08 '''–'''
|align='center' style='background: #f0d0d0'|09 '''–'''
|align='center' style='background: #f0d0d0'|0A '''–'''
|align='center' style='background: #f0d0d0'|0B '''–'''
|align='center' style='background: #f0d0d0'|0C '''–'''
|align='center' style='background: #f0d0d0'|0D '''–'''
|align='center' style='background: #f0d0d0'|0E '''–'''
|align='center' style='background: #f0d0d0'|0F '''–'''

|-
!1…
|align='center' style='background: #f0d0d0'|10 '''–'''
|align='center' style='background: #f0d0d0'|11 '''–'''
|align='center' style='background: #f0d0d0'|12 '''–'''
|align='center' style='background: #f0d0d0'|13 '''–'''
|align='center' style='background: #f0d0d0'|14 '''–'''
|align='center' style='background: #f0d0d0'|15 '''–'''
|align='center' style='background: #f0d0d0'|16 '''–'''
|align='center' style='background: #f0d0d0'|17 '''–'''
|align='center' style='background: #f0d0d0'|18 '''–'''
|align='center' style='background: #f0d0d0'|19 '''–'''
|align='center' style='background: #f0d0d0'|1A '''–'''
|align='center' style='background: #f0d0d0'|1B '''–'''
|align='center' style='background: #f0d0d0'|1C '''–'''
|align='center' style='background: #f0d0d0'|1D '''–'''
|align='center' style='background: #f0d0d0'|1E '''–'''
|align='center' style='background: #f0d0d0'|1F '''–'''

|-
!2…
|align='center'|20 ''' '''
|align='center'|21 '''!'''
|align='center'|22 '''"'''
|align='center'|23 '''#'''
|align='center'|24 '''$'''
|align='center'|25 '''%'''
|align='center'|26 '''&'''
|align='center'|27 '''''''
|align='center'|28 '''('''
|align='center'|29 ''')'''
|align='center'|2A '''*'''
|align='center'|2B '''+'''
|align='center'|2C ''','''
|align='center'|2D '''-'''
|align='center'|2E '''.'''
|align='center'|2F '''/'''

|-
!3…
|align='center'|30 '''0'''
|align='center'|31 '''1'''
|align='center'|32 '''2'''
|align='center'|33 '''3'''
|align='center'|34 '''4'''
|align='center'|35 '''5'''
|align='center'|36 '''6'''
|align='center'|37 '''7'''
|align='center'|38 '''8'''
|align='center'|39 '''9'''
|align='center'|3A ''':'''
|align='center'|3B ''';'''
|align='center'|3C '''<'''
|align='center'|3D '''='''
|align='center'|3E '''>'''
|align='center'|3F '''?'''

|-
!4…
|align='center'|40 '''@'''
|align='center'|41 '''A'''
|align='center'|42 '''B'''
|align='center'|43 '''C'''
|align='center'|44 '''D'''
|align='center'|45 '''E'''
|align='center'|46 '''F'''
|align='center'|47 '''G'''
|align='center'|48 '''H'''
|align='center'|49 '''I'''
|align='center'|4A '''J'''
|align='center'|4B '''K'''
|align='center'|4C '''L'''
|align='center'|4D '''M'''
|align='center'|4E '''N'''
|align='center'|4F '''O'''

|-
!5…
|align='center'|50 '''P'''
|align='center'|51 '''Q'''
|align='center'|52 '''R'''
|align='center'|53 '''S'''
|align='center'|54 '''T'''
|align='center'|55 '''U'''
|align='center'|56 '''V'''
|align='center'|57 '''W'''
|align='center'|58 '''X'''
|align='center'|59 '''Y'''
|align='center'|5A '''Z'''
|align='center'|5B '''['''
|align='center'|5C '''\'''
|align='center'|5D ''']'''
|align='center'|5E '''^'''
|align='center'|5F '''_'''

|-
!6…
|align='center'|60 '''`'''
|align='center'|61 '''a'''
|align='center'|62 '''b'''
|align='center'|63 '''c'''
|align='center'|64 '''d'''
|align='center'|65 '''e'''
|align='center'|66 '''f'''
|align='center'|67 '''g'''
|align='center'|68 '''h'''
|align='center'|69 '''i'''
|align='center'|6A '''j'''
|align='center'|6B '''k'''
|align='center'|6C '''l'''
|align='center'|6D '''m'''
|align='center'|6E '''n'''
|align='center'|6F '''o'''

|-
!7…
|align='center'|70 '''p'''
|align='center'|71 '''q'''
|align='center'|72 '''r'''
|align='center'|73 '''s'''
|align='center'|74 '''t'''
|align='center'|75 '''u'''
|align='center'|76 '''v'''
|align='center'|77 '''w'''
|align='center'|78 '''x'''
|align='center'|79 '''y'''
|align='center'|7A '''z'''
|align='center'|7B '''{'''
|align='center'|7C '''|'''
|align='center'|7D '''}'''
|align='center'|7E '''~'''
|align='center' style='background: #d0e0d0'|7F '''�'''

|-
!8…
|align='center' style='background: #c0ffc0'|80 '''Ň'''
|align='center' style='background: #c0ffc0'|81 '''Ś'''
|align='center' style='background: #c0ffc0'|82 '''Ć'''
|align='center' style='background: #c0ffc0'|83 '''Ż'''
|align='center' style='background: #c0ffc0'|84 '''Ź'''
|align='center' style='background: #c0ffc0'|85 '''Ŝ'''
|align='center' style='background: #c0ffc0'|86 '''Ĉ'''
|align='center' style='background: #c0ffc0'|87 '''Ẑ'''
|align='center' style='background: #c0ffc0'|88 '''Ô''' [1]
|align='center' style='background: #c0ffc0'|89 '''Ŕ'''
|align='center' style='background: #c0ffc0'|8A '''Ǔ'''
|align='center' style='background: #c0ffc0'|8B '''Ă'''
|align='center' style='background: #c0ffc0'|8C '''Ń'''
|align='center' style='background: #80f080'|8D '''Ș'''
|align='center' style='background: #80f080'|8E '''Ț'''
|align='center' style='background: #d0e0d0'|8F '''�'''

|-
!9…
|align='center' style='background: #80f080'|90 '''đ'''
|align='center' style='background: #c0ffc0'|91 '''ś'''
|align='center' style='background: #c0ffc0'|92 '''ć'''
|align='center' style='background: #c0ffc0'|93 '''ż'''
|align='center' style='background: #c0ffc0'|94 '''ź'''
|align='center' style='background: #c0ffc0'|95 '''ŝ'''
|align='center' style='background: #c0ffc0'|96 '''ĉ'''
|align='center' style='background: #c0ffc0'|97 '''ẑ'''
|align='center' style='background: #c0ffc0'|98 '''ô''' [1]
|align='center' style='background: #c0ffc0'|99 '''ŕ'''
|align='center' style='background: #c0ffc0'|9A '''ǔ'''
|align='center' style='background: #c0ffc0'|9B '''ă'''
|align='center' style='background: #c0ffc0'|9C '''ń'''
|align='center' style='background: #80f080'|9D '''ș'''
|align='center' style='background: #80f080'|9E '''ț'''
|align='center' style='background: #d0e0d0'|9F '''�'''

|-
!A…
|align='center'|A0 '''[https://secure.wikimedia.org/wikipedia/en/wiki/Non-breaking_space NBSP]''' [2]
|align='center' style='background: #d0d0f0'|A1 '''ň''' (¡)'''
|align='center' style='background: #d0d0f0'|A2 '''Ű''' (¢)'''
|align='center' style='background: #d0d0f0'|A3 '''ě''' (£)'''
|align='center' style='background: #d0d0f0'|A4 '''ű''' (¤)'''
|align='center' style='background: #d0d0f0'|A5 '''Ě''' (¥)'''
|align='center' style='background: #d0d0f0'|A6 '''Š''' (¦)'''
|align='center'|A7 '''§'''
|align='center' style='background: #d0d0f0'|A8 '''š''' (¨)'''
|align='center' style='background: #d0d0f0'|A9 '''Ů''' (©)'''
|align='center' style='background: #d0d0f0'|AA '''Ą''' (ª)'''
|align='center' style='background: #d0d0f0'|AB '''Ę''' («)'''
|align='center' style='background: #d0d0f0'|AC '''Č''' (¬)'''
|align='center'|AD '''[https://secure.wikimedia.org/wikipedia/en/wiki/Soft_hyphen SHY]''' [2]
|align='center' style='background: #d0d0f0'|AE '''č''' (®)'''
|align='center' style='background: #d0d0f0'|AF '''ů''' (¯)'''

|-
!B…
|align='center' style='background: #d0d0f0'|B0 '''Ő''' (°)'''
|align='center' style='background: #d0d0f0'|B1 '''Ł''' (±)'''
|align='center' style='background: #d0d0f0'|B2 '''Ť''' (²)'''
|align='center' style='background: #d0d0f0'|B3 '''Ď''' (³)'''
|align='center' style='background: #d0d0f0'|B4 '''Ž''' (´)'''
|align='center' style='background: #d0d0f0'|B5 '''ł''' (µ)'''
|align='center' style='background: #d0d0f0'|B6 '''ť''' (¶)'''
|align='center' style='background: #d0d0f0'|B7 '''ď''' (·)'''
|align='center' style='background: #d0d0f0'|B8 '''ž''' (¸)'''
|align='center' style='background: #d0d0f0'|B9 '''ő''' (¹)'''
|align='center' style='background: #d0d0f0'|BA '''ą''' (º)'''
|align='center' style='background: #d0d0f0'|BB '''ę''' (»)'''
|align='center' style='background: #d0d0f0'|BC '''Œ''' (¼)'''
|align='center' style='background: #d0d0f0'|BD '''œ''' (½)'''
|align='center' style='background: #d0d0f0'|BE '''Ÿ''' (¾)'''
|align='center'|BF '''¿'''

|-
!C…
|align='center'|C0 '''À'''
|align='center'|C1 '''Á'''
|align='center'|C2 '''Â'''
|align='center'|C3 '''Ã'''
|align='center'|C4 '''Ä'''
|align='center'|C5 '''Å'''
|align='center'|C6 '''Æ'''
|align='center'|C7 '''Ç'''
|align='center'|C8 '''È'''
|align='center'|C9 '''É'''
|align='center'|CA '''Ê'''
|align='center'|CB '''Ë'''
|align='center'|CC '''Ì'''
|align='center'|CD '''Í'''
|align='center'|CE '''Î'''
|align='center'|CF '''Ï'''

|-
!D…
|align='center'|D0 '''Ð'''
|align='center'|D1 '''Ñ'''
|align='center'|D2 '''Ò'''
|align='center'|D3 '''Ó'''
|align='center'|D4 '''Ô'''
|align='center'|D5 '''Õ'''
|align='center'|D6 '''Ö'''
|align='center' style='background: #d0d0f0'|D7 '''Ř''' (×)'''
|align='center'|D8 '''Ø'''
|align='center'|D9 '''Ù'''
|align='center'|DA '''Ú'''
|align='center'|DB '''Û'''
|align='center'|DC '''Ü'''
|align='center'|DD '''Ý'''
|align='center'|DE '''Þ'''
|align='center'|DF '''ß'''

|-
!E…
|align='center'|E0 '''à'''
|align='center'|E1 '''á'''
|align='center'|E2 '''â'''
|align='center'|E3 '''ã'''
|align='center'|E4 '''ä'''
|align='center'|E5 '''å'''
|align='center'|E6 '''æ'''
|align='center'|E7 '''ç'''
|align='center'|E8 '''è'''
|align='center'|E9 '''é'''
|align='center'|EA '''ê'''
|align='center'|EB '''ë'''
|align='center'|EC '''ì'''
|align='center'|ED '''í'''
|align='center'|EE '''î'''
|align='center'|EF '''ï'''

|-
!F…
|align='center'|F0 '''ð'''
|align='center'|F1 '''ñ'''
|align='center'|F2 '''ò'''
|align='center'|F3 '''ó'''
|align='center'|F4 '''ô'''
|align='center'|F5 '''õ'''
|align='center'|F6 '''ö'''
|align='center' style='background: #d0d0f0'|F7 '''ř''' (÷)'''
|align='center'|F8 '''ø'''
|align='center'|F9 '''ù'''
|align='center'|FA '''ú'''
|align='center'|FB '''û'''
|align='center'|FC '''ü'''
|align='center'|FD '''ý'''
|align='center'|FE '''þ'''
|align='center'|FF '''ÿ'''

|}

==== Table Notes ====

'''[1]''' As discussed [https://forums.thedarkmod.com/index.php?/topic/22427-analysis-of-212-tdm-fonts/&do=findComment&comment=494855 here], the TDM char set has a redundant treatment of 2 characters:

* Ô appears at 0x88 and 0xD4
* ô appears at 0x98 and 0xF4

Starting with TDM 2.13, the redundancy can be removed and these new characters (from ISO-8859-3) introduced:

* Ğ appears at 0x88
* ğ appears at 0x98

'''[2]''' Avoid using the non-breaking space (NBSP, 0xA0) and the soft hyphen (SHY, 0xAD) in your strings. The TDM engine has no code to respect these during word wrap. Font maintainers: probably map NBSP to the <space> glyph, SHY to undefined/hollow box or zero-sized box.

==== Corresponding Unicode ====

For a mapping of these 256 codepoints to Unicode U+NNNN values and formal names, download 'TDM 8859-Style Font Map to Unicode-16.txt':

* [https://drive.google.com/file/d/1wLEtuFvnrZ-WHK8ign8i3diIXZdriZ4F/view?usp=sharing for TDM 2.13]
* [https://drive.google.com/file/d/1UAz9jSZpT_j33STP3So_Re8JWa8QuAmz/view?usp=sharing for TDM 2.12 and earlier]

Each of these files (by Geep, 2024) is in a standardized format so that it can also be imported into font design programs like FontForge as a custom 256-position map. In the comments, there is additional information about:
* ISO 8859-x sourcing of each character.
* alternative representations of some European and control characters.

==== Fonts with Special Characters ====
Certain fonts have a few codepoints that purposefully diverge from the table entry.

* Carleton font (regular, bold, glow) uses codepoint 0x23, ordinarily "#", to represent "superscript #", which is used in the main menu system to indicate FMs for which a translation pack is available.
* Treasure Map font has characters for "pirate skull and crossbones" and "bottle of booze (or poison)".

=== Russian ===

Characters conform to the [https://en.wikipedia.org/wiki/Win-1251 WIN-1251 native encoding, shown in the Wikipedia article]. Exception: the character '''0xFF''' (я) is mapped to '''0xB6''' upon loading. Therefore any Russian font must contain я at the place 0xB6. (This was to overcome a historical Doom3 bug that is now fixed. But to date "the remapping for Russian is still in place, tho, to avoid having to patch all the russian fonts", says bug report [https://bugs.thedarkmod.com/view.php?id=2812 "0002812: Character 0xFF does not work in fonts"]).

Within any given font, character overage may be incomplete. A 2025 effort extended the Mason 48pt font to all 256 codepoints.

=== Asian Languages (Korean, Chinese, Japanese) ===

The original D3 had support for these languages, so it might be possible to add them to TDM, too. At the moment, however, we lack the fonts and translators. Also, writing from right-to-left (Hebrew) or top-down (Japanese) might be tricky or outright impossible in our GUI without more work in the C++ code. Plus, these languages use more than 256 different characters, and an 8 bit table will not hold these.

== European Character Implementation ==
=== Priority Early-On - the "Top 50" ===

Some of the special characters are used more often than others. Here is a statistic over the entire string set of the TDM core, from TDM v1.08, showing the top 50 most-used characters (excluding a-z, 0-9 and russian characters):

{|class="wikitable" border=1 style="border-collapse: collapse; font-size: 85%" cellspacing=0 cellpadding=2

|-
|Rank
|Occurances
|Letter
|Remarks
|Rank
|Occurances
|Letter
|Remarks

|-
|1
|í
|715
|
|25
|ć
|67
|

|-
|2
|é
|674
|
|26
|è
|65
|

|-
|3
|á
|524
|
|27
|ú
|56
|

|-
|4
|ø
|303
|Danish
|28
|ê
|52
|

|-
|5
|č
|288
|
|29
|ö
|48
|German

|-
|6
|ó
|283
|
|30
|É
|46
|

|-
|7
|ü
|270
|German
|31
|ñ
|37
|

|-
|8
|ł
|203
|Polish
|32
|õ
|32
|

|-
|9
|æ
|200
|Danish
|33
|ń
|26
|

|-
|10
|ě
|182
|
|34
|Ł
|24
|

|-
|11
|ř
|175
|Czech
|35
|Š
|21
|

|-
|12
|ã
|168
|
|36
|â
|21
|

|-
|13
|ž
|148
|Czech
|37
|ź
|20
|

|-
|14
|ý
|142
|
|38
|ß
|18
|German

|-
|15
|ę
|141
|
|39
|Ó
|18
|

|-
|16
|ą
|140
|
|40
|ň
|15
|

|-
|17
|ż
|119
|
|41
|Ú
|15
|

|-
|18
|å
|109
|Danish
|42
|Á
|13
|

|-
|19
|š
|99
|
|43
|î
|12
|

|-
|20
|ś
|97
|
|44
|ť
|11
|

|-
|21
|ç
|91
|
|45
|ô
|9
|

|-
|22
|ä
|86
|German
|46
|Ž
|8
|

|-
|23
|à
|83
|
|47
|Ż
|7
|

|-
|24
|ů
|77
|
|48
|Č
|7
|

|-
|25
|ć
|67
|
|49
|ù
|6
|

|}

Although ö, ä and ü do not appear that often, with only these and Ü, Ö, Ä and ß, the entire German language works. So adding these letters to the fonts is quite important.

Preferably, all foreign letters would be added to the fonts (see [[Font Patcher]] or [[Refont]]). However, if time permits only adding a few, '''í''' would be more important than, say, '''ô'''.

It is commonplace for missing accented letters to be redirected in the .dat file to the corresponding unaccented base letter.

=== Coverage Expansion & Remaining Limitations ===

By 2014, all the system (e.g., main menu) fonts (Carleton, Carleton_condensed, Stone in sizes 24pt and 48pt; Mason and Mason_glow in 48pt) had good coverage of the "Top 50" and beyond, although not all 256 codepoints.
This was confirmed more specifically in 2024, as part of an [https://forums.thedarkmod.com/index.php?/topic/22427-analysis-of-212-tdm-fonts/ Analysis of 2.12 Fonts]. This analysis indicated that, unlike the system fonts, the FM fonts generally did not provide specific glyphs beyond ASCII.

In 2024, Stone 24pt, important for subtitles and a number of readables, was further extended to cover all 256 codepoints. This was tested with TDM 2.13[betas] and released with 2.14.

In 2025, the Russian Mason 48pt font was improved and extended to cover all TDM Russian codepoints, and included in TDM 2.14.

In 2026, English/European Carleton 24pt, widely used in the main menu and also some readables, was improved to:
* extend coverage to all codepoints
* replace sloppy hand-drawn Latin-1 glyphs with fresh glyphs, most of them generated from TTF then edge-darkened
* for simplicity, re-implement the red "glow" effect as if a drop-shadow.

Testing of this is planned with TDM 2.15 betas.

Stone 48pt improvements are under consideration for TDM 2.15.

[[Category:Fonts]]

{{i18n}}

Gen Lang Programs

2026-05-31T03:00:50Z

Geep: /* Introduction to Gen_lang.pl ("PL") and Gen_lang_plus ("PLUS") */

By Geep, from February 2025
== Introduction to Gen_lang.pl ("PL") and Gen_lang_plus ("PLUS") ==
This describes two software implementations of command-line programs that essentially do the same thing;
# The Perl program "gen_lang.pl" (dubbed here PL), created by Tels in the 2010-14 timeframe. This is easily deployed under Linux that has Perl capabilities. Version 17 Is current.
# The C++ program "gen_lang_plus" (dubbed here PLUS), a re-implementation with minor improvements created by Geep in 2025. This is lightly Windows-specific at this time. (Please volunteer if you want to make it run under Linux.) For the current version, see "Downloads" at this article's end.

The purpose of both is as follows.
* Read and write files in child folder "strings". (Caution: "not strings/fm", even if you specify the "fm" option.)
* Read an "all.lang" file, either that associated with the main-menu-system, or with a specific FM under development. This UTF-8 input file has translations of strings for all TDM-supported languages (currently 17). There are individual sections for each target language. Each string is of form

"#str_<id>" "<string content>" // optional comment.
* Generate a set of individual "<language>.lang" files, with the appropriate translated strings. Each file is generated in a standard 8-bit encoding (e.g., defined by one of the iso-8859 standards) designated for the target language. If a translator did not provide a given string in the target language, the master English string is automatically substituted.
* Finally, as requested by command-line options, various analyses can be performed. For example, a set of "missing_<language>.txt" files can be generated, to suggest where translation efforts are still needed.
This article details both programs, with important differences noted. Running this functionality is intended to be done, infrequently, by the person overseeing translation improvements to all.lang.

For more quick overviews of this process, see
* the wiki article [[Internationalization]]. This also covers the i18n.pl program, which is beyond the scope here.
* the preamble of the all.lang file, found in tdm_base01.pk4's \strings\.

It is helpful to mention what these two programs do '''not''' take into account:
* the <language>.map file that reroutes European codepoints from a standardized encoding to the TDM-specific custom 8-bit encoding discussed in [[I18N_-_Charset]].
* what UTF8 characters are allowed by that TDM-specific coding (as opposed to the ISO-8859 encoding).
* the font and fontsize a specific string will use, and what limitations that entails, and what within-DAT glyph-substitutions may be in effect.

== Runtime Environment for PLUS ==
To function in all aspects, PLUS requires Windows with certain UTF8 capabilities, introduced in later versions of Windows 10. Because the PLUS build is told explicitly to use UTF8, in theory what your "system locale" is set to should not matter. In particular, you are not required you set the system locale to the Windows 11 beta UTF8 codepage. (PLUS was developed on a dev box with the English (US) locale.)

You may run it under the traditional Windows console. However, that will not display UTF8 characters correctly on screen, which is mainly an issue with the -charstats and -charpunts options. Instead, use Windows Terminal (or Powershell with UTF8 encoding). Or pipe the console output to a file (i.e., "> myfile.txt"), that can be viewed as UTF8 with Notepad and other text editors.

== Overview of Command-Line Options ==

===For both PL and PLUS===
--csv Generate CSV file
--missing Generate files with lists of missing strings for each language.
--charstats Generate statistics about foreign characters.
--show-ranges Show occupied string index ranges.
--show-holes Show holes in the string index ranges.

With PLUS, one may use a single "-" before an option, instead of "--", and/or leave off the "show-" prefix. (Regarding "charstats", for consistency, since this option outputs to screen, PL should have used the "show-" prefix, but didn't. PLUS does, optionally.)

===For PLUS Only===
-old-preamble Keep <language>.lang preamble just like that of gen_lang.pl. Don't include file generation date or PLUS version number.
-charpunts ''or'' --show-charpunts Reports lines in which "?" was substituted for any character.
-charpunts-extra ''or'' --show-charpunts-extra Like charpunt, but includes "// comment" characters.
-fm Program used for an fm, not main menu; affects what's considered a valid numeric #str_<id> range.
-cvs-unsorted Like -csv, but row order stays like that of all.lang [English].

== Charpunts and Charpunts-Extra Options [PLUS Only] ==
During generation of a particular <language>.lang file, if a valid data line contains 1 or more characters that can't be rendered in the target encoding, then a 3-line report is issued to console. Specifically:
-charpunts Considers characters within the line's content (excluding comments).
-charpunts-extra Same as charpunts, but also considers characters within the line's "// comment".

When entering these options, you may use the "show-" prefix if you'd like, with 1 or 2 leading dashes.

By "// comment", is meant the optional comment that starts with "//" at the end of a #str_<id> line (but still excluding any other comment forms; these latter won't be present in <language>.lang).

Note – it is assumed that #str_<id> contains only 0-9, A-Z, a-z, or underline... so is not inspected by these options.

An example report for [Hungarian] encoded as iso-8859-2:

Output line 177...
from: "#str_02208" "Küldetési idõ"
to: "#str_02208" "K�ldet�si id?"

Important: in this example, only õ, the last character in the "from:" line, could not be encoded in iso-8859-2 and so is replaced by "?" in the "to:" line. The "to:" line characters indicated by � were successfully encoded, but now are not valid UTF8, so can no longer be shown as such. That is, the "to:" line has the identical string placed into the hungarian.lang file.

Here is an -charpunts-extra example where only the comment has characters that don't encode, in this case into iso-8859-1 for [English]:

Output line 396...
from: "#str_02482" "Srpski"// Serbian (Српски - same exception as Russian)
to: "#str_02482" "Srpski"// Serbian (?????? - same exception as Russian)

TIP: If the results of this option is too voluminous, recall that output from a console app can be directed into a file using "... > filename.txt".

These reports give the output line number within <language>.lang, rather than the input line in all.lang, because of difficulties getting the latter value to be correct in the face of, for instance, multiline comments. (Any line numbers that PL reports are usually off.)

== Old Preamble Option [PLUS Only] ==
Each <language>.lang file gets a standard preamble. For PL, the first line looks like this example:
// String table - english (iso-8859-1)

For PLUS, the first line by default also has UTC time and program version, like this example:
// String table - english (iso-8859-1) - created on 2025-02-15T04:00:21Z with gen_lang_plus v. 1.0

But you can ask PLUS to use PL's format, with the "-old-preamble" option. Why? To simplify comparing a particular <language>.lang file generated with both programs.
Since this is more a debugging option, it's not listed in the help, just here.

== Missing Option ==
This option alerts translators to untranslated strings. For each language (other than English, the master) it generates a file named "missing_<language>.txt, with lists of missing UTF8 strings. Each line has the quoted #str_<id> and quoted content, but not comments.

===What's Considered "Missing"?===
This categorization was established in PL and now mimicked in PLUS.

''If for a given master [English] #str_<id>, there's no matching #str_<id> in the target language.''

It's "missing", unless there's a (hard-coded) exception:

* The master string's content is in the "master_non_translatable" group, namely:
** An empty or whitespaces-only string.
** "TDM" or "The Dark Mod".
** A prefix designating a function key ("F") or port ("AUX" or "JOY") followed by 1 or 2 digits.
** A special numeric format like "320x400;640x480" or "123;345" or "1x;2x".
* The master string's content is a font selector, i.e., beginning with "fonts/".
* The #str_<id> has a numeric <id> within a "master_id_non_translatable" range. Just one range, 02460 – 02490, is so reserved, for language names.

''If the #str_<id> in English and the target language have identical content (not counting comments)''

It's "missing", unless there's an exception:

* The target line has a "//" comment indicating "stays the same"
* The "master_non_translatable", font selector, or "master_id_non_translatable" exclusions apply.

''Otherwise, it's not missing.''

That covers this additional case, where for the matching #str_<id> in English and the target language, there's different content (ignoring comments). Surprisingly, this is considered "not missing" even when the English content exists and the target language content is an empty string.

Rarely, the master content can be empty, but the translated string may or may not be. An example is #str_02313, representing an optional second line needed for some languages.

== CSV Options ==
These options read the contents of all.lang and rearrange them for export as a comma-separated-values "tdm_all_lang.csv" UTF8 file in the "strings" folder. The options have different generated row order:

-csv Rows sorted by #str_<id>; seriously buggy ordering in PL, works in PLUS.
-csv-unsorted PLUS only. Keeps row order of [English] in all.lang

The exported CSV file can then be imported into other tools for translators, e.g., Excel spreadsheets. Be aware as you process this data further: maintaining the UTF8 (or other Unicode) encoding ensures character integrity.

=== Generated CVS File Format ===
The first line of the file has the field (aka column) headers, with languages in alphabetic order:

ID,catalan,czech,danish,dutch,english,french,german,hungarian,italian,polish,portuguese,romanian,russian,slovak,spanish,swedish,turkish,comment
There are 19 comma-separated fields here, so the results is very wide. (Recall in a spreadsheet, you can hide columns not of current interest.)

Broadly, the .csv format comes in different variants. Traditionally, as here, comma is the separator. If a field contains a comma, the field overall is wrapped in double quotes. PL also so wraps if there's a contained double-quote, colon, or semi-colon. PLUS mimics that policy. PL unfortunately only considers the language fields for wrapping. PLUS goes a bit further, to consider the "comment" field.

So, after the header each subsequent line has fields separated by commas, where:

* The first field, "ID", has #str_<id>. Unlike in all.lang, there are no enclosing double quotes.
* Remaining fields have translations. As expected, language fields are in the alphabetic header order shown, not necessarily the [language] section order in all.lang. English is in field 5. A field might be empty, have translation text, or have a copy of the master [English] text. (see "What's in Each Language Field" below). There are enclosing double quotes as needed.
* The last field has any comment from the master {English], beginning with "//". If there was no comment, a trailing comma ends the line.

An example row with some empty fields, for the English word "Error", with no comment:

#str_02000,Error.,,Fejl,,Error,Erreur,Fehler,Hiba,Errore,Błąd,Erro,Eroare,Ошибка,Chyba,,,Hata,
Comments on source lines in sections other than [english] are not included.

=== Sorted and Unsorted Row Orders ===

With the -csv option:

* For PLUS, the row order is sorted by #str_<id>.
* While PL intended the row order to be sorted by #str_<id>, the actual sorting is scattershot. (A cause may be the more-recent presence of numerous non-numeric IDs. The sort uses a custom comparator, which knows only about numeric IDs. Other IDs are "tied" in order, not good for many sort algorithms. The Perl code that writes the <language>.lang files uses a better comparator.) The workaround is to import the data into your spreadsheet (keeping UTF8 encoding) and do row sorting there.

With the -csv-unsorted option [PLUS only]:

* Sometimes, it is more helpful to have rows in the same order as in the master [english] section of all.lang, e.g., not necessarily sorted; so perhaps meaningfully grouped. (Caution: in all.lang, there is sometimes a preceding full-line comment that describes a given grouping. That will not be present in the .csv file.)

=== What's in Each Language Field ===
As discussed above, a field will have enclosing double quotes as needed.

The master "english" field, will simply have the [English] content (which could in rare cases be empty).

The situation for other languages is more complex. PL appears, in its separate csv implementation, to be following a middle course, between:
* the "always use translation if available; otherwise English" policy for <language>.lang generation.
* the categorization of the Missing Option.

To make clear the difference, we repeat the Missing Options description, but with '''lines crossed out''' below. (PLUS follows what PL does here, but FYI, there is commented-out code that could implement the crossed-out conditions.)

A field considered "missing" will be empty (e.g., between 2 commas).

''If for a given master [English] #str_<id>, there's no matching #str_<id> in the target language.''

It's "missing", unless there's a (hard-coded) exception:
* The master string's content is in the "master_non_translatable" group, namely:
** An empty or whitespaces-only string.
** "TDM" or "The Dark Mod".
** A prefix designating a function key ("F") or port ("AUX" or "JOY") followed by 1 or 2 digits.
** A special numeric format like "320x400;640x480" or "123;345" or "1x;2x".
* <s>The master string's content is a font selector, i.e., beginning with "fonts/".</s>
* <s>The #str_<id> has a numeric <id> within a "master_id_non_translatable" range. Just one range, 2460 – 2490, is so reserved, for language names.</s>

In this case, if it's not missing, the '''master string's content''' will be used.

''If the #str_<id> in English and the target language have identical content (not counting comments)''

It's "missing", unless there's an exception:
* <s>The target line has a "// comment" indicating "stays the same".</s>
* The "master_non_translatable", <s>font selector, or "master_id_non_translatable"</s> exclusions apply.

In this case, if it's not missing, the '''translated string content (same as master string's content)''' will be used. As indicated, any "stays the same" phrase in the line's comment within the [language] section is ignored.

''Otherwise, it's not missing.''

The '''translated string's content''' will be used. This is the normal "translation provided" case, where for the matching #str_<id> in English and the target language, there's different content (ignoring comments). Note that if English content exists but the target language content is an empty string, while this categorization would call it "not missing", it still has the same result: nothing between the commmas.

=== Differences in Comments between PL and PLUS ===
As noted above , PLUS will enclose the comment field in double quotes if needed. Also, if the comment field contains any unescaped double-quotes, they are backslash-escaped.
PL will do none of that. This is a bug. When the .csv file is imported into a spreadsheet, extra spurious columns may result, requiring manual fix-up.
Also, there is a difference in handling of how characters appear in comments. PLUS will preserve UTF8 characters. PL will replace characters not in ISO-8859-1 with "?" (resulting in the same appearance as in english.lang).

== Charstats Option ==
Creating bitmap font glyphs can be a time-consuming process. This option provides information to suggest, among European (i.e., non-ASCII, non-Cyrillic) characters, which ones should take priority in that process, based on what translators have provided to all.lang.

The results go to the console. PL and PLUS formats differ. PL groups compactly by "Top 5", "Top 10", and so on, and is not particularly Unicode-aware.
PLUS gives each character its own line, with rank and additional data. (And the output here is in utf8 form, better viewed in Windows Terminal than the traditional console. Or pipe to a text file that, e.g., Notepad can treat as UTF8.) Example output:

Non-ASCII UTF8 characters in 'all.lang' across all languages except [Russian],
by descending frequency. (Excludes characters in comments.)

Rank, unicode codepoint, utf8 char, frequency (i.e., count out of 13563 total listed)

1 U+00e1 á 1504
2 U+00e9 é 1420
3 U+00ed í 1099
4 U+0131 ı 1075
5 U+00fc ü 755
6 U+010d č 644
7 U+00f3 ó 498
8 U+00f6 ö 418
9 U+00fa ú 407
....
93 U+0152 Œ 1
94 U+0158 Ř 1
95 U+0179 Ź 1

== Ranges Option and Holes Option ==
Traditionally, #str_<id>s had only 5-digit numeric values. When a new string needed to be added (i.e., to the [English] master), it was helpful to know what numeric ranges were already fully in use, and conversely, what ranges are unoccupied, dubbed "holes". With these options, that info gets reported to the console. Note that for PL, "holes" reports only if "ranges" is not given as an option. PLUS removes that restriction.
PL processes and reports <id>s in [English] listing order; if that is non-monotonic, this can cause anomalies for the "holes" output. To fix that, PLUS does a pre-sort into monotonic order.
PL and PLUS formats differ slightly. An example PLUS output for "-ranges":

There are 48 occupied numeric #str_ ranges in [English]:

1000-1019 (with 20 entries)
1050-1062 (with 13 entries)
1500-1503 (with 4 entries)
2000-2016 (with 17 entries)
...
8980-8988 (with 9 entries)
10000-10162 (with 163 entries)
10180-10185 (with 6 entries)

Also, there are 54 non-numeric #str_ entries.

In the last line, you see that, unlike PL, PLUS is aware of non-numeric <id>s, but just reports them as a total.
An example PLUS output for "-holes":

There are 44 unoccupied numeric #str_ ranges (aka holes) in [English]:

0-999 (with 1000 openings)
1020-1049 (with 30 openings)
1063-1499 (with 437 openings)
1504-1999 (with 496 openings)
....
8989-9999 (with 1011 openings)
10163-10179 (with 17 openings)
10185-19999 (with 9814 openings)

The range from 20000-99999 is reserved for FMs. Using #str_<id> in that range in all.lang will trigger a fatal error (with the –range or –hole option). (See also the FM Option.)

== FM Option [PLUS only] ==
By default, when either the -ranges or -holes option is in effect, the valid range for #str_<id> numeric values is enforced by PLUS as 0-19999. If you are using this for FM strings, select this option to make the valid range 20000-99999.

''These days, many but not all main menu #str_<id>s contain a substring "_menu_". There could be future enforcement of alphanumeric substrings.''
== Details about Main File Formats and Processing ==

=== All.lang File Input Format ===
The file begins with a preamble (in C-style comment form) of notes for translators, some of which we restate here. Then an opening "{" by itself, followed by a series of language sections. Each starts with a line with one of these headers (shown in the order currently seen in the main menu all.lang file):

[English]
[German]
[French]
[Italian]
[Spanish
[Polish]
[Romanian]
[Russian]
[Portuguese}
[Czech]
[Hungarian]
[Slovak]
[Swedish]
[Danish]
[Dutch]
[Turkish]
[Catalan]

Case of the language name doesn't matter, nor does order in which sections are listed. But it is a convention to list English first. After the header comes a series of convertible lines and comment lines, as discussed in next sections. The last line of the file has the closing "}".

=== Converting Each Line ===
Within any particular language section of all.lang, a convertible line will have in this order:

# A #str_<id>, in double quotes, where <id> is an unsigned integer, or a string composed of ASCII characters a-z, A-Z, 0-9, or underscore. Preferred for the latter are all lower case with underscores as word separators. Camel-case is tolerated, but not spaces or dashes. Ignoring the "#str_" prefix, the <id> must be no less than 5 and no more than 63 characters long. Leading zeros should be used to pad a numeric <id> to 5 digits. [Note: program i18n.pl possibly deals only with numeric <id>s.]
# The language-specific UTF8 <string content>, in double quotes
# An optional comment beginning with "//". The next section covers overall treatment of comments.

These are led and separated by whitespace. A leading tab is normal, with tab separators.

No particular ordering of #str_<id>s is required, though ordering numeric <id>s (at least within sub-groups) is desirable.
==== Duplicates Across Lines Within a Section ====
If a particular <id> value appears more than once in a section, the last value is the effective one. A console warning will generally occur during parsing, in the case of PLUS like:
Warning - #str_02518 redefined within [english]...
from: malformed
to: 100

In the [English] section, there might be separate <id>s with the same content. This will generally cause a warning, in the case of PLUS like:
Caution - These strings have the same content ('Master'): #str_08206, #str_03008

To avoid the latter warning, a group of duplicates can be assigned a group number and hard-coded in the "master_double_exceptions" list. Only one group of ten members is so defined currently, those with a required empty string as content. More generally (says a PL comment): "Sometimes it can make sense to have two different strings as when they are translated into different strings in another language. A [theoretical] example would be "Saw" (I saw something, ich hab etwas gesehen) and "Saw" (Saw, Säge)."

==== Substituting English when No Translation ====
Ideally, a #str_<id> in the master [English] section has a match in a target language's section. Then the translated content will always be used for encoding and listing in the <language>.lang file. If no match, the English content is substituted. (Note that only a subset of these substituted strings will categorized as "Missing" if the -missing option is used. Also note that the substitution policy is slightly different with the -csv option.)

==== Conversion Differences between PL and PLUS ====
* To do encoding, PL uses the Perl Encode module, that can autoload language-specific encode/decode tables.
* In the C++ implementation, source file "UTF8_8859_convert.cpp" includes similar (albeit custom) tables for the codepages TDM supports. The overall approach is convert from UTF8 to UTF16, then to the target ISO encoding. That process does not use <locale> facets (which are problematic for our purposes), but standard C++ library "codecvt_utf8_utf16" and "wstring_convert" capabilities.

=== The <language>.Lang File Output Format ===
* A preamble states the language name and specific ISO encoding.
* This is followed by the "#str_<id> ..." lines; sorted in alphabetic order; <id> in numeric form will be listed before those in alphabetic form. Among the latter, an upper case letter will sort before all lower case letters.
* Trailing "//" comments on "#str_<id>" lines from all.lang are preserved.
* Comments of the form /*...*/ in all.lang are skipped, whether spanning multiple lines or part of a single line.
* Blank lines, or lines with only whitespace or a "//" comment, are likewise skipped. The latter comments typically contain headers to organize groups of items in all.lang, but that organization is not retained, replaced by alphanumeric ordering as mentioned.

==== Output File Differences between PL and PLUS ====
These differences are not thought to have functional implications:

* The first line of the preamble will differ unless PLUS's -old_preamble option is used.
* Between a string content and any comment, PLUS preserves tabs and spaces found in all.lang, while PL substitutes two tabs. This is means that simple file comparison programs (like Windows "fc", even with /T or /W options) will find lots of trivial differences. It is suggested you use a more sophisticated comparison tool, for instance, Notepad++ with the ComparePlus plugin and "Ignore changed spaces" selected.

== Notes on PLUS Internals ==
A hand-crafted conversion from a static analysis of PL, PLUS preserves many variable names, some reimagined as functions. Befitting a straightforward conversion, it offers a procedural, C-like style, without much in the way of a class hierarchy, overarching object-oriented design pattern, or advanced C++ features. (This may be of benefit if part or all of its functionality is ever integrated into the TDM engine and/or DR.)
Not much effort was spent on performance optimization. However, as a compiled language, it will of course run much faster than PL. Also, the C++ implementation avoids use of regular expressions, which are heavily featured in PL and are notoriously slow and also hard for most coders to read.

Platform-independent C++ standard-library structures like vectors, (ordered) sets, maps, and multimaps are employed. However, to do the UTF8 to ISO conversions, a Windows-specific approach is taken, to convert via unencoding from utf8 to wide characters and then re-encoding to target ISOs. (While it is possible to do such conversions entirely within 8-bit characters, the resulting code is a puzzle box, best left to third-party libraries.) Instead of using a third-party library, the encode/decode implementation here includes use of the "deprecated" C++ standard "codecvt" feature; while deprecated, the C++ standard committee has not (as of 2025) come up with a viable replacement.

Like PL, PLUS has some DEBUG statements defined (requiring recompile for C++). These reflect specific concerns during development and testing and are of limited general interest.

== Downloads ==
For PLUS v1.1 of 2025, July 16 (mainly adds Catalan as a supported language)

* [https://drive.google.com/file/d/1R_qajkfq5_drIGEMYQ8ahpJwfN1LdkiT/view?usp=sharing gen_lang_plus_source_v1.1.zip]. This is a Visual Studio project. Includes open-source license.
* [https://drive.google.com/file/d/1kj_zE9VN7l1DMztnOHx-UaNbIAECIE6M/view?usp=sharing gen_lang_plus.exe]

For PLUS v1.0 of 2025, Feb 28:

* [https://drive.google.com/file/d/1V_FSMEBYsinXPMKlH3_OmzcS8f1zjVeL/view?usp=sharing gen_lang_plus_source_v1.0.zip]. This is a Visual Studio project.
* [https://drive.google.com/file/d/1xsas9kZ-6tRdNdFhKHS736xYK5-aYGMg/view?usp=sharing gen_lang_plus.exe]

== See Also ==
The Perl program "i18n.pl" contains similar functionality for FM-specific strings, but also parses and edits the FM .map file, so is considerably more complicated.

Inventory

2026-05-30T22:24:42Z

Geep: /* Length of Inventory Display Names */ New section added

This article describes how to set up inventory items and how they can be given to an entity. An entity's inventory can be seen as some sort of "container" for various items. Inventory items are distinguished by their category, such as ''Tools'', ''Maps'', ''Potions'' and ''Weapons'' (yes, a weapon is also a special kind of inventory item). All entities can have an inventory, even though it may only make sense for AI and the player to actually have one. Also included is a script interface, so that a mapper can interact with the inventory in a more sophisticated way, if the default behaviour is not sufficient.

== Definitions ==

The spawnargs can be either set in the def file as a default, or in the map file to override settings for specific entities. Naturaly this also means that they can be manipulated by scripts as well.

'''IMPORTANT!''' When items are put into inventory they remain in the map in their original location, but are hidden and will therefore 'disappear'. If this doesn't work, then the item will stay visible. This is a intentionally so, to make the mapper aware of the problem. Check the console and/or enable the inventory logclass in the darkmod.log file to see what went wrong.

There are several terms and types of items that can be used in the inventory:

* '''Anonymous items''' An anonymous object means that it will not show up as an item in the inventory. Examples are gold coins and all the other (mostly loot) items that are collected but not being used individually. In this case they only count for the total of loot and are discarded afterwards. Anonymous items also can not be dropped after they are placed into the inventory because they essentially no longer exist. For the loot count it obviously doesn't matter wether an item is anonymous or not, as all are added up into the loot categories. The same holds for ammonition (arrows). These get added to the weapon's ammo and are removed from the map.

* '''Stackable items''' These are items that can be stacked in the inventory. This means that the player can acquire multiple instances of such items, but only one entry is shown in the inventory with a counter of how many currently are available. An example would be a health potion. The player can possess more than one health potion at a time and this would be indicated by the counter on the HUD. Stackable items are identified by setting the stackable property. They also must always use the same name and category. If this doesn't match, they are considered to be different. This also allows for dealing out i.e. fake health potions which have no effect or deal damage instead (as an example).

* '''Category''' Each item has a Category, which is used to group items. This allows the player to faster scroll through the inventory because he doesn't have to cycle through all the individual items. For example a category would be 'Readables' where books and scrolls are stored, and another Category would be 'Tools' where lockpicks and other items can be stored. Note that the actual category names are entirely up to the mapper. It doesn't have any consequence as to the playability and is only a convenience for the player. The inventory category is briefly displayed on the player HUD when cycling through the items.

* '''Cursor''' ''(This is coding-related information)'' An inventory can have multiple cursors. Each cursor can point to a different place in the same inventory, and can restrict the movement to certain categories. This way, you can implement different HUDs or GUIs which can show different parts of the inventory in different places even though all the items are in one single inventory. Weapons are handled this way; a separate cursor is used which is only allowed to cycle through the weapon category.

== Spawnargs ==
;'''<tt>inv_name</tt>''' | string '''[required]'''
:Specifies the name the object should display when it is activated in the inventory. Keep in mind that the display name and the category together are used to determine whether two items are of the same type. This is important to determine whether items can be "stacked". Both '''inv_name''' and '''inv_category''' must match.
:Example: <tt>"inv_name" "Health Potion"</tt>

;'''<tt>inv_category</tt>''' | string '''[required]'''
: Specifies the category that the object should be filed under.
:Example: <tt>"inv_category" "Potions"</tt>

;'''<tt>inv_icon</tt>''' | string (D3 path to icon file)
:Points to an icon that is to be displayed on the player HUD when the object is selected in the inventory. (This can also point to a shader name.) Note that you don't need to specify the file extension.
:Example: <tt>"inv_icon" "guis/assets/hud/inventory_icons/icon_health_potion"</tt>

;'''<tt>inv_stackable</tt>''' | [0/1]
: Determines whether an item can be stacked on top of other items of the same type. An example would be the health potion item. The player can pick up more than one health potion, but in the inventory he will only get one item with a counter. Note that loot items need not to be stackable, they are handled separately by special code.

;'''<tt>inv_item_id</tt>''' | string
:This key can be set by the mapper to a value of his or her choice. This is needed if the mapper wants to address specific items or groups of items in order to implement custom behaviour, even if the <tt>inv_name</tt> is the same for this group of items. For example, a mapper can create a fake health potion which shows up in the inventory just like a regular one. If the mapper desired, he could set up a script to check for this exact potion and trigger custom behaviour when the item is used.

;'''<tt>inv_count</tt>''' | integer number
: Defines how many instances of an item is to be added to the inventory. Applies only to items with <tt>inv_stackable</tt> set to 1. Non-stackable items have always an item count of 1 and this argument is ignored. As an example, the mapper could set up a stack of health potions as single entity (some sort of quiver) which immediately adds 5 potions to the player's inventory.

;'''<tt>inv_droppable</tt>''' | [0|1]
:If set to 1 the item can be dropped into the map by the player. This will not work for anonymous items (loot, ammo), since their entity will be removed from the map after they had been put into the inventory.

;'''<tt>drop_to_hands</tt>''' | [0|1]
:If set to 1 (default) the item drops to the hands (grabber manipulator) of the player instead of to the ground. Set to 0 and the item drops directly to the floor when dropped.

;'''<tt>inv_loot_type</tt>''' | [ 0 | 1 | 2 | 3 ]
::* 0 = No lootitem (default)
::* 1 = Jewelry/Gems
::* 2 = Gold
::* 3 = Goods
:This has to be set in order to define what kind of item it is and if it is a loot item, which category of loot it should account for. Note: it's not possible to choose other values (e.g. loot type = 4), the code will probably crash.

;'''<tt>inv_loot_value</tt>''' | integer
:Determines the amount of loot this item accounts for. This spawnarg is only applicable for items with a non-zero <tt>inv_loot_type</tt>.

;'''<tt>inv_ammo_amount</tt>''' | integer (default is 0)
: Determines whether this item is an ammo item and how much ammonition this item represents. When this argument is 0, the item is not recognised as ammo. Ordinary ammonition items like [[atdm:ammo_broadhead]] have <tt>inv_ammo_amount</tt> set to 1, but it's perfectly valid to set it to higher values for items like quivers. Don't forget to add the <tt>inv_weapon_name</tt> spawnarg, which is needed by the code to determine which weapon this ammo belongs to.

;'''<tt>inv_weapon_name</tt>''' | string
: This spawnarg applies to weapon and ammo items. Each weapon must have a unique <tt>inv_weapon_name</tt>, like "broadhead" or "blackjack". This weapon name is used to determine which weapon an ammonition item is belonging to. If the <tt>inv_weapon_name</tt> is missing on ammonition, it cannot be recognised as loot (a warning is emitted to the console and the log).

;'''<tt>inv_use_on_frob</tt>''' | [0|1] (default is 0)
: When this spawnarg is set to 1, it can be used just by hitting the "frob" button (of course it must be selected in the inventory). The code then attempts to "use" this item on the highlighted entity in front of the player. The system is still in the works, so this information might not be fully accurate.

;'''<tt>inv_map_start</tt>''' | [0|1]
:Determines wether this object should be automatically moved to the inventory at map start.

;'''<tt>inv_target</tt>''' | string (entityname, optional, defaults to "player1")
:If the <tt>inv_map_start</tt> argument is set to "1", this defines the name of the entity that should receive it, otherwise the value is ignored. To give an item to the player, you would use <tt>player1</tt> as the name (which is the default value anyway).

;'''<tt>inv_hud</tt>''' | string (D3 path to .gui file)
: If this key is set it should point to a GUI file, which defines the hud for this particular item. As an example, you can look at the file tdm_loot.hud, which implements a custom hud that does not use the regular inventory item HUD. The mapper is responsible to maintain the state for such an item on his own. In order to do this, there is an initialization message sent to the specified script and other messages as well like selecting or deselecting an item. In order to make this work, the mapper must set up the correct scriptobject and add a few events to it. An example description of how to operate a custom HUD will be described in the scripting section on this article.

;'''<tt>inv_hud_layer</tt>''' | integer (layernumber)
: If a custom hud is used for an item by setting the key <tt>inv_hud</tt>, this key can be set to specify a layer number the custom hud should be displayed on. Normally this value can be set to 0 or left blank when using the default screen for the player, but for huds on other objects in the map, this might be needed.

;'''<tt>inv_persistent</tt>''' | [0|1] (default is 0)
: If this is set to "1", the item can be taken to the next map. This is useful for designing campaigns, where important items or weapons can be taken to the next level.

;'''<tt>inv_lgmodifier</tt>''' | int (default is 0, maximum is DARKMOD_LG_MAX = 32)
: This can be used to modify the lightgem brightness when this item is selected in the inventory. Useful for weapons like the fire arrow.

;'''<tt>inv_movement_modifier</tt>''' | float | default is 1, must be positive
: This can be used to slow down the player when this item is equipped (e.g. for weapons like the shortsword). This value is multiplied on the maximum movement speed.

;'''<tt>inv_no_pickup_message</tt>''' | [0|1] | default is 0
: Setting this to 1 disables the "pick up message" when this item is put into the player's inventory.

== Length of Inventory Display Names ==
The inv_name needs to be relatively short. If it is too long, when displayed in the lower right screen corner, rightmost words will be clipped or missing. This starts to become a concern at roughly 18-20 characters (including spaces). To worse-case test this, go to the HUD Size/Opacity "Adjust" page (under Settings > Video > General), leave the "Icon Size" at the default, but maximize "Weapon/Item Text Size".

Fixes for this are:
* simply shorten the name. For instance, it may not be necessary to call an item "Treasure Chest Key", if the icon makes it obviously a key, so "Treasure Chest" would do.
* Manually force the display name to two lines, by inserting a "\n" into the inv_name string (or if using #str_ translations, into the corresponding content in the all.lang file and its offspring). The engine and inventory display gui collaborate on this, but only 2 lines at most. Cautions: Don't expect automatic word-wrap from 1 to 2 lines. And either line could still be individually clipped if too long.

If you are providing i18n translation strings, review every language's inventory name lengths. Non-English phrases are often longer than English.

== Default equipment for map start ==

This describes how to give items to the player at map start time, but the same mechanism can be applied to any other AI (or entity for that matter) as well.

* First create your object in the editor, just like you would if you wanted to put it in the map. Choose Create Entity and select the inventory item of your choice (a health potion for example). Place it where you like, but not outside in the void.
* Set the key <tt>inv_map_start</tt> on the object entity to the value 1.
* (Optional) Set the key <tt>inv_target</tt> to the name of the entity you would like this item to go to.

The object will be moved to the target entity's inventory right at map start (and will be hidden or removed). The player will not be able to see the item (unless there was a mistake in the setup).

== Inventory CVARs ==
The following cvars can be used to modify the behaviour of some inventory properties. Some of them are probably only of interest to modders, while others are also of interest to players and might be added to a customization menu.

;'''<tt>tdm_inv_hud_file</tt>''' | string | default "guis/tdm_inv.gui"
:Specifies the gui file that should be used for the inventory. this can be changed for mods, that wish to implement a different GUI, or provide alternative skins for the player.

;'''<tt>tdm_inv_loot_item_def</tt>''' | string | default "atdm:inv_loot_info_item"
: Specifies the entityDef that should be used for the loot info slot in the inventory. This entityDef holds the references for the loot HUD.

;'''<tt>tdm_inv_hud_pickupmessages</tt>''' | [0|1] | default is 1
:If set to 1, the HUD is displaying the item the player has just picked up.

;'''<tt>tdm_inv_loot_sound</tt>''' | string | default "frob_loot"
: Specifies the default path to the soundfile that is played when loot is aquired. Note that this can be overriden on a per item level, and wont have an effect for such items. ''(greebo: Should be removed)''

;'''<tt>tdm_inv_use_on_frob</tt>''' | [0|1] | default is 0 (for now)
:When set to '1' the code attempts to use the currently selected inventory on frob, provided the selected item supports this action.

;'''<tt>tdm_inv_use_on_frob_visual_feedback</tt> | [0|1] | default is 1
:When set to '1' the HUD is giving visual feedback when the currently highlighted item is used.

=== Related CVARs ===
;'''<tt>tdm_hud_opacity</tt> | float [0..1]
:Defines the opacity of the HUD GUIs, also affects the lightgem and the weapon HUD.

== Key bindings ==

For inventory key bindings see [[Bindings_and_User_Settings#Inventory_Related]]

== Scriptsupport ==
The following events are available for scripters. These events can be called on any entity (as every entity has an inventory), but I assume for 99% of the cases, you will want to use these on <tt>$player1</tt>.

;<tt>scriptEvent float getLootAmount(float Type);</tt>
:Returns the amount of loot for the given type (e.g. LOOT_GOODS). There are a few loot constants defined in <tt>tdm_events.script</tt> file. Pass LOOT_TOTAL to return the sum of all loot types.
:*LOOT_TOTAL
:*LOOT_JEWELRY
:*LOOT_GOLD
:*LOOT_GOODS

;<tt>scriptEvent float changeLootAmount(float type, float amount);</tt>
:Changes the loot amount of the given Type (e.g. GOODS) by <amount>. The new value of the changed type is returned (e.g. the new GOODS value if this has been changed). Note: The LOOT_TOTAL type can't be changed and 0 is returned.

;<tt>scriptEvent void addInvItem(entity inv_item);</tt>
:Adds the given item to the inventory. Depending on the type, the passed entity will be removed from the game (as for loot items) or hidden. If the item couldn't be added, a warning is emitted to the console.

;<tt>scriptEvent float replaceInvItem(entity oldItem, entity newItem);</tt>
:Replaces the entity <oldItem> with <newItem> in the inventory, while keeping <oldItem>'s inventory position intact.
:Note: The position guarantee only applies if <oldItem> and newItem share the same category. If the categories are different, the position of <newItem> is likely to be different than the one of <oldItem>.
:Note that <oldItem> will be removed from the inventory. If <newItem> is the $null_entity, <oldItem> is just removed and no replacement happens.
:Returns: 1 if the operation was successful, 0 otherwise.

;<tt>scriptEvent entity getNextInvItem();</tt>
;<tt>scriptEvent entity getPrevInvItem();</tt>
:Cycles the standard cursor to the next/prev inventory item.
:Returns: the item entity pointed to after the next/prev operation is complete.

;<tt>scriptEvent float setCurInvCategory(string categoryName);</tt>
:Sets the inventory cursor to the first item of the named category.
:Returns: 1 on success, 0 on failure (e.g. wrong category name).

;<tt>scriptEvent entity setCurInvItem(string itemName);</tt>
:Sets the inventory cursor to the named item.
:Returns: the item entity of the newly selected item (can be the $null_entity).

;<tt>scriptEvent string getCurInvCategory();</tt>
:Returns the name of the currently highlighted inventory category.

;<tt>scriptEvent entity getCurInvItemEntity();</tt>
:Returns the currently highlighted inventory item entity.

;<tt>scriptEvent string getCurInvItemName();</tt>
:Returns the name of the currently highlighted inventory item (the one defined in <tt>inv_name</tt>).

;<tt>scriptEvent string getCurInvItemId();</tt>
:Returns the name of the currently highlighted inventory item (the one defined in <tt>inv_item_id</tt>). Most items will return an empty string, unless the "inv_item_id" is set on purpose.

;<tt>scriptEvent string getCurInvIcon();</tt>
:Returns the icon of the currently highlighted inventory item.

;<tt>scriptEvent void changeInvItemCount(string name, string category, float amount);</tt>
:Decreases the inventory item stack count by amount. The item is addressed using the name and category of the item. These are usually defined on the inventory item entity (<tt>inv_name</tt>, <tt>inv_category</tt>). Amount can be both negative and positive.

;<tt>scriptEvent void changeInvLightgemModifier(string name, string category, float modifier);</tt>
:Sets the lightgem modifier value of the given item. Valid arguments are between 0 and 32 (which is the maximum lightgem value).

;<tt>scriptEvent void changeInvIcon(string name, string category, string icon);</tt>
:Sets the inventory icon of the given item in the given category to <icon>.

=== Example ===
A short example of the above script events in action is the lantern script:
// Set the icon to the "on" icon
userEntity.changeInvIcon(getKey("inv_name"), getKey("inv_category"), getKey("inv_icon_on"));
The first call is retrieving the <tt>inv_name</tt> and <tt>inv_category</tt> spawnargs from the lantern entityDef and takes them as argument for te <tt>changeInvIcon</tt> call. The <tt>inv_name</tt> and <tt>inv_category</tt> are necessary for the code to lookup the item in the player's inventory. The third parameter defines which icon the lantern inventory item should have from now on.

== Custom HUDs ==
It is possible to implement a custom HUD for each inventory item. Examples for inventory items with custom HUDs are the player compass and the loot info item. This describes how to set up a custom HUD for your item.

# First off, you need an entityDef with your inventory item. Look at <tt>atdm:playertools_compass</tt> for an example.
# Your inventory item entity needs to have its own script object, so you'll need to name that in your entityDef using the "scriptobject" spawnarg.
# The scriptobject (which will be defined in a .script file) needs to implement a small set of functions which are invoked by the code when the item is initialised, selected or de-selected.

=== Set up the entityDef ===
Again, the compass is given as an example:
entityDef atdm:playertools_compass
{
"inherit" "atdm:playertool"
"spawnclass" "idStaticEntity"

"editor_usage" "Compass"

"model" "models/darkmod/player_equipment/compass.ase"
"scriptobject" "playertools_compass"

"inv_name" "Compass"
"inv_category" "Compass"
"inv_map_start" "1"

"inv_hud" "guis/playertools/compass.gui"
"inv_hud_layer" "11" // greebo: Readables are on layer 10
"inv_icon" ""
"inv_droppable" "0"
}
The compass is set up like any other inventory item - the important thing is to specify the <tt>inv_hud</tt> and <tt>inv_hud_layer</tt> spawnargs. The <tt>inv_hud</tt> argument is pointing to a sepcific GUI file, which will be displayed when the inventory item is selected by the player. The <tt>inv_hud_layer</tt> defines on which layer the GUI is being drawn (GUIS with higher overlay numbers are drawn after the ones with lower numbers).

Also note that <tt>scriptobject</tt> spawnarg which points to the script class, in this case <tt>playertools_compass</tt>. See the next chapter for information about how to set this up.

=== Set up the scriptobject ===
As next step, you'll need to add a custom scriptobject which defines the methods to be called by the SDK code. Create a .script file and define a scriptobject with the following methods:
/*
* Compass scriptobject, derives from player_tools
*/
object playertools_compass : player_tools
{
// greebo: Gets called upon addition to the inventory
void inventory_item_init(entity userEntity, float overlayHandle, string overlayName);

// Gets called when the player switches to another inventory item
void inventory_item_unselect(entity userEntity, float overlayHandle);

// Gets called when this item is selected in the inventory
void inventory_item_select(entity userEntity, float overlayHandle);

// Gets called to update the HUD (not each frame!)
void inventory_item_update(entity userEntity, float overlayHandle);
};
As you can gather from the comments, the various functions are called by the SDK code on certain occasions. The <tt>userEntity</tt> argument always defines the entity which holds the inventory item, which is the $player1 entity in almost all cases. The second parameter <tt>overlayHandle</tt> defines the GUI handle which can be used to set the GUI state variables of the custom HUD. These depend on your implementation, of course. I won't go into the details here (you can look at the actual files in the scripts/ folder), but as an example I can pick the <tt>inventory_item_select()</tt> method of the compass scriptobject:
void playertools_compass::inventory_item_select(entity userEntity, float overlayHandle)
{
_overlayHandle = overlayHandle;

// Disable the default inventory
userEntity.setGuiFloat(userEntity.getInventoryOverlay(), "Inventory_ItemVisible", 0);

// Make the compass GUI visible
userEntity.setGuiFloat(_overlayHandle, "CompassVisible", 1);

// Start a new thread
_updateThreadNum = thread updateLoop(userEntity);
}
The interesting part is how to set the GUI state variables, which is easy: just use the <tt>setGui***</tt> methods on the <tt>userEntity</tt> (usually the player), passing the overlayHandle along to specify which HUD you are addressing.

===Set up a custom GUI if needed===
As mentioned above, you can define key ''inv_hud'' to point to a custom .gui file. For example, the special compass GUI is further considered in conjunction with its implementing architecture in [[GUI Scripting: RenderDef]]. Also, starting in TDM 2.06, there are a richer set of user settings that affect inventory HUD displays. If your custom item provides its own GUI, consider incorporating these (e.g., "gui::HUD_Opacity", "gui::smallTextSize"). For examples, see the "Extra: Adding a Custom GUI" section at this article's end, or contents of files tdm_hud.gui, tdm_inv.gui, or tdm_loot.gui in tdm_gui01.pk4\guis\.

== Setting up Weapons ==
Setting up weapons is not that hard actually from the entityDef point of view. The hard part is to get the models and animations right, which is mostly artwork. However, this short chapter should explain how the various entityDefs are connected to each other.

=== Weapon ===
First of all, you'll need a weapon entityDef, one that is inheriting from <tt>atdm:weapon_base</tt>. The entityDef needs a unique <tt>inv_weapon_name</tt> serving as identifier for ammunition and scripting. The <tt>atdm:weapon_base</tt> carries some editor_* spawnargs which explain the various options you have to "configure" your weapon (like whether ammunition is required, or whether it is a toggleable weapon, or the scriptobject, etc.).

Let's assume you set up a weapon with ammunition (i.e. the weapon carries the spawanrg <tt>"ammo_required" "1"</tt>). In this case you'll need a couple of additional entityDefs, namely ''ammo'', ''attachment'', ''projectile'' and ''result'' entities.

=== Ammo ===
For weapons requiring ammunition, you'll need to add the <tt>def_ammo</tt> spawnarg, which should point to an entityDef inheriting from <tt>atdm:ammo_base</tt>. This links the weapon to the correct ammunition entityDef. To link back the ammo to the weapon, add the <tt>inv_weapon_name</tt> spawnarg to the ammo entityDef pointing back to the weapon (e.g. "broadhead").

=== The Weapon Attachment ===
Each arrow weapon in TDM needs an attachment entity for display during the bow animations. For instance, whenever the player selects the water arrow weapon and starts to draw the bow string, the entity of type <tt>atdm:attachment_waterarrow</tt> is attached to the bow viewmodel. The name of the attachment entityDef is defined on the weapon with the spawnarg <tt>def_attach</tt>.

=== The Projectile ===
Once the player releases the bow string, the projectile is fired. The <tt>def_projectile</tt> spawnarg on the weapon points to the desired projectile entityDef.

=== The Projectile Result ===
The launched projectile will impact somewhere, and this is the point in space where the so-called ''projectile result'' will be spawned. The projectile entityDef holds the spawnarg <tt>def_result</tt> pointing to the correct result entityDef. The result in turn has to implement the correct script methods which are called by the projectile collision code in the SDK. These script methods on the result's scriptobject will implement the actual behaviour of the arrow (like playing sounds, deploying ropes, etc.).

== How to make inventory items to interact with world objects ==
Kingsal has reported how to use inventory items on items frob-highlighted in the game world. The report is here: http://forums.thedarkmod.com/topic/18505-script-for-placing-the-right-object-in-the-right-place/?p=397333

Consider this scenario:
* The gamer knows that somewhere in the map, there's a skull that must be placed on an altar.
* When the skull is found, frobbing it puts it into the inventory.
* Later, either:
** frob the pedestal altar, which appears to instantly transfer the skull from inventory to atop the altar. (Behind the scene, there are 2 skulls involved: the custom entity dropped from inventory, and a hidden one prepositioned on the altar.)
** drop the skull into your hands (R key), move it above the altar, and drop it there (R key again). (Altar remains frobbable after this, but frobbing does nothing.)

This requires a custom set up for an inventory item you would like the player to use_on_frob when highlighting an object in the world. (While the scenario in this example is placing a skull on a pedestal, there are many different uses/scenarios. There are also several ways to do this. Check out http://wiki.thedarkmod.com/index.php?title=Tool,_Key,_custom_used_by_inventory_actions for another method.)

You will need the def files and script file below.

This assumes you have basic knowledge of creating .def files and .scripts. If not. PM me (kingsal) for help.

===Def File===
Place this in your def file.

//++++++++++++++++++++++++Use Inventory Item++++++++++++++++++++++++++++++
// The inventory_use_item's "inv_name" spawnarg MUST match the "item_name" spawnarg on the Altar.

entityDef inventory__use_item //Change the name if you'd like
{
"inherit" "atdm:moveable_small_base"

//editor junk
"editor_displayFolder" "interactables/special" // Change to a location you'd like it to show up in DR.
"editor_usage" "Custom use-on-frob item"
"editor_color" "0.922 0.039 0.855"

//Model
"model" "models/darkmod/graveyard/bones/skull2.ase" // Change to appropriate model. Should have a collision mesh.
"mass" "10" // If item can be dropped, Set this higher to avoid the player from lobbing it too far.
"friction" "0.7"
"solid" "0"

//Inventory stuff
"inv_name" "custom item name" //Rename it something fun! MUST match the name on the Altar.
"inv_icon" "guis\assets\hud\inventory_icons\skull_inv_icon" // GUI icon.
"inv_droppable" "1" //Allows the player to drop this. Beware they might drop it someplace where it can't be retrieved.
"inv_category" "Custom Items" //Rename this to the appropiate category.
"inv_stackable" "1" //This is only needed if their are multiple of these items that you want to stack in the inventory.

//sound
"snd_acquire" "tool_pickup"
"snd_bounce" "tdm_impact_metal_med_lesser"

}

//++++++++++++++++++++++++Altar++++++++++++++++++++++++++++++

entityDef use_item_altar //Change the name if you'd like
{
"inherit" "atdm:entity_base"
"spawnclass" "idStaticEntity"

//editor junk
"editor_displayFolder" "interactables/special" // Change to a location you'd like it to show up in DR.
"editor_usage" "Altar for placing inventory_use_items"
"editor_color" "0.922 0.039 0.855"

//Model
"model" "models/darkmod/furniture/tables/builder_pedestal01.lwo" //Change to appropriate model
"solid" "1" //Must be solid

//Interaction
"frobable" "1"
"frob_action_script" "use_altar"
"item_name" "custom item name" //This must match the inv_name spawnarg of the custom item
}

===Script===
This is the script that goes in your mymap.script. Or fms/scripts which requires adding the script name to your tdm_custom_script file.

/////////// EVENT SCRIPTS //////////////
//Place this in your fms/maps/ as a mymapname.script.
void use_altar(entity altar)
{

entity curr_item = $player1.getCurInvItemEntity();
if ($player1.getCurInvItemName() == altar.getKey("item_name"))
{
$player1.changeInvItemCount(curr_item.getKey("inv_name"), curr_item.getKey("inv_category"), -1); //Removes item count by one.
altar.activateTargets( $player1 ); //Activates the altar's targets.
altar.setFrobable( 0 ); //Sets to none frobable. One time use. REMOVE THIS TO MAKE RE-USABLE.
altar.startSoundShader ("mage_fireball_impact", SND_CHANNEL_VOICE ); //Play a sound you like!
sys.wait( 1 );
}

}

===Set-up===

By default the custom items can be found in DR under yourfms/interactables/special. Unless you changed the path

1. Add the inventory_use_item and use_item_altar to your map.

2. Be sure to change the "inv_name" spawnarg on the custom item and the "item_name" spawnarg on the altar. They must match to work.

3. Place a func_static of the item's model on the altar and set spawnarg "hide 1". Have the altar target the func_static and it will appear, giving the illusion it was placed there.

''If you want skull-on-altar to satisfy an objective, additional coding and/or location-detection will need to be added.''

===Extra: Adding a Custom GUI===
Suppose you wanted to extend this example, to make the skull inventory icon pulse with color? You could do this with a custom GUI, explained in [[GUI Scripting: Inventory Icon Example]]. This also provides a inventory script object, that could serve as a template for use in other projects; it may be of more general use that the compass script object. Plus, more about using global and local GUI::Parameters in this context.

[[Category:Editing]]

Carleton Fonts

2026-05-26T16:15:33Z

Geep: /* Improvements to English Carleton 24pt in 2026 */ mention ExportUnicodeFontToDoom3

''By Geep, 2025. The analysis here as of TDM 2.12 and for "english" (including European) unless indicated otherwise.''

== The Carleton Family in a Nutshell ==
Carleton is a squarish print-style serif font. The lower case letters look like smaller versions of the upper case letters, so this font can also be referred to as "Carleton Caps", [[Fonts_Screenshots#Carleton_Caps_only | as in this screenshot]]. Within TDM, there are four members of the Carleton family:
* carleton
* carleton_bold
* carleton_condensed (i.e., more tightly spaced in the horizontal dimension)
* carleton_glow

Base-font carleton is used extensively throughout the main menu system. It may appear by itself, in black, for non-interactive subheadings and descriptions. (In a few places, like the "Downloadable Missions" title, a "headline" style using carleton_bold is deployed.)

Or it may participate in dynamic text highlighting for user interactions, using overlay combinations like:
* carleton and carleton_glow
* carleton_bold and carleton_glow, for titles and headlines
* carleton, carleton_bold and carleton_glow, for certain "new game" buttons

For FMs, there are standard readable sheet and scroll prefabs and sign text decals that use carleton, just by itself. The style of this font makes it a good choices for notices; between title and body, and upper and lower case, there can appear to be four different sizes of "capital" letters.

All these usages predominately involve mid-sized and large text (e.g., GUI textscale 0.24 and up), that draws on the 24pt and 48pt size bitmaps. The "english" form of 24pt and 48pt both offer TDM’s full European glyph set. Glyphs are stylishly done for 48pt and not bad for ASCII characters of 24pt; the accented characters of 24pt are rough-hewn and merely adequate.

While 48pt carleton_bold actually has bold (thickened) glyphs, 24pt carleton_bold glyphs are merely copies of regular 24pt carleton, so not bold.

== File Naming and Content Sharing across the Carleton Family ==
The four members share bitmap naming. For instance, if you examine any of the 4 derived fontimage_24.ref files, you see references like:

shaderName fonts/Carleton_0_24.tga

and it will say "Carleton_..." in all cases, not for instance "Carleton_condensed_...". (As is typically the case in TDM, a shader filetype of .tga actually resolves to .dds, and shaderName is case-insensitive; the actual filenames are all lower-case.)

There is also file content sharing (i.e., duplication). As shown in the tables below, the sharing pattern is more complex, and arguably incoherent. This may reflect errors in distribution, or perhaps some member/size combinations not really being used.

{| class="wikitable" style="margin-left: 0px; margin-right: auto;"
|+ '''Table of 2.12 English Carleton Family DAT Files Sharing File Names and in Some Cases Contents.''' The content of each file is unique, unless shown here by "SAME", which refers to only to matching another file’s content IN THE SAME ROW.
|-
! filename !! /carleton/ !! /carleton_bold/ !! /carleton_condensed/ !! /carleton_glow/
|-
| fontimage_12.dat || SAME || SAME || SAME || SAME
|-
| fontimage_24.dat || SAME || SAME || unique || SAME
|-
| fontimage_48.dat || SAME || SAME || unique || SAME
|}

The fontimage_24.dat files shown as SAME were updated for 2.15.

{| class="wikitable" style="margin-left: 0px; margin-right: auto;"
|+ '''Table of 2.12 & 2.15 English Carleton Family DDS Files Sharing File Names and in Some Cases Contents.''' The content of each file is unique, unless shown here by "SAME", which refers to only to matching another file’s content IN THE SAME ROW.
|-
! filename !! /carleton/ !! /carleton_bold/ !! /carleton_condensed/ !! /carleton_glow/
|-
| carleton_0_12.dds || SAME || unique || SAME || unique
|-
| carleton_0_24.dds || '''SAME''' || '''SAME''' || unique || '''SAME''' [was unique before 2.15]
|-
| carleton_1_24.dds || '''SAME''' || '''SAME''' || unique || '''SAME''' [was unique before 2.15]
|-
| carleton_2_24.dds [Added 2.15] || '''SAME''' || '''SAME''' || n/a || '''SAME'''
|-
| carleton_0_48.dds || SAME || unique || SAME || unique
|-
| carleton_1_48.dds || SAME || unique || SAME || unique
|-
| carleton_2_48.dds || SAME || unique || SAME || unique
|-
| carleton_3_48.dds || SAME || unique || SAME || unique
|-
| carleton_4_48.dds || SAME || unique || SAME || unique
|-
| carleton_5_48.dds || SAME || unique || SAME || unique
|-
| carleton_6_48.dds || SAME || unique || SAME || unique
|-
| carleton_7_48.dds || SAME || unique || SAME || unique
|}

The carleton_*_24 DDS files were updated for 2.15 (except for carleton_condensed).

== Bitmap File Sizes across the Carleton Family ==
The english 24pt DDS files '''shown in bold above''' have 512x512 bitmaps. All other files (including those for Russian, not in the table) have the default 256x256 bitmaps. This includes carleton_glow unless bolded. Observe that it is not required that the base & glow have identical bitmap sizes (although that is helpful to allow GIMP layering).

See also [[Refont#Carleton_Family]] for corresponding refont commands.

== Anomalies of Carleton and Carleton Bold 24pt Glyphs ==
As mentioned above, 24pt Carleton Bold is identical to 24pt Carleton; so not really bold. The remaining discussion applies equally to 24pt Carleton and Carleton Bold.

Evidently, the original generation of the 24pt size, into two 256x256 bitmaps "carleton_0_24.dds" and "carleton_1_24.dds", contained only ASCII alphanumeric characters and limited punctuation, with no accented/Latin-1 glyphs. Later, these bitmaps were scaled up to 512x512 bitmaps, to ease drawing in the missing characters by hand. The resulting new characters are coarser than the generated and scaled ASCII characters.

You can see this aspects in the main menu, under Settings/Video/Language, where, in the list of 16 languages, accented letters are thicker.

Also, if viewed in GIMP, the white characters have a faint black border, not seen elsewhere (e.g., in the 48pt bitmaps). This is true of both scaled-up ASCII and drawn Latin-1 characters, though far more prominent in the latter. However, TDM's monochrome, usually black rendering (defined by forecolor in the GUI) obscures the presence of this border effect. The purpose for it is discussed next.

== Carleton When Toggling Choices Within a Submenu ==
Throughout Setting submenus, the Carleton 24pt font is used within option lists. More generally, this presentation style is used for row items within lists.

For example, under Settings/Audio/, there is a row with "Main Menu Music" and a choice of "On" or "Off". This is implemented by a standardized choiceDef.
* On the left, the "Main Menu Music" phrase is carleton, rendered in translucent black (with alpha 0.85) and a textscale of 0.24 (which draws from 24pt).
* On the right, the "On" and "Off" text by default is the same, but slightly smaller at textscale 0.22 (also from 24pt).

When you mouse-hover, the current-value text turns momentarily white with a faint black border. The white is set, not by the GUI, but by the engine's "hoverColor", which is opaque white (1,1,1,1). The black border improves readability against the parchment background. It is due to the "anomolous" black border baked into the font, as discussed above.

''Aside: There is a GUI scripting text attribute "shadow", to draw black drop shadows (offset equally down and right) under font characters. This is not used in the main menu system. Within the engine, "shadow" invokes a "textShadow" boolean, false by default.''

== Improvements to English Carleton 24pt in 2026 ==
''This summarizes what is described in more detail [https://forums.thedarkmod.com/index.php?/topic/23109-improvements-to-carleton-24pt-font here]''

A number of problems needed correcting:
* some missing or bad glyphs
* glyphs lacking their accents
* many "ugly" badly-drawn glyphs
* suboptimal vertical/horizontal placement
* clipping

For TDM 2.15, all 256 of TDM's English/European codepoints, including accents, were implemented,. Ugly glyphs were replaced by fresh ones regenerated from TTF; dev tools were updated to facilitate that (e.g., hirez, bolding, and inPlace options added to [[ExportUnicodeFontToDoom3]]). Placement/spacing, and clipping were generally improved, involving both bitmap and DAT tweaks.

The new system (after a false start) uses three 512x512 bitmaps instead of two.

The previous custom carleton_glow 24pt set of bitmaps with smudged glyphs is no longer used. Instead, a copy of carleton 24pt bitmaps is used for carleton_glow (as well as carleton_bold per previous). Thus, the "glow" relies ''solely'' on the main-menu's simulated "drop shadow" effect (due to overlapped offset GUI defWindows).

Carleton_condensed 24pt font was considered deprecated and not touched by this redo.

== Carleton & Carleton Glow in the Main Menu System ==
This pairing occurs basically everywhere thorough the main menu system. In a typical presentation, against a parchment background, major menu-page-selection keywords are by default rendered in black with no glow. But they will turn white with blood-red glow highlighting when either selected (as if a tab for the current page) or moused-over. This will also play a sound and often show a text hint.

=== Example Implementation ===
TDM uses a number of different "button" (i.e., selectable text) styles, driven by #defines in \tdm_gui01\guis\mainmenu_defs.gui. For example, those of the main menu home page use:
#define MM_NORMAL_FONT "fonts/carleton"
#define MM_GLOW_FONT "fonts/carleton_glow"
#define MM_FONTSCALE 0.33
#define MM_BUTTON_HEIGHT 18

For colors, the text is black initially, with glow highlighting invisible. Upon mouse hover, the text becomes white, and the glow red. RGBA colors are defined for this, in vector and string (with S prefix) forms:

#define NORMAL_COLOR 0,0,0,0.90 // black, not entirely opaque
#define SNORMAL_COLOR "0 0 0 0.90"
#define INVISIBLE 0, 0, 0, 0
#define SINVISIBLE "0 0 0 0"
#define GLOW_WHITE_COLOR 0.98,0.93,0.82,1
#define SGLOW_WHITE_COLOR "0.98 0.93 0.82 1"
#define GLOW_RED_COLOR 0.6,0.1,0.1,0.5 // semi-transparent
#define SGLOW_RED_COLOR "0.6 0.1 0.1 0.5"

To be specific, consider a simplified imaginary main menu "button" we'll call "Simple". (We're avoiding the layout calculations and other complications of a real button.) For our button, there are 3 aligned windowDefs in mainmenu_defs.gui, with these locations:

#define MM_POS_SIMPLE_BUTTON rect 40, 445, 160, MM_BUTTON_HEIGHT * 1.3
#define MM_POS_SIMPLE_BUTTON_GLOW rect 41, 446, 159, MM_BUTTON_HEIGHT * 1.3 - 1
#define MM_POS_SIMPLE_ACTION MM_POS_SIMPLE_BUTTON

The windowDefs positioned by these will also do the following:
* MM_POS_SIMPLE_BUTTON: set the default appearance of the button text.
* MM_POS_SIMPLE_BUTTON_GLOW: set the default appearance of the glow "highlight" text. Note this text is offset down and to the right by one pixel, compared to MM_POS_SIMPLE_BUTTON, to give the glow a "drop shadow" flavor. This is a frequent treatment, though in some cases only the right shift is done.
* MM_POS_SIMPLE_ACTION defines the mouse-over and mouse-selection dynamic behaviors. (Be aware that in some actual cases, this is combined into the first windowDef.)

Then, besides the rects, the other attributes are defined for the two default windowDefs:

#define MM_FONT font MM_NORMAL_FONT forecolor SNORMAL_COLOR textscale MM_FONTSCALE visible 1 textalign 1 // centered text
#define MM_FONT_GLOW font MM_GLOW_FONT forecolor INVISIBLE textscale MM_FONTSCALE visible 1 textalign 1

(This is a simplification; for the main menu, MM_FONT's forecolor is #defined as INVISIBLE, then transitions to SNORMAL_COLOR in 1/2 second.)

Within an overall page layout given by mainmenu_main.gui (but with our button shoved in), we might have nested:

windowDef SimpleTextH
{
rect MM_POS_SIMPLE_BUTTON_GLOW
MM_FONT_GLOW
visible "gui::showSimple"
text "#str_01234" // "Simple"
}
windowDef SimpleText
{
rect MM_POS_SIMPLE_BUTTON
MM_FONT
visible "gui::showSimple"
text "#str_01234" // "Simple"
}
windowDef SimpleAction
{
rect MM_POS_SIMPLE_ACTION
visible "gui::showSimple"
float exit;

onMouseEnter
{
set "exit" 0;
transition "SimpleText::forecolor" SNORMAL_COLOR SGLOW_WHITE_COLOR "50" ;
transition "SimpleTextH::forecolor" SINVISIBLE SGLOW_RED_COLOR "50" ;
set "cmd" "play sound/meta/menu/mnu_hover";
}

onMouseExit
{
if ("exit" == 0)
{
transition "SimpleText::forecolor" SGLOW_WHITE_COLOR SNORMAL_COLOR "50" ;
transition "SimpleTextH::forecolor" SGLOW_RED_COLOR SINVISIBLE "50" ;
}
}

onAction
{
transition "SimpleText::forecolor" SGLOW_WHITE_COLOR SNORMAL_COLOR "50" ;
transition "SimpleTextH::forecolor" SGLOW_RED_COLOR SINVISIBLE "50" ;

set "cmd" "play sound/meta/menu/mnu_select;";
set "cmd" "onSimpleClicked"; // tell engine

// And any additional commands here to switch states, resetTime, etc.
}
}

The "H" (highlighted) windowDef is shown first, to draw behind the main text. onMouseEnter turns the text color from black to white in 50 milliseconds, and the glow from invisible to red. onMouseExit reverses that. onAction, when the button is mouse-selected, does the visual transition as mouse exit, but plays a different sound... and then does whatever "Simple" is supposed to do.

== Carleton in Assets for FMs ==
In the tables below, most content has a textscale above 0.30, so draws from the 48pt size, '''indicated in bold'''. Otherwise, with a textscale of 0.16 to 0.30, from 24pt.

{| class="wikitable" style="margin-left: 0px; margin-right: auto;"
|+ '''Carleton in Standard Readable Prefabs.'''
Within \tdm_prefabs01\xdata\prefabs.xd, "gui_page<n>" : "guis/readables/..."
|-
! Prefab !! Title textscale !! Body textscale
|-
| .../books/... none || ||
|-
| .../scrolls/scroll_print_carleton.gui || '''0.40''' || 0.28
|-
| .../sheets/sheet_paper_print_carleton_caps.gui || '''0.40''' || '''0.31'''
|}

{| class="wikitable" style="margin-left: 0px; margin-right: auto;"
|+ '''Carleton in Sign Text.''' Within \sign_text_decals\
|-
! Decal !! Textscale
|-
| sign_text_carleton.gui || '''2'''
|-
| sign_text_carleton_small.gui || '''1'''
|}

== Carleton_condensed ==
As indicated above, Carleton_condensed DDS files are all 256x256.

=== 12pt Size ===
''The main menu system does not use this size. In your FM, it is recommended to NOT invoke 12pt carleton_condensed (i.e., by specifying a GUI textscale of 0.15 or less). Instead, use regular carleton, possibly with a slightly smaller textscale.''

Although 12pt carleton_condensed exists, its DAT file and single DDS file are mere placeholders that are identical to those of carleton 12pt.

=== 48pt Size ===
''The main menu system does not use this size. In your FM, it is recommended to NOT invoke 48pt carleton_condensed (i.e., by specifying a GUI textscale of above 0.30). Instead, use regular carleton, possibly with a slightly smaller textscale.''

The set of eight DDS files for 48pt carleton_condensed are identical to those for 48pt carleton. However, the DAT file has different content, though the difference is not due to horizontal "condensation".

A one time, Tels drafted a Font Patcher command file for 48pt carleton_condensed, to reduce the width and xSkip of a selected subset of the carleton’s ASCII alphanumeric characters, presumably those most generously spaced to begin with. Evidently this was not finalized and deployed. Instead, inspection of the current 48pt DAT file for carleton_condensed suggests it was based on an early version of carleton, at a time when only some of the accented characters were implemented. (In particular, the DAT lacks re-implemented metrics for chars 128-139 and 145-155.)

=== 24pt Size ===
''The main menu system uses this, but sparingly. Since a "glow" form of carleton_condensed was never developed, only regular non-glow uses are applicable.''

The contents of the DAT file and the set of two DDS files for 48pt carleton_condensed DIFFER from those for 48pt carleton.

For the main menu system, where carleton was used for English-language players, the more-compact carleton_condensed was briefly considered as a method of accommodating European language translations. However, this would require dynamic language switching, and was found to be a hill too far, compared to just reducing Carleton’s textscale value.

The actual limited uses in the main menu systems are seen as you survey the downloadable missions. Specifically, when looking at a candidate mission, the Mission Details page has a Description section, whose body text is carleton_condensed with textscale 0.17. Compared to other similar text section here (that use regular carleton with textscale 0.18), this is slightly smaller and condensed. Also, the Next >> and << Prev buttons for cycling through screenshots have their button captions in this font (with textscale 0.23).

== For More ==
* Character-set coverage of Carleton family is included in the the [https://forums.thedarkmod.com/index.php?/topic/22427-analysis-of-212-tdm-fonts/ summary analysis of 2.12 TDM fonts], based on applying 'refont -stats ...' to all 'english' DAT files.

{{tutorial}} [[Category:Fonts]]

Carleton Fonts

2026-05-26T15:58:48Z

Geep: /* File Naming and Content Sharing across the Carleton Family */

''By Geep, 2025. The analysis here as of TDM 2.12 and for "english" (including European) unless indicated otherwise.''

== The Carleton Family in a Nutshell ==
Carleton is a squarish print-style serif font. The lower case letters look like smaller versions of the upper case letters, so this font can also be referred to as "Carleton Caps", [[Fonts_Screenshots#Carleton_Caps_only | as in this screenshot]]. Within TDM, there are four members of the Carleton family:
* carleton
* carleton_bold
* carleton_condensed (i.e., more tightly spaced in the horizontal dimension)
* carleton_glow

Base-font carleton is used extensively throughout the main menu system. It may appear by itself, in black, for non-interactive subheadings and descriptions. (In a few places, like the "Downloadable Missions" title, a "headline" style using carleton_bold is deployed.)

Or it may participate in dynamic text highlighting for user interactions, using overlay combinations like:
* carleton and carleton_glow
* carleton_bold and carleton_glow, for titles and headlines
* carleton, carleton_bold and carleton_glow, for certain "new game" buttons

For FMs, there are standard readable sheet and scroll prefabs and sign text decals that use carleton, just by itself. The style of this font makes it a good choices for notices; between title and body, and upper and lower case, there can appear to be four different sizes of "capital" letters.

All these usages predominately involve mid-sized and large text (e.g., GUI textscale 0.24 and up), that draws on the 24pt and 48pt size bitmaps. The "english" form of 24pt and 48pt both offer TDM’s full European glyph set. Glyphs are stylishly done for 48pt and not bad for ASCII characters of 24pt; the accented characters of 24pt are rough-hewn and merely adequate.

While 48pt carleton_bold actually has bold (thickened) glyphs, 24pt carleton_bold glyphs are merely copies of regular 24pt carleton, so not bold.

== File Naming and Content Sharing across the Carleton Family ==
The four members share bitmap naming. For instance, if you examine any of the 4 derived fontimage_24.ref files, you see references like:

shaderName fonts/Carleton_0_24.tga

and it will say "Carleton_..." in all cases, not for instance "Carleton_condensed_...". (As is typically the case in TDM, a shader filetype of .tga actually resolves to .dds, and shaderName is case-insensitive; the actual filenames are all lower-case.)

There is also file content sharing (i.e., duplication). As shown in the tables below, the sharing pattern is more complex, and arguably incoherent. This may reflect errors in distribution, or perhaps some member/size combinations not really being used.

{| class="wikitable" style="margin-left: 0px; margin-right: auto;"
|+ '''Table of 2.12 English Carleton Family DAT Files Sharing File Names and in Some Cases Contents.''' The content of each file is unique, unless shown here by "SAME", which refers to only to matching another file’s content IN THE SAME ROW.
|-
! filename !! /carleton/ !! /carleton_bold/ !! /carleton_condensed/ !! /carleton_glow/
|-
| fontimage_12.dat || SAME || SAME || SAME || SAME
|-
| fontimage_24.dat || SAME || SAME || unique || SAME
|-
| fontimage_48.dat || SAME || SAME || unique || SAME
|}

The fontimage_24.dat files shown as SAME were updated for 2.15.

{| class="wikitable" style="margin-left: 0px; margin-right: auto;"
|+ '''Table of 2.12 & 2.15 English Carleton Family DDS Files Sharing File Names and in Some Cases Contents.''' The content of each file is unique, unless shown here by "SAME", which refers to only to matching another file’s content IN THE SAME ROW.
|-
! filename !! /carleton/ !! /carleton_bold/ !! /carleton_condensed/ !! /carleton_glow/
|-
| carleton_0_12.dds || SAME || unique || SAME || unique
|-
| carleton_0_24.dds || '''SAME''' || '''SAME''' || unique || '''SAME''' [was unique before 2.15]
|-
| carleton_1_24.dds || '''SAME''' || '''SAME''' || unique || '''SAME''' [was unique before 2.15]
|-
| carleton_2_24.dds [Added 2.15] || '''SAME''' || '''SAME''' || n/a || '''SAME'''
|-
| carleton_0_48.dds || SAME || unique || SAME || unique
|-
| carleton_1_48.dds || SAME || unique || SAME || unique
|-
| carleton_2_48.dds || SAME || unique || SAME || unique
|-
| carleton_3_48.dds || SAME || unique || SAME || unique
|-
| carleton_4_48.dds || SAME || unique || SAME || unique
|-
| carleton_5_48.dds || SAME || unique || SAME || unique
|-
| carleton_6_48.dds || SAME || unique || SAME || unique
|-
| carleton_7_48.dds || SAME || unique || SAME || unique
|}

The carleton_*_24 DDS files were updated for 2.15 (except for carleton_condensed).

== Bitmap File Sizes across the Carleton Family ==
The english 24pt DDS files '''shown in bold above''' have 512x512 bitmaps. All other files (including those for Russian, not in the table) have the default 256x256 bitmaps. This includes carleton_glow unless bolded. Observe that it is not required that the base & glow have identical bitmap sizes (although that is helpful to allow GIMP layering).

See also [[Refont#Carleton_Family]] for corresponding refont commands.

== Anomalies of Carleton and Carleton Bold 24pt Glyphs ==
As mentioned above, 24pt Carleton Bold is identical to 24pt Carleton; so not really bold. The remaining discussion applies equally to 24pt Carleton and Carleton Bold.

Evidently, the original generation of the 24pt size, into two 256x256 bitmaps "carleton_0_24.dds" and "carleton_1_24.dds", contained only ASCII alphanumeric characters and limited punctuation, with no accented/Latin-1 glyphs. Later, these bitmaps were scaled up to 512x512 bitmaps, to ease drawing in the missing characters by hand. The resulting new characters are coarser than the generated and scaled ASCII characters.

You can see this aspects in the main menu, under Settings/Video/Language, where, in the list of 16 languages, accented letters are thicker.

Also, if viewed in GIMP, the white characters have a faint black border, not seen elsewhere (e.g., in the 48pt bitmaps). This is true of both scaled-up ASCII and drawn Latin-1 characters, though far more prominent in the latter. However, TDM's monochrome, usually black rendering (defined by forecolor in the GUI) obscures the presence of this border effect. The purpose for it is discussed next.

== Carleton When Toggling Choices Within a Submenu ==
Throughout Setting submenus, the Carleton 24pt font is used within option lists. More generally, this presentation style is used for row items within lists.

For example, under Settings/Audio/, there is a row with "Main Menu Music" and a choice of "On" or "Off". This is implemented by a standardized choiceDef.
* On the left, the "Main Menu Music" phrase is carleton, rendered in translucent black (with alpha 0.85) and a textscale of 0.24 (which draws from 24pt).
* On the right, the "On" and "Off" text by default is the same, but slightly smaller at textscale 0.22 (also from 24pt).

When you mouse-hover, the current-value text turns momentarily white with a faint black border. The white is set, not by the GUI, but by the engine's "hoverColor", which is opaque white (1,1,1,1). The black border improves readability against the parchment background. It is due to the "anomolous" black border baked into the font, as discussed above.

''Aside: There is a GUI scripting text attribute "shadow", to draw black drop shadows (offset equally down and right) under font characters. This is not used in the main menu system. Within the engine, "shadow" invokes a "textShadow" boolean, false by default.''

== Improvements to English Carleton 24pt in 2026 ==
''This summarizes what is described in more detail [https://forums.thedarkmod.com/index.php?/topic/23109-improvements-to-carleton-24pt-font here]''

A number of problems needed correcting:
* some missing or bad glyphs
* glyphs lacking their accents
* many "ugly" badly-drawn glyphs
* suboptimal vertical/horizontal placement
* clipping

For TDM 2.15, all 256 of TDM's English/European codepoints, including accents, were implemented,. Ugly glyphs were replaced by fresh ones regenerated from TTF; dev tools were updated to facilitate that. Placement/spacing, and clipping were generally improved, involving both bitmap and DAT tweaks.

The new system (after a false start) uses three 512x512 bitmaps instead of two.

The previous custom carleton_glow 24pt set of bitmaps with smudged glyphs is no longer used. Instead, a copy of carleton 24pt bitmaps is used for carleton_glow (as well as carleton_bold per previous). Thus, the "glow" relies ''solely'' on the main-menu's simulated "drop shadow" effect (due to overlapped offset GUI defWindows).

Carleton_condensed 24pt font was considered deprecated and not touched by this redo.

== Carleton & Carleton Glow in the Main Menu System ==
This pairing occurs basically everywhere thorough the main menu system. In a typical presentation, against a parchment background, major menu-page-selection keywords are by default rendered in black with no glow. But they will turn white with blood-red glow highlighting when either selected (as if a tab for the current page) or moused-over. This will also play a sound and often show a text hint.

=== Example Implementation ===
TDM uses a number of different "button" (i.e., selectable text) styles, driven by #defines in \tdm_gui01\guis\mainmenu_defs.gui. For example, those of the main menu home page use:
#define MM_NORMAL_FONT "fonts/carleton"
#define MM_GLOW_FONT "fonts/carleton_glow"
#define MM_FONTSCALE 0.33
#define MM_BUTTON_HEIGHT 18

For colors, the text is black initially, with glow highlighting invisible. Upon mouse hover, the text becomes white, and the glow red. RGBA colors are defined for this, in vector and string (with S prefix) forms:

#define NORMAL_COLOR 0,0,0,0.90 // black, not entirely opaque
#define SNORMAL_COLOR "0 0 0 0.90"
#define INVISIBLE 0, 0, 0, 0
#define SINVISIBLE "0 0 0 0"
#define GLOW_WHITE_COLOR 0.98,0.93,0.82,1
#define SGLOW_WHITE_COLOR "0.98 0.93 0.82 1"
#define GLOW_RED_COLOR 0.6,0.1,0.1,0.5 // semi-transparent
#define SGLOW_RED_COLOR "0.6 0.1 0.1 0.5"

To be specific, consider a simplified imaginary main menu "button" we'll call "Simple". (We're avoiding the layout calculations and other complications of a real button.) For our button, there are 3 aligned windowDefs in mainmenu_defs.gui, with these locations:

#define MM_POS_SIMPLE_BUTTON rect 40, 445, 160, MM_BUTTON_HEIGHT * 1.3
#define MM_POS_SIMPLE_BUTTON_GLOW rect 41, 446, 159, MM_BUTTON_HEIGHT * 1.3 - 1
#define MM_POS_SIMPLE_ACTION MM_POS_SIMPLE_BUTTON

The windowDefs positioned by these will also do the following:
* MM_POS_SIMPLE_BUTTON: set the default appearance of the button text.
* MM_POS_SIMPLE_BUTTON_GLOW: set the default appearance of the glow "highlight" text. Note this text is offset down and to the right by one pixel, compared to MM_POS_SIMPLE_BUTTON, to give the glow a "drop shadow" flavor. This is a frequent treatment, though in some cases only the right shift is done.
* MM_POS_SIMPLE_ACTION defines the mouse-over and mouse-selection dynamic behaviors. (Be aware that in some actual cases, this is combined into the first windowDef.)

Then, besides the rects, the other attributes are defined for the two default windowDefs:

#define MM_FONT font MM_NORMAL_FONT forecolor SNORMAL_COLOR textscale MM_FONTSCALE visible 1 textalign 1 // centered text
#define MM_FONT_GLOW font MM_GLOW_FONT forecolor INVISIBLE textscale MM_FONTSCALE visible 1 textalign 1

(This is a simplification; for the main menu, MM_FONT's forecolor is #defined as INVISIBLE, then transitions to SNORMAL_COLOR in 1/2 second.)

Within an overall page layout given by mainmenu_main.gui (but with our button shoved in), we might have nested:

windowDef SimpleTextH
{
rect MM_POS_SIMPLE_BUTTON_GLOW
MM_FONT_GLOW
visible "gui::showSimple"
text "#str_01234" // "Simple"
}
windowDef SimpleText
{
rect MM_POS_SIMPLE_BUTTON
MM_FONT
visible "gui::showSimple"
text "#str_01234" // "Simple"
}
windowDef SimpleAction
{
rect MM_POS_SIMPLE_ACTION
visible "gui::showSimple"
float exit;

onMouseEnter
{
set "exit" 0;
transition "SimpleText::forecolor" SNORMAL_COLOR SGLOW_WHITE_COLOR "50" ;
transition "SimpleTextH::forecolor" SINVISIBLE SGLOW_RED_COLOR "50" ;
set "cmd" "play sound/meta/menu/mnu_hover";
}

onMouseExit
{
if ("exit" == 0)
{
transition "SimpleText::forecolor" SGLOW_WHITE_COLOR SNORMAL_COLOR "50" ;
transition "SimpleTextH::forecolor" SGLOW_RED_COLOR SINVISIBLE "50" ;
}
}

onAction
{
transition "SimpleText::forecolor" SGLOW_WHITE_COLOR SNORMAL_COLOR "50" ;
transition "SimpleTextH::forecolor" SGLOW_RED_COLOR SINVISIBLE "50" ;

set "cmd" "play sound/meta/menu/mnu_select;";
set "cmd" "onSimpleClicked"; // tell engine

// And any additional commands here to switch states, resetTime, etc.
}
}

The "H" (highlighted) windowDef is shown first, to draw behind the main text. onMouseEnter turns the text color from black to white in 50 milliseconds, and the glow from invisible to red. onMouseExit reverses that. onAction, when the button is mouse-selected, does the visual transition as mouse exit, but plays a different sound... and then does whatever "Simple" is supposed to do.

== Carleton in Assets for FMs ==
In the tables below, most content has a textscale above 0.30, so draws from the 48pt size, '''indicated in bold'''. Otherwise, with a textscale of 0.16 to 0.30, from 24pt.

{| class="wikitable" style="margin-left: 0px; margin-right: auto;"
|+ '''Carleton in Standard Readable Prefabs.'''
Within \tdm_prefabs01\xdata\prefabs.xd, "gui_page<n>" : "guis/readables/..."
|-
! Prefab !! Title textscale !! Body textscale
|-
| .../books/... none || ||
|-
| .../scrolls/scroll_print_carleton.gui || '''0.40''' || 0.28
|-
| .../sheets/sheet_paper_print_carleton_caps.gui || '''0.40''' || '''0.31'''
|}

{| class="wikitable" style="margin-left: 0px; margin-right: auto;"
|+ '''Carleton in Sign Text.''' Within \sign_text_decals\
|-
! Decal !! Textscale
|-
| sign_text_carleton.gui || '''2'''
|-
| sign_text_carleton_small.gui || '''1'''
|}

== Carleton_condensed ==
As indicated above, Carleton_condensed DDS files are all 256x256.

=== 12pt Size ===
''The main menu system does not use this size. In your FM, it is recommended to NOT invoke 12pt carleton_condensed (i.e., by specifying a GUI textscale of 0.15 or less). Instead, use regular carleton, possibly with a slightly smaller textscale.''

Although 12pt carleton_condensed exists, its DAT file and single DDS file are mere placeholders that are identical to those of carleton 12pt.

=== 48pt Size ===
''The main menu system does not use this size. In your FM, it is recommended to NOT invoke 48pt carleton_condensed (i.e., by specifying a GUI textscale of above 0.30). Instead, use regular carleton, possibly with a slightly smaller textscale.''

The set of eight DDS files for 48pt carleton_condensed are identical to those for 48pt carleton. However, the DAT file has different content, though the difference is not due to horizontal "condensation".

A one time, Tels drafted a Font Patcher command file for 48pt carleton_condensed, to reduce the width and xSkip of a selected subset of the carleton’s ASCII alphanumeric characters, presumably those most generously spaced to begin with. Evidently this was not finalized and deployed. Instead, inspection of the current 48pt DAT file for carleton_condensed suggests it was based on an early version of carleton, at a time when only some of the accented characters were implemented. (In particular, the DAT lacks re-implemented metrics for chars 128-139 and 145-155.)

=== 24pt Size ===
''The main menu system uses this, but sparingly. Since a "glow" form of carleton_condensed was never developed, only regular non-glow uses are applicable.''

The contents of the DAT file and the set of two DDS files for 48pt carleton_condensed DIFFER from those for 48pt carleton.

For the main menu system, where carleton was used for English-language players, the more-compact carleton_condensed was briefly considered as a method of accommodating European language translations. However, this would require dynamic language switching, and was found to be a hill too far, compared to just reducing Carleton’s textscale value.

The actual limited uses in the main menu systems are seen as you survey the downloadable missions. Specifically, when looking at a candidate mission, the Mission Details page has a Description section, whose body text is carleton_condensed with textscale 0.17. Compared to other similar text section here (that use regular carleton with textscale 0.18), this is slightly smaller and condensed. Also, the Next >> and << Prev buttons for cycling through screenshots have their button captions in this font (with textscale 0.23).

== For More ==
* Character-set coverage of Carleton family is included in the the [https://forums.thedarkmod.com/index.php?/topic/22427-analysis-of-212-tdm-fonts/ summary analysis of 2.12 TDM fonts], based on applying 'refont -stats ...' to all 'english' DAT files.

{{tutorial}} [[Category:Fonts]]

Carleton Fonts

2026-05-26T15:25:57Z

Geep: Changed tables, added Improvements to English Carleton 24pt in 2026

''By Geep, 2025. The analysis here as of TDM 2.12 and for "english" (including European) unless indicated otherwise.''

== The Carleton Family in a Nutshell ==
Carleton is a squarish print-style serif font. The lower case letters look like smaller versions of the upper case letters, so this font can also be referred to as "Carleton Caps", [[Fonts_Screenshots#Carleton_Caps_only | as in this screenshot]]. Within TDM, there are four members of the Carleton family:
* carleton
* carleton_bold
* carleton_condensed (i.e., more tightly spaced in the horizontal dimension)
* carleton_glow

Base-font carleton is used extensively throughout the main menu system. It may appear by itself, in black, for non-interactive subheadings and descriptions. (In a few places, like the "Downloadable Missions" title, a "headline" style using carleton_bold is deployed.)

Or it may participate in dynamic text highlighting for user interactions, using overlay combinations like:
* carleton and carleton_glow
* carleton_bold and carleton_glow, for titles and headlines
* carleton, carleton_bold and carleton_glow, for certain "new game" buttons

For FMs, there are standard readable sheet and scroll prefabs and sign text decals that use carleton, just by itself. The style of this font makes it a good choices for notices; between title and body, and upper and lower case, there can appear to be four different sizes of "capital" letters.

All these usages predominately involve mid-sized and large text (e.g., GUI textscale 0.24 and up), that draws on the 24pt and 48pt size bitmaps. The "english" form of 24pt and 48pt both offer TDM’s full European glyph set. Glyphs are stylishly done for 48pt and not bad for ASCII characters of 24pt; the accented characters of 24pt are rough-hewn and merely adequate.

While 48pt carleton_bold actually has bold (thickened) glyphs, 24pt carleton_bold glyphs are merely copies of regular 24pt carleton, so not bold.

== File Naming and Content Sharing across the Carleton Family ==
The four members share bitmap naming. For instance, if you examine any of the 4 derived fontimage_24.ref files, you see references like:

shaderName fonts/Carleton_0_24.tga

and it will say "Carleton_..." in all cases, not for instance "Carleton_condensed_...". (As is typically the case in TDM, a shader filetype of .tga actually resolves to .dds, and shaderName is case-insensitive; the actual filenames are all lower-case.)

There is also file content sharing (i.e., duplication). As shown in the tables below, the sharing pattern is more complex, and arguably incoherent. This may reflect errors in distribution, or perhaps some member/size combinations not really being used.

{| class="wikitable" style="margin-left: 0px; margin-right: auto;"
|+ '''Table of 2.12 English Carleton Family DAT Files Sharing File Names and in Some Cases Contents.''' The content of each file is unique, unless shown here by "SAME", which refers to only to matching another file’s content IN THE SAME ROW.
|-
! filename !! /carleton/ !! /carleton_bold/ !! /carleton_condensed/ !! /carleton_glow/
|-
| fontimage_12.dat || SAME || SAME || SAME || SAME
|-
| fontimage_24.dat || SAME || SAME || unique || SAME
|-
| fontimage_48.dat || SAME || SAME || unique || SAME
|}

The fontimage_24.dat files shown as '''SAME''' were updated for 2.15.

{| class="wikitable" style="margin-left: 0px; margin-right: auto;"
|+ '''Table of 2.12 & 2.15 English Carleton Family DDS Files Sharing File Names and in Some Cases Contents.''' The content of each file is unique, unless shown here by "SAME", which refers to only to matching another file’s content IN THE SAME ROW.
|-
! filename !! /carleton/ !! /carleton_bold/ !! /carleton_condensed/ !! /carleton_glow/
|-
| carleton_0_12.dds || SAME || unique || SAME || unique
|-
| carleton_0_24.dds || '''SAME''' || '''SAME''' || unique || '''SAME''' [was unique before 2.15]
|-
| carleton_1_24.dds || '''SAME''' || '''SAME''' || unique || '''SAME''' [was unique before 2.15]
|-
| carleton_2_24.dds [Added 2.15] || '''SAME''' || '''SAME''' || n/a || '''SAME'''
|-
| carleton_0_48.dds || SAME || unique || SAME || unique
|-
| carleton_1_48.dds || SAME || unique || SAME || unique
|-
| carleton_2_48.dds || SAME || unique || SAME || unique
|-
| carleton_3_48.dds || SAME || unique || SAME || unique
|-
| carleton_4_48.dds || SAME || unique || SAME || unique
|-
| carleton_5_48.dds || SAME || unique || SAME || unique
|-
| carleton_6_48.dds || SAME || unique || SAME || unique
|-
| carleton_7_48.dds || SAME || unique || SAME || unique
|}

The carleton_*_24 DDS files were updated for 2.15 (except for carleton_condensed).

== Bitmap File Sizes across the Carleton Family ==
The english 24pt DDS files '''shown in bold above''' have 512x512 bitmaps. All other files (including those for Russian, not in the table) have the default 256x256 bitmaps. This includes carleton_glow unless bolded. Observe that it is not required that the base & glow have identical bitmap sizes (although that is helpful to allow GIMP layering).

See also [[Refont#Carleton_Family]] for corresponding refont commands.

== Anomalies of Carleton and Carleton Bold 24pt Glyphs ==
As mentioned above, 24pt Carleton Bold is identical to 24pt Carleton; so not really bold. The remaining discussion applies equally to 24pt Carleton and Carleton Bold.

Evidently, the original generation of the 24pt size, into two 256x256 bitmaps "carleton_0_24.dds" and "carleton_1_24.dds", contained only ASCII alphanumeric characters and limited punctuation, with no accented/Latin-1 glyphs. Later, these bitmaps were scaled up to 512x512 bitmaps, to ease drawing in the missing characters by hand. The resulting new characters are coarser than the generated and scaled ASCII characters.

You can see this aspects in the main menu, under Settings/Video/Language, where, in the list of 16 languages, accented letters are thicker.

Also, if viewed in GIMP, the white characters have a faint black border, not seen elsewhere (e.g., in the 48pt bitmaps). This is true of both scaled-up ASCII and drawn Latin-1 characters, though far more prominent in the latter. However, TDM's monochrome, usually black rendering (defined by forecolor in the GUI) obscures the presence of this border effect. The purpose for it is discussed next.

== Carleton When Toggling Choices Within a Submenu ==
Throughout Setting submenus, the Carleton 24pt font is used within option lists. More generally, this presentation style is used for row items within lists.

For example, under Settings/Audio/, there is a row with "Main Menu Music" and a choice of "On" or "Off". This is implemented by a standardized choiceDef.
* On the left, the "Main Menu Music" phrase is carleton, rendered in translucent black (with alpha 0.85) and a textscale of 0.24 (which draws from 24pt).
* On the right, the "On" and "Off" text by default is the same, but slightly smaller at textscale 0.22 (also from 24pt).

When you mouse-hover, the current-value text turns momentarily white with a faint black border. The white is set, not by the GUI, but by the engine's "hoverColor", which is opaque white (1,1,1,1). The black border improves readability against the parchment background. It is due to the "anomolous" black border baked into the font, as discussed above.

''Aside: There is a GUI scripting text attribute "shadow", to draw black drop shadows (offset equally down and right) under font characters. This is not used in the main menu system. Within the engine, "shadow" invokes a "textShadow" boolean, false by default.''

== Improvements to English Carleton 24pt in 2026 ==
''This summarizes what is described in more detail [https://forums.thedarkmod.com/index.php?/topic/23109-improvements-to-carleton-24pt-font here]''

A number of problems needed correcting:
* some missing or bad glyphs
* glyphs lacking their accents
* many "ugly" badly-drawn glyphs
* suboptimal vertical/horizontal placement
* clipping

For TDM 2.15, all 256 of TDM's English/European codepoints, including accents, were implemented,. Ugly glyphs were replaced by fresh ones regenerated from TTF; dev tools were updated to facilitate that. Placement/spacing, and clipping were generally improved, involving both bitmap and DAT tweaks.

The new system (after a false start) uses three 512x512 bitmaps instead of two.

The previous custom carleton_glow 24pt set of bitmaps with smudged glyphs is no longer used. Instead, a copy of carleton 24pt bitmaps is used for carleton_glow (as well as carleton_bold per previous). Thus, the "glow" relies ''solely'' on the main-menu's simulated "drop shadow" effect (due to overlapped offset GUI defWindows).

Carleton_condensed 24pt font was considered deprecated and not touched by this redo.

== Carleton & Carleton Glow in the Main Menu System ==
This pairing occurs basically everywhere thorough the main menu system. In a typical presentation, against a parchment background, major menu-page-selection keywords are by default rendered in black with no glow. But they will turn white with blood-red glow highlighting when either selected (as if a tab for the current page) or moused-over. This will also play a sound and often show a text hint.

=== Example Implementation ===
TDM uses a number of different "button" (i.e., selectable text) styles, driven by #defines in \tdm_gui01\guis\mainmenu_defs.gui. For example, those of the main menu home page use:
#define MM_NORMAL_FONT "fonts/carleton"
#define MM_GLOW_FONT "fonts/carleton_glow"
#define MM_FONTSCALE 0.33
#define MM_BUTTON_HEIGHT 18

For colors, the text is black initially, with glow highlighting invisible. Upon mouse hover, the text becomes white, and the glow red. RGBA colors are defined for this, in vector and string (with S prefix) forms:

#define NORMAL_COLOR 0,0,0,0.90 // black, not entirely opaque
#define SNORMAL_COLOR "0 0 0 0.90"
#define INVISIBLE 0, 0, 0, 0
#define SINVISIBLE "0 0 0 0"
#define GLOW_WHITE_COLOR 0.98,0.93,0.82,1
#define SGLOW_WHITE_COLOR "0.98 0.93 0.82 1"
#define GLOW_RED_COLOR 0.6,0.1,0.1,0.5 // semi-transparent
#define SGLOW_RED_COLOR "0.6 0.1 0.1 0.5"

To be specific, consider a simplified imaginary main menu "button" we'll call "Simple". (We're avoiding the layout calculations and other complications of a real button.) For our button, there are 3 aligned windowDefs in mainmenu_defs.gui, with these locations:

#define MM_POS_SIMPLE_BUTTON rect 40, 445, 160, MM_BUTTON_HEIGHT * 1.3
#define MM_POS_SIMPLE_BUTTON_GLOW rect 41, 446, 159, MM_BUTTON_HEIGHT * 1.3 - 1
#define MM_POS_SIMPLE_ACTION MM_POS_SIMPLE_BUTTON

The windowDefs positioned by these will also do the following:
* MM_POS_SIMPLE_BUTTON: set the default appearance of the button text.
* MM_POS_SIMPLE_BUTTON_GLOW: set the default appearance of the glow "highlight" text. Note this text is offset down and to the right by one pixel, compared to MM_POS_SIMPLE_BUTTON, to give the glow a "drop shadow" flavor. This is a frequent treatment, though in some cases only the right shift is done.
* MM_POS_SIMPLE_ACTION defines the mouse-over and mouse-selection dynamic behaviors. (Be aware that in some actual cases, this is combined into the first windowDef.)

Then, besides the rects, the other attributes are defined for the two default windowDefs:

#define MM_FONT font MM_NORMAL_FONT forecolor SNORMAL_COLOR textscale MM_FONTSCALE visible 1 textalign 1 // centered text
#define MM_FONT_GLOW font MM_GLOW_FONT forecolor INVISIBLE textscale MM_FONTSCALE visible 1 textalign 1

(This is a simplification; for the main menu, MM_FONT's forecolor is #defined as INVISIBLE, then transitions to SNORMAL_COLOR in 1/2 second.)

Within an overall page layout given by mainmenu_main.gui (but with our button shoved in), we might have nested:

windowDef SimpleTextH
{
rect MM_POS_SIMPLE_BUTTON_GLOW
MM_FONT_GLOW
visible "gui::showSimple"
text "#str_01234" // "Simple"
}
windowDef SimpleText
{
rect MM_POS_SIMPLE_BUTTON
MM_FONT
visible "gui::showSimple"
text "#str_01234" // "Simple"
}
windowDef SimpleAction
{
rect MM_POS_SIMPLE_ACTION
visible "gui::showSimple"
float exit;

onMouseEnter
{
set "exit" 0;
transition "SimpleText::forecolor" SNORMAL_COLOR SGLOW_WHITE_COLOR "50" ;
transition "SimpleTextH::forecolor" SINVISIBLE SGLOW_RED_COLOR "50" ;
set "cmd" "play sound/meta/menu/mnu_hover";
}

onMouseExit
{
if ("exit" == 0)
{
transition "SimpleText::forecolor" SGLOW_WHITE_COLOR SNORMAL_COLOR "50" ;
transition "SimpleTextH::forecolor" SGLOW_RED_COLOR SINVISIBLE "50" ;
}
}

onAction
{
transition "SimpleText::forecolor" SGLOW_WHITE_COLOR SNORMAL_COLOR "50" ;
transition "SimpleTextH::forecolor" SGLOW_RED_COLOR SINVISIBLE "50" ;

set "cmd" "play sound/meta/menu/mnu_select;";
set "cmd" "onSimpleClicked"; // tell engine

// And any additional commands here to switch states, resetTime, etc.
}
}

The "H" (highlighted) windowDef is shown first, to draw behind the main text. onMouseEnter turns the text color from black to white in 50 milliseconds, and the glow from invisible to red. onMouseExit reverses that. onAction, when the button is mouse-selected, does the visual transition as mouse exit, but plays a different sound... and then does whatever "Simple" is supposed to do.

== Carleton in Assets for FMs ==
In the tables below, most content has a textscale above 0.30, so draws from the 48pt size, '''indicated in bold'''. Otherwise, with a textscale of 0.16 to 0.30, from 24pt.

{| class="wikitable" style="margin-left: 0px; margin-right: auto;"
|+ '''Carleton in Standard Readable Prefabs.'''
Within \tdm_prefabs01\xdata\prefabs.xd, "gui_page<n>" : "guis/readables/..."
|-
! Prefab !! Title textscale !! Body textscale
|-
| .../books/... none || ||
|-
| .../scrolls/scroll_print_carleton.gui || '''0.40''' || 0.28
|-
| .../sheets/sheet_paper_print_carleton_caps.gui || '''0.40''' || '''0.31'''
|}

{| class="wikitable" style="margin-left: 0px; margin-right: auto;"
|+ '''Carleton in Sign Text.''' Within \sign_text_decals\
|-
! Decal !! Textscale
|-
| sign_text_carleton.gui || '''2'''
|-
| sign_text_carleton_small.gui || '''1'''
|}

== Carleton_condensed ==
As indicated above, Carleton_condensed DDS files are all 256x256.

=== 12pt Size ===
''The main menu system does not use this size. In your FM, it is recommended to NOT invoke 12pt carleton_condensed (i.e., by specifying a GUI textscale of 0.15 or less). Instead, use regular carleton, possibly with a slightly smaller textscale.''

Although 12pt carleton_condensed exists, its DAT file and single DDS file are mere placeholders that are identical to those of carleton 12pt.

=== 48pt Size ===
''The main menu system does not use this size. In your FM, it is recommended to NOT invoke 48pt carleton_condensed (i.e., by specifying a GUI textscale of above 0.30). Instead, use regular carleton, possibly with a slightly smaller textscale.''

The set of eight DDS files for 48pt carleton_condensed are identical to those for 48pt carleton. However, the DAT file has different content, though the difference is not due to horizontal "condensation".

A one time, Tels drafted a Font Patcher command file for 48pt carleton_condensed, to reduce the width and xSkip of a selected subset of the carleton’s ASCII alphanumeric characters, presumably those most generously spaced to begin with. Evidently this was not finalized and deployed. Instead, inspection of the current 48pt DAT file for carleton_condensed suggests it was based on an early version of carleton, at a time when only some of the accented characters were implemented. (In particular, the DAT lacks re-implemented metrics for chars 128-139 and 145-155.)

=== 24pt Size ===
''The main menu system uses this, but sparingly. Since a "glow" form of carleton_condensed was never developed, only regular non-glow uses are applicable.''

The contents of the DAT file and the set of two DDS files for 48pt carleton_condensed DIFFER from those for 48pt carleton.

For the main menu system, where carleton was used for English-language players, the more-compact carleton_condensed was briefly considered as a method of accommodating European language translations. However, this would require dynamic language switching, and was found to be a hill too far, compared to just reducing Carleton’s textscale value.

The actual limited uses in the main menu systems are seen as you survey the downloadable missions. Specifically, when looking at a candidate mission, the Mission Details page has a Description section, whose body text is carleton_condensed with textscale 0.17. Compared to other similar text section here (that use regular carleton with textscale 0.18), this is slightly smaller and condensed. Also, the Next >> and << Prev buttons for cycling through screenshots have their button captions in this font (with textscale 0.23).

== For More ==
* Character-set coverage of Carleton family is included in the the [https://forums.thedarkmod.com/index.php?/topic/22427-analysis-of-212-tdm-fonts/ summary analysis of 2.12 TDM fonts], based on applying 'refont -stats ...' to all 'english' DAT files.

{{tutorial}} [[Category:Fonts]]

The Parts and Whole: DR Layers

2026-05-23T21:11:43Z

Geep: /* See Also */ add link to Layers

''By Geep 2022''
==Introduction==
In a hurry? See [https://www.darkradiant.net/userguide/#_using_layers Using Layers, in the DR User Manual].

In what follows, LMB and RMB are abbreviations for left and right mouse buttons.

A "Layer" is any arbitrary collection of map objects; you define it by giving it a name (in the Layers viewer) and assigning each object to it (from the RMB menu). Once established, a Layer’s objects can be quickly made visible or not, or selected/deselected. An object can be assigned to multiple Layers. Unassigned objects are considered to be in the "Default" Layer. Any Layer can be set as the current "Active Layer", to which newly-created objects are automatically assigned.

Unlike Filters, the use of Layers requires active organizing by you, but provides powerful itemized control. Layers, once created, can persist throughout your project, available to use over and over again. Layers only affect DR, not your FM. Their data is stored in the map/<FM>.darkradiant file.

==Typical Uses==
A Layer can be defined based upon any arbitrary criteria (e.g., location, machine parts, difficulty level, and so on). Thus, a Layer is not necessarily a "layer" in a spatial sense, although it can be used in that way; for example, to create a separate Layer for each floor of a mansion.

One good use of a Layer is to hide geometric objects that are particularly "busy", with a lot of wireframe lines that can obscure other objects in orthogonal views. Some examples:
* Fences and gates with brush bars
* Stairs
* Ground patches

Another use is with complicated ensembles, like a machine with many static and moving parts. This is as an alternative - or even supplement - to putting the parts in an anonymous DR Group.

Layer objects can be anything you can select in your map, including path corners, triggers, AI, visportals and so on. But consider: the visibility of some of these may be adequately managed by Filters alone.

While an object can be assigned to multiple Layers, you can make it your policy to just assign each object to a single layer, if you wish.

==Seeing Layers – the Layers Viewer==
You can bring up the "Layers" viewer by either:
* the top menu’s View/Layers
* keyboard shortcut Ctrl+L

Once open, you’ll see the list of defined layers (only “Default” for a new project), where each row has the following items left to right:
* A button (with tooltip "Toggle layer visibility") that show one of 4 states:
** Blue with checkmark icon = this Layer is currently visible
** Blue with star icon = this Layer is currently visible, and "active", i.e., newly created (but not cloned) objects will be automatically assigned to it.
** Gray with no icon = this Layer is currently hidden
** Gray with star icon = this Layer is currently hidden, but will become the active Layer when "Show all" occurs.
* A slim color swatch. This is red for all Layers that the current selection(s) belong to; otherwise gray. Tooltip: "Indicates whether anything among the current selection is part of this layer".
* The name field, read-only. With tooltip: "Click to select all in layer, hold SHIFT to deselect, hold CTRL to set as active layer."
* A button with a pencil icon (tootip: "Rename this layer", to make the name field editable, except for "Default".
* A button with a red X icon (tooltip: "Delete this layer"), except for "Default". This just deletes the layer, not the objects. Objects that were only assigned to that deleted Layer will be reassigned to "Default".

At the bottom are 3 large buttons: "New" (with a plus sign), "Show all", and "Hide all".

==Visibility of Objects in a Layer==
Hiding an object by either a Filter or View’s Hide/Show will take priority over its visibility due to Layers.
An object can be a member of multiple Layers. Assuming it’s not hidden by Filter or Hide/Show, then if any of its Layers are visible, it is too.

==Selecting All Objects in a Layer==
As just indicated, you can LMB on a Layer’s name field to select all its objects (or Shift+LMB to deselect). Alternatively, you can "Hide all" Layers, show the Layer of interest, then Edit/Invert selection (keyboard shortcut "I").

==Thinking about Naming==
Before you start creating Layers, think a little about what naming convention you want to use. In the Layer viewer, the Layers will always be shown in alphabetical order, and that may be a consideration. Don’t obsess about this; you can always evolve names later. It is seldom useful to have the word "Layer" as part of a name.

==Creating a Layer==
There are two ways to do this:
* In the Layers viewer, hit "New"
* In a map orthogonal view, RMB and "Create Layer…". (Any map object selected before doing this makes no difference.)

Either will bring up a dialog box to enter the Layer name. Subsequently, in the Layers viewer, the new row will appear in alphabetical order.

==Managing Layer Assignments of Existing Objects==
You can perform actions here with or without the Layers viewer open.
With one or more map objects selected, in the orthogonal view, use RMB. There are 3 menu items
* "Add to Layer >". Adds the object(s) to a specified layer, without affecting any of its other Layer assignments. So, if an object is already in "Default" and you assign it "Ground Floor", it will then be in both Layers.
* "Move to Layer >". Adds the object(s) to a specified layer, and removes any of its assignments to other Layers (except for the one newly specified). So caution: any objects that previously were in multiple Layers are now not… if this is not what you want, take further action.
* "Remove from Layer >". Removes the object(s) from a specified layer, without affecting any of its other Layer assignments.

For each of these, further mouse navigation will show the current layer names in a sub-menu. Choose one with LMB.

==Auto-Assigning New Objects using the Active Layer==
When a new map object is created by copying (aka cloning) another object (e.g., with keyboard Space), it automatically gets the source object’s Layer assignment(s).

If instead, a map object is created afresh, it is assigned to the current "active" (i.e., starred) Layer, which is usually "Default", but not always. As discussed next, you can manipulate the star, to speed up assignment of multiple new objects to a particular layer.

==Managing the Active (Starred) Layer==
In the Layers viewer, usually, the "Default" layer has the star, so that newly created map objects (except when copied) are auto-assigned to that layer. You can move the star to a different layer. Quickest way:

Ctrl+LMB on the name field you want to use for auto-assignment. The left button becomes starred.
Another easy way is by hiding all Layers except the one you want active:
# Press “Hide all”. Then all the layer row left buttons will be grayed out. All will be iconless, except "Default" will be starred.
# Hit the leftmost button in the row you want to use for auto-assignment. This Layer becomes visible, and its button will turn blue + starred.
# If you wish, make other rows individually visible, or hit “Show all”. The row starred in (2) remains starred.

Choice of Active Layer is somewhat temporary, in that, if you hide it (either individually or by using "Hide all"), the star always reverts back to "Default". However, the setting will persist across closing and opening the Layers viewer.

==Custom DR Scripting of Layers==
If you need special functionality, DR offers Python scripting, and in particular for Layers exposes a GlobalLayerManager (including LayerVisitor) API with about 2 dozen function calls. See [https://wiki.thedarkmod.com/index.php?title=DarkRadiant_Script_Reference the DarkRadiant Script Reference].

==See Also==
* [[Layers]], for another take on this topic.
* [[The Parts and Whole: Overview]]

{{Editing}}

Layers

2026-05-23T21:09:57Z

Geep: /* See Also */ section added with link to DR Layers]

== Overview ==
[[Image:LayerInspector.jpg|thumb|368px|right|The layer inspector]]
The idea of layers to organize and simplify the users experience in editing media is not a new one. Most image editing software like Photoshop or The Gimp have this feature as well as several 3D modeling/mapping programs, including Dark Radiant, of course. If you are new to the concept of layers, just imagine them as a convenient way to hide elements that are currently in the way.
Please note that layers are only a tool to organize your map, they have no effect in the game.

[[Image:Layers_enabled.jpg|368px|thumb|right|Without layers, working in this cluttered space would be a nightmare...]]
== The Layer Inspector ==
To use Dark Radiant's layer feature, open the layer inspector with the default shortcut {{Key|Ctrl+L}} or via the View->Layers menu entry. If you haven't tinkered with layers yet you should see a list with exactly one entry called ''Default'' (unlike in the screenshot to the right). This is the layer that Dark Radiant automatically creates for you when you begin a new map and that every element belongs to unless you reassign it. It is in every map and can not be removed.

In the layer inspector window you can do the following things:
* By clicking on the checkbox to the left of the layer name you can show/hide a layer respectively it's elements
* Clicking the layer name itself will select/deselect all members of that layer.
* The two buttons to the right of the layer name allow you to change it's name and to delete a layer (in that order). If you delete a layer, it's elements will not be removed from the map, but assigned to the Default layer instead.
* Click on ''New'' to create a new layer. You'll be prompted to give it a unique and - preferably - meaningful name.

[[Image:Layers_disabled.jpg|368px|thumb|right|...but with most of the layers hidden from view everything becomes clear again.]]
== How to Assign Elements to Layers ==
Select one or more elements and then right click anywhere in the orthogonal view. At the bottom of the context menu you should see the following items:
* '''Create Layer...''': Same as ''New'' in the layer inspector.
* '''Add to Layer...''': If you add something to a layer, it will become a member of this layer but also remains in the layers it already belongs to.
* '''Move to Layer...''': Same as above, but the element will exclusively be a member of the newly assigned layer.
* '''Remove from Layer...''': Removes an element from a layer. Note that the list shows all layers, not only those that the selected element is a member of.

== Alternatives ==
There are no real alternatives to layers but three very convenient companions that you may use alongside:
* Select anything you don't want to see and press {{Key|H}} to hide it from view. Press {{Key|Shift+H}} to show it again. If you hide a selection then all the elements you hid previously will remain invisible.
* With [[Defining custom Filters in DarkRadiant|filters]] you can hide specific kinds of entities or textures by using [http://en.wikipedia.org/wiki/Regex regular expressions].
{{editing}}{{darkradiant}}
* With "Selection Focus" you can select some things, go into "Selection Focus" mode (Default key Ctrl-F, if you want to modify the key, it's named "ToggleSelectionFocus") and then you can modify those things without being able to select and modify surrounding elements in the map, but the surroundings are still visible when "Selection focus" is active, while with filters and layers other things get hidden in order to focus on specific things.

== See Also ==
For another take on layers, see [[The_Parts_and_Whole:_DR_Layers]].

I18N - Charset

2026-05-11T19:14:12Z

Geep: /* Coverage Expansion & Remaining Limitations */

== Introduction ==

The D3 code that handles the GUI bitmap font can only load a specific range of bytes as characters. To get the most out of the available entries, special charsets are used. The fonts (Carleton for the menu f.i.) are build/patched so that the right characters appear in the right place.

== Encodings ==

=== all.lang ===

This file is in '''UTF-8''', and converted with the help of either the script '''devel/gen_lang.pl''':

perl devel/gen_lang.pl

or, more recently, the Windows C++ utility program '''gen_lang_plus'''. [[Gen_Lang_Programs]] has details of these.

This process ensures that the generated language files are in their proper encodings (see below).

=== All other language files ===

Note that the language files (f.i. '''strings/german.lang''') as well as the readables and the FM dictionariaries are expected to be in the following encodings:

* '''Czech''', '''Hungarian''', '''Slovak''', '''Polish:''' [https://secure.wikimedia.org/wikipedia/en/wiki/ISO/IEC_8859-2 ISO-8859-2] ('''not WIN-1250!)
* '''Russian:''' [https://secure.wikimedia.org/wikipedia/en/wiki/Win-1251 WIN-1251]
* '''French:''' [https://secure.wikimedia.org/wikipedia/en/wiki/ISO/IEC_8859-15 ISO-8859-15]
* '''Romanian:''' [https://secure.wikimedia.org/wikipedia/en/wiki/ISO/IEC_8859-16 ISO-8859-16]
* '''All other languages:''' [https://secure.wikimedia.org/wikipedia/en/wiki/ISO/IEC_8859-1 ISO-8859-1] (German, Dutch, Danish, Swedish, Portuguese, etc.)

{{infobox|The core dictionaries are automatically generated in the right encoding, but make sure that you use the right encoding for the FM dictionary, too!}}

== Character remapping ==

The characters are remapped upon loading the dictionary/readable, from their native encoding to the special one that TDM uses and that is described here. Responsible for the remapping are [[I18N - Character mapping|mapping files]], f.i. "strings/czech.map". If a map file for a specific language is not found, "strings/default.map" is used instead, if this is not found, no remapping takes place.

See '''[[I18N - Character mapping|Character mapping]]''' for more information.

=== European Languages ===

This mapping is used for European languages, f.i. '''Czech''', '''French''', '''German''', '''Spanish''', '''Portuguese''', '''Polish'''. Note that the double accented characters in Hungarian '''Ő, ő, Ű and ű''' look a bit different from '''Ö, ö, Ü and ü'''!

In the table below, the original ISO 8859-1 characters are given in ''()'' below the TDM character.

'''Color code:'''

{{box|#f0d0d0|Character not usable by TDM|Unusable}}{{box|#d0e0d0|Character not yet used in TDM|Unused}}{{box|#c0ffc0|Character displayed in v1.08 or newer|Usable in v1.08}}{{box|#80f080|Character displayed in v2.03 or newer|Usable in v2.03}}{{box|#d0d0f0|Changed from the ISO-8859-1 default, usable by TDM 1.0 or newer|Changed from ISO 8859-1}}

{|class="wikitable" border=1 style="border-collapse: collapse; font-size: 95%" cellspacing=0 cellpadding=2 width=100%

|-
!
!…0
!…1
!…2
!…3
!…4
!…5
!…6
!…7
!…8
!…9
!…A
!…B
!…C
!…D
!…E
!…F

|-
!0…
|align='center' style='background: #f0d0d0'|00 '''–'''
|align='center' style='background: #f0d0d0'|01 '''–'''
|align='center' style='background: #f0d0d0'|02 '''–'''
|align='center' style='background: #f0d0d0'|03 '''–'''
|align='center' style='background: #f0d0d0'|04 '''–'''
|align='center' style='background: #f0d0d0'|05 '''–'''
|align='center' style='background: #f0d0d0'|06 '''–'''
|align='center' style='background: #f0d0d0'|07 '''–'''
|align='center' style='background: #f0d0d0'|08 '''–'''
|align='center' style='background: #f0d0d0'|09 '''–'''
|align='center' style='background: #f0d0d0'|0A '''–'''
|align='center' style='background: #f0d0d0'|0B '''–'''
|align='center' style='background: #f0d0d0'|0C '''–'''
|align='center' style='background: #f0d0d0'|0D '''–'''
|align='center' style='background: #f0d0d0'|0E '''–'''
|align='center' style='background: #f0d0d0'|0F '''–'''

|-
!1…
|align='center' style='background: #f0d0d0'|10 '''–'''
|align='center' style='background: #f0d0d0'|11 '''–'''
|align='center' style='background: #f0d0d0'|12 '''–'''
|align='center' style='background: #f0d0d0'|13 '''–'''
|align='center' style='background: #f0d0d0'|14 '''–'''
|align='center' style='background: #f0d0d0'|15 '''–'''
|align='center' style='background: #f0d0d0'|16 '''–'''
|align='center' style='background: #f0d0d0'|17 '''–'''
|align='center' style='background: #f0d0d0'|18 '''–'''
|align='center' style='background: #f0d0d0'|19 '''–'''
|align='center' style='background: #f0d0d0'|1A '''–'''
|align='center' style='background: #f0d0d0'|1B '''–'''
|align='center' style='background: #f0d0d0'|1C '''–'''
|align='center' style='background: #f0d0d0'|1D '''–'''
|align='center' style='background: #f0d0d0'|1E '''–'''
|align='center' style='background: #f0d0d0'|1F '''–'''

|-
!2…
|align='center'|20 ''' '''
|align='center'|21 '''!'''
|align='center'|22 '''"'''
|align='center'|23 '''#'''
|align='center'|24 '''$'''
|align='center'|25 '''%'''
|align='center'|26 '''&'''
|align='center'|27 '''''''
|align='center'|28 '''('''
|align='center'|29 ''')'''
|align='center'|2A '''*'''
|align='center'|2B '''+'''
|align='center'|2C ''','''
|align='center'|2D '''-'''
|align='center'|2E '''.'''
|align='center'|2F '''/'''

|-
!3…
|align='center'|30 '''0'''
|align='center'|31 '''1'''
|align='center'|32 '''2'''
|align='center'|33 '''3'''
|align='center'|34 '''4'''
|align='center'|35 '''5'''
|align='center'|36 '''6'''
|align='center'|37 '''7'''
|align='center'|38 '''8'''
|align='center'|39 '''9'''
|align='center'|3A ''':'''
|align='center'|3B ''';'''
|align='center'|3C '''<'''
|align='center'|3D '''='''
|align='center'|3E '''>'''
|align='center'|3F '''?'''

|-
!4…
|align='center'|40 '''@'''
|align='center'|41 '''A'''
|align='center'|42 '''B'''
|align='center'|43 '''C'''
|align='center'|44 '''D'''
|align='center'|45 '''E'''
|align='center'|46 '''F'''
|align='center'|47 '''G'''
|align='center'|48 '''H'''
|align='center'|49 '''I'''
|align='center'|4A '''J'''
|align='center'|4B '''K'''
|align='center'|4C '''L'''
|align='center'|4D '''M'''
|align='center'|4E '''N'''
|align='center'|4F '''O'''

|-
!5…
|align='center'|50 '''P'''
|align='center'|51 '''Q'''
|align='center'|52 '''R'''
|align='center'|53 '''S'''
|align='center'|54 '''T'''
|align='center'|55 '''U'''
|align='center'|56 '''V'''
|align='center'|57 '''W'''
|align='center'|58 '''X'''
|align='center'|59 '''Y'''
|align='center'|5A '''Z'''
|align='center'|5B '''['''
|align='center'|5C '''\'''
|align='center'|5D ''']'''
|align='center'|5E '''^'''
|align='center'|5F '''_'''

|-
!6…
|align='center'|60 '''`'''
|align='center'|61 '''a'''
|align='center'|62 '''b'''
|align='center'|63 '''c'''
|align='center'|64 '''d'''
|align='center'|65 '''e'''
|align='center'|66 '''f'''
|align='center'|67 '''g'''
|align='center'|68 '''h'''
|align='center'|69 '''i'''
|align='center'|6A '''j'''
|align='center'|6B '''k'''
|align='center'|6C '''l'''
|align='center'|6D '''m'''
|align='center'|6E '''n'''
|align='center'|6F '''o'''

|-
!7…
|align='center'|70 '''p'''
|align='center'|71 '''q'''
|align='center'|72 '''r'''
|align='center'|73 '''s'''
|align='center'|74 '''t'''
|align='center'|75 '''u'''
|align='center'|76 '''v'''
|align='center'|77 '''w'''
|align='center'|78 '''x'''
|align='center'|79 '''y'''
|align='center'|7A '''z'''
|align='center'|7B '''{'''
|align='center'|7C '''|'''
|align='center'|7D '''}'''
|align='center'|7E '''~'''
|align='center' style='background: #d0e0d0'|7F '''�'''

|-
!8…
|align='center' style='background: #c0ffc0'|80 '''Ň'''
|align='center' style='background: #c0ffc0'|81 '''Ś'''
|align='center' style='background: #c0ffc0'|82 '''Ć'''
|align='center' style='background: #c0ffc0'|83 '''Ż'''
|align='center' style='background: #c0ffc0'|84 '''Ź'''
|align='center' style='background: #c0ffc0'|85 '''Ŝ'''
|align='center' style='background: #c0ffc0'|86 '''Ĉ'''
|align='center' style='background: #c0ffc0'|87 '''Ẑ'''
|align='center' style='background: #c0ffc0'|88 '''Ô''' [1]
|align='center' style='background: #c0ffc0'|89 '''Ŕ'''
|align='center' style='background: #c0ffc0'|8A '''Ǔ'''
|align='center' style='background: #c0ffc0'|8B '''Ă'''
|align='center' style='background: #c0ffc0'|8C '''Ń'''
|align='center' style='background: #80f080'|8D '''Ș'''
|align='center' style='background: #80f080'|8E '''Ț'''
|align='center' style='background: #d0e0d0'|8F '''�'''

|-
!9…
|align='center' style='background: #80f080'|90 '''đ'''
|align='center' style='background: #c0ffc0'|91 '''ś'''
|align='center' style='background: #c0ffc0'|92 '''ć'''
|align='center' style='background: #c0ffc0'|93 '''ż'''
|align='center' style='background: #c0ffc0'|94 '''ź'''
|align='center' style='background: #c0ffc0'|95 '''ŝ'''
|align='center' style='background: #c0ffc0'|96 '''ĉ'''
|align='center' style='background: #c0ffc0'|97 '''ẑ'''
|align='center' style='background: #c0ffc0'|98 '''ô''' [1]
|align='center' style='background: #c0ffc0'|99 '''ŕ'''
|align='center' style='background: #c0ffc0'|9A '''ǔ'''
|align='center' style='background: #c0ffc0'|9B '''ă'''
|align='center' style='background: #c0ffc0'|9C '''ń'''
|align='center' style='background: #80f080'|9D '''ș'''
|align='center' style='background: #80f080'|9E '''ț'''
|align='center' style='background: #d0e0d0'|9F '''�'''

|-
!A…
|align='center'|A0 '''[https://secure.wikimedia.org/wikipedia/en/wiki/Non-breaking_space NBSP]''' [2]
|align='center' style='background: #d0d0f0'|A1 '''ň''' (¡)'''
|align='center' style='background: #d0d0f0'|A2 '''Ű''' (¢)'''
|align='center' style='background: #d0d0f0'|A3 '''ě''' (£)'''
|align='center' style='background: #d0d0f0'|A4 '''ű''' (¤)'''
|align='center' style='background: #d0d0f0'|A5 '''Ě''' (¥)'''
|align='center' style='background: #d0d0f0'|A6 '''Š''' (¦)'''
|align='center'|A7 '''§'''
|align='center' style='background: #d0d0f0'|A8 '''š''' (¨)'''
|align='center' style='background: #d0d0f0'|A9 '''Ů''' (©)'''
|align='center' style='background: #d0d0f0'|AA '''Ą''' (ª)'''
|align='center' style='background: #d0d0f0'|AB '''Ę''' («)'''
|align='center' style='background: #d0d0f0'|AC '''Č''' (¬)'''
|align='center'|AD '''[https://secure.wikimedia.org/wikipedia/en/wiki/Soft_hyphen SHY]''' [2]
|align='center' style='background: #d0d0f0'|AE '''č''' (®)'''
|align='center' style='background: #d0d0f0'|AF '''ů''' (¯)'''

|-
!B…
|align='center' style='background: #d0d0f0'|B0 '''Ő''' (°)'''
|align='center' style='background: #d0d0f0'|B1 '''Ł''' (±)'''
|align='center' style='background: #d0d0f0'|B2 '''Ť''' (²)'''
|align='center' style='background: #d0d0f0'|B3 '''Ď''' (³)'''
|align='center' style='background: #d0d0f0'|B4 '''Ž''' (´)'''
|align='center' style='background: #d0d0f0'|B5 '''ł''' (µ)'''
|align='center' style='background: #d0d0f0'|B6 '''ť''' (¶)'''
|align='center' style='background: #d0d0f0'|B7 '''ď''' (·)'''
|align='center' style='background: #d0d0f0'|B8 '''ž''' (¸)'''
|align='center' style='background: #d0d0f0'|B9 '''ő''' (¹)'''
|align='center' style='background: #d0d0f0'|BA '''ą''' (º)'''
|align='center' style='background: #d0d0f0'|BB '''ę''' (»)'''
|align='center' style='background: #d0d0f0'|BC '''Œ''' (¼)'''
|align='center' style='background: #d0d0f0'|BD '''œ''' (½)'''
|align='center' style='background: #d0d0f0'|BE '''Ÿ''' (¾)'''
|align='center'|BF '''¿'''

|-
!C…
|align='center'|C0 '''À'''
|align='center'|C1 '''Á'''
|align='center'|C2 '''Â'''
|align='center'|C3 '''Ã'''
|align='center'|C4 '''Ä'''
|align='center'|C5 '''Å'''
|align='center'|C6 '''Æ'''
|align='center'|C7 '''Ç'''
|align='center'|C8 '''È'''
|align='center'|C9 '''É'''
|align='center'|CA '''Ê'''
|align='center'|CB '''Ë'''
|align='center'|CC '''Ì'''
|align='center'|CD '''Í'''
|align='center'|CE '''Î'''
|align='center'|CF '''Ï'''

|-
!D…
|align='center'|D0 '''Ð'''
|align='center'|D1 '''Ñ'''
|align='center'|D2 '''Ò'''
|align='center'|D3 '''Ó'''
|align='center'|D4 '''Ô'''
|align='center'|D5 '''Õ'''
|align='center'|D6 '''Ö'''
|align='center' style='background: #d0d0f0'|D7 '''Ř''' (×)'''
|align='center'|D8 '''Ø'''
|align='center'|D9 '''Ù'''
|align='center'|DA '''Ú'''
|align='center'|DB '''Û'''
|align='center'|DC '''Ü'''
|align='center'|DD '''Ý'''
|align='center'|DE '''Þ'''
|align='center'|DF '''ß'''

|-
!E…
|align='center'|E0 '''à'''
|align='center'|E1 '''á'''
|align='center'|E2 '''â'''
|align='center'|E3 '''ã'''
|align='center'|E4 '''ä'''
|align='center'|E5 '''å'''
|align='center'|E6 '''æ'''
|align='center'|E7 '''ç'''
|align='center'|E8 '''è'''
|align='center'|E9 '''é'''
|align='center'|EA '''ê'''
|align='center'|EB '''ë'''
|align='center'|EC '''ì'''
|align='center'|ED '''í'''
|align='center'|EE '''î'''
|align='center'|EF '''ï'''

|-
!F…
|align='center'|F0 '''ð'''
|align='center'|F1 '''ñ'''
|align='center'|F2 '''ò'''
|align='center'|F3 '''ó'''
|align='center'|F4 '''ô'''
|align='center'|F5 '''õ'''
|align='center'|F6 '''ö'''
|align='center' style='background: #d0d0f0'|F7 '''ř''' (÷)'''
|align='center'|F8 '''ø'''
|align='center'|F9 '''ù'''
|align='center'|FA '''ú'''
|align='center'|FB '''û'''
|align='center'|FC '''ü'''
|align='center'|FD '''ý'''
|align='center'|FE '''þ'''
|align='center'|FF '''ÿ'''

|}

==== Table Notes ====

'''[1]''' As discussed [https://forums.thedarkmod.com/index.php?/topic/22427-analysis-of-212-tdm-fonts/&do=findComment&comment=494855 here], the TDM char set has a redundant treatment of 2 characters:

* Ô appears at 0x88 and 0xD4
* ô appears at 0x98 and 0xF4

Starting with TDM 2.13, the redundancy can be removed and these new characters (from ISO-8859-3) introduced:

* Ğ appears at 0x88
* ğ appears at 0x98

'''[2]''' Avoid using the non-breaking space (NBSP, 0xA0) and the soft hyphen (SHY, 0xAD) in your strings. The TDM engine has no code to respect these during word wrap. Font maintainers: probably map NBSP to the <space> glyph, SHY to undefined/hollow box or zero-sized box.

==== Corresponding Unicode ====

For a mapping of these 256 codepoints to Unicode U+NNNN values and formal names, download 'TDM 8859-Style Font Map to Unicode-16.txt':

* [https://drive.google.com/file/d/1wLEtuFvnrZ-WHK8ign8i3diIXZdriZ4F/view?usp=sharing for TDM 2.13]
* [https://drive.google.com/file/d/1UAz9jSZpT_j33STP3So_Re8JWa8QuAmz/view?usp=sharing for TDM 2.12 and earlier]

Each of these files (by Geep, 2024) is in a standardized format so that it can also be imported into font design programs like FontForge as a custom 256-position map. In the comments, there is additional information about:
* ISO 8859-x sourcing of each character.
* alternative representations of some European and control characters.

==== Fonts with Special Characters ====
Certain fonts have a few codepoints that purposefully diverge from the table entry.

* Carleton font (regular, bold, glow) uses codepoint 0x23, ordinarily "#", to represent "superscript #", which is used in the main menu system to indicate FMs for which a translation pack is available.
* Treasure Map font has characters for "pirate skull and crossbones" and "bottle of booze (or poison)".

=== Russian ===

Characters conform to the [https://en.wikipedia.org/wiki/Win-1251 WIN-1251 native encoding, shown in the Wikipedia article]. Exception: the character '''0xFF''' (я) is mapped to '''0xB6''' upon loading. Therefore any Russian font must contain я at the place 0xB6.

Within any given font, character overage may be incomplete. A 2025 effort extended the Mason 48pt font to all 256 codepoints.

=== Asian Languages (Korean, Chinese, Japanese) ===

The original D3 had support for these languages, so it might be possible to add them to TDM, too. At the moment, however, we lack the fonts and translators. Also, writing from right-to-left (Hebrew) or top-down (Japanese) might be tricky or outright impossible in our GUI without more work in the C++ code. Plus, these languages use more than 256 different characters, and an 8 bit table will not hold these.

== European Character Implementation ==
=== Priority Early-On - the "Top 50" ===

Some of the special characters are used more often than others. Here is a statistic over the entire string set of the TDM core, from TDM v1.08, showing the top 50 most-used characters (excluding a-z, 0-9 and russian characters):

{|class="wikitable" border=1 style="border-collapse: collapse; font-size: 85%" cellspacing=0 cellpadding=2

|-
|Rank
|Occurances
|Letter
|Remarks
|Rank
|Occurances
|Letter
|Remarks

|-
|1
|í
|715
|
|25
|ć
|67
|

|-
|2
|é
|674
|
|26
|è
|65
|

|-
|3
|á
|524
|
|27
|ú
|56
|

|-
|4
|ø
|303
|Danish
|28
|ê
|52
|

|-
|5
|č
|288
|
|29
|ö
|48
|German

|-
|6
|ó
|283
|
|30
|É
|46
|

|-
|7
|ü
|270
|German
|31
|ñ
|37
|

|-
|8
|ł
|203
|Polish
|32
|õ
|32
|

|-
|9
|æ
|200
|Danish
|33
|ń
|26
|

|-
|10
|ě
|182
|
|34
|Ł
|24
|

|-
|11
|ř
|175
|Czech
|35
|Š
|21
|

|-
|12
|ã
|168
|
|36
|â
|21
|

|-
|13
|ž
|148
|Czech
|37
|ź
|20
|

|-
|14
|ý
|142
|
|38
|ß
|18
|German

|-
|15
|ę
|141
|
|39
|Ó
|18
|

|-
|16
|ą
|140
|
|40
|ň
|15
|

|-
|17
|ż
|119
|
|41
|Ú
|15
|

|-
|18
|å
|109
|Danish
|42
|Á
|13
|

|-
|19
|š
|99
|
|43
|î
|12
|

|-
|20
|ś
|97
|
|44
|ť
|11
|

|-
|21
|ç
|91
|
|45
|ô
|9
|

|-
|22
|ä
|86
|German
|46
|Ž
|8
|

|-
|23
|à
|83
|
|47
|Ż
|7
|

|-
|24
|ů
|77
|
|48
|Č
|7
|

|-
|25
|ć
|67
|
|49
|ù
|6
|

|}

Although ö, ä and ü do not appear that often, with only these and Ü, Ö, Ä and ß, the entire German language works. So adding these letters to the fonts is quite important.

Preferably, all foreign letters would be added to the fonts (see [[Font Patcher]] or [[Refont]]). However, if time permits only adding a few, '''í''' would be more important than, say, '''ô'''.

It is commonplace for missing accented letters to be redirected in the .dat file to the corresponding unaccented base letter.

=== Coverage Expansion & Remaining Limitations ===

By 2014, all the system (e.g., main menu) fonts (Carleton, Carleton_condensed, Stone in sizes 24pt and 48pt; Mason and Mason_glow in 48pt) had good coverage of the "Top 50" and beyond, although not all 256 codepoints.
This was confirmed more specifically in 2024, as part of an [https://forums.thedarkmod.com/index.php?/topic/22427-analysis-of-212-tdm-fonts/ Analysis of 2.12 Fonts]. This analysis indicated that, unlike the system fonts, the FM fonts generally did not provide specific glyphs beyond ASCII.

In 2024, Stone 24pt, important for subtitles and a number of readables, was further extended to cover all 256 codepoints. This was tested with TDM 2.13[betas] and released with 2.14.

In 2025, the Russian Mason 48pt font was improved and extended to cover all TDM Russian codepoints, and included in TDM 2.14.

In 2026, English/European Carleton 24pt, widely used in the main menu and also some readables, was improved to:
* extend coverage to all codepoints
* replace sloppy hand-drawn Latin-1 glyphs with fresh glyphs, most of them generated from TTF then edge-darkened
* for simplicity, re-implement the red "glow" effect as if a drop-shadow.

Testing of this is planned with TDM 2.15 betas.

Stone 48pt improvements are under consideration for TDM 2.15.

[[Category:Fonts]]

{{i18n}}

I18N - Charset

2026-05-11T19:08:28Z

Geep: /* all.lang */ Include gen_lang_plus

== Introduction ==

The D3 code that handles the GUI bitmap font can only load a specific range of bytes as characters. To get the most out of the available entries, special charsets are used. The fonts (Carleton for the menu f.i.) are build/patched so that the right characters appear in the right place.

== Encodings ==

=== all.lang ===

This file is in '''UTF-8''', and converted with the help of either the script '''devel/gen_lang.pl''':

perl devel/gen_lang.pl

or, more recently, the Windows C++ utility program '''gen_lang_plus'''. [[Gen_Lang_Programs]] has details of these.

This process ensures that the generated language files are in their proper encodings (see below).

=== All other language files ===

Note that the language files (f.i. '''strings/german.lang''') as well as the readables and the FM dictionariaries are expected to be in the following encodings:

* '''Czech''', '''Hungarian''', '''Slovak''', '''Polish:''' [https://secure.wikimedia.org/wikipedia/en/wiki/ISO/IEC_8859-2 ISO-8859-2] ('''not WIN-1250!)
* '''Russian:''' [https://secure.wikimedia.org/wikipedia/en/wiki/Win-1251 WIN-1251]
* '''French:''' [https://secure.wikimedia.org/wikipedia/en/wiki/ISO/IEC_8859-15 ISO-8859-15]
* '''Romanian:''' [https://secure.wikimedia.org/wikipedia/en/wiki/ISO/IEC_8859-16 ISO-8859-16]
* '''All other languages:''' [https://secure.wikimedia.org/wikipedia/en/wiki/ISO/IEC_8859-1 ISO-8859-1] (German, Dutch, Danish, Swedish, Portuguese, etc.)

{{infobox|The core dictionaries are automatically generated in the right encoding, but make sure that you use the right encoding for the FM dictionary, too!}}

== Character remapping ==

The characters are remapped upon loading the dictionary/readable, from their native encoding to the special one that TDM uses and that is described here. Responsible for the remapping are [[I18N - Character mapping|mapping files]], f.i. "strings/czech.map". If a map file for a specific language is not found, "strings/default.map" is used instead, if this is not found, no remapping takes place.

See '''[[I18N - Character mapping|Character mapping]]''' for more information.

=== European Languages ===

This mapping is used for European languages, f.i. '''Czech''', '''French''', '''German''', '''Spanish''', '''Portuguese''', '''Polish'''. Note that the double accented characters in Hungarian '''Ő, ő, Ű and ű''' look a bit different from '''Ö, ö, Ü and ü'''!

In the table below, the original ISO 8859-1 characters are given in ''()'' below the TDM character.

'''Color code:'''

{{box|#f0d0d0|Character not usable by TDM|Unusable}}{{box|#d0e0d0|Character not yet used in TDM|Unused}}{{box|#c0ffc0|Character displayed in v1.08 or newer|Usable in v1.08}}{{box|#80f080|Character displayed in v2.03 or newer|Usable in v2.03}}{{box|#d0d0f0|Changed from the ISO-8859-1 default, usable by TDM 1.0 or newer|Changed from ISO 8859-1}}

{|class="wikitable" border=1 style="border-collapse: collapse; font-size: 95%" cellspacing=0 cellpadding=2 width=100%

|-
!
!…0
!…1
!…2
!…3
!…4
!…5
!…6
!…7
!…8
!…9
!…A
!…B
!…C
!…D
!…E
!…F

|-
!0…
|align='center' style='background: #f0d0d0'|00 '''–'''
|align='center' style='background: #f0d0d0'|01 '''–'''
|align='center' style='background: #f0d0d0'|02 '''–'''
|align='center' style='background: #f0d0d0'|03 '''–'''
|align='center' style='background: #f0d0d0'|04 '''–'''
|align='center' style='background: #f0d0d0'|05 '''–'''
|align='center' style='background: #f0d0d0'|06 '''–'''
|align='center' style='background: #f0d0d0'|07 '''–'''
|align='center' style='background: #f0d0d0'|08 '''–'''
|align='center' style='background: #f0d0d0'|09 '''–'''
|align='center' style='background: #f0d0d0'|0A '''–'''
|align='center' style='background: #f0d0d0'|0B '''–'''
|align='center' style='background: #f0d0d0'|0C '''–'''
|align='center' style='background: #f0d0d0'|0D '''–'''
|align='center' style='background: #f0d0d0'|0E '''–'''
|align='center' style='background: #f0d0d0'|0F '''–'''

|-
!1…
|align='center' style='background: #f0d0d0'|10 '''–'''
|align='center' style='background: #f0d0d0'|11 '''–'''
|align='center' style='background: #f0d0d0'|12 '''–'''
|align='center' style='background: #f0d0d0'|13 '''–'''
|align='center' style='background: #f0d0d0'|14 '''–'''
|align='center' style='background: #f0d0d0'|15 '''–'''
|align='center' style='background: #f0d0d0'|16 '''–'''
|align='center' style='background: #f0d0d0'|17 '''–'''
|align='center' style='background: #f0d0d0'|18 '''–'''
|align='center' style='background: #f0d0d0'|19 '''–'''
|align='center' style='background: #f0d0d0'|1A '''–'''
|align='center' style='background: #f0d0d0'|1B '''–'''
|align='center' style='background: #f0d0d0'|1C '''–'''
|align='center' style='background: #f0d0d0'|1D '''–'''
|align='center' style='background: #f0d0d0'|1E '''–'''
|align='center' style='background: #f0d0d0'|1F '''–'''

|-
!2…
|align='center'|20 ''' '''
|align='center'|21 '''!'''
|align='center'|22 '''"'''
|align='center'|23 '''#'''
|align='center'|24 '''$'''
|align='center'|25 '''%'''
|align='center'|26 '''&'''
|align='center'|27 '''''''
|align='center'|28 '''('''
|align='center'|29 ''')'''
|align='center'|2A '''*'''
|align='center'|2B '''+'''
|align='center'|2C ''','''
|align='center'|2D '''-'''
|align='center'|2E '''.'''
|align='center'|2F '''/'''

|-
!3…
|align='center'|30 '''0'''
|align='center'|31 '''1'''
|align='center'|32 '''2'''
|align='center'|33 '''3'''
|align='center'|34 '''4'''
|align='center'|35 '''5'''
|align='center'|36 '''6'''
|align='center'|37 '''7'''
|align='center'|38 '''8'''
|align='center'|39 '''9'''
|align='center'|3A ''':'''
|align='center'|3B ''';'''
|align='center'|3C '''<'''
|align='center'|3D '''='''
|align='center'|3E '''>'''
|align='center'|3F '''?'''

|-
!4…
|align='center'|40 '''@'''
|align='center'|41 '''A'''
|align='center'|42 '''B'''
|align='center'|43 '''C'''
|align='center'|44 '''D'''
|align='center'|45 '''E'''
|align='center'|46 '''F'''
|align='center'|47 '''G'''
|align='center'|48 '''H'''
|align='center'|49 '''I'''
|align='center'|4A '''J'''
|align='center'|4B '''K'''
|align='center'|4C '''L'''
|align='center'|4D '''M'''
|align='center'|4E '''N'''
|align='center'|4F '''O'''

|-
!5…
|align='center'|50 '''P'''
|align='center'|51 '''Q'''
|align='center'|52 '''R'''
|align='center'|53 '''S'''
|align='center'|54 '''T'''
|align='center'|55 '''U'''
|align='center'|56 '''V'''
|align='center'|57 '''W'''
|align='center'|58 '''X'''
|align='center'|59 '''Y'''
|align='center'|5A '''Z'''
|align='center'|5B '''['''
|align='center'|5C '''\'''
|align='center'|5D ''']'''
|align='center'|5E '''^'''
|align='center'|5F '''_'''

|-
!6…
|align='center'|60 '''`'''
|align='center'|61 '''a'''
|align='center'|62 '''b'''
|align='center'|63 '''c'''
|align='center'|64 '''d'''
|align='center'|65 '''e'''
|align='center'|66 '''f'''
|align='center'|67 '''g'''
|align='center'|68 '''h'''
|align='center'|69 '''i'''
|align='center'|6A '''j'''
|align='center'|6B '''k'''
|align='center'|6C '''l'''
|align='center'|6D '''m'''
|align='center'|6E '''n'''
|align='center'|6F '''o'''

|-
!7…
|align='center'|70 '''p'''
|align='center'|71 '''q'''
|align='center'|72 '''r'''
|align='center'|73 '''s'''
|align='center'|74 '''t'''
|align='center'|75 '''u'''
|align='center'|76 '''v'''
|align='center'|77 '''w'''
|align='center'|78 '''x'''
|align='center'|79 '''y'''
|align='center'|7A '''z'''
|align='center'|7B '''{'''
|align='center'|7C '''|'''
|align='center'|7D '''}'''
|align='center'|7E '''~'''
|align='center' style='background: #d0e0d0'|7F '''�'''

|-
!8…
|align='center' style='background: #c0ffc0'|80 '''Ň'''
|align='center' style='background: #c0ffc0'|81 '''Ś'''
|align='center' style='background: #c0ffc0'|82 '''Ć'''
|align='center' style='background: #c0ffc0'|83 '''Ż'''
|align='center' style='background: #c0ffc0'|84 '''Ź'''
|align='center' style='background: #c0ffc0'|85 '''Ŝ'''
|align='center' style='background: #c0ffc0'|86 '''Ĉ'''
|align='center' style='background: #c0ffc0'|87 '''Ẑ'''
|align='center' style='background: #c0ffc0'|88 '''Ô''' [1]
|align='center' style='background: #c0ffc0'|89 '''Ŕ'''
|align='center' style='background: #c0ffc0'|8A '''Ǔ'''
|align='center' style='background: #c0ffc0'|8B '''Ă'''
|align='center' style='background: #c0ffc0'|8C '''Ń'''
|align='center' style='background: #80f080'|8D '''Ș'''
|align='center' style='background: #80f080'|8E '''Ț'''
|align='center' style='background: #d0e0d0'|8F '''�'''

|-
!9…
|align='center' style='background: #80f080'|90 '''đ'''
|align='center' style='background: #c0ffc0'|91 '''ś'''
|align='center' style='background: #c0ffc0'|92 '''ć'''
|align='center' style='background: #c0ffc0'|93 '''ż'''
|align='center' style='background: #c0ffc0'|94 '''ź'''
|align='center' style='background: #c0ffc0'|95 '''ŝ'''
|align='center' style='background: #c0ffc0'|96 '''ĉ'''
|align='center' style='background: #c0ffc0'|97 '''ẑ'''
|align='center' style='background: #c0ffc0'|98 '''ô''' [1]
|align='center' style='background: #c0ffc0'|99 '''ŕ'''
|align='center' style='background: #c0ffc0'|9A '''ǔ'''
|align='center' style='background: #c0ffc0'|9B '''ă'''
|align='center' style='background: #c0ffc0'|9C '''ń'''
|align='center' style='background: #80f080'|9D '''ș'''
|align='center' style='background: #80f080'|9E '''ț'''
|align='center' style='background: #d0e0d0'|9F '''�'''

|-
!A…
|align='center'|A0 '''[https://secure.wikimedia.org/wikipedia/en/wiki/Non-breaking_space NBSP]''' [2]
|align='center' style='background: #d0d0f0'|A1 '''ň''' (¡)'''
|align='center' style='background: #d0d0f0'|A2 '''Ű''' (¢)'''
|align='center' style='background: #d0d0f0'|A3 '''ě''' (£)'''
|align='center' style='background: #d0d0f0'|A4 '''ű''' (¤)'''
|align='center' style='background: #d0d0f0'|A5 '''Ě''' (¥)'''
|align='center' style='background: #d0d0f0'|A6 '''Š''' (¦)'''
|align='center'|A7 '''§'''
|align='center' style='background: #d0d0f0'|A8 '''š''' (¨)'''
|align='center' style='background: #d0d0f0'|A9 '''Ů''' (©)'''
|align='center' style='background: #d0d0f0'|AA '''Ą''' (ª)'''
|align='center' style='background: #d0d0f0'|AB '''Ę''' («)'''
|align='center' style='background: #d0d0f0'|AC '''Č''' (¬)'''
|align='center'|AD '''[https://secure.wikimedia.org/wikipedia/en/wiki/Soft_hyphen SHY]''' [2]
|align='center' style='background: #d0d0f0'|AE '''č''' (®)'''
|align='center' style='background: #d0d0f0'|AF '''ů''' (¯)'''

|-
!B…
|align='center' style='background: #d0d0f0'|B0 '''Ő''' (°)'''
|align='center' style='background: #d0d0f0'|B1 '''Ł''' (±)'''
|align='center' style='background: #d0d0f0'|B2 '''Ť''' (²)'''
|align='center' style='background: #d0d0f0'|B3 '''Ď''' (³)'''
|align='center' style='background: #d0d0f0'|B4 '''Ž''' (´)'''
|align='center' style='background: #d0d0f0'|B5 '''ł''' (µ)'''
|align='center' style='background: #d0d0f0'|B6 '''ť''' (¶)'''
|align='center' style='background: #d0d0f0'|B7 '''ď''' (·)'''
|align='center' style='background: #d0d0f0'|B8 '''ž''' (¸)'''
|align='center' style='background: #d0d0f0'|B9 '''ő''' (¹)'''
|align='center' style='background: #d0d0f0'|BA '''ą''' (º)'''
|align='center' style='background: #d0d0f0'|BB '''ę''' (»)'''
|align='center' style='background: #d0d0f0'|BC '''Œ''' (¼)'''
|align='center' style='background: #d0d0f0'|BD '''œ''' (½)'''
|align='center' style='background: #d0d0f0'|BE '''Ÿ''' (¾)'''
|align='center'|BF '''¿'''

|-
!C…
|align='center'|C0 '''À'''
|align='center'|C1 '''Á'''
|align='center'|C2 '''Â'''
|align='center'|C3 '''Ã'''
|align='center'|C4 '''Ä'''
|align='center'|C5 '''Å'''
|align='center'|C6 '''Æ'''
|align='center'|C7 '''Ç'''
|align='center'|C8 '''È'''
|align='center'|C9 '''É'''
|align='center'|CA '''Ê'''
|align='center'|CB '''Ë'''
|align='center'|CC '''Ì'''
|align='center'|CD '''Í'''
|align='center'|CE '''Î'''
|align='center'|CF '''Ï'''

|-
!D…
|align='center'|D0 '''Ð'''
|align='center'|D1 '''Ñ'''
|align='center'|D2 '''Ò'''
|align='center'|D3 '''Ó'''
|align='center'|D4 '''Ô'''
|align='center'|D5 '''Õ'''
|align='center'|D6 '''Ö'''
|align='center' style='background: #d0d0f0'|D7 '''Ř''' (×)'''
|align='center'|D8 '''Ø'''
|align='center'|D9 '''Ù'''
|align='center'|DA '''Ú'''
|align='center'|DB '''Û'''
|align='center'|DC '''Ü'''
|align='center'|DD '''Ý'''
|align='center'|DE '''Þ'''
|align='center'|DF '''ß'''

|-
!E…
|align='center'|E0 '''à'''
|align='center'|E1 '''á'''
|align='center'|E2 '''â'''
|align='center'|E3 '''ã'''
|align='center'|E4 '''ä'''
|align='center'|E5 '''å'''
|align='center'|E6 '''æ'''
|align='center'|E7 '''ç'''
|align='center'|E8 '''è'''
|align='center'|E9 '''é'''
|align='center'|EA '''ê'''
|align='center'|EB '''ë'''
|align='center'|EC '''ì'''
|align='center'|ED '''í'''
|align='center'|EE '''î'''
|align='center'|EF '''ï'''

|-
!F…
|align='center'|F0 '''ð'''
|align='center'|F1 '''ñ'''
|align='center'|F2 '''ò'''
|align='center'|F3 '''ó'''
|align='center'|F4 '''ô'''
|align='center'|F5 '''õ'''
|align='center'|F6 '''ö'''
|align='center' style='background: #d0d0f0'|F7 '''ř''' (÷)'''
|align='center'|F8 '''ø'''
|align='center'|F9 '''ù'''
|align='center'|FA '''ú'''
|align='center'|FB '''û'''
|align='center'|FC '''ü'''
|align='center'|FD '''ý'''
|align='center'|FE '''þ'''
|align='center'|FF '''ÿ'''

|}

==== Table Notes ====

'''[1]''' As discussed [https://forums.thedarkmod.com/index.php?/topic/22427-analysis-of-212-tdm-fonts/&do=findComment&comment=494855 here], the TDM char set has a redundant treatment of 2 characters:

* Ô appears at 0x88 and 0xD4
* ô appears at 0x98 and 0xF4

Starting with TDM 2.13, the redundancy can be removed and these new characters (from ISO-8859-3) introduced:

* Ğ appears at 0x88
* ğ appears at 0x98

'''[2]''' Avoid using the non-breaking space (NBSP, 0xA0) and the soft hyphen (SHY, 0xAD) in your strings. The TDM engine has no code to respect these during word wrap. Font maintainers: probably map NBSP to the <space> glyph, SHY to undefined/hollow box or zero-sized box.

==== Corresponding Unicode ====

For a mapping of these 256 codepoints to Unicode U+NNNN values and formal names, download 'TDM 8859-Style Font Map to Unicode-16.txt':

* [https://drive.google.com/file/d/1wLEtuFvnrZ-WHK8ign8i3diIXZdriZ4F/view?usp=sharing for TDM 2.13]
* [https://drive.google.com/file/d/1UAz9jSZpT_j33STP3So_Re8JWa8QuAmz/view?usp=sharing for TDM 2.12 and earlier]

Each of these files (by Geep, 2024) is in a standardized format so that it can also be imported into font design programs like FontForge as a custom 256-position map. In the comments, there is additional information about:
* ISO 8859-x sourcing of each character.
* alternative representations of some European and control characters.

==== Fonts with Special Characters ====
Certain fonts have a few codepoints that purposefully diverge from the table entry.

* Carleton font (regular, bold, glow) uses codepoint 0x23, ordinarily "#", to represent "superscript #", which is used in the main menu system to indicate FMs for which a translation pack is available.
* Treasure Map font has characters for "pirate skull and crossbones" and "bottle of booze (or poison)".

=== Russian ===

Characters conform to the [https://en.wikipedia.org/wiki/Win-1251 WIN-1251 native encoding, shown in the Wikipedia article]. Exception: the character '''0xFF''' (я) is mapped to '''0xB6''' upon loading. Therefore any Russian font must contain я at the place 0xB6.

Within any given font, character overage may be incomplete. A 2025 effort extended the Mason 48pt font to all 256 codepoints.

=== Asian Languages (Korean, Chinese, Japanese) ===

The original D3 had support for these languages, so it might be possible to add them to TDM, too. At the moment, however, we lack the fonts and translators. Also, writing from right-to-left (Hebrew) or top-down (Japanese) might be tricky or outright impossible in our GUI without more work in the C++ code. Plus, these languages use more than 256 different characters, and an 8 bit table will not hold these.

== European Character Implementation ==
=== Priority Early-On - the "Top 50" ===

Some of the special characters are used more often than others. Here is a statistic over the entire string set of the TDM core, from TDM v1.08, showing the top 50 most-used characters (excluding a-z, 0-9 and russian characters):

{|class="wikitable" border=1 style="border-collapse: collapse; font-size: 85%" cellspacing=0 cellpadding=2

|-
|Rank
|Occurances
|Letter
|Remarks
|Rank
|Occurances
|Letter
|Remarks

|-
|1
|í
|715
|
|25
|ć
|67
|

|-
|2
|é
|674
|
|26
|è
|65
|

|-
|3
|á
|524
|
|27
|ú
|56
|

|-
|4
|ø
|303
|Danish
|28
|ê
|52
|

|-
|5
|č
|288
|
|29
|ö
|48
|German

|-
|6
|ó
|283
|
|30
|É
|46
|

|-
|7
|ü
|270
|German
|31
|ñ
|37
|

|-
|8
|ł
|203
|Polish
|32
|õ
|32
|

|-
|9
|æ
|200
|Danish
|33
|ń
|26
|

|-
|10
|ě
|182
|
|34
|Ł
|24
|

|-
|11
|ř
|175
|Czech
|35
|Š
|21
|

|-
|12
|ã
|168
|
|36
|â
|21
|

|-
|13
|ž
|148
|Czech
|37
|ź
|20
|

|-
|14
|ý
|142
|
|38
|ß
|18
|German

|-
|15
|ę
|141
|
|39
|Ó
|18
|

|-
|16
|ą
|140
|
|40
|ň
|15
|

|-
|17
|ż
|119
|
|41
|Ú
|15
|

|-
|18
|å
|109
|Danish
|42
|Á
|13
|

|-
|19
|š
|99
|
|43
|î
|12
|

|-
|20
|ś
|97
|
|44
|ť
|11
|

|-
|21
|ç
|91
|
|45
|ô
|9
|

|-
|22
|ä
|86
|German
|46
|Ž
|8
|

|-
|23
|à
|83
|
|47
|Ż
|7
|

|-
|24
|ů
|77
|
|48
|Č
|7
|

|-
|25
|ć
|67
|
|49
|ù
|6
|

|}

Although ö, ä and ü do not appear that often, with only these and Ü, Ö, Ä and ß, the entire German language works. So adding these letters to the fonts is quite important.

Preferably, all foreign letters would be added to the fonts (see [[Font Patcher]] or [[Refont]]). However, if time permits only adding a few, '''í''' would be more important than, say, '''ô'''.

It is commonplace for missing accented letters to be redirected in the .dat file to the corresponding unaccented base letter.

=== Coverage Expansion & Remaining Limitations ===

By 2014, all the system (e.g., main menu) fonts (Carleton, Carleton_condensed, Stone in sizes 24pt and 48pt; Mason and Mason_glow in 48pt) had good coverage of the "Top 50" and beyond, although not all 256 codepoints.
This was confirmed more specifically in 2024, as part of an [https://forums.thedarkmod.com/index.php?/topic/22427-analysis-of-212-tdm-fonts/ Analysis of 2.12 Fonts]. This analysis indicated that, unlike the system fonts, the FM fonts generally did not provide specific glyphs beyond ASCII.

In 2024, Stone 24pt, important for subtitles and a number of readables, was further extended to cover all 256 codepoints. This was tested with TDM 2.13[betas] and released with 2.14.

In 2025, the Russian Mason 48pt font was improved and extended to cover all TDM Russian codepoints.

In 2026, English/European Carleton 24pt, widely used in the main menu and also some readables, was improved to:
* extend coverage to all codepoints
* replace sloppy hand-drawn Latin-1 glyphs with fresh glyphs, most of them generated from TTF then edge-darkened
* for simplicity, re-implement the red "glow" effect as if a drop-shadow.

Testing of this is planned with TDM 2.15 betas.

Stone 48pt improvements are under consideration for TDM 2.15.

[[Category:Fonts]]

{{i18n}}

I18N - Charset

2026-05-11T17:48:09Z

Geep: /* Coverage Expansion & Remaining Limitations */ Update Mason 48pt, Carleton 24pt

== Introduction ==

The D3 code that handles the GUI bitmap font can only load a specific range of bytes as characters. To get the most out of the available entries, special charsets are used. The fonts (Carleton for the menu f.i.) are build/patched so that the right characters appear in the right place.

== Encodings ==

=== all.lang ===

This file is in '''UTF-8''', and converted with the help of the script '''devel/gen_lang.pl''':

perl devel/gen_lang.pl

This ensures that the generated language files are in their proper encodings (see below).

=== All other language files ===

Note that the language files (f.i. '''strings/german.lang''') as well as the readables and the FM dictionariaries are expected to be in the following encodings:

* '''Czech''', '''Hungarian''', '''Slovak''', '''Polish:''' [https://secure.wikimedia.org/wikipedia/en/wiki/ISO/IEC_8859-2 ISO-8859-2] ('''not WIN-1250!)
* '''Russian:''' [https://secure.wikimedia.org/wikipedia/en/wiki/Win-1251 WIN-1251]
* '''French:''' [https://secure.wikimedia.org/wikipedia/en/wiki/ISO/IEC_8859-15 ISO-8859-15]
* '''Romanian:''' [https://secure.wikimedia.org/wikipedia/en/wiki/ISO/IEC_8859-16 ISO-8859-16]
* '''All other languages:''' [https://secure.wikimedia.org/wikipedia/en/wiki/ISO/IEC_8859-1 ISO-8859-1] (German, Dutch, Danish, Swedish, Portuguese, etc.)

{{infobox|The core dictionaries are automatically generated in the right encoding, but make sure that you use the right encoding for the FM dictionary, too!}}

== Character remapping ==

The characters are remapped upon loading the dictionary/readable, from their native encoding to the special one that TDM uses and that is described here. Responsible for the remapping are [[I18N - Character mapping|mapping files]], f.i. "strings/czech.map". If a map file for a specific language is not found, "strings/default.map" is used instead, if this is not found, no remapping takes place.

See '''[[I18N - Character mapping|Character mapping]]''' for more information.

=== European Languages ===

This mapping is used for European languages, f.i. '''Czech''', '''French''', '''German''', '''Spanish''', '''Portuguese''', '''Polish'''. Note that the double accented characters in Hungarian '''Ő, ő, Ű and ű''' look a bit different from '''Ö, ö, Ü and ü'''!

In the table below, the original ISO 8859-1 characters are given in ''()'' below the TDM character.

'''Color code:'''

{{box|#f0d0d0|Character not usable by TDM|Unusable}}{{box|#d0e0d0|Character not yet used in TDM|Unused}}{{box|#c0ffc0|Character displayed in v1.08 or newer|Usable in v1.08}}{{box|#80f080|Character displayed in v2.03 or newer|Usable in v2.03}}{{box|#d0d0f0|Changed from the ISO-8859-1 default, usable by TDM 1.0 or newer|Changed from ISO 8859-1}}

{|class="wikitable" border=1 style="border-collapse: collapse; font-size: 95%" cellspacing=0 cellpadding=2 width=100%

|-
!
!…0
!…1
!…2
!…3
!…4
!…5
!…6
!…7
!…8
!…9
!…A
!…B
!…C
!…D
!…E
!…F

|-
!0…
|align='center' style='background: #f0d0d0'|00 '''–'''
|align='center' style='background: #f0d0d0'|01 '''–'''
|align='center' style='background: #f0d0d0'|02 '''–'''
|align='center' style='background: #f0d0d0'|03 '''–'''
|align='center' style='background: #f0d0d0'|04 '''–'''
|align='center' style='background: #f0d0d0'|05 '''–'''
|align='center' style='background: #f0d0d0'|06 '''–'''
|align='center' style='background: #f0d0d0'|07 '''–'''
|align='center' style='background: #f0d0d0'|08 '''–'''
|align='center' style='background: #f0d0d0'|09 '''–'''
|align='center' style='background: #f0d0d0'|0A '''–'''
|align='center' style='background: #f0d0d0'|0B '''–'''
|align='center' style='background: #f0d0d0'|0C '''–'''
|align='center' style='background: #f0d0d0'|0D '''–'''
|align='center' style='background: #f0d0d0'|0E '''–'''
|align='center' style='background: #f0d0d0'|0F '''–'''

|-
!1…
|align='center' style='background: #f0d0d0'|10 '''–'''
|align='center' style='background: #f0d0d0'|11 '''–'''
|align='center' style='background: #f0d0d0'|12 '''–'''
|align='center' style='background: #f0d0d0'|13 '''–'''
|align='center' style='background: #f0d0d0'|14 '''–'''
|align='center' style='background: #f0d0d0'|15 '''–'''
|align='center' style='background: #f0d0d0'|16 '''–'''
|align='center' style='background: #f0d0d0'|17 '''–'''
|align='center' style='background: #f0d0d0'|18 '''–'''
|align='center' style='background: #f0d0d0'|19 '''–'''
|align='center' style='background: #f0d0d0'|1A '''–'''
|align='center' style='background: #f0d0d0'|1B '''–'''
|align='center' style='background: #f0d0d0'|1C '''–'''
|align='center' style='background: #f0d0d0'|1D '''–'''
|align='center' style='background: #f0d0d0'|1E '''–'''
|align='center' style='background: #f0d0d0'|1F '''–'''

|-
!2…
|align='center'|20 ''' '''
|align='center'|21 '''!'''
|align='center'|22 '''"'''
|align='center'|23 '''#'''
|align='center'|24 '''$'''
|align='center'|25 '''%'''
|align='center'|26 '''&'''
|align='center'|27 '''''''
|align='center'|28 '''('''
|align='center'|29 ''')'''
|align='center'|2A '''*'''
|align='center'|2B '''+'''
|align='center'|2C ''','''
|align='center'|2D '''-'''
|align='center'|2E '''.'''
|align='center'|2F '''/'''

|-
!3…
|align='center'|30 '''0'''
|align='center'|31 '''1'''
|align='center'|32 '''2'''
|align='center'|33 '''3'''
|align='center'|34 '''4'''
|align='center'|35 '''5'''
|align='center'|36 '''6'''
|align='center'|37 '''7'''
|align='center'|38 '''8'''
|align='center'|39 '''9'''
|align='center'|3A ''':'''
|align='center'|3B ''';'''
|align='center'|3C '''<'''
|align='center'|3D '''='''
|align='center'|3E '''>'''
|align='center'|3F '''?'''

|-
!4…
|align='center'|40 '''@'''
|align='center'|41 '''A'''
|align='center'|42 '''B'''
|align='center'|43 '''C'''
|align='center'|44 '''D'''
|align='center'|45 '''E'''
|align='center'|46 '''F'''
|align='center'|47 '''G'''
|align='center'|48 '''H'''
|align='center'|49 '''I'''
|align='center'|4A '''J'''
|align='center'|4B '''K'''
|align='center'|4C '''L'''
|align='center'|4D '''M'''
|align='center'|4E '''N'''
|align='center'|4F '''O'''

|-
!5…
|align='center'|50 '''P'''
|align='center'|51 '''Q'''
|align='center'|52 '''R'''
|align='center'|53 '''S'''
|align='center'|54 '''T'''
|align='center'|55 '''U'''
|align='center'|56 '''V'''
|align='center'|57 '''W'''
|align='center'|58 '''X'''
|align='center'|59 '''Y'''
|align='center'|5A '''Z'''
|align='center'|5B '''['''
|align='center'|5C '''\'''
|align='center'|5D ''']'''
|align='center'|5E '''^'''
|align='center'|5F '''_'''

|-
!6…
|align='center'|60 '''`'''
|align='center'|61 '''a'''
|align='center'|62 '''b'''
|align='center'|63 '''c'''
|align='center'|64 '''d'''
|align='center'|65 '''e'''
|align='center'|66 '''f'''
|align='center'|67 '''g'''
|align='center'|68 '''h'''
|align='center'|69 '''i'''
|align='center'|6A '''j'''
|align='center'|6B '''k'''
|align='center'|6C '''l'''
|align='center'|6D '''m'''
|align='center'|6E '''n'''
|align='center'|6F '''o'''

|-
!7…
|align='center'|70 '''p'''
|align='center'|71 '''q'''
|align='center'|72 '''r'''
|align='center'|73 '''s'''
|align='center'|74 '''t'''
|align='center'|75 '''u'''
|align='center'|76 '''v'''
|align='center'|77 '''w'''
|align='center'|78 '''x'''
|align='center'|79 '''y'''
|align='center'|7A '''z'''
|align='center'|7B '''{'''
|align='center'|7C '''|'''
|align='center'|7D '''}'''
|align='center'|7E '''~'''
|align='center' style='background: #d0e0d0'|7F '''�'''

|-
!8…
|align='center' style='background: #c0ffc0'|80 '''Ň'''
|align='center' style='background: #c0ffc0'|81 '''Ś'''
|align='center' style='background: #c0ffc0'|82 '''Ć'''
|align='center' style='background: #c0ffc0'|83 '''Ż'''
|align='center' style='background: #c0ffc0'|84 '''Ź'''
|align='center' style='background: #c0ffc0'|85 '''Ŝ'''
|align='center' style='background: #c0ffc0'|86 '''Ĉ'''
|align='center' style='background: #c0ffc0'|87 '''Ẑ'''
|align='center' style='background: #c0ffc0'|88 '''Ô''' [1]
|align='center' style='background: #c0ffc0'|89 '''Ŕ'''
|align='center' style='background: #c0ffc0'|8A '''Ǔ'''
|align='center' style='background: #c0ffc0'|8B '''Ă'''
|align='center' style='background: #c0ffc0'|8C '''Ń'''
|align='center' style='background: #80f080'|8D '''Ș'''
|align='center' style='background: #80f080'|8E '''Ț'''
|align='center' style='background: #d0e0d0'|8F '''�'''

|-
!9…
|align='center' style='background: #80f080'|90 '''đ'''
|align='center' style='background: #c0ffc0'|91 '''ś'''
|align='center' style='background: #c0ffc0'|92 '''ć'''
|align='center' style='background: #c0ffc0'|93 '''ż'''
|align='center' style='background: #c0ffc0'|94 '''ź'''
|align='center' style='background: #c0ffc0'|95 '''ŝ'''
|align='center' style='background: #c0ffc0'|96 '''ĉ'''
|align='center' style='background: #c0ffc0'|97 '''ẑ'''
|align='center' style='background: #c0ffc0'|98 '''ô''' [1]
|align='center' style='background: #c0ffc0'|99 '''ŕ'''
|align='center' style='background: #c0ffc0'|9A '''ǔ'''
|align='center' style='background: #c0ffc0'|9B '''ă'''
|align='center' style='background: #c0ffc0'|9C '''ń'''
|align='center' style='background: #80f080'|9D '''ș'''
|align='center' style='background: #80f080'|9E '''ț'''
|align='center' style='background: #d0e0d0'|9F '''�'''

|-
!A…
|align='center'|A0 '''[https://secure.wikimedia.org/wikipedia/en/wiki/Non-breaking_space NBSP]''' [2]
|align='center' style='background: #d0d0f0'|A1 '''ň''' (¡)'''
|align='center' style='background: #d0d0f0'|A2 '''Ű''' (¢)'''
|align='center' style='background: #d0d0f0'|A3 '''ě''' (£)'''
|align='center' style='background: #d0d0f0'|A4 '''ű''' (¤)'''
|align='center' style='background: #d0d0f0'|A5 '''Ě''' (¥)'''
|align='center' style='background: #d0d0f0'|A6 '''Š''' (¦)'''
|align='center'|A7 '''§'''
|align='center' style='background: #d0d0f0'|A8 '''š''' (¨)'''
|align='center' style='background: #d0d0f0'|A9 '''Ů''' (©)'''
|align='center' style='background: #d0d0f0'|AA '''Ą''' (ª)'''
|align='center' style='background: #d0d0f0'|AB '''Ę''' («)'''
|align='center' style='background: #d0d0f0'|AC '''Č''' (¬)'''
|align='center'|AD '''[https://secure.wikimedia.org/wikipedia/en/wiki/Soft_hyphen SHY]''' [2]
|align='center' style='background: #d0d0f0'|AE '''č''' (®)'''
|align='center' style='background: #d0d0f0'|AF '''ů''' (¯)'''

|-
!B…
|align='center' style='background: #d0d0f0'|B0 '''Ő''' (°)'''
|align='center' style='background: #d0d0f0'|B1 '''Ł''' (±)'''
|align='center' style='background: #d0d0f0'|B2 '''Ť''' (²)'''
|align='center' style='background: #d0d0f0'|B3 '''Ď''' (³)'''
|align='center' style='background: #d0d0f0'|B4 '''Ž''' (´)'''
|align='center' style='background: #d0d0f0'|B5 '''ł''' (µ)'''
|align='center' style='background: #d0d0f0'|B6 '''ť''' (¶)'''
|align='center' style='background: #d0d0f0'|B7 '''ď''' (·)'''
|align='center' style='background: #d0d0f0'|B8 '''ž''' (¸)'''
|align='center' style='background: #d0d0f0'|B9 '''ő''' (¹)'''
|align='center' style='background: #d0d0f0'|BA '''ą''' (º)'''
|align='center' style='background: #d0d0f0'|BB '''ę''' (»)'''
|align='center' style='background: #d0d0f0'|BC '''Œ''' (¼)'''
|align='center' style='background: #d0d0f0'|BD '''œ''' (½)'''
|align='center' style='background: #d0d0f0'|BE '''Ÿ''' (¾)'''
|align='center'|BF '''¿'''

|-
!C…
|align='center'|C0 '''À'''
|align='center'|C1 '''Á'''
|align='center'|C2 '''Â'''
|align='center'|C3 '''Ã'''
|align='center'|C4 '''Ä'''
|align='center'|C5 '''Å'''
|align='center'|C6 '''Æ'''
|align='center'|C7 '''Ç'''
|align='center'|C8 '''È'''
|align='center'|C9 '''É'''
|align='center'|CA '''Ê'''
|align='center'|CB '''Ë'''
|align='center'|CC '''Ì'''
|align='center'|CD '''Í'''
|align='center'|CE '''Î'''
|align='center'|CF '''Ï'''

|-
!D…
|align='center'|D0 '''Ð'''
|align='center'|D1 '''Ñ'''
|align='center'|D2 '''Ò'''
|align='center'|D3 '''Ó'''
|align='center'|D4 '''Ô'''
|align='center'|D5 '''Õ'''
|align='center'|D6 '''Ö'''
|align='center' style='background: #d0d0f0'|D7 '''Ř''' (×)'''
|align='center'|D8 '''Ø'''
|align='center'|D9 '''Ù'''
|align='center'|DA '''Ú'''
|align='center'|DB '''Û'''
|align='center'|DC '''Ü'''
|align='center'|DD '''Ý'''
|align='center'|DE '''Þ'''
|align='center'|DF '''ß'''

|-
!E…
|align='center'|E0 '''à'''
|align='center'|E1 '''á'''
|align='center'|E2 '''â'''
|align='center'|E3 '''ã'''
|align='center'|E4 '''ä'''
|align='center'|E5 '''å'''
|align='center'|E6 '''æ'''
|align='center'|E7 '''ç'''
|align='center'|E8 '''è'''
|align='center'|E9 '''é'''
|align='center'|EA '''ê'''
|align='center'|EB '''ë'''
|align='center'|EC '''ì'''
|align='center'|ED '''í'''
|align='center'|EE '''î'''
|align='center'|EF '''ï'''

|-
!F…
|align='center'|F0 '''ð'''
|align='center'|F1 '''ñ'''
|align='center'|F2 '''ò'''
|align='center'|F3 '''ó'''
|align='center'|F4 '''ô'''
|align='center'|F5 '''õ'''
|align='center'|F6 '''ö'''
|align='center' style='background: #d0d0f0'|F7 '''ř''' (÷)'''
|align='center'|F8 '''ø'''
|align='center'|F9 '''ù'''
|align='center'|FA '''ú'''
|align='center'|FB '''û'''
|align='center'|FC '''ü'''
|align='center'|FD '''ý'''
|align='center'|FE '''þ'''
|align='center'|FF '''ÿ'''

|}

==== Table Notes ====

'''[1]''' As discussed [https://forums.thedarkmod.com/index.php?/topic/22427-analysis-of-212-tdm-fonts/&do=findComment&comment=494855 here], the TDM char set has a redundant treatment of 2 characters:

* Ô appears at 0x88 and 0xD4
* ô appears at 0x98 and 0xF4

Starting with TDM 2.13, the redundancy can be removed and these new characters (from ISO-8859-3) introduced:

* Ğ appears at 0x88
* ğ appears at 0x98

'''[2]''' Avoid using the non-breaking space (NBSP, 0xA0) and the soft hyphen (SHY, 0xAD) in your strings. The TDM engine has no code to respect these during word wrap. Font maintainers: probably map NBSP to the <space> glyph, SHY to undefined/hollow box or zero-sized box.

==== Corresponding Unicode ====

For a mapping of these 256 codepoints to Unicode U+NNNN values and formal names, download 'TDM 8859-Style Font Map to Unicode-16.txt':

* [https://drive.google.com/file/d/1wLEtuFvnrZ-WHK8ign8i3diIXZdriZ4F/view?usp=sharing for TDM 2.13]
* [https://drive.google.com/file/d/1UAz9jSZpT_j33STP3So_Re8JWa8QuAmz/view?usp=sharing for TDM 2.12 and earlier]

Each of these files (by Geep, 2024) is in a standardized format so that it can also be imported into font design programs like FontForge as a custom 256-position map. In the comments, there is additional information about:
* ISO 8859-x sourcing of each character.
* alternative representations of some European and control characters.

==== Fonts with Special Characters ====
Certain fonts have a few codepoints that purposefully diverge from the table entry.

* Carleton font (regular, bold, glow) uses codepoint 0x23, ordinarily "#", to represent "superscript #", which is used in the main menu system to indicate FMs for which a translation pack is available.
* Treasure Map font has characters for "pirate skull and crossbones" and "bottle of booze (or poison)".

=== Russian ===

Characters conform to the [https://en.wikipedia.org/wiki/Win-1251 WIN-1251 native encoding, shown in the Wikipedia article]. Exception: the character '''0xFF''' (я) is mapped to '''0xB6''' upon loading. Therefore any Russian font must contain я at the place 0xB6.

Within any given font, character overage may be incomplete. A 2025 effort extended the Mason 48pt font to all 256 codepoints.

=== Asian Languages (Korean, Chinese, Japanese) ===

The original D3 had support for these languages, so it might be possible to add them to TDM, too. At the moment, however, we lack the fonts and translators. Also, writing from right-to-left (Hebrew) or top-down (Japanese) might be tricky or outright impossible in our GUI without more work in the C++ code. Plus, these languages use more than 256 different characters, and an 8 bit table will not hold these.

== European Character Implementation ==
=== Priority Early-On - the "Top 50" ===

Some of the special characters are used more often than others. Here is a statistic over the entire string set of the TDM core, from TDM v1.08, showing the top 50 most-used characters (excluding a-z, 0-9 and russian characters):

{|class="wikitable" border=1 style="border-collapse: collapse; font-size: 85%" cellspacing=0 cellpadding=2

|-
|Rank
|Occurances
|Letter
|Remarks
|Rank
|Occurances
|Letter
|Remarks

|-
|1
|í
|715
|
|25
|ć
|67
|

|-
|2
|é
|674
|
|26
|è
|65
|

|-
|3
|á
|524
|
|27
|ú
|56
|

|-
|4
|ø
|303
|Danish
|28
|ê
|52
|

|-
|5
|č
|288
|
|29
|ö
|48
|German

|-
|6
|ó
|283
|
|30
|É
|46
|

|-
|7
|ü
|270
|German
|31
|ñ
|37
|

|-
|8
|ł
|203
|Polish
|32
|õ
|32
|

|-
|9
|æ
|200
|Danish
|33
|ń
|26
|

|-
|10
|ě
|182
|
|34
|Ł
|24
|

|-
|11
|ř
|175
|Czech
|35
|Š
|21
|

|-
|12
|ã
|168
|
|36
|â
|21
|

|-
|13
|ž
|148
|Czech
|37
|ź
|20
|

|-
|14
|ý
|142
|
|38
|ß
|18
|German

|-
|15
|ę
|141
|
|39
|Ó
|18
|

|-
|16
|ą
|140
|
|40
|ň
|15
|

|-
|17
|ż
|119
|
|41
|Ú
|15
|

|-
|18
|å
|109
|Danish
|42
|Á
|13
|

|-
|19
|š
|99
|
|43
|î
|12
|

|-
|20
|ś
|97
|
|44
|ť
|11
|

|-
|21
|ç
|91
|
|45
|ô
|9
|

|-
|22
|ä
|86
|German
|46
|Ž
|8
|

|-
|23
|à
|83
|
|47
|Ż
|7
|

|-
|24
|ů
|77
|
|48
|Č
|7
|

|-
|25
|ć
|67
|
|49
|ù
|6
|

|}

Although ö, ä and ü do not appear that often, with only these and Ü, Ö, Ä and ß, the entire German language works. So adding these letters to the fonts is quite important.

Preferably, all foreign letters would be added to the fonts (see [[Font Patcher]] or [[Refont]]). However, if time permits only adding a few, '''í''' would be more important than, say, '''ô'''.

It is commonplace for missing accented letters to be redirected in the .dat file to the corresponding unaccented base letter.

=== Coverage Expansion & Remaining Limitations ===

By 2014, all the system (e.g., main menu) fonts (Carleton, Carleton_condensed, Stone in sizes 24pt and 48pt; Mason and Mason_glow in 48pt) had good coverage of the "Top 50" and beyond, although not all 256 codepoints.
This was confirmed more specifically in 2024, as part of an [https://forums.thedarkmod.com/index.php?/topic/22427-analysis-of-212-tdm-fonts/ Analysis of 2.12 Fonts]. This analysis indicated that, unlike the system fonts, the FM fonts generally did not provide specific glyphs beyond ASCII.

In 2024, Stone 24pt, important for subtitles and a number of readables, was further extended to cover all 256 codepoints. This was tested with TDM 2.13[betas] and released with 2.14.

In 2025, the Russian Mason 48pt font was improved and extended to cover all TDM Russian codepoints.

In 2026, English/European Carleton 24pt, widely used in the main menu and also some readables, was improved to:
* extend coverage to all codepoints
* replace sloppy hand-drawn Latin-1 glyphs with fresh glyphs, most of them generated from TTF then edge-darkened
* for simplicity, re-implement the red "glow" effect as if a drop-shadow.

Testing of this is planned with TDM 2.15 betas.

Stone 48pt improvements are under consideration for TDM 2.15.

[[Category:Fonts]]

{{i18n}}

Carleton Fonts

2026-05-04T17:55:46Z

Geep: /* Carleton When Toggling Choices Within a Submenu */

''By Geep, 2025. The analysis here as of TDM 2.12 and for "english" (including European) unless indicated otherwise.''

== The Carleton Family in a Nutshell ==
Carleton is a squarish print-style serif font. The lower case letters look like smaller versions of the upper case letters, so this font can also be referred to as "Carleton Caps", [[Fonts_Screenshots#Carleton_Caps_only | as in this screenshot]]. Within TDM, there are four members of the Carleton family:
* carleton
* carleton_bold
* carleton_condensed (i.e., more tightly spaced in the horizontal dimension)
* carleton_glow

Base-font carleton is used extensively throughout the main menu system. It may appear by itself, in black, for non-interactive subheadings and descriptions. (In a few places, like the "Downloadable Missions" title, a "headline" style using carleton_bold is deployed.)

Or it may participate in dynamic text highlighting for user interactions, using overlay combinations like:
* carleton and carleton_glow
* carleton_bold and carleton_glow, for titles and headlines
* carleton, carleton_bold and carleton_glow, for certain "new game" buttons

For FMs, there are standard readable sheet and scroll prefabs and sign text decals that use carleton, just by itself. The style of this font makes it a good choices for notices; between title and body, and upper and lower case, there can appear to be four different sizes of "capital" letters.

All these usages predominately involve mid-sized and large text (e.g., GUI textscale 0.24 and up), that draws on the 24pt and 48pt size bitmaps. The "english" form of 24pt and 48pt both offer TDM’s full European glyph set. Glyphs are stylishly done for 48pt and not bad for ASCII characters of 24pt; the accented characters of 24pt are rough-hewn and merely adequate.

While 48pt carleton_bold actually has bold (thickened) glyphs, 24pt carleton_bold glyphs are merely copies of regular 24pt carleton, so not bold.

== File Naming and Content Sharing across the Carleton Family ==
The four members share bitmap naming. For instance, if you examine any of the 4 derived fontimage_24.ref files, you see references like:

shaderName fonts/Carleton_0_24.tga

and it will say "Carleton_..." in all cases, not for instance "Carleton_condensed_...". (As is typically the case in TDM, a shader filetype of .tga actually resolves to .dds, and shaderName is case-insensitive; the actual filenames are all lower-case.)

There is also file content sharing (i.e., duplication). As shown in the tables below, the sharing pattern is more complex, and arguably incoherent. This may reflect errors in distribution, or perhaps some member/size combinations not really being used.

{| class="wikitable" style="margin-left: 0px; margin-right: auto;"
|+ '''Table of 2.12 English Carleton Family DAT Files Sharing File Names and in Some Cases Contents.''' The content of each file is unique, unless shown here by "SAME", which refers to only to matching another file’s content IN THE SAME ROW.
|-
! filename !! /carleton/ !! /carleton_bold/ !! /carleton_condensed/ !! /carleton_glow/
|-
| fontimage_12.dat || SAME || SAME || SAME || SAME
|-
| fontimage_24.dat || SAME || SAME || unique || SAME
|-
| fontimage_48.dat || SAME || SAME || unique || SAME
|}

{| class="wikitable" style="margin-left: 0px; margin-right: auto;"
|+ '''Table of 2.12 English Carleton Family DDS Files Sharing File Names and in Some Cases Contents.''' The content of each file is unique, unless shown here by "SAME", which refers to only to matching another file’s content IN THE SAME ROW.
|-
! filename !! /carleton/ !! /carleton_bold/ !! /carleton_condensed/ !! /carleton_glow/
|-
| carleton_0_12.dds || SAME || unique || SAME || unique
|-
| carleton_0_24.dds || '''SAME''' || '''SAME''' || unique || unique
|-
| carleton_1_24.dds || '''SAME''' || '''SAME''' || unique || unique
|-
| carleton_0_48.dds || SAME || unique || SAME || unique
|-
| carleton_1_48.dds || SAME || unique || SAME || unique
|-
| carleton_2_48.dds || SAME || unique || SAME || unique
|-
| carleton_3_48.dds || SAME || unique || SAME || unique
|-
| carleton_4_48.dds || SAME || unique || SAME || unique
|-
| carleton_5_48.dds || SAME || unique || SAME || unique
|-
| carleton_6_48.dds || SAME || unique || SAME || unique
|-
| carleton_7_48.dds || SAME || unique || SAME || unique
|}

== Bitmap File Sizes across the Carleton Family ==
The english 24pt DDS files '''shown in bold above''' have 512x512 bitmaps. All other files (including those for Russian, not in the table) have the default 256x256 bitmaps. This includes carleton_glow. Observe that it is not required that the base & glow have identical bitmap sizes (although that is helpful to allow GIMP layering).

See also [[Refont#Carleton_Family]] for corresponding refont commands.

== Anomalies of Carleton and Carleton Bold 24pt Glyphs ==
As mentioned above, 24pt Carleton Bold is identical to 24pt Carleton; so not really bold. The remaining discussion applies equally to 24pt Carleton and Carleton Bold.

Evidently, the original generation of the 24pt size, into two 256x256 bitmaps "carleton_0_24.dds" and "carleton_1_24.dds", contained only ASCII alphanumeric characters and limited punctuation, with no accented/Latin-1 glyphs. Later, these bitmaps were scaled up to 512x512 bitmaps, to ease drawing in the missing characters by hand. The resulting new characters are coarser than the generated and scaled ASCII characters.

You can see this aspects in the main menu, under Settings/Video/Language, where, in the list of 16 languages, accented letters are thicker.

Also, if viewed in GIMP, the white characters have a faint black border, not seen elsewhere (e.g., in the 48pt bitmaps). This is true of both scaled-up ASCII and drawn Latin-1 characters, though far more prominent in the latter. However, TDM's monochrome, usually black rendering (defined by forecolor in the GUI) obscures the presence of this border effect. The purpose for it is discussed next.

== Carleton When Toggling Choices Within a Submenu ==
Throughout Setting submenus, the Carleton 24pt font is used within option lists. More generally, this presentation style is used for row items within lists.

For example, under Settings/Audio/, there is a row with "Main Menu Music" and a choice of "On" or "Off". This is implemented by a standardized choiceDef.
* On the left, the "Main Menu Music" phrase is carleton, rendered in translucent black (with alpha 0.85) and a textscale of 0.24 (which draws from 24pt).
* On the right, the "On" and "Off" text by default is the same, but slightly smaller at textscale 0.22 (also from 24pt).

When you mouse-hover, the current-value text turns momentarily white with a faint black border. The white is set, not by the GUI, but by the engine's "hoverColor", which is opaque white (1,1,1,1). The black border improves readability against the parchment background. It is due to the "anomolous" black border baked into the font, as discussed above.

''Aside: There is a GUI scripting text attribute "shadow", to draw black drop shadows (offset equally down and right) under font characters. This is not used in the main menu system. Within the engine, "shadow" invokes a "textShadow" boolean, false by default.''

== Carleton & Carleton Glow in the Main Menu System ==
This pairing occurs basically everywhere thorough the main menu system. In a typical presentation, against a parchment background, major menu-page-selection keywords are by default rendered in black with no glow. But they will turn white with blood-red glow highlighting when either selected (as if a tab for the current page) or moused-over. This will also play a sound and often show a text hint.

=== Example Implementation ===
TDM uses a number of different "button" (i.e., selectable text) styles, driven by #defines in \tdm_gui01\guis\mainmenu_defs.gui. For example, those of the main menu home page use:
#define MM_NORMAL_FONT "fonts/carleton"
#define MM_GLOW_FONT "fonts/carleton_glow"
#define MM_FONTSCALE 0.33
#define MM_BUTTON_HEIGHT 18

For colors, the text is black initially, with glow highlighting invisible. Upon mouse hover, the text becomes white, and the glow red. RGBA colors are defined for this, in vector and string (with S prefix) forms:

#define NORMAL_COLOR 0,0,0,0.90 // black, not entirely opaque
#define SNORMAL_COLOR "0 0 0 0.90"
#define INVISIBLE 0, 0, 0, 0
#define SINVISIBLE "0 0 0 0"
#define GLOW_WHITE_COLOR 0.98,0.93,0.82,1
#define SGLOW_WHITE_COLOR "0.98 0.93 0.82 1"
#define GLOW_RED_COLOR 0.6,0.1,0.1,0.5 // semi-transparent
#define SGLOW_RED_COLOR "0.6 0.1 0.1 0.5"

To be specific, consider a simplified imaginary main menu "button" we'll call "Simple". (We're avoiding the layout calculations and other complications of a real button.) For our button, there are 3 aligned windowDefs in mainmenu_defs.gui, with these locations:

#define MM_POS_SIMPLE_BUTTON rect 40, 445, 160, MM_BUTTON_HEIGHT * 1.3
#define MM_POS_SIMPLE_BUTTON_GLOW rect 41, 446, 159, MM_BUTTON_HEIGHT * 1.3 - 1
#define MM_POS_SIMPLE_ACTION MM_POS_SIMPLE_BUTTON

The windowDefs positioned by these will also do the following:
* MM_POS_SIMPLE_BUTTON: set the default appearance of the button text.
* MM_POS_SIMPLE_BUTTON_GLOW: set the default appearance of the glow "highlight" text. Note this text is offset down and to the right by one pixel, compared to MM_POS_SIMPLE_BUTTON, to give the glow a "drop shadow" flavor. This is a frequent treatment, though in some cases only the right shift is done.
* MM_POS_SIMPLE_ACTION defines the mouse-over and mouse-selection dynamic behaviors. (Be aware that in some actual cases, this is combined into the first windowDef.)

Then, besides the rects, the other attributes are defined for the two default windowDefs:

#define MM_FONT font MM_NORMAL_FONT forecolor SNORMAL_COLOR textscale MM_FONTSCALE visible 1 textalign 1 // centered text
#define MM_FONT_GLOW font MM_GLOW_FONT forecolor INVISIBLE textscale MM_FONTSCALE visible 1 textalign 1

(This is a simplification; for the main menu, MM_FONT's forecolor is #defined as INVISIBLE, then transitions to SNORMAL_COLOR in 1/2 second.)

Within an overall page layout given by mainmenu_main.gui (but with our button shoved in), we might have nested:

windowDef SimpleTextH
{
rect MM_POS_SIMPLE_BUTTON_GLOW
MM_FONT_GLOW
visible "gui::showSimple"
text "#str_01234" // "Simple"
}
windowDef SimpleText
{
rect MM_POS_SIMPLE_BUTTON
MM_FONT
visible "gui::showSimple"
text "#str_01234" // "Simple"
}
windowDef SimpleAction
{
rect MM_POS_SIMPLE_ACTION
visible "gui::showSimple"
float exit;

onMouseEnter
{
set "exit" 0;
transition "SimpleText::forecolor" SNORMAL_COLOR SGLOW_WHITE_COLOR "50" ;
transition "SimpleTextH::forecolor" SINVISIBLE SGLOW_RED_COLOR "50" ;
set "cmd" "play sound/meta/menu/mnu_hover";
}

onMouseExit
{
if ("exit" == 0)
{
transition "SimpleText::forecolor" SGLOW_WHITE_COLOR SNORMAL_COLOR "50" ;
transition "SimpleTextH::forecolor" SGLOW_RED_COLOR SINVISIBLE "50" ;
}
}

onAction
{
transition "SimpleText::forecolor" SGLOW_WHITE_COLOR SNORMAL_COLOR "50" ;
transition "SimpleTextH::forecolor" SGLOW_RED_COLOR SINVISIBLE "50" ;

set "cmd" "play sound/meta/menu/mnu_select;";
set "cmd" "onSimpleClicked"; // tell engine

// And any additional commands here to switch states, resetTime, etc.
}
}

The "H" (highlighted) windowDef is shown first, to draw behind the main text. onMouseEnter turns the text color from black to white in 50 milliseconds, and the glow from invisible to red. onMouseExit reverses that. onAction, when the button is mouse-selected, does the visual transition as mouse exit, but plays a different sound... and then does whatever "Simple" is supposed to do.

== Carleton in Assets for FMs ==
In the tables below, most content has a textscale above 0.30, so draws from the 48pt size, '''indicated in bold'''. Otherwise, with a textscale of 0.16 to 0.30, from 24pt.

{| class="wikitable" style="margin-left: 0px; margin-right: auto;"
|+ '''Carleton in Standard Readable Prefabs.'''
Within \tdm_prefabs01\xdata\prefabs.xd, "gui_page<n>" : "guis/readables/..."
|-
! Prefab !! Title textscale !! Body textscale
|-
| .../books/... none || ||
|-
| .../scrolls/scroll_print_carleton.gui || '''0.40''' || 0.28
|-
| .../sheets/sheet_paper_print_carleton_caps.gui || '''0.40''' || '''0.31'''
|}

{| class="wikitable" style="margin-left: 0px; margin-right: auto;"
|+ '''Carleton in Sign Text.''' Within \sign_text_decals\
|-
! Decal !! Textscale
|-
| sign_text_carleton.gui || '''2'''
|-
| sign_text_carleton_small.gui || '''1'''
|}

== Carleton_condensed ==
As indicated above, Carleton_condensed DDS files are all 256x256.

=== 12pt Size ===
''The main menu system does not use this size. In your FM, it is recommended to NOT invoke 12pt carleton_condensed (i.e., by specifying a GUI textscale of 0.15 or less). Instead, use regular carleton, possibly with a slightly smaller textscale.''

Although 12pt carleton_condensed exists, its DAT file and single DDS file are mere placeholders that are identical to those of carleton 12pt.

=== 48pt Size ===
''The main menu system does not use this size. In your FM, it is recommended to NOT invoke 48pt carleton_condensed (i.e., by specifying a GUI textscale of above 0.30). Instead, use regular carleton, possibly with a slightly smaller textscale.''

The set of eight DDS files for 48pt carleton_condensed are identical to those for 48pt carleton. However, the DAT file has different content, though the difference is not due to horizontal "condensation".

A one time, Tels drafted a Font Patcher command file for 48pt carleton_condensed, to reduce the width and xSkip of a selected subset of the carleton’s ASCII alphanumeric characters, presumably those most generously spaced to begin with. Evidently this was not finalized and deployed. Instead, inspection of the current 48pt DAT file for carleton_condensed suggests it was based on an early version of carleton, at a time when only some of the accented characters were implemented. (In particular, the DAT lacks re-implemented metrics for chars 128-139 and 145-155.)

=== 24pt Size ===
''The main menu system uses this, but sparingly. Since a "glow" form of carleton_condensed was never developed, only regular non-glow uses are applicable.''

The contents of the DAT file and the set of two DDS files for 48pt carleton_condensed DIFFER from those for 48pt carleton.

For the main menu system, where carleton was used for English-language players, the more-compact carleton_condensed was briefly considered as a method of accommodating European language translations. However, this would require dynamic language switching, and was found to be a hill too far, compared to just reducing Carleton’s textscale value.

The actual limited uses in the main menu systems are seen as you survey the downloadable missions. Specifically, when looking at a candidate mission, the Mission Details page has a Description section, whose body text is carleton_condensed with textscale 0.17. Compared to other similar text section here (that use regular carleton with textscale 0.18), this is slightly smaller and condensed. Also, the Next >> and << Prev buttons for cycling through screenshots have their button captions in this font (with textscale 0.23).

== For More ==
* Character-set coverage of Carleton family is included in the the [https://forums.thedarkmod.com/index.php?/topic/22427-analysis-of-212-tdm-fonts/ summary analysis of 2.12 TDM fonts], based on applying 'refont -stats ...' to all 'english' DAT files.

{{tutorial}} [[Category:Fonts]]

GUI Scripting: Properties in Common

2026-05-04T17:43:52Z

Geep: /* shadow bool */ Indicate it may take an int

''This page is part of a series. See [[GUI Scripting Language]] for overview.''
==Introduction==
Here is a catalogue of Properties common to windowDefs and all other members of the "guiDef" family. (Each member's additional task-related Properties are detailed individually elsewhere.) The catalogue is arranged by:

1) Frequency of use in TDM (widely; seldom; debug; unlikely to be useful)

2) General purpose

* rectangle size, location, and appearance
* text and font attributes
* cursor attributes
* timer and events
3) Alphabetically

A Property has a predefined name, type (Boolean, float, vec2, vec4, string) and default value. Properties appear in a <Property List>, by convention at the start of a guiDef's body, after the "{". Routinely, one Property is listed per line. Any property not explicitly listed still exists, with its default value.
====About "Registers", Marked Here As ®====
As indicated in the listing below, properties are of two types:
* those that can only appear in a property list - not within event handlers - and can only be given an initial unchanging value. Informally, these are like tags.
* those that ''can'' be changed, called "Registers", and indicated here by a ® symbol. These are like true variables.

A Register can be changed by one of these two methods:
# By a "set" or "transition" event handler command, which updates the initial value. If the command is in a different guiDef (while still part of the same GUI), use the "guiDef_name::" prefix before the variable.
# By "binding" a gui:: parameter to it, as its value. This value will then be checked every frame. The value of the gui:: parameter is updated either from an associated .script file, or from a "set" or "transition" command in some guiDef of the GUI. For more, see [[GUI Scripting: GUI:: Parameters]].

While changing a non-register value is not possible, you can probably get the desired effect by cloning the guiDef and selective hiding.

====About Syntax & Usage Examples====
Syntax examples shown here start with how they can appear in a property list. For properties that are registers, there may be additional examples with event handler commands "set", "transition", or "if (condition)". Property list and event handler commands have different syntax; don’t confuse them.

==Used Widely in TDM==
===Rectangle Size, Location, and Appearance===
====backcolor ''color_vector'' ®====
Defines the guiDef’s background color. Colors are normalized RGB and alpha values. . Default: all 0 values (black but transparent).
backcolor 1,1,0,1 // Yellow with no transparency.
====background ''path'' ®====
Defines the guiDef’s background image or video. Typically, this specifies the logical path to a material shader, as defined in a .mtr file. Alternatively, it could be a relative file path, e.g., to a .tga file; the file extension is left off. Default is "".
background "guis/assets/readables/books/book_rightpage_01"
set "background" "guis/video/credits/city_sequence01"; // Logical path shown, defined in materials/tdm_gui.mtr, is to a roq video.
====bordercolor ''color_vector'' ® ====
Defines the color of the guiDef’s border. Colors are normalized RGB and alpha values. The bordersize property must be non-zero for a bordercolor to show. Default: all 1 values (opaque white).
bordercolor 1,1,0,1 // Yellow with no transparency.
bordercolor 0, 0, 0, 0.7 // Used in mainmenu_loadsave.gui. Semi-transparent black border.
====bordersize ''pixels''====
Defines the stroke size used to draw the guiDef’s border, in [presumably logical] pixels. Default: 0.
bordersize 1 // Only sizes 0 and 1 are used in core.
====forceaspectwidth ''width'' & forceaspectheight ''height''====
Force a specific draw surface width and height. Used in a top-level windowDef.

While these commands make only a single appearance in core TDM, in #include file "readables.guicore", that’s within a macro hierarchy affecting all the readables. Default: 640w x 480h.
====matcolor ''color_vector'' ®====
Defines the color of the image displayed in the guiDef’s "background" property. While in a R,G,B,A format, each float is not an absolute color value; it is a percentage (from 0 to 1) of how much of that channel will be rendered. Usually only the A channel is changed. Default: all 1 values (100% rendered).
matcolor 1,1,1,0 // In windowDef backgroundsingle, hide this background initially, then,
set "backgroundsingle::matcolor" "1 1 1 1"; // in a script command, show it right away or fade in.
transition "backgroundsingle::matcolor" "1 1 1 0" "1 1 1 1" READABLE_FADE_TIME;
====modal - see under "Timer and Events"====
====noclip ''bool''====
Don’t clip draw operations that lie outside the guiDef rectangle? Default: 0 (false).
noclip 1 // Widely set to 1 in core, e.g., for readables.
====rect ''vector_with_4_values'' ®====
Defines the location, width and height of the guiDef rectangle as x-origin, y-origin, width, height. 0, 0, 640, 480 would be a guiDef of 640 by 480 logical pixels whose top left corner is at coordinate 0,0. The first two values always represent the guiDef’s upper left corner. The rect of a child guiDef is relative to its parent's rect but within its inner border as given by bordersize. That is, if the parent x/y origin coordinates are 0,0, and the parent's bordersize is 3, then if the child x/y origin coordinates are 0,0, that's actually at the parent's 3,3 location.
rect 0, 0, 640, 480 // By convention, a top-level windowDef is explicitly set to these values, to define the logical coordinate system for child guiDefs.
set "body::rect" "20, 10, 250, 380"; // In guis\readables\parchment_everett_hand_2.gui
transition "message::rect" "0, 0, 185, 1000" "10, 59, 185, 1000" "1" // a script event in tdm_message_no_art.gui that appropriately sizes a popup message box, in this case for 2 lines of text.

====visible ''bool'' ®====
Should this guiDef be visible? Default: 1 (true).
visible 0 // Default is 1 (true). In core, widely used as a toggle.
if ("StealthScoreDetail::visible" == 1) { // Fragment from within mainmenu_success.gui’s
set "StealthScoreDetail::visible" "0"; …} // onAction, showing test and change of value.
===Text and Font Attributes===
====font ''font_path''====
Sets the font to be used for the text, from among available TDM fonts. Default: "".
font "fonts/stone" // Property is widely used in core.
====forecolor ''color_vector'' ®====
Defines the color of the guiDef’s text. Colors are normalized RGB and alpha values. Default: all 1 values (opaque white).
forecolor 1,1,1,1 // This example is opaque white, widely used.
forecolor 0, 0, 0, 0.66 // Black text, semi-transparent, as used for various sign texts.
transition "title::forecolor" "0 0 0 0" "0 0 0 0.85" READABLE_FADE_TIME; // As script command, here to fade in title of a readable sheet of paper.
====text ''string_literal_or_variable'' ®====
The text to be displayed in the guiDef. The character limit is 1024 [true?]. Default: "".
text "Heading" // In property list. Widely used.
text "gui::gui_parm1" // Get desired sign text from spawnarg; used with sign text decals available as prefabs.
set "leftCapital::text" "$gui::left_capital"; // script command used in core for readable books with illuminated drop caps.

====textalign ''align_enum''====
Defines the text’s alignment within the guiDef. Values are 0 (align left), 1 (center horizontally), or 2 (align right). Default: 0 (align left).
textalign 1 // In property list. Value of 1 widely used for centering. Value of 2 rarely, e.g., in tdm_loot.gui .
====textalignx ''offset_x'' & textaligny ''offset_y''====
Offset respectively the x & y value of the text relative to the guiDef. Defaults: 0.
textalignx -3 // mainmenu_defs.gui includes these 2 properties
textaligny -2 // in #defines to properly space button captions.
====textscale ''factor'' ®====
Uniformly scales the text’s font size in the guiDef. The range is generally from 0.0 to 1.0 but can exceed 1.0. Default: 1.
textscale 1.5 // Widely used in readables, ranging from 0.2 to 3.
===Cursor Attributes===
====menugui ''bool''====
Use on a top-level windowDef. A value of 1 marks the gui as a menu gui. This affects the look of the cursor pointer. Helpful too when debugging world guis. Default: 0 (false).
menugui 1 // Value of 1 used in mainmenu.gui, which the #includes all other mainmenu… gui files.
====nocursor ''bool''====
Use on a top-level windowDef. A value of 1 shows no cursor over the windowGui. This can be used for non-interactive GUIs such as videos and in-world monitors. Default: 0 (false).
nocursor 1 // Most HUD and other overlays will set "nocursor 1".
===Timer and Events===
====modal ''bool''====
Should this guiDef eat events if active? Used for pop-up boxes. Default: 0 (false).
modal 1 // Typical use in core: mainmenu_message.gui
====noevents ''bool'' ®====
Should all of the guiDef’s onAction scripts be disabled? Default: 0 (false).
noevents 1
set "noevents" "1" // Representative use in core: in mainmenu_loadsave.gui
====notime ''bool'' ®====
Should all of the guiDef’s onTime scripts be stopped from running? Used for guiDefs holding animation scripts. Default: 0 (false).
notime 1 // Widely used in core.
set "notime" "1"; // Representative use in core: in tdm_inv.gui

==Seldom or Never Used in TDM==
These properties were not found to be used in the core unless otherwise noted with specific examples. Generic examples are given in some cases.
===Rectangle Size, Location, and Appearance===
====invertrect ''bool''====
Correct for this guiDef being upside-down? Default: 0 (false).
invertrect 1 // Not used in core.
====matscalex ''factor_x'' & matscaley ''factor_y''====
Scales the background material in the x & y directions respectively. When set to -1, flips the guiDef’s texture along the horizontal & vertical axis respectively. Default: 1.
matscalex -1 // Used in mainmenu_background when player failed, to flip the texture of "big chains". Matscaley not used in core.
====naturalmatscale ''bool''====
Use the real size of the background material? Default: 0 (false).
naturalmatscale 1 // Not used in core.
====rotate ''degrees'' ®====
Defines the angle in degrees that the guiDef’s image will be rotated. This property can also be used in a "transition" statement to rotate the image over time. Default: 0 degrees.
// Not used in property list in core.
set "rotate" "0"; // Examples from the mainmenu_background.gui, if player fails, rotate a small
transition "rotate" "0" "9" "5000" "0.7" "0.7"; // chain in the background
====shear ''vector_with_2_values''====
"Shear" the rectangle, which turns it into a parallelogram. Range of each value is 0 to 1. Vec2 Default: 0,0.
shear 0.5,0 // Not used in core.
===Text and Font Attributes===
====nowrap ''bool''====
Don’t wrap text that can’t fit in the rectangle? Default: 0 (false), so wrap
nowrap 1
====shadow ''bool''====
Use a black drop-shadow when drawing the text? Default: 0 (false)
shadow 1

''This may actually take an integer, indicating the number of "pixels" offset the shadow is, both rightwards and downwards.''

===Timer and Events===
====wantenter ''bool''====
When the user presses enter, and there's no child guiDef that has the focus, should the guiDef’s onAction (and/or onActionRelease) event handler run? Default: 0 (false)
wantenter 1

==Debug Only==
====showtime ''bool''====
Display the guiDef time? Default: 0 (false).
showtime 1
====showcoords ''bool''====
Display the guiDef coordinates? Default: 0 (false).
showcoords 1

==Unlikely to be Useful==
For more about these properties, likely more pertinent to other idTech4 games, see [[GUI Scripting: TDM vs Doom 3, Quake 4]].
====comment ''string''====
Free form comment area. Unnecessary. Usually, just use /*…*/ or // for comments. Or if this gui is paired with an entity, add a "comment" spawnarg to the latter.
====name ''new_name_string''====
Re-defines the guiDef’s name.. Each guiDef in a GUI file must have a unique name, which by default is initialized by the <guiDef Type> <name> {...}. But can be overwritten by using "name" property explicitly.
====play ''sound_path''====
Prints a warning message telling you not to use it. Main menu system developers: Use 'set "cmd" "play ..." ' instead. Mappers: trigger sounds from a .script or deploy a separate entity.
===Unused in Doom 3 & TDM===
Says Ref 1:

scale®, translate®, varbackground®

runscript® Not available as property, only as script command in Doom 3 (though unused in that form in TDM.)

Listed in Ref 3 (Quake 4), but not in Ref 1:

dpadgui

==For More==
This property listing is largely from Ref 3 of [[GUI Scripting: References & Resources]] as supplemented by Ref 1, but re-ordered. Examples are largely from TDM 2.10 core menus.

{{GUI}}

Carleton Fonts

2026-05-04T17:31:59Z

Geep: revise remarks about black borders

''By Geep, 2025. The analysis here as of TDM 2.12 and for "english" (including European) unless indicated otherwise.''

== The Carleton Family in a Nutshell ==
Carleton is a squarish print-style serif font. The lower case letters look like smaller versions of the upper case letters, so this font can also be referred to as "Carleton Caps", [[Fonts_Screenshots#Carleton_Caps_only | as in this screenshot]]. Within TDM, there are four members of the Carleton family:
* carleton
* carleton_bold
* carleton_condensed (i.e., more tightly spaced in the horizontal dimension)
* carleton_glow

Base-font carleton is used extensively throughout the main menu system. It may appear by itself, in black, for non-interactive subheadings and descriptions. (In a few places, like the "Downloadable Missions" title, a "headline" style using carleton_bold is deployed.)

Or it may participate in dynamic text highlighting for user interactions, using overlay combinations like:
* carleton and carleton_glow
* carleton_bold and carleton_glow, for titles and headlines
* carleton, carleton_bold and carleton_glow, for certain "new game" buttons

For FMs, there are standard readable sheet and scroll prefabs and sign text decals that use carleton, just by itself. The style of this font makes it a good choices for notices; between title and body, and upper and lower case, there can appear to be four different sizes of "capital" letters.

All these usages predominately involve mid-sized and large text (e.g., GUI textscale 0.24 and up), that draws on the 24pt and 48pt size bitmaps. The "english" form of 24pt and 48pt both offer TDM’s full European glyph set. Glyphs are stylishly done for 48pt and not bad for ASCII characters of 24pt; the accented characters of 24pt are rough-hewn and merely adequate.

While 48pt carleton_bold actually has bold (thickened) glyphs, 24pt carleton_bold glyphs are merely copies of regular 24pt carleton, so not bold.

== File Naming and Content Sharing across the Carleton Family ==
The four members share bitmap naming. For instance, if you examine any of the 4 derived fontimage_24.ref files, you see references like:

shaderName fonts/Carleton_0_24.tga

and it will say "Carleton_..." in all cases, not for instance "Carleton_condensed_...". (As is typically the case in TDM, a shader filetype of .tga actually resolves to .dds, and shaderName is case-insensitive; the actual filenames are all lower-case.)

There is also file content sharing (i.e., duplication). As shown in the tables below, the sharing pattern is more complex, and arguably incoherent. This may reflect errors in distribution, or perhaps some member/size combinations not really being used.

{| class="wikitable" style="margin-left: 0px; margin-right: auto;"
|+ '''Table of 2.12 English Carleton Family DAT Files Sharing File Names and in Some Cases Contents.''' The content of each file is unique, unless shown here by "SAME", which refers to only to matching another file’s content IN THE SAME ROW.
|-
! filename !! /carleton/ !! /carleton_bold/ !! /carleton_condensed/ !! /carleton_glow/
|-
| fontimage_12.dat || SAME || SAME || SAME || SAME
|-
| fontimage_24.dat || SAME || SAME || unique || SAME
|-
| fontimage_48.dat || SAME || SAME || unique || SAME
|}

{| class="wikitable" style="margin-left: 0px; margin-right: auto;"
|+ '''Table of 2.12 English Carleton Family DDS Files Sharing File Names and in Some Cases Contents.''' The content of each file is unique, unless shown here by "SAME", which refers to only to matching another file’s content IN THE SAME ROW.
|-
! filename !! /carleton/ !! /carleton_bold/ !! /carleton_condensed/ !! /carleton_glow/
|-
| carleton_0_12.dds || SAME || unique || SAME || unique
|-
| carleton_0_24.dds || '''SAME''' || '''SAME''' || unique || unique
|-
| carleton_1_24.dds || '''SAME''' || '''SAME''' || unique || unique
|-
| carleton_0_48.dds || SAME || unique || SAME || unique
|-
| carleton_1_48.dds || SAME || unique || SAME || unique
|-
| carleton_2_48.dds || SAME || unique || SAME || unique
|-
| carleton_3_48.dds || SAME || unique || SAME || unique
|-
| carleton_4_48.dds || SAME || unique || SAME || unique
|-
| carleton_5_48.dds || SAME || unique || SAME || unique
|-
| carleton_6_48.dds || SAME || unique || SAME || unique
|-
| carleton_7_48.dds || SAME || unique || SAME || unique
|}

== Bitmap File Sizes across the Carleton Family ==
The english 24pt DDS files '''shown in bold above''' have 512x512 bitmaps. All other files (including those for Russian, not in the table) have the default 256x256 bitmaps. This includes carleton_glow. Observe that it is not required that the base & glow have identical bitmap sizes (although that is helpful to allow GIMP layering).

See also [[Refont#Carleton_Family]] for corresponding refont commands.

== Anomalies of Carleton and Carleton Bold 24pt Glyphs ==
As mentioned above, 24pt Carleton Bold is identical to 24pt Carleton; so not really bold. The remaining discussion applies equally to 24pt Carleton and Carleton Bold.

Evidently, the original generation of the 24pt size, into two 256x256 bitmaps "carleton_0_24.dds" and "carleton_1_24.dds", contained only ASCII alphanumeric characters and limited punctuation, with no accented/Latin-1 glyphs. Later, these bitmaps were scaled up to 512x512 bitmaps, to ease drawing in the missing characters by hand. The resulting new characters are coarser than the generated and scaled ASCII characters.

You can see this aspects in the main menu, under Settings/Video/Language, where, in the list of 16 languages, accented letters are thicker.

Also, if viewed in GIMP, the white characters have a faint black border, not seen elsewhere (e.g., in the 48pt bitmaps). This is true of both scaled-up ASCII and drawn Latin-1 characters, though far more prominent in the latter. However, TDM's monochrome, usually black rendering (defined by forecolor in the GUI) obscures the presence of this border effect. The purpose for it is discussed next.

== Carleton When Toggling Choices Within a Submenu ==
Throughout Setting submenus, the Carleton 24pt font is used within option lists. More generally, this presentation style is used for row items within lists.

For example, under Settings/Audio/, there is a row with "Main Menu Music" and a choice of "On" or "Off". This is implemented by a standardized choiceDef.
* On the left, the "Main Menu Music" phrase is carleton, rendered in translucent black (with alpha 0.85) and a textscale of 0.24 (which draws from 24pt).
* On the right, the "On" and "Off" text by default is the same, but slightly smaller at textscale 0.22 (also from 24pt).

When you mouse-hover, the current-value text turns momentarily white with a faint black border. The white is set, not by the GUI, but by the engine's "hoverColor", which is opaque white (1,1,1,1). The black border improves readability against the parchment background. It is due to the "anomolous" black border baked into the font, as discussed above. [Aside: the engine has a "textShadow" boolean and code which presumably could be used to draw a border around a font character. However, "textShadow" is false by default. Unused?]

== Carleton & Carleton Glow in the Main Menu System ==
This pairing occurs basically everywhere thorough the main menu system. In a typical presentation, against a parchment background, major menu-page-selection keywords are by default rendered in black with no glow. But they will turn white with blood-red glow highlighting when either selected (as if a tab for the current page) or moused-over. This will also play a sound and often show a text hint.

=== Example Implementation ===
TDM uses a number of different "button" (i.e., selectable text) styles, driven by #defines in \tdm_gui01\guis\mainmenu_defs.gui. For example, those of the main menu home page use:
#define MM_NORMAL_FONT "fonts/carleton"
#define MM_GLOW_FONT "fonts/carleton_glow"
#define MM_FONTSCALE 0.33
#define MM_BUTTON_HEIGHT 18

For colors, the text is black initially, with glow highlighting invisible. Upon mouse hover, the text becomes white, and the glow red. RGBA colors are defined for this, in vector and string (with S prefix) forms:

#define NORMAL_COLOR 0,0,0,0.90 // black, not entirely opaque
#define SNORMAL_COLOR "0 0 0 0.90"
#define INVISIBLE 0, 0, 0, 0
#define SINVISIBLE "0 0 0 0"
#define GLOW_WHITE_COLOR 0.98,0.93,0.82,1
#define SGLOW_WHITE_COLOR "0.98 0.93 0.82 1"
#define GLOW_RED_COLOR 0.6,0.1,0.1,0.5 // semi-transparent
#define SGLOW_RED_COLOR "0.6 0.1 0.1 0.5"

To be specific, consider a simplified imaginary main menu "button" we'll call "Simple". (We're avoiding the layout calculations and other complications of a real button.) For our button, there are 3 aligned windowDefs in mainmenu_defs.gui, with these locations:

#define MM_POS_SIMPLE_BUTTON rect 40, 445, 160, MM_BUTTON_HEIGHT * 1.3
#define MM_POS_SIMPLE_BUTTON_GLOW rect 41, 446, 159, MM_BUTTON_HEIGHT * 1.3 - 1
#define MM_POS_SIMPLE_ACTION MM_POS_SIMPLE_BUTTON

The windowDefs positioned by these will also do the following:
* MM_POS_SIMPLE_BUTTON: set the default appearance of the button text.
* MM_POS_SIMPLE_BUTTON_GLOW: set the default appearance of the glow "highlight" text. Note this text is offset down and to the right by one pixel, compared to MM_POS_SIMPLE_BUTTON, to give the glow a "drop shadow" flavor. This is a frequent treatment, though in some cases only the right shift is done.
* MM_POS_SIMPLE_ACTION defines the mouse-over and mouse-selection dynamic behaviors. (Be aware that in some actual cases, this is combined into the first windowDef.)

Then, besides the rects, the other attributes are defined for the two default windowDefs:

#define MM_FONT font MM_NORMAL_FONT forecolor SNORMAL_COLOR textscale MM_FONTSCALE visible 1 textalign 1 // centered text
#define MM_FONT_GLOW font MM_GLOW_FONT forecolor INVISIBLE textscale MM_FONTSCALE visible 1 textalign 1

(This is a simplification; for the main menu, MM_FONT's forecolor is #defined as INVISIBLE, then transitions to SNORMAL_COLOR in 1/2 second.)

Within an overall page layout given by mainmenu_main.gui (but with our button shoved in), we might have nested:

windowDef SimpleTextH
{
rect MM_POS_SIMPLE_BUTTON_GLOW
MM_FONT_GLOW
visible "gui::showSimple"
text "#str_01234" // "Simple"
}
windowDef SimpleText
{
rect MM_POS_SIMPLE_BUTTON
MM_FONT
visible "gui::showSimple"
text "#str_01234" // "Simple"
}
windowDef SimpleAction
{
rect MM_POS_SIMPLE_ACTION
visible "gui::showSimple"
float exit;

onMouseEnter
{
set "exit" 0;
transition "SimpleText::forecolor" SNORMAL_COLOR SGLOW_WHITE_COLOR "50" ;
transition "SimpleTextH::forecolor" SINVISIBLE SGLOW_RED_COLOR "50" ;
set "cmd" "play sound/meta/menu/mnu_hover";
}

onMouseExit
{
if ("exit" == 0)
{
transition "SimpleText::forecolor" SGLOW_WHITE_COLOR SNORMAL_COLOR "50" ;
transition "SimpleTextH::forecolor" SGLOW_RED_COLOR SINVISIBLE "50" ;
}
}

onAction
{
transition "SimpleText::forecolor" SGLOW_WHITE_COLOR SNORMAL_COLOR "50" ;
transition "SimpleTextH::forecolor" SGLOW_RED_COLOR SINVISIBLE "50" ;

set "cmd" "play sound/meta/menu/mnu_select;";
set "cmd" "onSimpleClicked"; // tell engine

// And any additional commands here to switch states, resetTime, etc.
}
}

The "H" (highlighted) windowDef is shown first, to draw behind the main text. onMouseEnter turns the text color from black to white in 50 milliseconds, and the glow from invisible to red. onMouseExit reverses that. onAction, when the button is mouse-selected, does the visual transition as mouse exit, but plays a different sound... and then does whatever "Simple" is supposed to do.

== Carleton in Assets for FMs ==
In the tables below, most content has a textscale above 0.30, so draws from the 48pt size, '''indicated in bold'''. Otherwise, with a textscale of 0.16 to 0.30, from 24pt.

{| class="wikitable" style="margin-left: 0px; margin-right: auto;"
|+ '''Carleton in Standard Readable Prefabs.'''
Within \tdm_prefabs01\xdata\prefabs.xd, "gui_page<n>" : "guis/readables/..."
|-
! Prefab !! Title textscale !! Body textscale
|-
| .../books/... none || ||
|-
| .../scrolls/scroll_print_carleton.gui || '''0.40''' || 0.28
|-
| .../sheets/sheet_paper_print_carleton_caps.gui || '''0.40''' || '''0.31'''
|}

{| class="wikitable" style="margin-left: 0px; margin-right: auto;"
|+ '''Carleton in Sign Text.''' Within \sign_text_decals\
|-
! Decal !! Textscale
|-
| sign_text_carleton.gui || '''2'''
|-
| sign_text_carleton_small.gui || '''1'''
|}

== Carleton_condensed ==
As indicated above, Carleton_condensed DDS files are all 256x256.

=== 12pt Size ===
''The main menu system does not use this size. In your FM, it is recommended to NOT invoke 12pt carleton_condensed (i.e., by specifying a GUI textscale of 0.15 or less). Instead, use regular carleton, possibly with a slightly smaller textscale.''

Although 12pt carleton_condensed exists, its DAT file and single DDS file are mere placeholders that are identical to those of carleton 12pt.

=== 48pt Size ===
''The main menu system does not use this size. In your FM, it is recommended to NOT invoke 48pt carleton_condensed (i.e., by specifying a GUI textscale of above 0.30). Instead, use regular carleton, possibly with a slightly smaller textscale.''

The set of eight DDS files for 48pt carleton_condensed are identical to those for 48pt carleton. However, the DAT file has different content, though the difference is not due to horizontal "condensation".

A one time, Tels drafted a Font Patcher command file for 48pt carleton_condensed, to reduce the width and xSkip of a selected subset of the carleton’s ASCII alphanumeric characters, presumably those most generously spaced to begin with. Evidently this was not finalized and deployed. Instead, inspection of the current 48pt DAT file for carleton_condensed suggests it was based on an early version of carleton, at a time when only some of the accented characters were implemented. (In particular, the DAT lacks re-implemented metrics for chars 128-139 and 145-155.)

=== 24pt Size ===
''The main menu system uses this, but sparingly. Since a "glow" form of carleton_condensed was never developed, only regular non-glow uses are applicable.''

The contents of the DAT file and the set of two DDS files for 48pt carleton_condensed DIFFER from those for 48pt carleton.

For the main menu system, where carleton was used for English-language players, the more-compact carleton_condensed was briefly considered as a method of accommodating European language translations. However, this would require dynamic language switching, and was found to be a hill too far, compared to just reducing Carleton’s textscale value.

The actual limited uses in the main menu systems are seen as you survey the downloadable missions. Specifically, when looking at a candidate mission, the Mission Details page has a Description section, whose body text is carleton_condensed with textscale 0.17. Compared to other similar text section here (that use regular carleton with textscale 0.18), this is slightly smaller and condensed. Also, the Next >> and << Prev buttons for cycling through screenshots have their button captions in this font (with textscale 0.23).

== For More ==
* Character-set coverage of Carleton family is included in the the [https://forums.thedarkmod.com/index.php?/topic/22427-analysis-of-212-tdm-fonts/ summary analysis of 2.12 TDM fonts], based on applying 'refont -stats ...' to all 'english' DAT files.

{{tutorial}} [[Category:Fonts]]

I18N - Charset

2026-05-02T16:19:45Z

Geep: create "Fonts with Special Characters" section

== Introduction ==

The D3 code that handles the GUI bitmap font can only load a specific range of bytes as characters. To get the most out of the available entries, special charsets are used. The fonts (Carleton for the menu f.i.) are build/patched so that the right characters appear in the right place.

== Encodings ==

=== all.lang ===

This file is in '''UTF-8''', and converted with the help of the script '''devel/gen_lang.pl''':

perl devel/gen_lang.pl

This ensures that the generated language files are in their proper encodings (see below).

=== All other language files ===

Note that the language files (f.i. '''strings/german.lang''') as well as the readables and the FM dictionariaries are expected to be in the following encodings:

* '''Czech''', '''Hungarian''', '''Slovak''', '''Polish:''' [https://secure.wikimedia.org/wikipedia/en/wiki/ISO/IEC_8859-2 ISO-8859-2] ('''not WIN-1250!)
* '''Russian:''' [https://secure.wikimedia.org/wikipedia/en/wiki/Win-1251 WIN-1251]
* '''French:''' [https://secure.wikimedia.org/wikipedia/en/wiki/ISO/IEC_8859-15 ISO-8859-15]
* '''Romanian:''' [https://secure.wikimedia.org/wikipedia/en/wiki/ISO/IEC_8859-16 ISO-8859-16]
* '''All other languages:''' [https://secure.wikimedia.org/wikipedia/en/wiki/ISO/IEC_8859-1 ISO-8859-1] (German, Dutch, Danish, Swedish, Portuguese, etc.)

{{infobox|The core dictionaries are automatically generated in the right encoding, but make sure that you use the right encoding for the FM dictionary, too!}}

== Character remapping ==

The characters are remapped upon loading the dictionary/readable, from their native encoding to the special one that TDM uses and that is described here. Responsible for the remapping are [[I18N - Character mapping|mapping files]], f.i. "strings/czech.map". If a map file for a specific language is not found, "strings/default.map" is used instead, if this is not found, no remapping takes place.

See '''[[I18N - Character mapping|Character mapping]]''' for more information.

=== European Languages ===

This mapping is used for European languages, f.i. '''Czech''', '''French''', '''German''', '''Spanish''', '''Portuguese''', '''Polish'''. Note that the double accented characters in Hungarian '''Ő, ő, Ű and ű''' look a bit different from '''Ö, ö, Ü and ü'''!

In the table below, the original ISO 8859-1 characters are given in ''()'' below the TDM character.

'''Color code:'''

{{box|#f0d0d0|Character not usable by TDM|Unusable}}{{box|#d0e0d0|Character not yet used in TDM|Unused}}{{box|#c0ffc0|Character displayed in v1.08 or newer|Usable in v1.08}}{{box|#80f080|Character displayed in v2.03 or newer|Usable in v2.03}}{{box|#d0d0f0|Changed from the ISO-8859-1 default, usable by TDM 1.0 or newer|Changed from ISO 8859-1}}

{|class="wikitable" border=1 style="border-collapse: collapse; font-size: 95%" cellspacing=0 cellpadding=2 width=100%

|-
!
!…0
!…1
!…2
!…3
!…4
!…5
!…6
!…7
!…8
!…9
!…A
!…B
!…C
!…D
!…E
!…F

|-
!0…
|align='center' style='background: #f0d0d0'|00 '''–'''
|align='center' style='background: #f0d0d0'|01 '''–'''
|align='center' style='background: #f0d0d0'|02 '''–'''
|align='center' style='background: #f0d0d0'|03 '''–'''
|align='center' style='background: #f0d0d0'|04 '''–'''
|align='center' style='background: #f0d0d0'|05 '''–'''
|align='center' style='background: #f0d0d0'|06 '''–'''
|align='center' style='background: #f0d0d0'|07 '''–'''
|align='center' style='background: #f0d0d0'|08 '''–'''
|align='center' style='background: #f0d0d0'|09 '''–'''
|align='center' style='background: #f0d0d0'|0A '''–'''
|align='center' style='background: #f0d0d0'|0B '''–'''
|align='center' style='background: #f0d0d0'|0C '''–'''
|align='center' style='background: #f0d0d0'|0D '''–'''
|align='center' style='background: #f0d0d0'|0E '''–'''
|align='center' style='background: #f0d0d0'|0F '''–'''

|-
!1…
|align='center' style='background: #f0d0d0'|10 '''–'''
|align='center' style='background: #f0d0d0'|11 '''–'''
|align='center' style='background: #f0d0d0'|12 '''–'''
|align='center' style='background: #f0d0d0'|13 '''–'''
|align='center' style='background: #f0d0d0'|14 '''–'''
|align='center' style='background: #f0d0d0'|15 '''–'''
|align='center' style='background: #f0d0d0'|16 '''–'''
|align='center' style='background: #f0d0d0'|17 '''–'''
|align='center' style='background: #f0d0d0'|18 '''–'''
|align='center' style='background: #f0d0d0'|19 '''–'''
|align='center' style='background: #f0d0d0'|1A '''–'''
|align='center' style='background: #f0d0d0'|1B '''–'''
|align='center' style='background: #f0d0d0'|1C '''–'''
|align='center' style='background: #f0d0d0'|1D '''–'''
|align='center' style='background: #f0d0d0'|1E '''–'''
|align='center' style='background: #f0d0d0'|1F '''–'''

|-
!2…
|align='center'|20 ''' '''
|align='center'|21 '''!'''
|align='center'|22 '''"'''
|align='center'|23 '''#'''
|align='center'|24 '''$'''
|align='center'|25 '''%'''
|align='center'|26 '''&'''
|align='center'|27 '''''''
|align='center'|28 '''('''
|align='center'|29 ''')'''
|align='center'|2A '''*'''
|align='center'|2B '''+'''
|align='center'|2C ''','''
|align='center'|2D '''-'''
|align='center'|2E '''.'''
|align='center'|2F '''/'''

|-
!3…
|align='center'|30 '''0'''
|align='center'|31 '''1'''
|align='center'|32 '''2'''
|align='center'|33 '''3'''
|align='center'|34 '''4'''
|align='center'|35 '''5'''
|align='center'|36 '''6'''
|align='center'|37 '''7'''
|align='center'|38 '''8'''
|align='center'|39 '''9'''
|align='center'|3A ''':'''
|align='center'|3B ''';'''
|align='center'|3C '''<'''
|align='center'|3D '''='''
|align='center'|3E '''>'''
|align='center'|3F '''?'''

|-
!4…
|align='center'|40 '''@'''
|align='center'|41 '''A'''
|align='center'|42 '''B'''
|align='center'|43 '''C'''
|align='center'|44 '''D'''
|align='center'|45 '''E'''
|align='center'|46 '''F'''
|align='center'|47 '''G'''
|align='center'|48 '''H'''
|align='center'|49 '''I'''
|align='center'|4A '''J'''
|align='center'|4B '''K'''
|align='center'|4C '''L'''
|align='center'|4D '''M'''
|align='center'|4E '''N'''
|align='center'|4F '''O'''

|-
!5…
|align='center'|50 '''P'''
|align='center'|51 '''Q'''
|align='center'|52 '''R'''
|align='center'|53 '''S'''
|align='center'|54 '''T'''
|align='center'|55 '''U'''
|align='center'|56 '''V'''
|align='center'|57 '''W'''
|align='center'|58 '''X'''
|align='center'|59 '''Y'''
|align='center'|5A '''Z'''
|align='center'|5B '''['''
|align='center'|5C '''\'''
|align='center'|5D ''']'''
|align='center'|5E '''^'''
|align='center'|5F '''_'''

|-
!6…
|align='center'|60 '''`'''
|align='center'|61 '''a'''
|align='center'|62 '''b'''
|align='center'|63 '''c'''
|align='center'|64 '''d'''
|align='center'|65 '''e'''
|align='center'|66 '''f'''
|align='center'|67 '''g'''
|align='center'|68 '''h'''
|align='center'|69 '''i'''
|align='center'|6A '''j'''
|align='center'|6B '''k'''
|align='center'|6C '''l'''
|align='center'|6D '''m'''
|align='center'|6E '''n'''
|align='center'|6F '''o'''

|-
!7…
|align='center'|70 '''p'''
|align='center'|71 '''q'''
|align='center'|72 '''r'''
|align='center'|73 '''s'''
|align='center'|74 '''t'''
|align='center'|75 '''u'''
|align='center'|76 '''v'''
|align='center'|77 '''w'''
|align='center'|78 '''x'''
|align='center'|79 '''y'''
|align='center'|7A '''z'''
|align='center'|7B '''{'''
|align='center'|7C '''|'''
|align='center'|7D '''}'''
|align='center'|7E '''~'''
|align='center' style='background: #d0e0d0'|7F '''�'''

|-
!8…
|align='center' style='background: #c0ffc0'|80 '''Ň'''
|align='center' style='background: #c0ffc0'|81 '''Ś'''
|align='center' style='background: #c0ffc0'|82 '''Ć'''
|align='center' style='background: #c0ffc0'|83 '''Ż'''
|align='center' style='background: #c0ffc0'|84 '''Ź'''
|align='center' style='background: #c0ffc0'|85 '''Ŝ'''
|align='center' style='background: #c0ffc0'|86 '''Ĉ'''
|align='center' style='background: #c0ffc0'|87 '''Ẑ'''
|align='center' style='background: #c0ffc0'|88 '''Ô''' [1]
|align='center' style='background: #c0ffc0'|89 '''Ŕ'''
|align='center' style='background: #c0ffc0'|8A '''Ǔ'''
|align='center' style='background: #c0ffc0'|8B '''Ă'''
|align='center' style='background: #c0ffc0'|8C '''Ń'''
|align='center' style='background: #80f080'|8D '''Ș'''
|align='center' style='background: #80f080'|8E '''Ț'''
|align='center' style='background: #d0e0d0'|8F '''�'''

|-
!9…
|align='center' style='background: #80f080'|90 '''đ'''
|align='center' style='background: #c0ffc0'|91 '''ś'''
|align='center' style='background: #c0ffc0'|92 '''ć'''
|align='center' style='background: #c0ffc0'|93 '''ż'''
|align='center' style='background: #c0ffc0'|94 '''ź'''
|align='center' style='background: #c0ffc0'|95 '''ŝ'''
|align='center' style='background: #c0ffc0'|96 '''ĉ'''
|align='center' style='background: #c0ffc0'|97 '''ẑ'''
|align='center' style='background: #c0ffc0'|98 '''ô''' [1]
|align='center' style='background: #c0ffc0'|99 '''ŕ'''
|align='center' style='background: #c0ffc0'|9A '''ǔ'''
|align='center' style='background: #c0ffc0'|9B '''ă'''
|align='center' style='background: #c0ffc0'|9C '''ń'''
|align='center' style='background: #80f080'|9D '''ș'''
|align='center' style='background: #80f080'|9E '''ț'''
|align='center' style='background: #d0e0d0'|9F '''�'''

|-
!A…
|align='center'|A0 '''[https://secure.wikimedia.org/wikipedia/en/wiki/Non-breaking_space NBSP]''' [2]
|align='center' style='background: #d0d0f0'|A1 '''ň''' (¡)'''
|align='center' style='background: #d0d0f0'|A2 '''Ű''' (¢)'''
|align='center' style='background: #d0d0f0'|A3 '''ě''' (£)'''
|align='center' style='background: #d0d0f0'|A4 '''ű''' (¤)'''
|align='center' style='background: #d0d0f0'|A5 '''Ě''' (¥)'''
|align='center' style='background: #d0d0f0'|A6 '''Š''' (¦)'''
|align='center'|A7 '''§'''
|align='center' style='background: #d0d0f0'|A8 '''š''' (¨)'''
|align='center' style='background: #d0d0f0'|A9 '''Ů''' (©)'''
|align='center' style='background: #d0d0f0'|AA '''Ą''' (ª)'''
|align='center' style='background: #d0d0f0'|AB '''Ę''' («)'''
|align='center' style='background: #d0d0f0'|AC '''Č''' (¬)'''
|align='center'|AD '''[https://secure.wikimedia.org/wikipedia/en/wiki/Soft_hyphen SHY]''' [2]
|align='center' style='background: #d0d0f0'|AE '''č''' (®)'''
|align='center' style='background: #d0d0f0'|AF '''ů''' (¯)'''

|-
!B…
|align='center' style='background: #d0d0f0'|B0 '''Ő''' (°)'''
|align='center' style='background: #d0d0f0'|B1 '''Ł''' (±)'''
|align='center' style='background: #d0d0f0'|B2 '''Ť''' (²)'''
|align='center' style='background: #d0d0f0'|B3 '''Ď''' (³)'''
|align='center' style='background: #d0d0f0'|B4 '''Ž''' (´)'''
|align='center' style='background: #d0d0f0'|B5 '''ł''' (µ)'''
|align='center' style='background: #d0d0f0'|B6 '''ť''' (¶)'''
|align='center' style='background: #d0d0f0'|B7 '''ď''' (·)'''
|align='center' style='background: #d0d0f0'|B8 '''ž''' (¸)'''
|align='center' style='background: #d0d0f0'|B9 '''ő''' (¹)'''
|align='center' style='background: #d0d0f0'|BA '''ą''' (º)'''
|align='center' style='background: #d0d0f0'|BB '''ę''' (»)'''
|align='center' style='background: #d0d0f0'|BC '''Œ''' (¼)'''
|align='center' style='background: #d0d0f0'|BD '''œ''' (½)'''
|align='center' style='background: #d0d0f0'|BE '''Ÿ''' (¾)'''
|align='center'|BF '''¿'''

|-
!C…
|align='center'|C0 '''À'''
|align='center'|C1 '''Á'''
|align='center'|C2 '''Â'''
|align='center'|C3 '''Ã'''
|align='center'|C4 '''Ä'''
|align='center'|C5 '''Å'''
|align='center'|C6 '''Æ'''
|align='center'|C7 '''Ç'''
|align='center'|C8 '''È'''
|align='center'|C9 '''É'''
|align='center'|CA '''Ê'''
|align='center'|CB '''Ë'''
|align='center'|CC '''Ì'''
|align='center'|CD '''Í'''
|align='center'|CE '''Î'''
|align='center'|CF '''Ï'''

|-
!D…
|align='center'|D0 '''Ð'''
|align='center'|D1 '''Ñ'''
|align='center'|D2 '''Ò'''
|align='center'|D3 '''Ó'''
|align='center'|D4 '''Ô'''
|align='center'|D5 '''Õ'''
|align='center'|D6 '''Ö'''
|align='center' style='background: #d0d0f0'|D7 '''Ř''' (×)'''
|align='center'|D8 '''Ø'''
|align='center'|D9 '''Ù'''
|align='center'|DA '''Ú'''
|align='center'|DB '''Û'''
|align='center'|DC '''Ü'''
|align='center'|DD '''Ý'''
|align='center'|DE '''Þ'''
|align='center'|DF '''ß'''

|-
!E…
|align='center'|E0 '''à'''
|align='center'|E1 '''á'''
|align='center'|E2 '''â'''
|align='center'|E3 '''ã'''
|align='center'|E4 '''ä'''
|align='center'|E5 '''å'''
|align='center'|E6 '''æ'''
|align='center'|E7 '''ç'''
|align='center'|E8 '''è'''
|align='center'|E9 '''é'''
|align='center'|EA '''ê'''
|align='center'|EB '''ë'''
|align='center'|EC '''ì'''
|align='center'|ED '''í'''
|align='center'|EE '''î'''
|align='center'|EF '''ï'''

|-
!F…
|align='center'|F0 '''ð'''
|align='center'|F1 '''ñ'''
|align='center'|F2 '''ò'''
|align='center'|F3 '''ó'''
|align='center'|F4 '''ô'''
|align='center'|F5 '''õ'''
|align='center'|F6 '''ö'''
|align='center' style='background: #d0d0f0'|F7 '''ř''' (÷)'''
|align='center'|F8 '''ø'''
|align='center'|F9 '''ù'''
|align='center'|FA '''ú'''
|align='center'|FB '''û'''
|align='center'|FC '''ü'''
|align='center'|FD '''ý'''
|align='center'|FE '''þ'''
|align='center'|FF '''ÿ'''

|}

==== Table Notes ====

'''[1]''' As discussed [https://forums.thedarkmod.com/index.php?/topic/22427-analysis-of-212-tdm-fonts/&do=findComment&comment=494855 here], the TDM char set has a redundant treatment of 2 characters:

* Ô appears at 0x88 and 0xD4
* ô appears at 0x98 and 0xF4

Starting with TDM 2.13, the redundancy can be removed and these new characters (from ISO-8859-3) introduced:

* Ğ appears at 0x88
* ğ appears at 0x98

'''[2]''' Avoid using the non-breaking space (NBSP, 0xA0) and the soft hyphen (SHY, 0xAD) in your strings. The TDM engine has no code to respect these during word wrap. Font maintainers: probably map NBSP to the <space> glyph, SHY to undefined/hollow box or zero-sized box.

==== Corresponding Unicode ====

For a mapping of these 256 codepoints to Unicode U+NNNN values and formal names, download 'TDM 8859-Style Font Map to Unicode-16.txt':

* [https://drive.google.com/file/d/1wLEtuFvnrZ-WHK8ign8i3diIXZdriZ4F/view?usp=sharing for TDM 2.13]
* [https://drive.google.com/file/d/1UAz9jSZpT_j33STP3So_Re8JWa8QuAmz/view?usp=sharing for TDM 2.12 and earlier]

Each of these files (by Geep, 2024) is in a standardized format so that it can also be imported into font design programs like FontForge as a custom 256-position map. In the comments, there is additional information about:
* ISO 8859-x sourcing of each character.
* alternative representations of some European and control characters.

==== Fonts with Special Characters ====
Certain fonts have a few codepoints that purposefully diverge from the table entry.

* Carleton font (regular, bold, glow) uses codepoint 0x23, ordinarily "#", to represent "superscript #", which is used in the main menu system to indicate FMs for which a translation pack is available.
* Treasure Map font has characters for "pirate skull and crossbones" and "bottle of booze (or poison)".

=== Russian ===

Characters conform to the [https://en.wikipedia.org/wiki/Win-1251 WIN-1251 native encoding, shown in the Wikipedia article]. Exception: the character '''0xFF''' (я) is mapped to '''0xB6''' upon loading. Therefore any Russian font must contain я at the place 0xB6.

Within any given font, character overage may be incomplete. A 2025 effort extended the Mason 48pt font to all 256 codepoints.

=== Asian Languages (Korean, Chinese, Japanese) ===

The original D3 had support for these languages, so it might be possible to add them to TDM, too. At the moment, however, we lack the fonts and translators. Also, writing from right-to-left (Hebrew) or top-down (Japanese) might be tricky or outright impossible in our GUI without more work in the C++ code. Plus, these languages use more than 256 different characters, and an 8 bit table will not hold these.

== European Character Implementation ==
=== Priority Early-On - the "Top 50" ===

Some of the special characters are used more often than others. Here is a statistic over the entire string set of the TDM core, from TDM v1.08, showing the top 50 most-used characters (excluding a-z, 0-9 and russian characters):

{|class="wikitable" border=1 style="border-collapse: collapse; font-size: 85%" cellspacing=0 cellpadding=2

|-
|Rank
|Occurances
|Letter
|Remarks
|Rank
|Occurances
|Letter
|Remarks

|-
|1
|í
|715
|
|25
|ć
|67
|

|-
|2
|é
|674
|
|26
|è
|65
|

|-
|3
|á
|524
|
|27
|ú
|56
|

|-
|4
|ø
|303
|Danish
|28
|ê
|52
|

|-
|5
|č
|288
|
|29
|ö
|48
|German

|-
|6
|ó
|283
|
|30
|É
|46
|

|-
|7
|ü
|270
|German
|31
|ñ
|37
|

|-
|8
|ł
|203
|Polish
|32
|õ
|32
|

|-
|9
|æ
|200
|Danish
|33
|ń
|26
|

|-
|10
|ě
|182
|
|34
|Ł
|24
|

|-
|11
|ř
|175
|Czech
|35
|Š
|21
|

|-
|12
|ã
|168
|
|36
|â
|21
|

|-
|13
|ž
|148
|Czech
|37
|ź
|20
|

|-
|14
|ý
|142
|
|38
|ß
|18
|German

|-
|15
|ę
|141
|
|39
|Ó
|18
|

|-
|16
|ą
|140
|
|40
|ň
|15
|

|-
|17
|ż
|119
|
|41
|Ú
|15
|

|-
|18
|å
|109
|Danish
|42
|Á
|13
|

|-
|19
|š
|99
|
|43
|î
|12
|

|-
|20
|ś
|97
|
|44
|ť
|11
|

|-
|21
|ç
|91
|
|45
|ô
|9
|

|-
|22
|ä
|86
|German
|46
|Ž
|8
|

|-
|23
|à
|83
|
|47
|Ż
|7
|

|-
|24
|ů
|77
|
|48
|Č
|7
|

|-
|25
|ć
|67
|
|49
|ù
|6
|

|}

Although ö, ä and ü do not appear that often, with only these and Ü, Ö, Ä and ß, the entire German language works. So adding these letters to the fonts is quite important.

Preferably, all foreign letters would be added to the fonts (see [[Font Patcher]] or [[Refont]]). However, if time permits only adding a few, '''í''' would be more important than, say, '''ô'''.

It is commonplace for missing accented letters to be redirected in the .dat file to the corresponding unaccented base letter.

=== Coverage Expansion & Remaining Limitations ===

By 2014, all the system (e.g., main menu) fonts (Carleton, Carleton_condensed, Stone in sizes 24pt and 48pt; Mason and Mason_glow in 48pt) had good coverage of the "Top 50" and beyond, although not all 256 codepoints.
This was confirmed more specifically in 2024, as part of an [https://forums.thedarkmod.com/index.php?/topic/22427-analysis-of-212-tdm-fonts/ Analysis of 2.12 Fonts]. This analysis indicated that, unlike the system fonts, the FM fonts generally did not provide specific glyphs beyond ASCII.

In 2024, Stone 24pt, important for subtitles and a number of readables, was further extended to cover all 256 codepoints. This was tested with TDM 2.13[betas] and released with 2.14. Similar Stone 48pt and Carleton 24pt improvements are planned for TDM 2.15.

[[Category:Fonts]]

{{i18n}}