Wexos: Imported from avsys wiki

2024-05-01T18:06:05Z

Imported from avsys wiki

New page

'''TPL''' ('''T'''exture '''P'''alette '''L'''ibrary) is an image file format introduced on the [[Nintendo GameCube]], but later used on [[Wii]]. The format can store multiple textures into one file, though typically one file will contain one image. It also allows mipmaps to be stored. TPL files are on [[Wii]] used together with [[BRLYT]] and [[BRLAN]] to generate 2D layout.

== Header ==
The file starts with the following header:

{| class="wikitable"
|-
! Offset !! Type !! Description
|-
| 0x00 || UInt32 || '''File version'''. Always 0x0020AF30.
|-
| 0x04 || Int32 || '''Number of [[#Image Table|image tables]]''' in this file.
|-
| 0x08 || UInt32 || '''[[#Image Table|Image tables]] offset'''. This will always be placed after this header, thus 0x0C.
|}

== Image Table ==
The image table structure stores the texture. It splits the image into two sections, image and palette, where the latter is only used if the format used is a palette format. Each entry has the following structure:

{| class="wikitable"
|-
! Offset !! Type !! Description
|-
| 0x00 || UInt32 || '''[[#Image|Image]] offset'''.
|-
| 0x04 || UInt32 || '''[[#Palette|Palette]] offset'''. May be 0 if this image doesn't have a palette.
|}

=== Image ===
{| class="wikitable"
|-
! Offset !! Type !! Description
|-
| 0x00 || UInt16 || '''Height of image''' in pixels.
|-
| 0x02 || UInt16 || '''Width of image''' in pixels.
|-
| 0x04 || UInt32 || '''[[GameCube and Wii Image Formats|Image format]]'''. The pixel data type is determined by this value.
|-
| 0x08 || UInt32 || '''Image data offset'''. Offset to the data of the first image. The mipmaps are stored directly after the end of the first image.
|-
| 0x0C || UInt32 || '''Wrap S'''. 0 = Clamp, 1 = Repeat, 2 = Mirror
|-
| 0x10 || UInt32 || '''Wrap T''', same enum as above.
|-
| 0x14 || UInt32 || '''Minification filter'''.
{| class="wikitable"
|-
! Value !! Type
|-
| 0 || Nearest
|-
| 1 || Linear
|-
| 2 || Nearest_Mipmap_Nearest
|-
| 3 || Linear_Mipmap_Nearest
|-
| 4 || Nearest_Mipmap_Linear
|-
| 5 || Linear_Mipmap_Linear
|}
|-
| 0x18 || UInt32 || '''Magnification filter'''. 0 = Nearest, 1 = Linear
|-
| 0x1C || Float || '''LOD bias'''.
|-
| 0x20 || Byte || '''Edge LOD enable'''.
|-
| 0x21 || Byte || '''Min LOD'''. The level of the first image stored.
|-
| 0x22 || Byte || '''Max LOD'''. The level of the last image stored.
|-
| 0x23 || Byte || '''Unpacked'''. Must be set to 0 in file, set to 1 at runtime when the TPL file has been loaded.
|}

=== Palette ===
{| class="wikitable"
|-
! Offset !! Type !! Description
|-
| 0x00 || UInt16 || '''Number of palette entries'''. Each consist of a color of the type specified by the palette format.
|-
| 0x02 || Byte || '''Unpacked'''. Must be set to 0 in file, set to 1 at runtime when the TPL file has been loaded.
|-
| 0x03 || Byte || '''Padding'''.
|-
| 0x04 || UInt32 || '''[[GameCube and Wii Image Formats|Palette format]]'''.
|-
| 0x08 || UInt32 || '''Palette offset'''. Offset to the palette colors.
|}

== Tools ==
The following tools can handle TPL files:
* [[BrawlBox]], by [[Kryal]] and [[BlackJax96]]
* [[CTools Pack]], by [[Chadderz]]
* [[SZS Modifier]], by [[Chadderz]]
* [[Wexos's Toolbox]], by [[Wexos]]
* [[Wiimms SZS Tools]], by [[Wiimm]]

[[Category:GameCube File Formats]]
[[Category:Wii File Formats]]

TPL (File Format) - Revision history

Wexos: Imported from avsys wiki