Text Font Map - Revision history

Hyper at 17:51, 5 May 2026

2026-05-05T17:51:27Z

← Older revision		Revision as of 17:51, 5 May 2026
Line 180:		Line 180:
	\|const char*		\|const char*
	\|pTextFontProportionPath		\|pTextFontProportionPath
	\|A pointer to the path to the ~~'''~~Text Font Proportion~~'''~~ for this font.		\|A pointer to the path to the [[Text Font Proportion]] for this font.
	\|-		\|-
	\|0x14		\|0x14

Hyper at 17:41, 5 May 2026

2026-05-05T17:41:16Z

← Older revision		Revision as of 17:41, 5 May 2026
Line 13:		Line 13:
	!Description		!Description
	\|-		\|-
	\|fontmap.ftm		\|<code>fontmap.ftm</code>
	\|Rodin Pro Demi Bold		\|Rodin Pro Demi Bold
	\|18 ~ 20 px		\|18 ~ 20 px
Line 19:		Line 19:
	\|✔️		\|✔️
	\|28x28		\|28x28
	\|~~Used for~~ system text and subtitles.		\|For system text and subtitles.
	\|-		\|-
	\|font2map.ftm		\|<code>font2map.ftm</code>
	\|New Rodin Pro Ultra Bold		\|New Rodin Pro Ultra Bold
	\|~24.5 px		\|~24.5 px
Line 27:		Line 27:
	\|❌		\|❌
	\|37x50		\|37x50
	\|~~Used for~~ main menu header text.		\|For main menu header text.
	\|-		\|-
	\|font3map.ftm		\|<code>font3map.ftm</code>
	\|New Rodin Pro Ultra Bold		\|New Rodin Pro Ultra Bold
	\|~19.5 px		\|~19.5 px
Line 35:		Line 35:
	\|❌		\|❌
	\|31x41		\|31x41
	\|~~Used for~~ main menu option text.		\|For main menu option text.
	\|}		\|}

Hyper at 17:38, 5 May 2026

2026-05-05T17:38:54Z

← Older revision		Revision as of 17:38, 5 May 2026
Line 2:		Line 2:

	These files are located in <code>text.arc</code> under the <code>./text/</code> directory from [[Sonic the Hedgehog (2006) File System#Platform Root\|platform root]] as <code>*.ftm</code> files.		These files are located in <code>text.arc</code> under the <code>./text/</code> directory from [[Sonic the Hedgehog (2006) File System#Platform Root\|platform root]] as <code>*.ftm</code> files.
			<br><br>
			{\| class="wikitable"
			\|+
			!Name
			!Font
			!Size
			!Atlas Size
			!Pictures?
			!Cell Size
			!Description
			\|-
			\|fontmap.ftm
			\|Rodin Pro Demi Bold
			\|18 ~ 20 px
			\|2048x2048
			\|✔️
			\|28x28
			\|Used for system text and subtitles.
			\|-
			\|font2map.ftm
			\|New Rodin Pro Ultra Bold
			\|~24.5 px
			\|1024x512
			\|❌
			\|37x50
			\|Used for main menu header text.
			\|-
			\|font3map.ftm
			\|New Rodin Pro Ultra Bold
			\|~19.5 px
			\|512x512
			\|❌
			\|31x41
			\|Used for main menu option text.
			\|}

	== Specification ==		== Specification ==

Hyper at 17:20, 5 May 2026

2026-05-05T17:20:18Z

← Older revision		Revision as of 17:20, 5 May 2026
Line 85:		Line 85:
	\|}		\|}
	To get the Unicode character this element pertains to, use the following expression:<syntaxhighlight lang="text">		To get the Unicode character this element pertains to, use the following expression:<syntaxhighlight lang="text">
	~~Character =~~ (CodePageIndex << 8) \| CharacterIndex		(CodePageIndex << 8) \| CharacterIndex
	</syntaxhighlight>		</syntaxhighlight>

Hyper at 20:49, 4 December 2025

2025-12-04T20:49:55Z

← Older revision		Revision as of 20:49, 4 December 2025
Line 163:		Line 163:
	\|The height of each character cell in the font atlas texture.		\|The height of each character cell in the font atlas texture.
	\|}		\|}
			[[Category:File Formats]]

Hyper at 20:46, 4 December 2025

2025-12-04T20:46:26Z

← Older revision		Revision as of 20:46, 4 December 2025
Line 150:		Line 150:
	\|const char*		\|const char*
	\|pTextFontPicturePath		\|pTextFontPicturePath
	\|A pointer to the path to the ~~'''~~Text Font Picture~~'''~~ for this font.		\|A pointer to the path to the [[Text Font Picture]] for this font.
	If non-applicable, this should be null.		If non-applicable, this should be null.
	\|-		\|-

Hyper at 20:30, 4 December 2025

2025-12-04T20:30:51Z

