Font Patcher - Revision history

Geep: /* scale */ Add link to Per-Character Font Scaling

2024-07-06T19:04:03Z

scale: Add link to Per-Character Font Scaling

← Older revision		Revision as of 19:04, 6 July 2024
Line 114:		Line 114:

	scale 0xEF 1.1 1.1		scale 0xEF 1.1 1.1

			''Geep 2024:'' for more, see [[Font Metrics %26 DAT File Format#Per-Character Font Scaling]]

	=== decrease_width ===		=== decrease_width ===

Tels: tweaks

2014-08-08T14:24:38Z

tweaks

← Older revision		Revision as of 14:24, 8 August 2014
Line 129:		Line 129:
	=== increase_xskip ===		=== increase_xskip ===

	Each character has, in addition to it's with, a paramter xSkip, which defines how many pixels are skipped after rendering the character. ~~This thus defines~~ the ~~place where the next~~ character ~~is places, and~~ thus the spacing between characters. With this command, you can increase ~~this~~:		Each character has, in addition to it's with, a paramter '''xSkip''', which defines how many pixels are skipped after rendering the character. Unlike real [https://en.wikipedia.org/wiki/Kerning Kerning], this value is independent of the following character.

			It does thus define the spacing between characters. With this command, you can increase the space:

	increase_xskip 0x65 2		increase_xskip 0x65 2
Line 135:		Line 137:
	=== decrease_xskip ===		=== decrease_xskip ===

	Reduces the xSkip parameter. See [[#increase_xskip]] for details.		Reduces the '''xSkip''' parameter. See [[#increase_xskip]] for details.

	decrease_xskip 0x65 2		decrease_xskip 0x65 2

			== Requirements ==

			* Needs Perl.

	== See also ==		== See also ==

Tels: small tweaks

2014-08-08T14:21:15Z

small tweaks

← Older revision		Revision as of 14:21, 8 August 2014
Line 13:		Line 13:
	copy_char 0x43 0xac // copy all fields from C to the new character Č		copy_char 0x43 0xac // copy all fields from C to the new character Č
	move_by 0xac 74 -52 // new position 174, 19 minus 100, 71		move_by 0xac 74 -52 // new position 174, 19 minus 100, 71
	shader 0xac fonts/carleton_6_48.tga // set the right texture file (the .tga ~~here~~ is ignored by D3)		shader 0xac fonts/carleton_6_48.tga // set the right texture file (the .tga is ignored by TDM)
	extend_top 0xac 8 // extend the character 8 pixel on the top		extend_top 0xac 8 // extend the character 8 pixel on the top
	</pre>		</pre>
Line 34:		Line 34:
	=== #define ===		=== #define ===

	Defines a new text ~~to be replaced~~. Example:		Defines a new text macro. Example:

	<pre>		<pre>
	#define H_EXTEND 1		#define H_EXTEND 1
			</pre>

			From here on "H_EXTEND" will be replaced with "1" like in this example:

			<pre>
	extend_botton 0x65 H_EXTEND		extend_botton 0x65 H_EXTEND
			</pre>

			which will look like this to the font patcher:

			<pre>
			extend_botton 0x65 1
	</pre>		</pre>

Line 83:		Line 93:
	Each character is painted on a TGA (or better DDS) file, and this command lets you set the		Each character is painted on a TGA (or better DDS) file, and this command lets you set the
	name of this file. Note that we specify here ".tga", even tho the actual files are ".dds", and		name of this file. Note that we specify here ".tga", even tho the actual files are ".dds", and
	also note that we do not store the language here. In this example, the real file used would be '''dds/fonts/english/carleton_6_48.dds''' - D3 will do this automatically for us:		also note that we do not store the language here. In this example, the real file used would be '''dds/fonts/english/carleton_6_48.dds''' - TDM will do this automatically for us:

	shader 0xac fonts/carleton_6_48.tga		shader 0xac fonts/carleton_6_48.tga

Tels: add more commands

2012-01-29T16:14:13Z

add more commands

← Older revision		Revision as of 16:14, 29 January 2012
Line 86:		Line 86:

	shader 0xac fonts/carleton_6_48.tga		shader 0xac fonts/carleton_6_48.tga

			=== source ===

			Sets the source font image file. Example:

			source font_source/carleton/fontimage_48.dat

			=== target ===

			Sets the target font image file. Example:

			target ../fonts/english/carleton/fontimage_48.dat

			=== scale ===

			Scale the character by X and Y as factors. Example to make the character 10% bigger:

			scale 0xEF 1.1 1.1

			=== decrease_width ===

			Reduce the width of the character by so many pixels:

			decrease_width 0x65 2

			=== increase_width ===

			Increase the width of the character by so many pixels:

			increase_width 0x65 2

			=== increase_xskip ===

			Each character has, in addition to it's with, a paramter xSkip, which defines how many pixels are skipped after rendering the character. This thus defines the place where the next character is places, and thus the spacing between characters. With this command, you can increase this:

			increase_xskip 0x65 2

			=== decrease_xskip ===

			Reduces the xSkip parameter. See [[#increase_xskip]] for details.

			decrease_xskip 0x65 2

	== See also ==		== See also ==

Tels: add download link

2011-11-24T18:01:06Z

add download link

← Older revision		Revision as of 18:01, 24 November 2011
Line 89:		Line 89:
	== See also ==		== See also ==

			* [http://www.bloodgate.com/mirrors/tdm/pub/scripts/font_patcher/ Download font_patcher.pl and examples]
	* [[I18N_-_Charset\|The charsets used by TDM]]		* [[I18N_-_Charset\|The charsets used by TDM]]
	* [[Font Conversion & Repair]]		* [[Font Conversion & Repair]]

Tels: typo

2011-11-07T20:55:12Z

typo

← Older revision		Revision as of 20:55, 7 November 2011
Line 89:		Line 89:
	== See also ==		== See also ==

	* [[I18N_-_Charset\|The ~~Charset~~ TDM ~~uses~~]]		* [[I18N_-_Charset\|The charsets used by TDM]]
	* [[Font Conversion & Repair]]		* [[Font Conversion & Repair]]
	* [[I18N]]		* [[I18N]]

	[[Category:Fonts]]		[[Category:Fonts]]

Tels: typos

2011-11-07T20:53:35Z

typos

← Older revision		Revision as of 20:53, 7 November 2011
Line 1:		Line 1:
	== Introduction ==		== Introduction ==

	This utility allows you to "patch" a '''fontImage.dat''' file, e.g. change different characters and values without having the other characters ~~getting affect~~ (a common ~~proble~~ with [[Font_Conversion_%26_Repair\|q3font]], f.i.).		This utility allows you to "patch" a '''fontImage.dat''' file, e.g. change different characters and values without having the other characters being affected (a common problem with [[Font_Conversion_%26_Repair\|q3font]], f.i.).

	The ~~file~~ reads in a ~~fontimage~~.dat file, a file with commands, then executes each command and then writes out the modified ~~fontimage~~.dat file. Here is an example command file:		The script reads in a '''fontImage.dat''' file, a file with commands, then executes each command and then writes out the modified '''fontImage.dat''' file. Here is an example command file:

	<pre>		<pre>
Line 12:		Line 12:

	copy_char 0x43 0xac // copy all fields from C to the new character Č		copy_char 0x43 0xac // copy all fields from C to the new character Č
	move_by 0xac 74 -52 // (new position 174, 19 minus 100, 71		move_by 0xac 74 -52 // new position 174, 19 minus 100, 71
	shader 0xac fonts/carleton_6_48.tga // set the right texture file (the .tga here is ignored by D3)		shader 0xac fonts/carleton_6_48.tga // set the right texture file (the .tga here is ignored by D3)
	extend_top 0xac 8 // extend the character 8 pixel on the top		extend_top 0xac 8 // extend the character 8 pixel on the top
	</pre>		</pre>

	The order of commands does usually not matter, unless you want for instance to copy a character and then modify it, in this case the ''[[#copy\|copy]]'' command must come before any modifications to the character.		The order of commands does usually not matter, unless you want for instance to copy a character and then modify it, in this case the ''[[#copy\|copy]]'' command must obviously come before any modifications to the character.

	=== Patching multiple fonts ===		=== Patching multiple fonts ===

Tels: typo

2011-11-06T10:05:04Z

typo

← Older revision		Revision as of 10:05, 6 November 2011
Line 76:		Line 76:
	move_by 0xac 74 -52		move_by 0xac 74 -52

	This is often used to "~~reloacte~~" the place where a character is painted on the texture from one		This is often used to "relocate" the place where a character is painted on the texture from one
	texture to the other, by using it in combination with ''[[#shader\|shader]]''.		texture to the other, by using it in combination with ''[[#shader\|shader]]''.

Tels: explain dump better

2011-11-06T10:04:26Z

explain dump better

← Older revision		Revision as of 10:04, 6 November 2011
Line 52:		Line 52:
	=== dump ===		=== dump ===

	This will ~~dump~~ all the fields for the character 0x65 (in this case "a"):		This will print all the fields for the character 0x65 (in this case "a") to the console:

	dump 0x65		dump 0x65

Tels: more comments

2011-11-06T08:54:26Z

more comments

← Older revision		Revision as of 08:54, 6 November 2011
Line 1:		Line 1:
	== Introduction ==		== Introduction ==

	This utility allows you to "patch" a ~~fontimage~~.dat file, e.g. change different characters and values without having the other characters getting affect (a common proble with q3font, f.i.).		This utility allows you to "patch" a '''fontImage.dat''' file, e.g. change different characters and values without having the other characters getting affect (a common proble with [[Font_Conversion_%26_Repair\|q3font]], f.i.).

	The file reads in a fontimage.dat file, a file with commands, then executes each command and then writes out the modified fontimage.dat file. Here is an example command file:		The file reads in a fontimage.dat file, a file with commands, then executes each command and then writes out the modified fontimage.dat file. Here is an example command file:
Line 16:		Line 16:
	extend_top 0xac 8 // extend the character 8 pixel on the top		extend_top 0xac 8 // extend the character 8 pixel on the top
	</pre>		</pre>

			The order of commands does usually not matter, unless you want for instance to copy a character and then modify it, in this case the ''[[#copy\|copy]]'' command must come before any modifications to the character.

			=== Patching multiple fonts ===

			The modified '''fontImage.dat''' file will be written out automatically at the end of the parsing stage.
			If you want to patch more than one fontImage.dat file, you need to use two seperate command files and call the font patcher twice.

	== Commands ==		== Commands ==