ExportFontToDoom3 - Revision history

Geep: Add See Also: ExportUnicodeFontToDoom3

2025-09-10T19:48:47Z

Add See Also: ExportUnicodeFontToDoom3

← Older revision		Revision as of 19:48, 10 September 2025
Line 88:		Line 88:
	* also from wayback machine.		* also from wayback machine.
	The project makes use of the circa-2005 FreeType font library (www.freetype.org) and DevIL image library.		The project makes use of the circa-2005 FreeType font library (www.freetype.org) and DevIL image library.

			== See Also: [[ExportUnicodeFontToDoom3]] ==
			This project, the successor to ExportFontToDoom3All256, can export Cyrillic and other Unicode characters, and adds further useful options.

	{{tutorial}} [[Category:Fonts]]		{{tutorial}} [[Category:Fonts]]

Geep: /* Intro to ExportFontToDoom3 & ExportFontToDoom3All256 */ Add link to ExportUnicdoeFontToDoom3

2025-09-10T19:42:27Z

Intro to ExportFontToDoom3 & ExportFontToDoom3All256: Add link to ExportUnicdoeFontToDoom3

← Older revision		Revision as of 19:42, 10 September 2025
Line 5:		Line 5:

	'''ExportFontToDoom3All256''' fixes that bug; it exports the glyphs assigned to codepoints in the range 0-255, routinely ANSI characters. It is also easier to run on modern Windows PCs, so recommended. It takes the same command-line arguments as ExportFontToDoom3. Credits to Crispy (for 2009 fix) and (in 2024 form) Geep.		'''ExportFontToDoom3All256''' fixes that bug; it exports the glyphs assigned to codepoints in the range 0-255, routinely ANSI characters. It is also easier to run on modern Windows PCs, so recommended. It takes the same command-line arguments as ExportFontToDoom3. Credits to Crispy (for 2009 fix) and (in 2024 form) Geep.

			'''See Also: successor project [[ExportUnicodeFontToDoom3]]''', that can export Cyrillic and other Unicode characters, and adds further useful options.

	== Using the Tool ==		== Using the Tool ==

Geep: /* Name Option */ Mention truncation, show template, add tip

2025-09-10T19:34:41Z

Name Option: Mention truncation, show template, add tip

← Older revision		Revision as of 19:34, 10 September 2025
Line 30:		Line 30:

	=== Name Option ===		=== Name Option ===
	To name the font to be exported, use the option:		To (re)name the font to be exported, use the option:
	-name ''fontname''		-name ''fontname''
	By default, the fontname is instead extracted from the font file. In either case, ~~this~~ fontname string will ~~begin~~ each of the TGA filename(s), which are referenced in turn in the per-character "shaderName" fields of the DAT file.		By default, the fontname is instead extracted from the font file. In either case, the fontname string will be truncated if too long. It then begins each of the TGA filename(s), which are referenced in turn in the per-character "shaderName" fields of the DAT file. The shaderName field in a DAT file can have at most 32 characters; when viewed as a REF or FNT file, it has this template:
			shaderName fontname_<1- or 2-digit count>_<2-digit fontsize>.tga

			''TIP: If the default fontname is more than 16 characters, it is recommended you use the -name option, to prevent ugly truncation or (corrected in ExportUnicodeFontToDoom3) aborts.''

	=== Other Options ===		=== Other Options ===
	In the description doc, there is a great deal of technical discussion about these next options, but of little likely relevance to TDM nowadays. Just ignore them in favor of their default values.		In the description doc, there is a great deal of technical discussion about these next options, but of little likely relevance to TDM nowadays. Just ignore them in favor of their default values.

Geep: /* Size Option */ Mention glyphScale, non-standard sizes

2025-08-27T14:59:28Z

Size Option: Mention glyphScale, non-standard sizes

