Font file - Revision history

Cas at 20:28, 2 April 2021

2021-04-02T20:28:28Z

← Older revision		Revision as of 22:28, 2 April 2021
Line 1:		Line 1:
	Stunts (BB 1.1) includes three '''font files''', which have a ".FNT" extension and a very unique format. The files in question are FONTDEF.FNT, FONTN.FNT and FONTLED.FNT. FONTDEF (probably standing for "Default Font") is the thick font used for the text in menus, dialog boxes and buttons. FONTN is used for longer text, for example, car descriptions in the showroom, scoreboard rows and the high score information when viewing the complete track in 3D in the Track menu. FONTLED only contains digits and a couple of punctuation characters and is used for the lap times in the replay menu panel.		Stunts (BB 1.1) includes three '''font files''', which have a ".FNT" extension and a very unique format. The files in question are FONTDEF.FNT, FONTN.FNT and FONTLED.FNT. FONTDEF (probably standing for "Default Font") is the thick font used for the text in menus, dialog boxes and buttons. FONTN is used for longer text, for example, car descriptions in the showroom, scoreboard rows and the high score information when viewing the complete track in 3D in the Track menu. FONTLED only contains digits and a couple of punctuation characters and is used for the lap times in the replay menu panel.

	While this font format appears to be unique to Stunts, it is pretty flexible and worth considering for other projects. The three fonts included with Stunts are bitmaps of character height 8, but vary in width. As a matter of fact, FONTDEF and FONTN are variable width, that is, each character can have an individual width. Yet, Stunts allows for fonts of other characteristics to be loaded. If the files are modified, Stunts adapts to the changes very well.		While this font format appears to be unique to DSI games, it is certainly not unique to Stunts. Even the same font files reappear, sometimes with slight changes, in games such as Fight. The format is pretty flexible and worth considering for other projects. The three fonts included with Stunts are bitmaps of character height 8, but vary in width. As a matter of fact, FONTDEF and FONTN are variable width, that is, each character can have an individual width. Yet, Stunts allows for fonts of other characteristics to be loaded. If the files are modified, Stunts adapts to the changes very well.

	== Font format features ==		== Font format features ==

Cas: /* How Stunts renders text */

2021-04-02T20:25:51Z

How Stunts renders text

← Older revision		Revision as of 22:25, 2 April 2021
Line 40:		Line 40:
	* '''5Dh (closing square bracket - ]):''' In multi-line text, this character is not rendered because Stunts interprets it as an end-of-line mark. In single lines, it does display, though.		* '''5Dh (closing square bracket - ]):''' In multi-line text, this character is not rendered because Stunts interprets it as an end-of-line mark. In single lines, it does display, though.
	* '''5Bh (opening square bracket - [):''' This character is printed everywhere except in menus, where it is used for marking the beginning of a menu option. Stunts menus are stored in an array by number, so to recognise the part of the text that will link to each sub-menu or action, the opening bracket will mark the separation of one and the next, but not go to the next line. The closing bracket does the same thing, but moving to the next line.		* '''5Bh (opening square bracket - [):''' This character is printed everywhere except in menus, where it is used for marking the beginning of a menu option. Stunts menus are stored in an array by number, so to recognise the part of the text that will link to each sub-menu or action, the opening bracket will mark the separation of one and the next, but not go to the next line. The closing bracket does the same thing, but moving to the next line.
	* '''7Dh (closing curly bracket - }):''' This character is normally printed, but in menu boxes~~, it marks~~ the beginning of the menu option list ~~instead~~. It is placed after the menu title and before the first menu option.		* '''7Dh (closing curly bracket - }):''' This character is normally printed, but in multi-line text, it represents a half-height new line marker. It's used in menu boxes to mark the beginning of the menu option list. It is placed after the menu title and before the first menu option.
	* '''40h (at symbol - @):''' This one is rendered almost everywhere except in text that is meant to carry a parameter or where a space has to be left for user input, such as when disabling the anti-piracy system or when entering your name for signing the scoreboard. In those cases, ''@'' is placed to mark the position where the text is to be entered or inserted.		* '''40h (at symbol - @):''' This one is rendered almost everywhere except in text that is meant to carry a parameter or where a space has to be left for user input, such as when disabling the anti-piracy system or when entering your name for signing the scoreboard. In those cases, ''@'' is placed to mark the position where the text is to be entered or inserted.

Cas at 22:02, 27 March 2021

2021-03-27T22:02:39Z

@@ Line 30: / Line 30: @@
 Each row is followed by the next immediately after without any separation other than the bits to complete the exact number of bytes, so glyphs are generated from the top down.
 [[Category:Modding]]
 [[Category:Internals]]

Cas: /* Glyphs */

2021-03-23T05:39:49Z

Glyphs

