BTI - Revision history

Jasper at 02:26, 27 February 2020

2020-02-27T02:26:13Z

Jasper at 21:51, 31 January 2020

2020-01-31T21:51:27Z

LagoLunatic: Document PalettesEnabled

2019-12-24T18:04:35Z

Document PalettesEnabled

Jasper at 18:28, 9 December 2019

2019-12-09T18:28:41Z

Jasper at 19:46, 11 November 2019

2019-11-11T19:46:30Z

Jasper at 19:46, 11 November 2019

2019-11-11T19:46:12Z

Gamma at 03:43, 31 October 2016

2016-10-31T03:43:18Z

Gamma at 03:36, 31 October 2016

2016-10-31T03:36:44Z

Gamma: Created page with "'''BTI''' is a format used for storing image data. It can be found alone as a .bti file, or as an embedded image in the TEX1 chunk of the BMD/BDL model format. The format is..."

2016-10-31T03:29:11Z

Created page with "'''BTI''' is a format used for storing image data. It can be found alone as a .bti file, or as an embedded image in the TEX1 chunk of the BMD/BDL model format. The format is..."

New page

'''BTI''' is a format used for storing image data. It can be found alone as a .bti file, or as an embedded image in the TEX1 chunk of the BMD/BDL model format.

The format is simply a header followed by the image data. The image data can be encoded in several different ways, and the header specifies which format the image data is in.

=Header=

// 0x20/32 bytes long
/*0x00*/ byte FormatID; // Image data format. See "Texture Formats" below
/*0x01*/ bool AlphaEnabled;
/*0x02*/ short Width; //Width of texture
/*0x04*/ short Height; //Height of texture
/*0x06*/ byte WrapS; //0 = clamp to edge, 1 = repeat, 2 = mirror
/*0x07*/ byte WrapT; //Above
/*0x08*/ byte Unknown1;
/*0x09*/ byte PaletteFormat; // Palette data format. See "Texture Formats" below
/*0x0A*/ short PaletteEntryCount; //Number of Palettes
/*0x0C*/ int PaletteOffset; //Offsets relative to start of BTITextureHeader
/*0x10*/ Color BorderColor;
/*0x14*/ byte MinFilter; //Probably two U8s, first is 5 or 1, second 1 most of the time
/*0x15*/ byte MagFilter;
/*0x16*/ short Unknown2; //0 most of the time, sometimes 0x10, 0x18, 0x20, 0x28
/*0x18*/ byte MipmapCount; //How many mipmaps
/*0x19*/ byte Unknown3;
/*0x1A*/ short LodBias;
/*0x1C*/ int DataOffset //Relative to the start of the header, points to Image Data
//Some of the unknown data may be related to render state (lod bias, min/mag filter, etc.?)

=Texture Formats=

This is the list of formats that the image data can be encoded in.

{| class="wikitable"
|-
! ID !! Format || Bits per Pixel || Block Width || Block Height || Block Size || Type/Description
|-
| 0x00 || I4 || 4 || 8 || 8 || 32 || Gray
|-
| 0x01 || I8 || 8 || 8 || 8 || 32 || Gray
|-
| 0x02 || IA4 || 8 || 8 || 4 || 32 || Gray + Alpha
|-
| 0x03 || IA8 || 16 || 4 || 4 || 32 || Gray + Alpha
|-
| 0x04 || RGB565 || 16 || 4 || 4 || 32 || Color
|-
| 0x05 || RGB5A3 || 16 || 4 || 4 || 32 || Color + Alpha
|-
| 0x06 || RGBA32 || 32 || 4 || 4 || 64 || Color + Alpha
|-
| 0x08 || C4 || 4 || 8 || 8 || 32 || Palette Choices (IA8, RGB565, RGB5A3)
|-
| 0x09 || C8 || 8 || 8 || 4 || 32 || Palette Choices (IA8, RGB565, RGB5A3)
|-
| 0x0A || C14X2 || 16 (14 used) || 4 || 4 || 32 || Palette Choices (IA8, RGB565, RGB5A3)
|-
| 0x0E || CMPR || 4 || 8 || 8 || 32 || Mini palettes in each block, RGB565 or transparent.
|}

@@ Line 43: / Line 43: @@
 | <center>0x16</center> || <center>1</center> || byte || MinLOD || The minimum LOD clamp, scaled by 8. This appears to always be 0, at least.
 |-