← Older revision		Revision as of 14:59, 27 August 2025
Line 17:		Line 17:
	To export the font in a certain size, use the option:		To export the font in a certain size, use the option:
	-size ''font_pointsize''		-size ''font_pointsize''
	For Doom3/TDM, only the sizes 12, 24, and 48 ~~should be chosen~~. More than one "-size" arguments may be specified, for example:		For Doom3/TDM, only the sizes 12, 24, and 48 directly produce valid end-products. More than one "-size" arguments may be specified, for example:
	ExportFontToDoom3All256 badtimes.ttf -size 12 -size 24		ExportFontToDoom3All256 badtimes.ttf -size 12 -size 24
	As indicated above, if no "-size" argument is specified, 12, 24, and 48 point fonts are exported.		As indicated above, if no "-size" argument is specified, 12, 24, and 48 point fonts are exported.

			The set of sizes in a particular generation run will jointly determine the "glyphScale" value specified at the end of bottom of a DAT/REF file, as follows:

			glyphScale[for size n] = largest-size-in-set / size-n

			So, depending on how you generate, you may have to hand-adjust the glyphScale later.

			It is possible to specify one or more non-standard sizes for special processing, e.g., to do TTF-to-DAT overall scaling. To use in TDM, this will need subsequent file renaming to one of the 3 valid sizes, and glyphScale correction.

	=== Name Option ===		=== Name Option ===
	To name the font to be exported, use the option:		To name the font to be exported, use the option:

Geep: /* Downloads of ExportFontToDoom3All256 */

2024-06-06T14:38:10Z

Downloads of ExportFontToDoom3All256