← Older revision		Revision as of 20:30, 4 December 2025
Line 4:		Line 4:

	== Specification ==		== Specification ==
	Text Font Map uses a [[Binary Resource]] container.		'''Text Font Map''' uses a [[Binary Resource]] container.

	=== Header ===		=== Header ===

Hyper: Created page with "'''''Text Font Map''''' is a file format used in Sonic the Hedgehog (2006) for storing font character information. These files are located in `text.arc` under the `./text/` directory from platform root as `*.ftm` files. == Specification == Text Font Map uses a Binary Resource container. === Header === The header consists of the following data structure: {| class="wikitable..."

2025-12-04T20:20:49Z

Created page with "'''''Text Font Map''''' is a file format used in Sonic the Hedgehog (2006) for storing font character information. These files are located in <code>text.arc</code> under the <code>./text/</code> directory from platform root as <code>*.ftm</code> files. == Specification == Text Font Map uses a Binary Resource container. === Header === The header consists of the following data structure: {| class="wikitable..."

New page

'''''Text Font Map''''' is a file format used in [[Sonic the Hedgehog (2006)]] for storing font character information.

These files are located in <code>text.arc</code> under the <code>./text/</code> directory from [[Sonic the Hedgehog (2006) File System#Platform Root|platform root]] as <code>*.ftm</code> files.

== Specification ==
Text Font Map uses a [[Binary Resource]] container.

=== Header ===
The header consists of the following data structure:
{| class="wikitable"
|+Length: 0x14
!Offset
!Type
!Name
!Description
|-
|0x00
|Char[4]
|Signature
|Always "FNTM".
|-
|0x04
|UInt32
|CodePageCount
|The number of code pages mapped in this font.
This is a zero-based count, so 0 = 1.
|-
|0x08
|UInt32
|CodePageTableOffset
|The offset of the table of code page offsets.
|-
|0x0C
|Byte
|Columns
|The number of columns in the font atlas.
This field is not used by the game. See [[Text Font Map#Static Font Data|Static Font Data]].
|-
|0x0D
|Byte
|Rows
|The number of rows in the font atlas.
This field is not used by the game. See [[Text Font Map#Static Font Data|Static Font Data]].
|-
|0x0E
|UInt16
|N/A
|Unknown. Always 1.
|-
|0x10
|UInt32
|FontNameOffset
|The offset of the name of this font.
|}

=== Code Page Table ===
The code page table is an indirection table with a fixed size of 256 elements.

Each element is a 32-bit offset that points to a fixed 256 element page of characters in Unicode. These characters consist of cell information and flags that map to the font atlas texture.

=== Character ===
Each character is stored as the following data structure:
{| class="wikitable"
|+Length: 0x04
!Offset
!Type
!Name
!Description
|-
|0x00
|Byte
|Column
|The column of this character cell in the font atlas texture.
|-
|0x01
|Byte
|Row
|The row of this character cell in the font atlas texture.
|-
|0x02
|UInt16
|Flags
|The flags for this character.
If <code>0xFFFF</code>, this character will be unset.
|}
To get the Unicode character this element pertains to, use the following expression:<syntaxhighlight lang="text">
Character = (CodePageIndex << 8) | CharacterIndex
</syntaxhighlight>

=== Static Font Data ===
The game stores the last remaining font information in a static array in the executable.

The array can be found at the following addresses:
{| class="wikitable"
|+
!Platform
!File
!Virtual Address
!Physical Address
|-
|Xbox 360
|<code>default.xex</code>
|<code>0x82B7F860</code>
|<code>0xB82860</code>
|-
|PlayStation 3
|<code>EBOOT.BIN</code>
|<code>0x100DDA20</code>
|<code>0x178DA20</code>
|}
The array consists of three elements of the following data structure:
{| class="wikitable"
|+Length: 0x1C
!Offset
!Type
!Name
!Description
|-
|0x00
|uint32_t
|ID
|The ID of this font.
|-
|0x04
|const char*
|pTexturePath
|A pointer to the path to the font atlas texture.
|-
|0x08
|uint16_t
|TextureWidth
|The width of the font atlas texture.
|-
|0x0A
|uint16_t
|TextureHeight
|The height of the font atlas texture.
|-
|0x0C
|const char*
|pTextFontMapPath
|A pointer to the path to the '''Text''' '''Font Map''' for this font.
|-
|0x10
|const char*
|pTextFontProportionPath
|A pointer to the path to the '''Text Font Proportion''' for this font.
|-
|0x14
|const char*
|pTextFontPicturePath
|A pointer to the path to the '''Text Font Picture''' for this font.
If non-applicable, this should be null.
|-
|0x18
|uint16_t
|CellWidth
|The width of each character cell in the font atlas texture.
|-
|0x1A
|uint16_t
|CellHeight
|The height of each character cell in the font atlas texture.
|}