-| <center>0x17</center> || <center>1</center> || byte || MaxLOD || The maximum LOD clamp, scaled by 8. This should practically have the same value as MaxLOD.
+| <center>0x17</center> || <center>1</center> || byte || MaxLOD || The maximum LOD clamp, scaled by 8. This should practically have the same value as MipmapCount.
 |-
 | <center>0x18</center> || <center>1</center> || byte || MipmapCount || Apparently unread by the engine itself, it only uses the MipmapEnable flag and the max LOD field.

@@ Line 29: / Line 29: @@
 | <center>0x0C</center> || <center>4</center> || int || PaletteOffset || The offset to the palette data, relative to the start of this header.
 |-
-| <center>0x10</center> || <center>4</center> || GXColor || BorderColor ||
+| <center>0x10</center> || <center>1</center> || bool || MipmapEnable || Whether the texture will use mipmaps.
 |-
 | <center>0x14</center> || <center>1</center> || GXTexFilter || MinFilter ||
@@ Line 35: / Line 41: @@
 | <center>0x15</center> || <center>1</center> || GXTexFilter || MagFilter ||
 |-
-| <center>0x16</center> || <center>1</center> || byte || MinLOD || The minimum LOD clamp, scaled by 8.
+| <center>0x16</center> || <center>1</center> || byte || MinLOD || The minimum LOD clamp, scaled by 8. This appears to always be 0, at least.
 |-
-| <center>0x17</center> || <center>1</center> || byte || MaxLOD || The maximum LOD clamp, scaled by 8.
+| <center>0x17</center> || <center>1</center> || byte || MaxLOD || The maximum LOD clamp, scaled by 8. This should practically have the same value as MaxLOD.
 |-
-| <center>0x18</center> || <center>1</center> || byte || MipmapCount ||
+| <center>0x18</center> || <center>1</center> || byte || MipmapCount || Apparently unread by the engine itself, it only uses the MipmapEnable flag and the max LOD field.
 |-
 | <center>0x19</center> || <center>1</center> || byte || Unknown ||

@@ Line 21: / Line 21: @@
 | <center>0x07</center> || <center>1</center> || GXWrapMode || WrapT || The wrap mode along the texture's T axis.
 |-
-| <center>0x08</center> || <center>1</center> || unknown || ||
+| <center>0x08</center> || <center>1</center> || bool || PalettesEnabled || Must be set to true for the palette to be used correctly.
 |-
 | <center>0x09</center> || <center>1</center> || GXTexPalette || PaletteFormat || The format of the associated palette.

@@ Line 25: / Line 25: @@
 | <center>0x09</center> || <center>1</center> || GXTexPalette || PaletteFormat || The format of the associated palette.
 |-
-| <center>0x0A</center> || <center>2</center> || short || PaletteFormat || The number of entries in the palette data.
+| <center>0x0A</center> || <center>2</center> || short || PaletteCount || The number of entries in the palette data.
 |-
 | <center>0x0C</center> || <center>4</center> || int || PaletteOffset || The offset to the palette data, relative to the start of this header.

@@ Line 46: / Line 46: @@
 |-
 | <center>0x1C</center> || <center>4</center> || int || TextureDataOffset || The offset to the texture data, relative to the start of this header.
-|-
+|}
 = As Embedded Image =

@@ Line 1: / Line 1: @@
-'''BTI''' is a format used for storing image data. It can be found alone as a .bti file, or as an embedded image in the TEX1 chunk of the BMD/BDL model format.
+'''BTI''' is a format used for storing texture image data. It can be found alone as a .bti file, or as an embedded image in the TEX1 chunk of the BMD/BDL model format.
 The format is simply a header followed by the image data. The image data can be encoded in several different ways, and the header specifies which format the image data is in.
