ExportUnicodeFontToDoom3 - Revision history

Geep: /* Relationship to Other Parameters */

2026-04-01T00:42:21Z

Relationship to Other Parameters

← Older revision		Revision as of 00:42, 1 April 2026
Line 141:		Line 141:
	* awayFromEdge <value>		* awayFromEdge <value>

	~~Thes~~ option is probably problematic and should be avoided for now:		This option is probably problematic and should be avoided for now:
	* startFileNumber		* startFileNumber

Geep: /* Relationship to Other Parameters */

2026-04-01T00:41:57Z

Relationship to Other Parameters

← Older revision		Revision as of 00:41, 1 April 2026
Line 141:		Line 141:
	* awayFromEdge <value>		* awayFromEdge <value>

	~~Theis~~ option is probably problematic and should be avoided for now:		Thes option is probably problematic and should be avoided for now:
	* startFileNumber		* startFileNumber

Geep: /* Downloads */ updates to release 1.2

2026-04-01T00:40:14Z

Downloads: updates to release 1.2

← Older revision		Revision as of 00:40, 1 April 2026
Line 148:		Line 148:

	== Downloads ==		== Downloads ==
	Release v1.2 of 2025-03-31		Release v1.2 of 2025-03-31 ''(which adds inPlace option; makes clearer a command-line message about xOffset and pitch).''
	* [~~REAL SOON~~]		* [https://drive.google.com/file/d/1CG_BXsTTYi7E3nQPKtBWi-94Cj3R5eOY/view?usp=sharing ExportUnicodeFontToDoom3_release_1_2_exe.zip] . Windows binary and required archived versions of FreeType and DevIL DLLs.
			* [https://drive.google.com/file/d/1Nw4RdKKx2YHoPR6D-YQzdnEFx-vyYUhk/view?usp=sharing ExportUnicodeFontToDoom3_release_1_2_source_project.zip] . The C++ project file with source code, including source & build project of archived library.

	Release v1.1 of 2025-03-03:		Release v1.1 of 2025-03-03:
	* [https://drive.google.com/file/d/1f3Jj53qtJGIp0_mz7Riing9Fi8ESFDr5/view?usp=sharing ExportUnicodeFontToDoom3_release_1_1_exe.zip] ~~. Windows binary and required archived versions of FreeType and DevIL DLLs.~~		* [https://drive.google.com/file/d/1f3Jj53qtJGIp0_mz7Riing9Fi8ESFDr5/view?usp=sharing ExportUnicodeFontToDoom3_release_1_1_exe.zip]
	* [https://drive.google.com/file/d/1nutMBfcIWw63wNTUdnlnzP397tGVpnpd/view?usp=sharing ExportUnicodeFontToDoom3_release_1_1_source_project.zip] ~~. The C++ project file with source code, including source & build project of archived library~~.		* [https://drive.google.com/file/d/1nutMBfcIWw63wNTUdnlnzP397tGVpnpd/view?usp=sharing ExportUnicodeFontToDoom3_release_1_1_source_project.zip] .

	Release 1 of 2024-09-10:		Release 1 of 2024-09-10:

Geep: Add inPlace option

2026-03-31T21:24:13Z

Add inPlace option

@@ Line 103: / Line 103: @@
 Caution: The adjustment algorithm moves the outline controls points, but doesn't change the number of such points;
 this means that certain situations like acute angles or intersections are sometimes handled incorrectly.
 == Changed Behavior for Font Title from ExportFontToDoom3All256 ==
@@ Line 108: / Line 148: @@
 == Downloads ==
 Release v1.1 of 2025-03-03:
 * [https://drive.google.com/file/d/1f3Jj53qtJGIp0_mz7Riing9Fi8ESFDr5/view?usp=sharing ExportUnicodeFontToDoom3_release_1_1_exe.zip] . Windows binary and required archived versions of FreeType and DevIL DLLs.

Geep: /* unicodeMap */ Must keep file ordered

2026-03-16T20:40:25Z

unicodeMap: Must keep file ordered

← Older revision		Revision as of 20:40, 16 March 2026
Line 28:		Line 28:

	In all 3 of those cases, every suppressed character in the output DAT file will be represented by the glyph that the font uses for U+0000. A hollow box is common.		In all 3 of those cases, every suppressed character in the output DAT file will be represented by the glyph that the font uses for U+0000. A hollow box is common.

			IMPORTANT: If you edit lines, the remaining active glyph lines MUST be in ascending order by the 2-hex-digit codepoint value that starts each line. Otherwise, results will go astray.

	=== startFileNumber <n> ===		=== startFileNumber <n> ===

Geep: /* Downloads */ Add 1.1 links. Also fix 1.0 source project link

2026-03-03T21:57:54Z

Downloads: Add 1.1 links. Also fix 1.0 source project link

← Older revision		Revision as of 21:57, 3 March 2026
Line 106:		Line 106:

	== Downloads ==		== Downloads ==
	~~[COMING SOON -~~ v1.1]		Release v1.1 of 2025-03-03:
			* [https://drive.google.com/file/d/1f3Jj53qtJGIp0_mz7Riing9Fi8ESFDr5/view?usp=sharing ExportUnicodeFontToDoom3_release_1_1_exe.zip] . Windows binary and required archived versions of FreeType and DevIL DLLs.
			* [https://drive.google.com/file/d/1nutMBfcIWw63wNTUdnlnzP397tGVpnpd/view?usp=sharing ExportUnicodeFontToDoom3_release_1_1_source_project.zip] . The C++ project file with source code, including source & build project of archived library.

	Release 1 of 2024-09-10:		Release 1 of 2024-09-10:
	* [https://drive.google.com/file/d/1MqoOfhc5-ovoxoHfRquYAcIEdHEOJAQV/view?usp=sharing ExportUnicodeFontToDoom3_release_1_exe.zip] ~~. Windows binary and required archived versions of FreeType and DevIL DLLs.~~		* [https://drive.google.com/file/d/1MqoOfhc5-ovoxoHfRquYAcIEdHEOJAQV/view?usp=sharing ExportUnicodeFontToDoom3_release_1_exe.zip]
	* [https://drive.google.com/file/d/1Frk_byfdtCcMqdr27ulw1XyuFj8vYp9x/view?usp=sharing ExportUnicodeFontToDoom3_release_1_source_project.zip] ~~. The C++ project file with source code, including source & build project of archived library.~~		* [https://drive.google.com/file/d/1Frk_byfdtCcMqdr27ulw1XyuFj8vYp9x/view?usp=sharing ExportUnicodeFontToDoom3_release_1_source_project.zip]

			== See Also ==
	The Cyrillic coverage of Lora Regular TTF font, projected to used as Russian Mason supplement in TDM 2.14, may be viewed and font downloaded [https://www.fontsquirrel.com/fonts/lora?filter%5Bclassifications%5D%5B0%5D=serif&filter%5Blanguages%5D%5B0%5D=cyrillic#eula here].		The Cyrillic coverage of Lora Regular TTF font, projected to used as Russian Mason supplement in TDM 2.14, may be viewed and font downloaded [https://www.fontsquirrel.com/fonts/lora?filter%5Bclassifications%5D%5B0%5D=serif&filter%5Blanguages%5D%5B0%5D=cyrillic#eula here].

Geep: Added 512x512 for awayFromEdge, hirez, bolding

2026-03-02T21:01:07Z

Added 512x512 for awayFromEdge, hirez, bolding

@@ Line 40: / Line 40: @@
 Allows specifying in positive integer pixels (e.g., "-awayFromEdge 2") a small extra boundary at the top and left edges of the overall bitmap. This is for fonts like Mason where extra space (typically 2 pixels) is needed around every character to create a "glow variant". Routine glyph layout provides usually enough space for this except at the top and (arguably) left edges. See also the "compact" parameter.
 === compact ===
@@ Line 57: / Line 59: @@
 Without "compact", the default is Grant Davies' second algorithm found in ExportFontToDoom3 v1.02. This likewise first pads each bounding box by 5 pixels to the right and 5 pixels below. It then further pads to make both the width and height a factor of 2; this makes 48pt quite sparse.  (It is possible this improved rendering performance in 2005; not important now. Also, in practice for major fonts, much of this "factor of 2" spacing was overridden by subsequent Font Patcher work.)
-=== (hirez - another possible argument) ===
+=== hirez or hires ===
-''Geep: This is a future idea, but no promises on this.''
+''Added with v1.1, March 2026''
-Change code to allow export of 512x512 bitmaps with larger, thus crisper glyphs. Specifically, add a new command-line option, -hirez, that would
+The integer parameter <n> is in units of 1/64th pixel. A positive value adjusts the outline to embolden the character. Negative thins. The change affects both the overall height and width of the outline.
-* output 512x512 TGAs and their DAT.
+You may think of the left and bottom character borders as unchanged. The allowed range of <n> is from -128 (i.e., -2 pixels) to 256 (4 pixels). The -2 limit is arbitrary, but for sanity. The 4 limit is the maximum FreeType permits.
-== Changed Behavior ==
+Caution: The adjustment algorithm moves the outline controls points, but doesn't change the number of such points;
 In ExportFontToDoom3All256, if the font title was more that 20 characters long, it would truncate it to fit in the DAT file as part of the shader names (i.e., paths to TGA files). But this threshold was wrong. Now, truncation and a warning happens if the font title is more that 17 characters long (or 16 if generated TGAs include any with a 2-digit count instead of 1-digit). If truncation occurs, the user is asked to consider using or revising the -name argument.
 == Downloads ==
 Release 1 of 2024-09-10:
 * [https://drive.google.com/file/d/1MqoOfhc5-ovoxoHfRquYAcIEdHEOJAQV/view?usp=sharing ExportUnicodeFontToDoom3_release_1_exe.zip] . Windows binary and required archived versions of FreeType and DevIL DLLs.

Geep: Add release 1 links

2025-09-11T21:35:55Z

Add release 1 links

← Older revision		Revision as of 21:35, 11 September 2025
Line 1:		Line 1:
	''By Geep, 2025 ~~[WORK IN PROGRESS]~~''		''By Geep, 2025''

	== Introduction ==		== Introduction ==
Line 7:		Line 7:
	This offshoot of [https://wiki.thedarkmod.com/index.php?title=ExportFontToDoom3 ExportFontToDoom3All256] is a generalized response to that. The main idea to select an input TTF font that includes not just ASCII or ANSI, but offers additional Unicode characters, like Cyrillic. The program still limits output to a maximum of 256 characters, consistent with the DAT format.		This offshoot of [https://wiki.thedarkmod.com/index.php?title=ExportFontToDoom3 ExportFontToDoom3All256] is a generalized response to that. The main idea to select an input TTF font that includes not just ASCII or ANSI, but offers additional Unicode characters, like Cyrillic. The program still limits output to a maximum of 256 characters, consistent with the DAT format.

	To achieve this, it reads in an external human-readable "unicodeMap" file, in Unicode.org’s "Format A". This format provides a mapping from the traditional 8-bit encoding that TDM uses to the corresponding UCS (Unicode 16-bit) value. Unicode.org provides stock files for standard ISO and Windows 8-bit encodings. Of specific interest here is [https://www.unicode.org/Public/MAPPINGS/VENDORS/MICSFT/WINDOWS/CP1251.TXT cp1251.txt for Cyrillic]. This requires just trivial editing for [https://wiki.thedarkmod.com/index.php?title=I18N_-_Charset TDM-specific codepoints].		To achieve this, it reads in an external human-readable "unicodeMap" file, in Unicode.org’s "Format A". This format provides a mapping from the traditional 8-bit encoding that TDM uses to the corresponding UCS (Unicode 16-bit) value. Unicode.org provides stock files for standard ISO and Windows 8-bit encodings. Of specific interest here is [https://www.unicode.org/Public/MAPPINGS/VENDORS/MICSFT/WINDOWS/CP1251.TXT cp1251.txt for Cyrillic]. This requires just trivial editing for [https://wiki.thedarkmod.com/index.php?title=I18N_-_Charset TDM-specific codepoints]. As discussed below, you can further edit a unicodeMap file in advance, if you want to generate just a subset of glyphs.
	As discussed below, you can further edit a unicodeMap file in advance, if you want to generate just a subset of glyphs.
			More broadly, this program supersedes ExportFontToDoom3 and ExportFontToDoom3All256.

	== New Command Line Arguments ==		== New Command Line Arguments ==
Line 68:		Line 69:

	== Downloads ==		== Downloads ==
	[~~links to do~~]		Release 1 of 2024-09-10:
			* [https://drive.google.com/file/d/1MqoOfhc5-ovoxoHfRquYAcIEdHEOJAQV/view?usp=sharing ExportUnicodeFontToDoom3_release_1_exe.zip] . 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/1Frk_byfdtCcMqdr27ulw1XyuFj8vYp9x/view?usp=sharing ExportUnicodeFontToDoom3_release_1_source_project.zip] . The C++ project file with source code, including source & build project of archived library.

	~~ExportUnicodeFontToDoom3 Release 1 of 09-10-2025~~.zip

	The C++ project file with source code:

	~~ExportUnicodeFontToDoom3_source_project.zip Release 1 of 09-10-2025. This zip is ... MB~~, ~~includes~~ source & build project of archived library.

	The Cyrillic coverage of Lora Regular TTF font, projected to used as Russian Mason supplement in TDM 2.14, may be viewed and font downloaded [https://www.fontsquirrel.com/fonts/lora?filter%5Bclassifications%5D%5B0%5D=serif&filter%5Blanguages%5D%5B0%5D=cyrillic#eula here].		The Cyrillic coverage of Lora Regular TTF font, projected to used as Russian Mason supplement in TDM 2.14, may be viewed and font downloaded [https://www.fontsquirrel.com/fonts/lora?filter%5Bclassifications%5D%5B0%5D=serif&filter%5Blanguages%5D%5B0%5D=cyrillic#eula here].

Geep: /* Changed Behavior */

2025-09-10T20:06:33Z

Changed Behavior

← Older revision		Revision as of 20:06, 10 September 2025
Line 65:		Line 65:

	== Changed Behavior ==		== Changed Behavior ==
	In ExportFontToDoom3All256, if the font title was more that 20 characters long, it would truncate it to fit in the DAT file as part of the shader names (i.e., paths to TGA files). But this threshold was wrong. Now, truncation and a warning happens if the font title is more that 17 characters long (or 16 if generated TGAs include any with a 2-digit count instead of 1-digit). If truncation occurs, the user is asked to consider using the -name argument.		In ExportFontToDoom3All256, if the font title was more that 20 characters long, it would truncate it to fit in the DAT file as part of the shader names (i.e., paths to TGA files). But this threshold was wrong. Now, truncation and a warning happens if the font title is more that 17 characters long (or 16 if generated TGAs include any with a 2-digit count instead of 1-digit). If truncation occurs, the user is asked to consider using or revising the -name argument.

	== Downloads ==		== Downloads ==

Geep: /* Downloads */

2025-09-10T20:05:07Z

Downloads

← Older revision		Revision as of 20:05, 10 September 2025
Line 78:		Line 78:
	ExportUnicodeFontToDoom3_source_project.zip Release 1 of 09-10-2025. This zip is ... MB, includes source & build project of archived library.		ExportUnicodeFontToDoom3_source_project.zip Release 1 of 09-10-2025. This zip is ... MB, includes source & build project of archived library.

	The Cyrillic coverage of Lora Regular TTF font, ~~project~~ to used as Russian Mason supplement in TDM 2.14, may be viewed and font downloaded [https://www.fontsquirrel.com/fonts/lora?filter%5Bclassifications%5D%5B0%5D=serif&filter%5Blanguages%5D%5B0%5D=cyrillic#eula here].		The Cyrillic coverage of Lora Regular TTF font, projected to used as Russian Mason supplement in TDM 2.14, may be viewed and font downloaded [https://www.fontsquirrel.com/fonts/lora?filter%5Bclassifications%5D%5B0%5D=serif&filter%5Blanguages%5D%5B0%5D=cyrillic#eula here].