← Older revision		Revision as of 07:39, 23 March 2021
Line 23:		Line 23:

	=== Glyphs ===		=== Glyphs ===
	For each code point with a non-zero index, a glyph has to be defined. If the font is variable width, the first byte in the glyph region contains the character width in pixels. For fixed width fonts, this byte is omitted. Following are the glyph rows. The number of bytes to represent each row depend on the character width. One byte is required for every 8 pixels. In other words, the number of bytes per row will be the ceiling of the division of the character width by 8. Stunts fonts go over 8 pixels wide, but never reach 17, so it is not ~~known~~ if ~~it supports wider fonts~~, ~~yet the~~ format allows for defining ~~them~~.		For each code point with a non-zero index, a glyph has to be defined. If the font is variable width, the first byte in the glyph region contains the character width in pixels. For fixed width fonts, this byte is omitted. Following are the glyph rows. The number of bytes to represent each row depend on the character width. One byte is required for every 8 pixels. In other words, the number of bytes per row will be the ceiling of the division of the character width by 8. Stunts fonts go over 8 pixels wide, but never reach 17. However, it has been tested it actually supports at least up to 32 pixels character width and 16 pixels character height.

			The format itself could theoretically define sizes up to 255x255, though it is unlikely that Stunts can support characters this large. There is another limit which has to do with indeces being 16bit words. Depending on whether Stunts treats them as signed or unsigned, characters beyond the 32kbyte or 64kbyte limit could not be referenced. A 32x32 font takes up enough space so that it would overflow the first limit if all characters are defined. Yet, since this format allows for only defining some characters, larger but limited fonts can still be created. The first limit for fixed width fonts and all characters defined would allow a square font up to 31x31. The second limit, under the same conditions, would allow up to 42x42.

	Pixels in each row are defined in ascending order (from lower bit to higher bit) from right to left and can be 0 for off or 1 for on. If more than one byte is used, the format is little-endian. Unused bits are left as 0 in original Stunts fonts, which is a good practice. In theory, they should be ignored anyway.		Pixels in each row are defined in ascending order (from lower bit to higher bit) from right to left and can be 0 for off or 1 for on. If more than one byte is used, the format is little-endian. Unused bits are left as 0 in original Stunts fonts, which is a good practice. In theory, they should be ignored anyway.

Cas: /* Glyphs */

2021-03-18T21:56:46Z

Glyphs

← Older revision		Revision as of 23:56, 18 March 2021
Line 26:		Line 26:

	Pixels in each row are defined in ascending order (from lower bit to higher bit) from right to left and can be 0 for off or 1 for on. If more than one byte is used, the format is little-endian. Unused bits are left as 0 in original Stunts fonts, which is a good practice. In theory, they should be ignored anyway.		Pixels in each row are defined in ascending order (from lower bit to higher bit) from right to left and can be 0 for off or 1 for on. If more than one byte is used, the format is little-endian. Unused bits are left as 0 in original Stunts fonts, which is a good practice. In theory, they should be ignored anyway.

			Each row is followed by the next immediately after without any separation other than the bits to complete the exact number of bytes, so glyphs are generated from the top down.

	[[Category:Modding]]		[[Category:Modding]]
	[[Category:Internals]]		[[Category:Internals]]

Cas at 21:55, 18 March 2021

2021-03-18T21:55:18Z

← Older revision		Revision as of 23:55, 18 March 2021
Line 18:		Line 18:
	* (1 word) Variable width flag: 1 for variable width, 0 for fixed width		* (1 word) Variable width flag: 1 for variable width, 0 for fixed width
	''Total: 22 bytes''		''Total: 22 bytes''

			=== Index ===
			Following the 22-byte header, comes the index. It's exactly 256 words long (512 bytes) and each word points to the position in the file where the glyph is defined for each code point from 0 to 255 in order. If a glyph is not defined for a certain code point, its index is set to zero. Valid indeces count from 0 at the beginning of the file. This means that position 534 (starting from 0) is the first byte in the file available for glyph definition and is used as such in the three fonts originally provided with Stunts. This could, however, be skipped freely and additional information stored there.

			=== Glyphs ===
			For each code point with a non-zero index, a glyph has to be defined. If the font is variable width, the first byte in the glyph region contains the character width in pixels. For fixed width fonts, this byte is omitted. Following are the glyph rows. The number of bytes to represent each row depend on the character width. One byte is required for every 8 pixels. In other words, the number of bytes per row will be the ceiling of the division of the character width by 8. Stunts fonts go over 8 pixels wide, but never reach 17, so it is not known if it supports wider fonts, yet the format allows for defining them.

			Pixels in each row are defined in ascending order (from lower bit to higher bit) from right to left and can be 0 for off or 1 for on. If more than one byte is used, the format is little-endian. Unused bits are left as 0 in original Stunts fonts, which is a good practice. In theory, they should be ignored anyway.

	[[Category:Modding]]		[[Category:Modding]]
	[[Category:Internals]]		[[Category:Internals]]

Cas: /* Header */

2021-03-18T21:40:21Z

Header