← Older revision		Revision as of 14:38, 6 June 2024
Line 54:		Line 54:
	* [https://drive.google.com/file/d/1HzyyuZv0AVEhw4czJEwQ4nDMuqCogRyi/view?usp=sharing 'ExportFontToDoom3All256 Release 1 of 04-26-2024.zip']		* [https://drive.google.com/file/d/1HzyyuZv0AVEhw4czJEwQ4nDMuqCogRyi/view?usp=sharing 'ExportFontToDoom3All256 Release 1 of 04-26-2024.zip']

	This version, having been rebuilt, does not require legacy msvcp71.dll & msvcr71.dll files needed to run ~~ExportFontToom3~~ v 1.02.		This version, having been rebuilt, does not require legacy msvcp71.dll & msvcr71.dll files needed to run ExportFontToDoom3 v 1.02.

	The C++ project file with source code:		The C++ project file with source code:

Geep: /* Downloads of ExportFontToDoom3All256 */ Mention test font

2024-04-26T16:17:25Z

Downloads of ExportFontToDoom3All256: Mention test font

← Older revision		Revision as of 16:17, 26 April 2024
Line 57:		Line 57:

	The C++ project file with source code:		The C++ project file with source code:
	* [https://drive.google.com/file/d/1nkXJpBPa8qDqQxVQd9c1HlsSMKgohIw-/view?usp=sharing ExportFontToDoom3All256_source_project.zip] Release 1 of 04-26-2024. This zip is 177 MB; includes source & build project of archived library.		* [https://drive.google.com/file/d/1nkXJpBPa8qDqQxVQd9c1HlsSMKgohIw-/view?usp=sharing ExportFontToDoom3All256_source_project.zip] Release 1 of 04-26-2024. This zip is 177 MB; includes source & build project of archived library. Also sample TTF font (distributed with TDM) for debug testing.

	For more about the modification and rebuild process, see "ReadMe_about_All256.txt", included in either of these two .zip downloads.		For more about the modification and rebuild process, see "ReadMe_about_All256.txt", included in either of these two .zip downloads.

Geep: /* Downloads of ExportFontToDoom3All256 */ Add link to source code project

2024-04-26T16:15:40Z

Downloads of ExportFontToDoom3All256: Add link to source code project

← Older revision		Revision as of 16:15, 26 April 2024
Line 52:		Line 52:
	== Downloads of ExportFontToDoom3All256 ==		== Downloads of ExportFontToDoom3All256 ==
	Windows binary and required archived versions of FreeType and DevIL DLLs:		Windows binary and required archived versions of FreeType and DevIL DLLs:
	* [https://drive.google.com/file/d/1HzyyuZv0AVEhw4czJEwQ4nDMuqCogRyi/view?usp=sharing ExportFontToDoom3All256 Release 1 of 04-26-2024]		* [https://drive.google.com/file/d/1HzyyuZv0AVEhw4czJEwQ4nDMuqCogRyi/view?usp=sharing 'ExportFontToDoom3All256 Release 1 of 04-26-2024.zip']

	This version, having been rebuilt, does not require legacy msvcp71.dll & msvcr71.dll files needed to run ExportFontToom3 v 1.02~~. For more about the modification and rebuild process, see "ReadMe_about_All256.txt", included in the foregoing .zip download~~.		This version, having been rebuilt, does not require legacy msvcp71.dll & msvcr71.dll files needed to run ExportFontToom3 v 1.02.

	The C++ project file with source code:		The C++ project file with source code:
	* [~~COMING SOON~~]		* [https://drive.google.com/file/d/1nkXJpBPa8qDqQxVQd9c1HlsSMKgohIw-/view?usp=sharing ExportFontToDoom3All256_source_project.zip] Release 1 of 04-26-2024. This zip is 177 MB; includes source & build project of archived library.

			For more about the modification and rebuild process, see "ReadMe_about_All256.txt", included in either of these two .zip downloads.

	== Downloads of ExportFontToDoom3 v 1.02 ==		== Downloads of ExportFontToDoom3 v 1.02 ==

Geep: Download link to ...All256 with context; rebuild details moved to 'Readme_about_All256.txt" file

2024-04-26T15:07:13Z

Download link to ...All256 with context; rebuild details moved to 'Readme_about_All256.txt" file

← Older revision		Revision as of 15:07, 26 April 2024
Line 2:		Line 2:
	The Windows command-line utility "ExportFontToDoom3" was created by Australian modder Grant Davies in 2005 to get TrueType Fonts, standard on Windows, into the metadata+bitmaps form needed by the Doom 3 engine. His final version, 1.02, was released as open-source and substantially used for TDM. It relies on the open-source DevIL and Freetype2 libraries.		The Windows command-line utility "ExportFontToDoom3" was created by Australian modder Grant Davies in 2005 to get TrueType Fonts, standard on Windows, into the metadata+bitmaps form needed by the Doom 3 engine. His final version, 1.02, was released as open-source and substantially used for TDM. It relies on the open-source DevIL and Freetype2 libraries.

	ExportFontToDoom3 exports only the bitmap glyphs assigned to codepoints in the range 0-127~~. These are~~ routinely the ASCII characters. The output actually generates metadata for 256 characters, but, due to a bug, upper-half characters are just mapped to the "undefined character" glyph.		'''ExportFontToDoom3''' exports only the bitmap glyphs assigned to codepoints in the range 0-127, routinely the ASCII characters. The output actually generates metadata for 256 characters, but, due to a bug, upper-half characters are just mapped to the "undefined character" glyph.

	ExportFontToDoom3All256 fixes that bug; it exports the glyphs assigned to codepoints in the range 0-255, routinely ANSI characters. It ~~has~~ the same command-line arguments as ExportFontToDoom3 ~~(which will be used in examples below)~~. Credits to Crispy (for 2009 fix) and (in 2024 form) Geep.		'''ExportFontToDoom3All256''' fixes that bug; it exports the glyphs assigned to codepoints in the range 0-255, routinely ANSI characters. It is also easier to run on modern Windows PCs, so recommended. It takes the same command-line arguments as ExportFontToDoom3. Credits to Crispy (for 2009 fix) and (in 2024 form) Geep.

	== Using the Tool ==		== Using the Tool ==
	''The information here is adapted from the description doc included with the download.''		''The information here is adapted from the description doc included with the ExportFontToDoom3 download.''
	=== Basic Command ===		=== Basic Command ===
	To export with the common settings of 12, 24, and 48 point fonts, simply type:		To export with the common settings of 12, 24, and 48 point fonts, simply type:
	~~ExportFontToDoom3~~ ''font_filename''		ExportFontToDoom3All256 ''font_filename''
	For example (and assuming here a font "badtimes" with no legal issues):		For example (and assuming here a font "badtimes" with no legal issues):
	~~ExportFontToDoom3~~ badtimes.ttf		ExportFontToDoom3All256 badtimes.ttf
	Most standard font formats (from the 2009 timeframe) can be used for export, but TrueType is most common.		Most standard font formats (from the 2009 timeframe) can be used for export, but TrueType is most common.
	=== Size Option ===		=== Size Option ===
Line 18:		Line 18:
	-size ''font_pointsize''		-size ''font_pointsize''
	For Doom3/TDM, only the sizes 12, 24, and 48 should be chosen. More than one "-size" arguments may be specified, for example:		For Doom3/TDM, only the sizes 12, 24, and 48 should be chosen. More than one "-size" arguments may be specified, for example:
	~~ExportFontToDoom3~~ badtimes.ttf -size 12 -size 24		ExportFontToDoom3All256 badtimes.ttf -size 12 -size 24
	As indicated above, if no "-size" argument is specified, 12, 24, and 48 point fonts are exported.		As indicated above, if no "-size" argument is specified, 12, 24, and 48 point fonts are exported.
	=== Name Option ===		=== Name Option ===
Line 49:		Line 49:
	* [https://web.archive.org/web/20081028224423/http://www.doom3world.org/phpbb2/viewtopic.php?t=11923 Tutorial 10 - Using custom fonts]		* [https://web.archive.org/web/20081028224423/http://www.doom3world.org/phpbb2/viewtopic.php?t=11923 Tutorial 10 - Using custom fonts]
	* [https://web.archive.org/web/20100522173219/http://www.doom3world.org/phpbb2/viewtopic.php?t=11924 Tutorial 11 - Editing fonts]		* [https://web.archive.org/web/20100522173219/http://www.doom3world.org/phpbb2/viewtopic.php?t=11924 Tutorial 11 - Editing fonts]

			== Downloads of ExportFontToDoom3All256 ==
			Windows binary and required archived versions of FreeType and DevIL DLLs:
			* [https://drive.google.com/file/d/1HzyyuZv0AVEhw4czJEwQ4nDMuqCogRyi/view?usp=sharing ExportFontToDoom3All256 Release 1 of 04-26-2024]

			This version, having been rebuilt, does not require legacy msvcp71.dll & msvcr71.dll files needed to run ExportFontToom3 v 1.02. For more about the modification and rebuild process, see "ReadMe_about_All256.txt", included in the foregoing .zip download.

			The C++ project file with source code:
			* [COMING SOON]

	== Downloads of ExportFontToDoom3 v 1.02 ==		== Downloads of ExportFontToDoom3 v 1.02 ==
Line 62:		Line 71:
	* also from wayback machine.		* also from wayback machine.
	The project makes use of the circa-2005 FreeType font library (www.freetype.org) and DevIL image library.		The project makes use of the circa-2005 FreeType font library (www.freetype.org) and DevIL image library.

	~~== Downloads of ExportFontToDoom3All256 [COMING SOON] ==~~
	~~== Modifying ExportFontToDoom3 for 256 Chars ==~~
	~~The standard version of this tool exports only the glyphs for the ASCII characters, i.e., in the range 0-127.~~

	In 2009, Crispy (with input from other TDMers Hyeron, Fidcal, and greebo) developed a variant version, "ExportFontToDoom3_modified", that could would also export characters in the range 128-256. (This presumably uses the character set and ordering of the Windows codepage of the generating machine. You would still have to subsequently rearrange things for the TDM-specific character mapping given in [[I18N_-_Charset]].)

	~~Unfortunately, as of 2024, that version appears lost. See [https://forums.thedarkmod.com/index.php?/topic/21741-subtitles-possibilities-beyond-211/&do=findComment&comment=492024 this forum post].~~
	~~=== Project Setup to Recreate Modified Version ===~~
	It is possible that the modifications could be reapplied. The original modification project was [https://forums.thedarkmod.com/index.php?/topic/10154-the-dark-mod-readables-ttf-fonts/&do=findComment&comment=200984 discussed here]. To summarize:
	* Start with the unmodified C++ source. It uses the FreeType and DeviL DLL libraries of that era. (Although you probably won't need it, know that www.freetype.org has an archive of past versions.)
	* Stick with the non-Unicode version of DeviL DLLs.
	* The code wants il_wrap.lib, , which is an object-oriented C++ wrapper around DevIL's procedural C interface, but il_wrap.lib no longer exists.
	* Fortunately, the wrapper source code was available, so it could simply be added directly to the ExportFontToDoom3 project. Once the class implementation is moved out of the header, it compiles. (The wrapper code referred to is possibly il_wrap.cpp and related .h’s from [https://github.com/DentonW/DevIL/ here].)
	* Change the loop iterating over character codes, so it goes from 0 to 255. The type of the character code index must be changed from int to unsigned long. Simply make that change in Font::getGlyphIndexForCharacterCode and the code that calls it

	{{tutorial}} [[Category:Fonts]]		{{tutorial}} [[Category:Fonts]]

Geep: /* and ExportFontToDoom3All256 */ change title

2024-04-25T16:07:46Z

and ExportFontToDoom3All256: change title

← Older revision		Revision as of 16:07, 25 April 2024
Line 1:		Line 1:
	== ~~and~~ ExportFontToDoom3All256 ==		== Intro to ExportFontToDoom3 & ExportFontToDoom3All256 ==
	The Windows command-line utility "ExportFontToDoom3" was created by Australian modder Grant Davies in 2005 to get TrueType Fonts, standard on Windows, into the metadata+bitmaps form needed by the Doom 3 engine. His final version, 1.02, was released as open-source and substantially used for TDM. It relies on the open-source DevIL and Freetype2 libraries.		The Windows command-line utility "ExportFontToDoom3" was created by Australian modder Grant Davies in 2005 to get TrueType Fonts, standard on Windows, into the metadata+bitmaps form needed by the Doom 3 engine. His final version, 1.02, was released as open-source and substantially used for TDM. It relies on the open-source DevIL and Freetype2 libraries.

Line 5:		Line 5:

	ExportFontToDoom3All256 fixes that bug; it exports the glyphs assigned to codepoints in the range 0-255, routinely ANSI characters. It has the same command-line arguments as ExportFontToDoom3 (which will be used in examples below). Credits to Crispy (for 2009 fix) and (in 2024 form) Geep.		ExportFontToDoom3All256 fixes that bug; it exports the glyphs assigned to codepoints in the range 0-255, routinely ANSI characters. It has the same command-line arguments as ExportFontToDoom3 (which will be used in examples below). Credits to Crispy (for 2009 fix) and (in 2024 form) Geep.

	== Using the Tool ==		== Using the Tool ==
	''The information here is adapted from the description doc included with the download.''		''The information here is adapted from the description doc included with the download.''

Geep: Change intro pp, include ...All256

2024-04-25T16:04:43Z

Change intro pp, include ...All256

← Older revision		Revision as of 16:04, 25 April 2024
Line 1:		Line 1:
	~~This~~ Windows command-line utility was created by Australian modder Grant Davies in 2005 to get standard Windows ~~fonts~~ into the Doom 3 engine. ~~The~~ final version, 1.02, was released as open-source and substantially used for TDM.		== and ExportFontToDoom3All256 ==
			The Windows command-line utility "ExportFontToDoom3" was created by Australian modder Grant Davies in 2005 to get TrueType Fonts, standard on Windows, into the metadata+bitmaps form needed by the Doom 3 engine. His final version, 1.02, was released as open-source and substantially used for TDM. It relies on the open-source DevIL and Freetype2 libraries.

			ExportFontToDoom3 exports only the bitmap glyphs assigned to codepoints in the range 0-127. These are routinely the ASCII characters. The output actually generates metadata for 256 characters, but, due to a bug, upper-half characters are just mapped to the "undefined character" glyph.

			ExportFontToDoom3All256 fixes that bug; it exports the glyphs assigned to codepoints in the range 0-255, routinely ANSI characters. It has the same command-line arguments as ExportFontToDoom3 (which will be used in examples below). Credits to Crispy (for 2009 fix) and (in 2024 form) Geep.
	== Using the Tool ==		== Using the Tool ==
	''The information here is adapted from the description doc included with the download.''		''The information here is adapted from the description doc included with the download.''
Line 45:		Line 49:
	* [https://web.archive.org/web/20100522173219/http://www.doom3world.org/phpbb2/viewtopic.php?t=11924 Tutorial 11 - Editing fonts]		* [https://web.archive.org/web/20100522173219/http://www.doom3world.org/phpbb2/viewtopic.php?t=11924 Tutorial 11 - Editing fonts]

	== Downloads of v 1.02 ==		== Downloads of ExportFontToDoom3 v 1.02 ==
	Windows binary:		Windows binary:
	* [https://grantheant.com/products/exportfonttodoom3 Grant Davie's project page]		* [https://grantheant.com/products/exportfonttodoom3 Grant Davie's project page]
Line 58:		Line 62:
	The project makes use of the circa-2005 FreeType font library (www.freetype.org) and DevIL image library.		The project makes use of the circa-2005 FreeType font library (www.freetype.org) and DevIL image library.

			== Downloads of ExportFontToDoom3All256 [COMING SOON] ==
	== Modifying ExportFontToDoom3 for 256 Chars ==		== Modifying ExportFontToDoom3 for 256 Chars ==
	The standard version of this tool exports only the glyphs for the ASCII characters, i.e., in the range 0-127.		The standard version of this tool exports only the glyphs for the ASCII characters, i.e., in the range 0-127.