TPL (File format): Difference between revisions

← Older edit

VisualWikitext

Latest revision as of 13:52, 7 October 2023

← Gotcha Force

This article is about the TPL file format.

This file format is almost completely documented.
The structure of this file is well known.

TPL file format (Texture Palette Library) is a folder with one or several texture.

Format

A TPL file contains one or several texture:

General format
TPL header file
Image offset table
All images	Palette header (optional)
	Palette data (optional)
	Image header
	Image data

Header

In general the header has a length of 12 bytes. All offsets are relative to the header.

Header:

Header
Offset	Length	Description
0x00	4	FileMagic. Always "\x00\x20\xAF\x30" (big endian)
0x04	4	Image count.
0x08	4	Image table offset

Gotcha Force TPLs length

All TPLs are aligned to 32 bytes. (NTSC/USA version)

Softwares

Softwares below handle TPLs files:

Rainbow, credits Marco Calautti.
BrawlBox, contributors: libertyernie, Sammi Husky, and BlackJax96
CTools Pack, credits Chadderz
Wiimms SZS Tools, credits Wiimm: can contain BREFT, BTI, TEX0, TPL and PNG.
Wexos's Toolbox, credits Wexos

@@ Line 3: / Line 3: @@
 ''This article is about the TPL file format.''
-<div style="text-align: center;">
+{{Research | 1| The structure of this file is well known. }}
-<div style="color: rgb(241, 196, 15);">This section is currently being written.</div>
-<div style="color: rgb(241, 196, 15); text-align: center;">More research is needed and some paragraphs may be wrong.</div>
-</div>
-Les fichiers '''TPL''' ('''T'''exture '''P'''alette '''L'''ibrary) sont des dossiers qui contiennent [https://www.gc-forever.com/yagcd/chap15.html#sec15.35 une ou plusieurs textures].
+'''TPL''' file format ('''T'''exture '''P'''alette '''L'''ibrary) is a folder with [https://www.gc-forever.com/yagcd/chap15.html#sec15.3 one or several texture].
 == Format ==
-Un fichier TPL peut contenir une ou plusieurs textures :
+A TPL file contains one or several texture:
 {| class="wikitable"
-! colspan=2 | Format général
+! colspan=2 | General format
 |-
-| colspan=2 align=center | Fichier TPL header
+| colspan=2 align=center | TPL header file
 |-
-| colspan=2 align=center | Table d'offset d'image
+| colspan=2 align=center | Image offset table
 |-
-| rowspan=4 align=center | Toutes les images || align=center | Palette header (optionnel)
+| rowspan=4 align=center | All images || align=center | Palette header (optional)
 |-
-| align=center | Palette data (optionnel)
+| align=center | Palette data (optional)
 |-
 | align=center | Image header
@@ Line 32: / Line 29: @@
 === Header ===
-En général, le header a une taille de 12 octets. Tous les offsets sont relatif à la taille du header.
+In general the header has a length of 12 bytes. All offsets are relative to the header.
-Header :
+Header:
 {| class="wikitable"
 ! colspan=3 | Header
 |-
-! Offset !! Taille !! Description
+! Offset !! Length !! Description
 |-
-| 0x00 || 4 || FileMagic. Toujours <tt>0x00 0x20 0xAF 0x30</tt> (big endian)
+| 0x00 || 4 || FileMagic. Always "\x00\x20\xAF\x30" (big endian)
 |-
-| 0x04 || 4 || Nombre d'images.
+| 0x04 || 4 || Image count.
 |-
-| 0x08 || 4 || Offset de la table d'image
+| 0x08 || 4 || Image table offset
 |}
-=== Table d'offset d'images ===
+=== Gotcha Force TPLs length ===
-=== Palette Header ===
+All TPLs are aligned to 32 bytes. (NTSC/USA version)
-=== Image Header ===
+== Softwares ==
-=== Image ===
+Softwares below handle TPLs files:
+* [https://github.com/marco-calautti/Rainbow Rainbow], credits Marco Calautti.
-=== Taille des TPLs ===
+* [https://github.com/libertyernie/brawltools BrawlBox], contributors: libertyernie, Sammi Husky, and BlackJax96
+* [https://github.com/Nightcaat/CTools CTools Pack], credits Chadderz
-Toutes les tailles de fichiers TPLs sont des multiples de 32 ;
+* [https://github.com/Wiimm/wiimms-szs-tools Wiimms SZS Tools], credits Wiimm: can contain BREFT, BTI, TEX0, TPL and PNG.
+* [https://wiki.tockdom.com/wiki/Wexos%27s_Toolbox Wexos's Toolbox], credits Wexos
-== Logiciels ==
-Ces logiciels ci-dessous comprennent et peuvent ouvrir les TPL :
-* [https://github.com/marco-calautti/Rainbow Rainbow], par Marco Calautti.
-* [[BrawlBox]], par Kryal et BlackJax96
-* [[CTools Pack]], par Chadderz
-* [[SZS Modifier]], par Chadderz
-* [[Wiimms SZS Tools]], par Wiimm: peut convertir BREFT, BTI, TEX0, TPL et PNG dans n'importe quelle direction.
-* [[Wexos's Toolbox]], par Wexos
 [[Category:File format]]
 [[Category:Gotcha Force]]