Anonymous

Changes

From Final Fantasy Inside

FF7/TEX format

8,897 bytes added, 05:20, 23 May 2019
m
9 revisions imported
== TEX Texture Data Format for PC by [[User:MirixMirex|MirixMirex]] (Edits by [[User:Aali|Aali]]) ==
FF7 PC texture consists of header, an optional palette and bitmap data. Usually data are stored like palletized picture, with bitmap pixels referencing to palette. Color 0 (in palette its usually black) is usually used as transparent color.
Sometimes, (I'm 'Pixel values of 0 may or may not sure if it is used in ff7 at all)be transparent, when bit depth is 16 data are stored as packed RGB in style RGB555depending on the color key status, which means 5 bits per color in one 2 byte entrymore on that later. This also applies to non-paletted formats. ''
When bit depth is 16 then data are stored as packed RGB in style RGB555, which means 5 bits per color in one 2 byte entry. I'm not sure if it is used in FF7 at all, its probably used in FF8.
<table CELLSPACING="0" style="margin''The tex format is actually very flexible and can take almost any non-bottom: 0px;"><tr><th style="border: 1px solid rgb(0, 0, 0); vertical-align: middle; width: 51px; height: 26px; background-color: rgb(230, 230, 230);">Offset </th><th style="border: 1px solid rgb(0, 0, 0); vertical-align: middle; width: 126px; height: 26px; background-color: rgb(230, 230, 230);">Size </th><th style="border: 1px solid rgb(0, 0, 0); vertical-align: middle; width: 222px; height: 26px; background-color: rgb(230, 230, 230);">Description </th></tr>paletted format as long as you describe it properly in the header.''
<tr>{| style="margin-bottom: 0px"<td ! style="border: 1px solid black; vertical-align: middle; width: 51px; height: 26px; background-color: rgb(0230, 0230, 0230)" | Offset! style="border: 1px solid black; vertical-align: middle; width: 51px126px; height: 25px26px;background-color: rgb(230, 230, 230)">0x00 </td>| Size<td ! style="border: 1px solid black; vertical-align: middle; width: 222px; height: 26px; background-color: rgb(0230, 0230, 0230)" | Description|-| style="border-style: solid none solid solid; border-color: black; border-width: 126px1px; vertical-align: top" || style="border-style: solid solid solid none; heightborder-color: 25pxblack;border-width: 1px" colspan="2" | Header|-| style="border: 1px solid black">| 0x0056 | style="border: 1px solid black" | 4 bytes </td>(long)<td | style="border: 1px solid rgb(0black" | Version, 0must be 1, 0or FF7 won't load the file|-| style="border: 1px solid black" | 0x04| style="border: 1px solid black" | 4 bytes (long)| style="border: 1px solid black" | Unknown|-| style="border: 1px solid black" | 0x08| style="border: 1px solid black" | 4 bytes (long)| style="border: 1px solid black" | Color key flag|-| style="border: 1px solid black" | 0x0C| style="border: 1px solid black" | 4 bytes (long)| style="border: 1px solid black" | Unknown|-| style="border: 1px solid black" | 0x10| style="border: 1px solid black" | 4 bytes (long)| style="border: 1px solid black" | Unknown|-| style="border: 1px solid black" | 0x14| style="border: 1px solid black" | 4 bytes (long)| style="border: 1px solid black" | Minimum bits per color (D3D driver uses these to determine which texture format to convert to on load)|-| style="border: 1px solid black" | 0x18| style="border: 1px solid black" | 4 bytes (long)| style="border: 1px solid black" | Maximum bits per color|-| style="border: 1px solid black" | 0x1C| style="border: 1px solid black" | 4 bytes (long)| style="border: 1px solid black" | Minimum alpha bits|-| style="border: 1px solid black" | 0x20| style="border: 1px solid black" | 4 bytes (long)| style="border: 1px solid black" | Maximum alpha bits|-| style="border: 1px solid black" | 0x24| style="border: 1px solid black" | 4 bytes (long)| style="border: 1px solid black" | Minimum bits per pixel|-| style="border: 1px solid black" | 0x28| style="border: 1px solid black" | 4 bytes (long)| style="border: 1px solid black" | Maximum bits per pixel|-| style="border: 1px solid black" | 0x2C| style="border: 1px solid black" | 4 bytes (long)| style="border: 1px solid black" | Unknown|-| style="border: 1px solid black" | 0x30| style="border: 1px solid black" | 4 bytes (long)| style="border: 1px solid black" | Number of palettes|-| style="border: 1px solid black" | 0x34| style="border: 1px solid black" | 4 bytes (long)| style="border: 1px solid black" | Number of colors per palette|-| style="border: 1px solid black" | 0x38| style="border: 1px solid black" | 4 bytes (long)| style="border: 1px solid black" | Bit depth|-| style="border: 1px solid black" | 0x3C| style="border: 1px solid black" | 4 bytes (long)| style="border: 1px solid black" | Image Width|-| style="border: 1px solid black" | 0x40| style="border: 1px solid black" | 4 bytes (long)| style="border: 1px solid black" | Image Height|-| style="border: 1px solid black" | 0x44| style="border: 1px solid black" | 4 bytes (long); | style="border: 1px solid black" | Pitch or bytes per row, usually ignored and assumed to be bytes per pixel * width|-| style="border: 222px; height1px solid black" | 0x48| style="border: 25px;1px solid black">| 4 bytes (long)| style="border: 1px solid black" | Unknown </td></tr>|-| style="border: 1px solid black" | 0x4C| style="border: 1px solid black" | 4 bytes (long)| style="border: 1px solid black" | Palette flag (this indicates the presence of a palette)<tr>|-<td | style="border: 1px solid rgbblack" | 0x50| style="border: 1px solid black" | 4 bytes (long)| style="border: 1px solid black" | Bits per index, always 0for non-paletted images|-| style="border: 1px solid black" | 0x54| style="border: 1px solid black" | 4 bytes (long)| style="border: 1px solid black" | Indexed-to-8bit flag, never used in FF7|-| style="border: 1px solid black" | 0x58| style="border: 1px solid black" | 4 bytes (long)| style="border: 1px solid black" | Palette size, always number of palettes * colors per palette|-| style="border: 1px solid black" | 0x5C| style="border: 1px solid black" | 4 bytes (long)| style="border: 1px solid black" | Number of colors per palette (again, may be 0sometimes, the other value will be used anyway)|-| style="border: 1px solid black" | 0x60| style="border: 1px solid black" | 4 bytes (long)| style="border: 1px solid black" | Runtime data, 0ignored on load|-| style="border: 1px solid black" | 0x64| style="border: 1px solid black" | 4 bytes (long)| style="border: 1px solid black" | Bits per pixel|-| style="border: 1px solid black" | 0x68| style="border: 1px solid black" | 4 bytes (long)| style="border: 1px solid black" | Bytes per pixel, always use this to determine how much data to read, if this is 1 you read 1 byte per pixel, regardless of bit depth|-| style="border-style: solid none solid solid; border-color: black; border-width: 51px1px; vertical-align: top" || style="border-style: solid solid solid none; heightborder-color: 25pxblack;border-width: 1px" colspan="2" | Pixel format (all 0 for paletted images)|-| style="border: 1px solid black" | 0x6C| style="border: 1px solid black" | 4 bytes (long)| style="border: 1px solid black" | Number of red bits|-| style="border: 1px solid black" | 0x70| style="border: 1px solid black" | 4 bytes (long)| style="border: 1px solid black" | Number of green bits|-| style="border: 1px solid black" | 0x74| style="border: 1px solid black" | 4 bytes (long)| style="border: 1px solid black" | Number of blue bits|-| style="border: 1px solid black" | 0x78| style="border: 1px solid black" | 4 bytes (long)| style="border: 1px solid black" | Number of alpha bits|-| style="border: 1px solid black" | 0x7C| style="border: 1px solid black" | 4 bytes (long)| style="border: 1px solid black" | Red bitmask|-| style="border: 1px solid black" | 0x80| style="border: 1px solid black">| 4 bytes (long)0x38 </td>| style="border: 1px solid black" | Green bitmask|-| style="border: 1px solid black" | 0x84| style="border: 1px solid black" | 4 bytes (long)| style="border: 1px solid black" | Blue bitmask|-| style="border: 1px solid black" | 0x88| style="border: 1px solid black" | 4 bytes (long)| style="border: 1px solid black" | Alpha bitmask|-| style="border: 1px solid black" | 0x8C| style="border: 1px solid black" | 4 bytes (long)| style="border: 1px solid black" | Red shift|-| style="border: 1px solid black" | 0x90| style="border: 1px solid black" | 4 bytes (long)| style="border: 1px solid black" | Green shift|-| style="border: 1px solid black" | 0x94| style="border: 1px solid black" | 4 bytes (long)| style="border: 1px solid black" | Blue shift|-| style="border: 1px solid black" | 0x98| style="border: 1px solid black" | 4 bytes (long)| style="border: 1px solid black" | Alpha shift|-| style="border: 1px solid black" | 0x9C| style="border: 1px solid black" | 4 bytes (long)<td | style="border: 1px solid rgbblack" | Always 8 - Number of red bits (0Not sure what the point of these fields is, 0, 0they're always ignored anyway)|-| style="border: 1px solid black" | 0xA0| style="border: 1px solid black" | 4 bytes (long)| style="border: 1px solid black" | 8 - Number of green bits|-| style="border: 1px solid black" | 0xA4| style="border: 1px solid black" | 4 bytes (long)| style="border: 1px solid black" | 8 - Number of blue bits|-| style="border: 1px solid black" | 0xA8| style="border: 1px solid black" | 4 bytes (long)| style="border: 1px solid black" | 8 - Number of alpha bits|-| style="border: 1px solid black" | 0xAC| style="border: 1px solid black" | 4 bytes (long)| style="border: 1px solid black" | Red max|-| style="border: 1px solid black" | 0xB0| style="border: 1px solid black" | 4 bytes (long)| style="border: 1px solid black" | Green max|-| style="border: 1px solid black" | 0xB4| style="border: 1px solid black" | 4 bytes (long)| style="border: 1px solid black" | Blue max|-| style="border: 1px solid black" | 0xB8| style="border: 1px solid black" | 4 bytes (long)| style="border: 1px solid black" | Alpha max|-| style="border-style: solid none solid solid; border-color: black; border-width: 126px1px; vertical-align: top" || style="border-style: solid solid solid none; heightborder-color: 25pxblack;border-width: 1px" colspan="2" | End of pixel format|-| style="border: 1px solid black">| 0xBC| style="border: 1px solid black" | 4 bytes (long) </td><td | style="border: 1px solid rgbblack" | Color key array flag (this indicates the presence of a color key array)|-| style="border: 1px solid black" | 0xC0| style="border: 1px solid black" | 4 bytes (long)| style="border: 1px solid black" | Runtime data|-| style="border: 1px solid black" | 0xC4| style="border: 1px solid black" | 4 bytes (long)| style="border: 1px solid black" | Reference alpha (more on this later)|-| style="border: 1px solid black" | 0xC8| style="border: 1px solid black" | 4 bytes (long)| style="border: 1px solid black" | Runtime data|-| style="border: 1px solid black" | 0xCC| style="border: 1px solid black" | 4 bytes (long)| style="border: 1px solid black" | Unknown|-| style="border: 1px solid black" | 0xD0| style="border: 1px solid black" | 4 bytes (long)| style="border: 1px solid black" | Palette index (runtime data)|-| style="border: 1px solid black" | 0xD4| style="border: 1px solid black" | 4 bytes (long)| style="border: 1px solid black" | Runtime data|-| style="border: 1px solid black" | 0xD8| style="border: 1px solid black" | 4 bytes (long)| style="border: 1px solid black" | Runtime data|-| style="border: 1px solid black" | 0xDC| style="border: 1px solid black" | 4 bytes (long)| style="border: 1px solid black" | Unknown|-| style="border: 1px solid black" | 0xE0| style="border: 1px solid black" | 4 bytes (long)| style="border: 1px solid black" | Unknown|-| style="border: 1px solid black" | 0xE4| style="border: 1px solid black" | 4 bytes (long)| style="border: 1px solid black" | Unknown|-| style="border: 1px solid black" | 0xE8| style="border: 1px solid black" | 4 bytes (long)| style="border: 1px solid black" | Unknown|-| style="border-style: solid none solid solid; border-color: black; border-width: 1px; vertical-align: top" || style="border-style: solid solid solid none; border-color: black; border-width: 1px" colspan="2" | Palette data (ignore this section if palette flag is 0)|-| style="border: 1px solid black; vertical-align: top" | 0xEC| style="border: 1px solid black; vertical-align: top" | Palette size * 4| style="border: 1px solid black; vertical-align: top" | The raw palette data, 0, 0)always in 32-bit BGRA format|-| style="border-style: solid none solid solid; border-color: black; border-width: 222px1px; vertical-align: top" || style="border-style: solid solid solid none; border-color: black; heightborder-width: 1px" colspan="2" | Pixel data|-| style="border: 25px1px solid black;vertical-align: top">| Variesbit depth | style="border: 1px solid black; vertical- can be 4align: top" colspan="2" | Read width * height * "bytes per pixel" bytes of data. If there's a palette, 8every pixel is an index into that palette, 16 </td>otherwise use the pixel format specification.|-| style="border-style: solid none solid solid; border-color: black; border-width: 1px; vertical-align: top" || style="border-style: solid solid solid none; border-color: black; border-width: 1px" colspan="2" | Color key array|-| style="border: 1px solid black; vertical-align: top" | Varies| style="border: 1px solid black; vertical-align: top" colspan="2" |Number of palettes * 1 bytes.</tr>|}
<tr><td style="border''Color keying: 1px solid rgb(0If the color key flag is zero, 0no color keying is performed and the color key array is ignored. Otherwise, 0); width: 51px; height: 25px;">0x3c </td><td style="border: 1px solid rgb(0the current palette index is used to retrieve a single byte from the color key array, 0this is the new color key flag, 0); width: 126px; height: 25px;">4 bytes zero means don't do color keying.'' If there is no color key array (longand the color key flag is not zero) </td><td style="border: 1px solid rgb(0, 0, 0); width: 222px; height: 25px;">Image Width </td></tr>you should always color key.
<tr><td style="border''Reference alpha: 1px solid rgb(0Only applies to paletted images, 0, 0); width: 51px; height: 25px;">0x40 </td><td style="border: 1px solid rgb(0, 0, 0); width: 126px; height: 25px;">4 bytes (long) </td><td style="border: 1px solid rgb(0, 0, 0); width: 222px; height: 25px;">Image Height </td></tr><tr><td style="border: 1px solid rgb(0, 0, 0); width: 51px; height: 25px;">0x44 </td><td style="border: 1px solid rgb(0, 0, 0); width: 126px; height: 25px;">20 bytes </td><td style="border: 1px solid rgb(0, 0, 0); width: 222px; height: 25px;">Unknown </td></tr> <tr><td style="border: 1px solid rgb(0, 0, 0); width: 51px; height: 25px;">0x58 </td><td style="border: 1px solid rgb(0, 0, 0); width: 126px; height: 25px;">4 bytes (long) </td><td style="border: 1px solid rgb(0, 0, 0); width: 222px; height: 25px;">Number of Palette Entries </td></tr> <tr><td style="border: 1px solid rgb(0, 0, 0); width: 51px; height: 25px;">0x5c </td><td style="border: 1px solid rgb(0, 0, 0); width: 126px; height: 25px;">144 bytes </td><td style="border: 1px solid rgb(0, 0, 0); width: 222px; height: 25px;">Unknown </td></tr> <tr><td style="border: 1px solid rgb(0, 0, 0); vertical-align: top; width: 51px; height: 96px;">0xec </td><td style="border: 1px solid rgb(0, 0, 0); vertical-align: top; width: 126px; height: 96px;">Palette Entries * 4 </td><td style="border: 1px solid rgb(0, 0, 0); vertical-align: top; width: 222px; height: 96px;">Every 4 bytes if the alpha value sampled from the palette represent one coloris 0xFE, BGRA -Blue Green Red Alpha, but I'm not sure about this value should be replaced with the reference alpha byte. I'm using only the BGR part </td></tr> <tr><td style="border-style: solid none solid solid; border-color: rgb(0, 0, 0); border-width: 1px; vertical-align: top; width: 51px; height: 25px;"></td><td colspan="2" style="border-style: solid solid solid none; border-color: rgb(0, 0, 0); border-width: 1px; width: 348px; height: 25px;">After the Palette data </td></tr> <tr><td style="border: 1px solid rgb(0, 0, 0); vertical-align: top; width: 51px; height: 140px;">Varies </td><td style="border: 1px solid rgb(0, 0, 0); vertical-align: top; width: 126px; height: 140px;">(sizex * sizey) if bit depth is 4 or 8, (sizex * sizey * 2) if bit depth is 16 </td><td style="border: 1px solid rgb(0, 0, 0); vertical-align: top; width: 222px; height: 140px;">Thebitmap: If bit depth is 4 or 8, every byte of bitmap data is referenceto palette color. If bit depth is 16, bitmap is composed from 16bit(2byte, short) values, which are RGB555 colors. </td></tr></table>'