Font Conversion & Repair: Difference between revisions

From The DarkMod Wiki
Jump to navigationJump to search
Geep (talk | contribs)
Start of redo. Break out Q3Font info into separate article
Line 1: Line 1:
These are some rough notes about converting ttf fonts to doom3 and repairing if necessary.
 


__TOC__
__TOC__


There are three tools:
As of 2024, there are four tools for TDM font conversion and repair:


* ExportFontToDoom
* [[ExportFontToDoom]] (ARTICLE COMING SOON)
* Q3Font [http://rfactory.org/q3font.html] (Runs also fine under ''Wine'')
* [[Q3Font]]
* [[Refont]] - New in 2024
* [[Font Patcher]]
* [[Font Patcher]]
== Fidcal's Original Take ==
These are some rough notes about converting ttf fonts to doom3 and repairing if necessary.


My understanding is that ''ExportFontToDoom'' is more suitable than Q3Font for converting. It is what I used to convert a lot of TTF fonts. See notes with that tool as to how use it. But be aware of copyright issues if converting TTF fonts.
My understanding is that ''ExportFontToDoom'' is more suitable than Q3Font for converting. It is what I used to convert a lot of TTF fonts. See notes with that tool as to how use it. But be aware of copyright issues if converting TTF fonts.
Line 21: Line 25:
The size 24 is used mostly by readables, while the menu uses 48 (the big headlines and the main menu) and 24 (settings and other headlines).
The size 24 is used mostly by readables, while the menu uses 48 (the big headlines and the main menu) and 24 (settings and other headlines).


This means it is not nec. to create other sizes, as these will be ignored, anyway.
This means it is not necessary to create other sizes, as these will be ignored, anyway.
 
== q3font ==
 
Copy the dat file(s) to the q3font folder and use this syntax to get a readable .fnt file:
 
q3font.exe -decompile fontImage_24.dat
 
A common problem is this:
 
Characters have an actual width but they also have a distance value from where they start being 'written' to the start of the next letter (xskip in the readable .fnt files.)
 
The true type font to doom font convertor named ExportFontToDoom3 appears to calculate this based on the character width (my guess.)
 
If lower case letters have descenders that curl back under the previous letter on the line, eg, f, g, j, p, y (q is OK because it curls forward) then the actual width of the character is greater than the distance from its start point to the start of the next character.
 
So, ExportFontToDoom3 makes xskip too big in the case of the above letters.
Reducing xskip in the .fnt files and restoring them to .dat files cures the problem.
 
In the readable .fnt files the characters are ASCII numbers.
A to Z are 65 to 90
a to z are 97 to 122
f = 102
g = 103
j = 106
p = 112
y = 121
 
Search the net for an ascii code list for others, or use "ascii" on the Linux console to get a list.
 
They fnt file can be converted back to .dat files using...
 
q3font.exe fontImage_24
 
You will need to relaunch Doom each adjustment as there is no quick way to reload fonts.
 
Example: Say you want to reduce the space after letter j
* q3font.exe -decompile fontImage_24.dat to produce a readable .fnt file
* In the .fnt file search down for the character header, eg, char 106.
* Within the curly brackets below the header are the various values.
* Look for xSkip.
* Say it has a value of 12. Try reducing it to 9 to reduce the offset.
* Convert back to .dat format, reload Dark Mod and check in-game.
 
== font_patcher.pl ==
 
The prefered method to fix and change fonts is via the font patcher utility. Please see the [[Font Patcher|main article]] for details.
 
== I18N (Internationalization) ==


If you convert a russian font, you need to move the character 0xFF to 0xB6, otherwise it will not show in the GUI or readables. See [[I18N - Charset]] for details.
== Further Thoughts and Updates ==
* Usage of font sizes. Some readables, like those with the Stone font, use 48 pt for titles. The subtitle system (as of TDM 2.12) uses Stone 24 pt, with (at render time) horizontal compression.
* [[Q3Font]] is where you can find updated info about using this Windows utility program, including Fidcal's simple example. (Some of this info used to be here in Font Conversion & Repair.).
* [[Refont]] describes this command-line program, that handles some of Q3font's functionality, but is easier to use. This new article has a detailed comparison.
* [[ExportFontToDoom]] (ARTICLE COMING SOON)
* [[Font Patcher]] has details about the font_patcher.pl utility, which is a preferred method (over Q3font) to fix and change fonts.
* I18N (Internationalization). If you convert a Russian font, you need to move the character 0xFF to 0xB6, otherwise it will not show in the GUI or readables. See [[I18N - Charset]] for details.


== Weblinks ==
== Weblinks ==

Revision as of 02:00, 5 March 2024


As of 2024, there are four tools for TDM font conversion and repair:

Fidcal's Original Take

These are some rough notes about converting ttf fonts to doom3 and repairing if necessary.

My understanding is that ExportFontToDoom is more suitable than Q3Font for converting. It is what I used to convert a lot of TTF fonts. See notes with that tool as to how use it. But be aware of copyright issues if converting TTF fonts.

With ExportFontToDoom there were quite a few spacing errors. Q3Font I found a bit puzzling so never did any conversions (it may be better for all I know.) BUT it can convert the dat files to readables for editing and back again so I used Q3Font to fix the errors.

Doom fonts have multiple dat files for each size. However, only the following are loaded by the code:

  • fontImage_12.dat
  • fontImage_24.dat
  • fontImage_48.dat

The size 24 is used mostly by readables, while the menu uses 48 (the big headlines and the main menu) and 24 (settings and other headlines).

This means it is not necessary to create other sizes, as these will be ignored, anyway.

Further Thoughts and Updates

  • Usage of font sizes. Some readables, like those with the Stone font, use 48 pt for titles. The subtitle system (as of TDM 2.12) uses Stone 24 pt, with (at render time) horizontal compression.
  • Q3Font is where you can find updated info about using this Windows utility program, including Fidcal's simple example. (Some of this info used to be here in Font Conversion & Repair.).
  • Refont describes this command-line program, that handles some of Q3font's functionality, but is easier to use. This new article has a detailed comparison.
  • ExportFontToDoom (ARTICLE COMING SOON)
  • Font Patcher has details about the font_patcher.pl utility, which is a preferred method (over Q3font) to fix and change fonts.
  • I18N (Internationalization). If you convert a Russian font, you need to move the character 0xFF to 0xB6, otherwise it will not show in the GUI or readables. See I18N - Charset for details.

Weblinks