OBD:TXMP: Difference between revisions

{{OBD_File_Header | type=TXMP | prev=TXMB | next=TxtC | name=Texture Map | family=Generic | align=center}}

The difference between "PC" (Windows retail) and "Mac" (Windows demo and Mac proper) is minor, at least from the point of view of disk storage (the structural difference is limited to runtime fields grouped at the end of the instance, which is why they haven't been documented or implemented in OniSplit). A more obvious difference is that "PC" TXMPs store their pixel data in the .raw file, and "Mac" TXMPs use the .sep file, but this merely amounts to using different fields within the same structure. Thus, even though the template checksums for "Mac" and "PC" are different, both formats can easily be described in common.

 

[[image:txmp_all.gif]]

:0 - ARGB4444, 16 bits/pixel (stored as a little-Endian int16, swaps to big Endian at runtime on Mac)

:1 - RGB555, 16 bits/pixel (stored as a little-Endian int16, swaps to big Endian at runtime on Mac)

:2 - ARGB1555, 16 bits/pixel (stored as a little-Endian int16, swaps to big Endian at runtime on Mac)

:3 (never used in Vanilla TXMPs) - I8, 8 bits/pixel, stored as a single byte. Monochrome "intensity" (256 levels of gray).

:4 (never used in Vanilla TXMPs) - I1, 8 pixels/byte. Pixel rows, bottom to top. Monochrome "intensity" (black-or-white).

:5 (never used in Vanilla TXMPs) - A8, 8 bits/pixel, stored as a single byte. Standalone alpha (256 levels of opacity).

:6 (never used in Vanilla TXMPs) - A4I4, 8 bits/pixel, stored as a single byte. Intensity (bit mask 0x0F), alpha (0xF0).

:7 (never used in Vanilla TXMPs<ref>Storage format 7 was jointly used by OniSplit, Daodan DLL and the Intel Mac build to allow for 32-bit textures with transparency - most importantly experimental lightmaps, see [[Lightmapping_levels|HERE]]. However, the actual storage format used in this case was RGBA_Bytes (type 11), and type 7 was used by mistake.</ref>) - ARGB8888, 32 bits/pixel (stored as a little-Endian int32, swaps to big Endian at runtime on a PowerPC Mac)

:8 - RGB888, 32 bits/pixel (stored as a little-Endian int32, swaps to big Endian at runtime on Mac)

:9 - S3TC/DXT1, RGB565 compressed 4 times ([https://www.khronos.org/opengl/wiki/S3_Texture_Compression GL_COMPRESSED_RGB_S3TC_DXT1_EXT] OpenGL texture format)

:10 (never used in Vanilla TXMPs) - RGB_Bytes, 24 bits/pixel, stored as 3 consecutive bytes: first Red, then Green, then Blue.

:11 (never used in Vanilla TXMPs<ref>Storage format 11 (RGBA_Bytes) was effectively implemented by OniSplit to allow for 32-bit textures with transparency - most importantly experimental lightmaps, see [[Lightmapping_levels|HERE]]. However, it was mislabeled as type 7 (ARGB8888) by OniSplit, Daodan DLL and the Intel Mac build, which resulted in byte swapping and the requirement of authoring PC and Mac versions of TXMPs.</ref>) - RGBA_Bytes, 32 bits/pixel, stored as 4 consecutive bytes: first Red, then Green, then Blue, then Alpha.

:12 (never used in Vanilla TXMPs) - RGBA5551, 16 bits/pixel (stored as a little-Endian int16, swaps to big Endian at runtime on Mac)

:13 (never used in Vanilla TXMPs) - RGBA4444, 16 bits/pixel (stored as a little-Endian int16, swaps to big Endian at runtime on Mac)

:14 (never used in Vanilla TXMPs) - RGB565, 16 bits/pixel (stored as a little-Endian int16, swaps to big Endian at runtime on Mac)

:15 (never used in Vanilla TXMPs) - ABGR1555, 16 bits/pixel (stored as a little-Endian int16, swaps to big Endian at runtime on Mac)

{{OBDtr| 0x9C | offset  |C800C8| 20 00 00 00 |00 00 00 20| at this position starts the texture part in the raw file (Windows retail only) }}

{{OBDtr| 0xA0 | offset  |C87C64| 00 00 00 00 | unused    | at this position starts the texture part in the separate file (Windows demo and Mac only) }}

{{OBDtr| 0xA4 | char[12] |B0C3D4| AD DE      | dead      | The layout of these 12 bytes is different for the "PC" and "Mac" versions (i.e. Windows retail vs. Windows demo and Mac):

*For a Mac or Windows demo TXMP, the four bytes at 0xA4-A7 are "00 00 00 00" instead of "AD DE AD DE", and correspond to a "material type" attributed at runtime (from [[TMBD]]), which is then used for impact/breakability lookup. The Windows retail TXMPs apparently have no such "material type" field.

*The fields at 0xA8-AF (for Windows demo and Mac) or 0xA4-AB (for Windows retail) are used only at runtime (and somehow obfuscated by "DEAD" when written to disk). Judging by the Windows demo and Mac engine, we can assume they are the same in both engines, and serve for rendering optimization (there is a texture name pointer, a "dirty" flag stored as a byte and 3 extra bytes used as flags).

Since runtime fields are grouped at the end, PC and Mac TXMPs are treated by OniSplit under the same template, merely switching between the .raw and .sep links, and blanking out everything past 0xA4.

{{OBDtr| 0xB0 | char[16] |B0C3D4| AD DE      | dead      | completely unused bytes (not part of the PC or Mac TXMP template) }}

{{OBDtr| 0x90 | int32    |C8FFC8| 56 00       | 86        | index of the 256-color palette used by this texture (starts at 0x15800 in level3_palette.pal) }}

{{OBDtr| 0xA0 | offset  |C800C8| C0 05 00 00 |00 00 05 C0| position of the pixel data in the .raw file }}

{{OBDtr| 0xA4 | offset  |C87C64| 00 00 00 00 | unused    | position of the pixel data in the .sep file (unused) }}

Unlike for PC or Mac game data (where pixel data is stored exclusively in .raw or exclusively in .sep for all TXMPs), PS2 TXMPs use .raw and .sep storage alternatively, depending on the TXMP. The engine apparently uses the .sep pointer only if there is no .raw pointer (or vice-versa).

Examples of textures using .sep storage are: all [[:Category:Fly-in_portraits|fly-in portraits]]; all [[:Category:Splashscreens|splashscreen]] components; some illustrations in Konoko's "data comlink" (namely, [[:File:TXMPLevel02move.png|combat move illustrations]] and [[:File:TXMPhypo.png|item illustrations]] (objectives and weapon illustrations use .raw storage).

;Oni's internal storage types

There are 16 types of image storage in Oni:

*The first 9 types are stored as integers (little Endian in PC memory and in TXMP, big Endian in Mac memory)

|Treated as 16-bit integer: stored as big-endian in TXMP (first the AAAARRRR byte, then the GGGGBBBB byte), but byte-swapped to little-endian on Mac platforms.

|Red: 0xStored in little-endian order in TXMP, unused high bit is set to 1. #FF0000

;ARGB4444 (format N°0)

*In Mac RAM the two bytes appear in big Endian order (high byte first).

*In PC RAM and in TXMP files the two bytes appear in little Endian order.

!<br/>Bits

!Byte 1 (high)<br/><code>7 6 5 4 3 2 1 0</code>

!Byte 0 (low)<br/><code>7 6 5 4 3 2 1 0</code>

!colspan=3|<br/>Bit values for primary colors (fully opaque)

!Hex view<br/>(Mac RAM)

!(TXMP and <br/>PC RAM)

;RGB555 (format N°1)

*In Mac RAM the two bytes appear in big Endian order (high byte first).

*In PC RAM and in TXMP files the two bytes appear in little Endian order.

!<br/>Bits

!Byte 1 (high)<br/><code>7 6 5 4 3 2 1 0</code>

!Byte 0 (low)<br/><code>7 6 5 4 3 2 1 0</code>

!colspan=3|<br/>Bit values for primary colors

!Hex view<br/>(Mac RAM)

!(TXMP and <br/>PC RAM)

;ARGB1555 (format N°2)

!<br/>Bits

!Byte 1 (high)<br/><code>7 6 5 4 3 2 1 0</code>

!Byte 0 (low)<br/><code>7 6 5 4 3 2 1 0</code>

!colspan=3|<br/>Bit values for primary colors (opaque)

!Hex view<br/>(Mac RAM)

!(TXMP and <br/>PC RAM)

;A4I4 (format N°6)

;ARGB8888 (format N°7)

!<br/>Bits

!Byte 3 (highest)<br/><code>7 6 5 4 3 2 1 0</code>

!Byte 2 (higher)<br/><code>7 6 5 4 3 2 1 0</code>

!Byte 1 (high)<br/><code>7 6 5 4 3 2 1 0</code>

!Byte 0 (low)<br/><code>7 6 5 4 3 2 1 0</code>

!colspan=5|<br/>Bit values for primary colors (fully opaque)

!Hex view<br/>(Mac RAM)

!(TXMP and <br/>PC RAM)

;RGB888 (format N°8)

!<br/>Bits

!Byte 3 (highest)<br/><code>7 6 5 4 3 2 1 0</code>

!Byte 2 (higher)<br/><code>7 6 5 4 3 2 1 0</code>

!Byte 1 (high)<br/><code>7 6 5 4 3 2 1 0</code>

!Byte 0 (low)<br/><code>7 6 5 4 3 2 1 0</code>

!colspan=5|<br/>Bit values for primary colors

!Hex view<br/>(Mac RAM)

!(TXMP and <br/>PC RAM)

;RGB_Bytes (format N°10)

!<br/>Bits

!Byte 0 (red)<br/><code>7 6 5 4 3 2 1 0</code>

!Byte 1 (green)<br/><code>7 6 5 4 3 2 1 0</code>

!Byte 2 (blue)<br/><code>7 6 5 4 3 2 1 0</code>

;RGBA_Bytes (format N°11)

!<br/>Bits

!Byte 0 (red)<br/><code>7 6 5 4 3 2 1 0</code>

!Byte 1 (green)<br/><code>7 6 5 4 3 2 1 0</code>

!Byte 2 (blue)<br/><code>7 6 5 4 3 2 1 0</code>

!Byte 3 (alpha)<br/><code>7 6 5 4 3 2 1 0</code>

!colspan=5|<br/>Bit values for primary colors (fully opaque)

{{OBD_File_Footer | type=TXMP | prev=TXMB | next=TxtC | name=Texture Map | family=Generic}}