← Older revision		Revision as of 23:40, 18 March 2021
Line 10:		Line 10:

	=== Header ===		=== Header ===
	(1 byte) Fixed = 3		* (1 byte) Fixed = 3
	(11 bytes) Fixed: all zeroes		* (11 bytes) Fixed: all zeroes
	(1 word) Not fully understood: 1 or 2 for variable width, but has to be 1 for fixed width		* (1 word) Not fully understood: 1 or 2 for variable width, but has to be 1 for fixed width
	(1 word) Font height		* (1 word) Font height
	(1 word) Font width (if width is variable, this is zero)		* (1 word) Font width (if width is variable, this is zero)
	(1 word) Unknown: Always 8 in the three original fonts and doesn't seem to do anything if changed		* (1 word) Unknown: Always 8 in the three original fonts and doesn't seem to do anything if changed
	(1 word) Variable width flag: 1 for variable width, 0 for fixed width		* (1 word) Variable width flag: 1 for variable width, 0 for fixed width
	''Total: 22 bytes''		''Total: 22 bytes''

	[[Category:Modding]]		[[Category:Modding]]
	[[Category:Internals]]		[[Category:Internals]]

Cas at 21:39, 18 March 2021

2021-03-18T21:39:49Z

@@ Line 5: / Line 5: @@
 == Font format features ==
 Stunts font format is strictly bitmap based, but very configurable. It allows for up to 256 characters that can be mapped to 256 code points from 0 to 255. Unused code points don't need to have their glyphs defined, which saves space. Fonts can have either fixed or variable width. For variable width, widths up to 255 are theoretically possible, although Stunts surely must have a much smaller limit. With fixed width, this could go up to 32767 or perhaps 65535 depending on how the values are interpreted. Character height can also, in theory, go up to these values. As of 18 March 2021, it is not known whether height can be made variable too.
 [[Category:Modding]]
 [[Category:Internals]]

Cas at 21:24, 18 March 2021

2021-03-18T21:24:36Z

← Older revision		Revision as of 23:24, 18 March 2021
Line 1:		Line 1:
	Stunts (BB 1.1) includes three '''font files''', which have a ".FNT" extension and a very unique format. The files in question are FONTDEF.FNT, FONTN.FNT and FONTLED.FNT. FONTDEF (probably standing for "Default Font") is the thick font used for the text in menus, dialog boxes and buttons. FONTN is used for longer text, for example, car descriptions in the showroom, scoreboard rows and the high score information when viewing the complete track in 3D in the Track menu. FONTLED only contains digits and a couple of punctuation characters and is used for the lap times in the replay menu panel.		Stunts (BB 1.1) includes three '''font files''', which have a ".FNT" extension and a very unique format. The files in question are FONTDEF.FNT, FONTN.FNT and FONTLED.FNT. FONTDEF (probably standing for "Default Font") is the thick font used for the text in menus, dialog boxes and buttons. FONTN is used for longer text, for example, car descriptions in the showroom, scoreboard rows and the high score information when viewing the complete track in 3D in the Track menu. FONTLED only contains digits and a couple of punctuation characters and is used for the lap times in the replay menu panel.

			While this font format appears to be unique to Stunts, it is pretty flexible and worth considering for other projects. The three fonts included with Stunts are bitmaps of character height 8, but vary in width. As a matter of fact, FONTDEF and FONTN are variable width, that is, each character can have an individual width. Yet, Stunts allows for fonts of other characteristics to be loaded. If the files are modified, Stunts adapts to the changes very well.

			== Font format features ==
			Stunts font format is strictly bitmap based, but very configurable. It allows for up to 256 characters that can be mapped to 256 code points from 0 to 255. Unused code points don't need to have their glyphs defined, which saves space. Fonts can have either fixed or variable width. For variable width, widths up to 255 are theoretically possible, although Stunts surely must have a much smaller limit. With fixed width, this could go up to 32767 or perhaps 65535 depending on how the values are interpreted. Character height can also, in theory, go up to these values. As of 18 March 2021, it is not known whether height can be made variable too.

			[[Category:Modding]]
			[[Category:Internals]]

Cas: Created page with "Stunts (BB 1.1) includes three '''font files''', which have a ".FNT" extension and a very unique format. The files in question are FONTDEF.FNT, FONTN.FNT and FONTLED.FNT. FONT..."

2021-03-18T21:10:23Z

Created page with "Stunts (BB 1.1) includes three '''font files''', which have a ".FNT" extension and a very unique format. The files in question are FONTDEF.FNT, FONTN.FNT and FONTLED.FNT. FONT..."

New page

Stunts (BB 1.1) includes three '''font files''', which have a ".FNT" extension and a very unique format. The files in question are FONTDEF.FNT, FONTN.FNT and FONTLED.FNT. FONTDEF (probably standing for "Default Font") is the thick font used for the text in menus, dialog boxes and buttons. FONTN is used for longer text, for example, car descriptions in the showroom, scoreboard rows and the high score information when viewing the complete track in 3D in the Track menu. FONTLED only contains digits and a couple of punctuation characters and is used for the lap times in the replay menu panel.