-=Header=
+= Header =
-  // 0x20/32 bytes long
+{| class="wikitable"
- /*0x00*/ byte FormatID; // Image data format. See "Texture Formats" below
+|-
- /*0x01*/ bool AlphaEnabled;
+! Offset                !! Size               !! Type !! Name !!  Description
- /*0x02*/ short Width; //Width of texture
+|-
- /*0x04*/ short Height; //Height of texture
+| <center>0x00</center> || <center>1</center> || GXTexFormat || Format || The format of the texture image
- /*0x06*/ byte WrapS; //0 = clamp to edge, 1 = repeat, 2 = mirror
+|-
- /*0x07*/ byte WrapT; //Above
+| <center>0x01</center> || <center>1</center> || bool || AlphaEnabled ||
- /*0x08*/ byte Unknown1;
+|-
- /*0x09*/ byte PaletteFormat; // Palette data format. See "Palette Formats" below
+| <center>0x02</center> || <center>2</center> || short || Width || The width of the texture
- /*0x0A*/ short PaletteEntryCount; //Number of Palettes
+|-
- /*0x0C*/ int PaletteOffset; //Offsets relative to start of BTITextureHeader
+| <center>0x04</center> || <center>2</center> || short || Height || The height of the texture
- /*0x10*/ Color BorderColor;
+|-
- /*0x14*/ byte MinFilter; //Probably two U8s, first is 5 or 1, second 1 most of the time
+| <center>0x06</center> || <center>1</center> || GXWrapMode || WrapS || The wrap mode along the texture's S axis.
- /*0x15*/ byte MagFilter;
+|-
- /*0x16*/ short Unknown2; //0 most of the time, sometimes 0x10, 0x18, 0x20, 0x28
+| <center>0x07</center> || <center>1</center> || GXWrapMode || WrapT || The wrap mode along the texture's T axis.
- /*0x18*/ byte MipmapCount; //How many mipmaps
+|-
- /*0x19*/ byte Unknown3;
+| <center>0x08</center> || <center>1</center> || unknown || ||
- /*0x1A*/ short LodBias;
+|-
- /*0x1C*/ int DataOffset //Relative to the start of the header, points to Image Data
+| <center>0x09</center> || <center>1</center> || GXTexPalette || PaletteFormat || The format of the associated palette.
- //Some of the unknown data may be related to render state (lod bias, min/mag filter, etc.?)
+|-
-=As Embedded Image=
+= As Embedded Image =
 The BTI format can be stored in models and particle banks as an embedded image. When this is the case, the headers for each embedded image are stored together, one after another. After the last header is the image data corresponding to each header in an uninterrupted stream.
-This is where the "DataOffset" variable in the header is useful. This offset specifies where the image data starts in relation to the start of the image data's header. In other words, to find the image data for a given header, you go to the start of the header and move forward the number of bytes given by DataOffset.
+This is where the "TextureDataOffset" variable in the header is useful. This offset specifies where the image data starts in relation to the start of the image data's header. In other words, to find the image data for a given header, you go to the start of the header and move forward the number of bytes given by TextureDataOffset.
-=Texture Formats=
+= Texture Formats =
 This is the list of formats that the image data can be encoded in.

@@ Line 13: / Line 13: @@
   /*0x07*/ byte WrapT; //Above
   /*0x08*/ byte Unknown1;
-  /*0x09*/ byte PaletteFormat; // Palette data format. See "Texture Formats" below
+  /*0x09*/ byte PaletteFormat; // Palette data format. See "Palette Formats" below
   /*0x0A*/ short PaletteEntryCount; //Number of Palettes
   /*0x0C*/ int PaletteOffset; //Offsets relative to start of BTITextureHeader
@@ Line 48: / Line 48: @@
 | 0x06 || RGBA32 || 32 || 4 || 4 || 64 || Color + Alpha
 |-
-| 0x08 || C4 || 4 || 8 || 8 || 32 || Palette Choices (IA8, RGB565, RGB5A3)
+| 0x08 || C4 || 4 || 8 || 8 || 32 || Palette
 |-
-| 0x09 || C8 || 8 || 8 || 4 || 32 || Palette Choices (IA8, RGB565, RGB5A3)
+| 0x09 || C8 || 8 || 8 || 4 || 32 || Palette
 |-
-| 0x0A || C14X2 || 16 (14 used) || 4 || 4 || 32 || Palette Choices (IA8, RGB565, RGB5A3)
+| 0x0A || C14X2 || 16 (14 used) || 4 || 4 || 32 || Palette
 |-
-| 0x0E || CMPR || 4 || 8 || 8 || 32 || Mini palettes in each block, RGB565 or transparent.
+| 0x0E || CMPR || 4 || 8 || 8 || 32 || Mini palettes in each block, RGB565, or transparent.
 |}