3D:CTXB format - Revision history

M-1: CTXB: Fix typo

2021-03-08T23:30:28Z

CTXB: Fix typo

M-1: CTXB: Update cubemap information

2021-03-08T23:05:41Z

CTXB: Update cubemap information

M-1: CTXB: Update unknown values

2021-03-08T22:27:56Z

CTXB: Update unknown values

Gamestabled: Created page with "The '''CTXB format''' ('''CTR Texture Binary'''?) is an image format used in Ocarina of Time 3D. Note: Nearly all this information was gathered from the source code of [https..."

2021-03-08T20:45:10Z

Created page with "The '''CTXB format''' ('''CTR Texture Binary'''?) is an image format used in Ocarina of Time 3D. Note: Nearly all this information was gathered from the source code of [https..."

New page

The '''CTXB format''' ('''CTR Texture Binary'''?) is an image format used in Ocarina of Time 3D.

Note: Nearly all this information was gathered from the source code of [https://github.com/xdanieldzd/Scarlet/blob/master/Scarlet.IO.ImageFormats/CTXB.cs Scarlet].

==CTXB chunk==
The CTXB chunk is first chunk encountered in the file. It encompasses the entire file and contains a TEX chunk.

{| class="wikitable" border="1"
! Offset !! Type !! Description
|-
| 0000 || char[4] || magic "ctxb" ''("CTR Texture Binary")''
|-
| 0004 || u32 || FileSize
|-
| 0008 || u32 || Number of TEX chunks
|-
| 000C || u32 || Unknown
|-
| 0010 || u32 || Offset to TEX chunk
|-
| 0014 || u32 || Offset to texture data
|}

==TEX chunk==
The TEX chunk contains textures.

{| class="wikitable" border="1"
! Offset !! Type !! Description
|-
| 0000 || char[4] || magic "tex " ''("Textures?")''
|-
| 0004 || u32 || size of chunk
|-
| 0008 || u32 || # of textures
|-
| 000C || ''[[#Texture|Texture]]''[# of textures] || array of textures
|}

===Texture===
Each ''Texture'' is:

{| class="wikitable" border="1"
! Offset !! Type !! Description
|-
| 0000 || u32 || Length of texture data in bytes
|-
| 0004 || u16 || Mipmap Count
|-
| 0006 || u16 || Unknown (Always 0 or 1)
|-
| 0008 || u16 || Width
|-
| 000A || u16 || Height
|-
| 000C || u16 ''([[#PicaTextureFormat|PicaTextureFormat]])'' || Texture color format
|-
| 000E || u16 ''([[#PicaDataType|PicaDataType]])'' || Texture data type ''(If 0, just use the texture color format by itself. Also see [[#PicaTextureFormat|PicaTextureFormat]])''
|-
| 0010 || u32 || Texture data offset, relative to the '''Texture data pointer''' from the [[#CMB chunk|CMB chunk]]
|-
| 0014 || char[16] || Texture name
|}

===PicaTextureFormat===
''PicaTextureFormat'' can be:
{| class="wikitable" border="1"
! Value !! Description
|-
| 0x6752 || RGBANativeDMP
|-
| 0x6754 || RGBNativeDMP
|-
| 0x6756 || AlphaNativeDMP
|-
| 0x6757 || LuminanceNativeDMP
|-
| 0x6758 || LuminanceAlphaNativeDMP
|-
| 0x675A || ETC1RGB8NativeDMP
|-
| 0x675B || ETC1AlphaRGB8A4NativeDMP
|}

''PicaTextureFormat'' interacts with ''PicaDataType'' as follows:
{| class="wikitable" border="1"
! ''PicaTextureFormat'' !! ''PicaDataType'' !! Resulting texture data format
|-
| ETC1RGB8NativeDMP || 0 || ETC1
|-
| ETC1AlphaRGB8A4NativeDMP || 0 || ETC1A4
|-
| RGBANativeDMP || u8 (unsigned byte) || RGBA8
|-
| RGBNativeDMP || u8 (unsigned byte) || RGB8
|-
| RGBANativeDMP || UnsignedShort4444 || RGBA4
|-
| RGBANativeDMP || UnsignedShort5551 || RGBA5551
|-
| RGBNativeDMP || UnsignedShort565 || RGB565
|-
| LuminanceAlphaNativeDMP || UnsignedByte44DMP || LA4
|-
| LuminanceAlphaNativeDMP || u8 (unsigned byte) || LA8
|-
| AlphaNativeDMP || u8 (unsigned byte) || A8
|-
| LuminanceNativeDMP || u8 (unsigned byte) || L8
|-
| LuminanceNativeDMP || Unsigned4BitsDMP || L4
|}

===PicaDataType===
''PicaDataType'' can be:
{| class="wikitable" border="1"
! Value !! Description
|-
| 0x1400 || s8 (byte)
|-
| 0x1401 || u8 (unsigned byte)
|-
| 0x1402 || s16 (short)
|-
| 0x1403 || u16 unsigned short
|-
| 0x1404 || s32 (int)
|-
| 0x1405 || u32 (unsigned int)
|-
| 0x1406 || f32 (float)
|-
| 0x6760 || UnsignedByte44DMP
|-
| 0x6761 || Unsigned4BitsDMP
|-
| 0x8033 || UnsignedShort4444
|-
| 0x8034 || UnsignedShort5551
|-
| 0x8363 || UnsignedShort565
|}

===RGBA===
Each ''RGBA'' is:
{| class="wikitable" border="1"
! Value !! Type
|-
| R || u8
|-
| G || u8
|-
| B || u8
|-
| A || u8
|}

@@ Line 50: / Line 50: @@
 | 0006 || u8  || IsETC1 (if TextureFormat is ETC1RGB8NativeDMP or ETC1AlphaRGB8A4NativeDMP)
 |-
-| 0006 || u8  || IsCubemap (see [[#CubemapData|CubemapData]])
+| 0007 || u8  || IsCubemap (see [[#CubemapData|CubemapData]])
 |-
 | 0008 || u16 || Width

@@ Line 1: / Line 1: @@
-The '''CTXB format''' ('''CTR Texture Binary'''?) is an image format used in Ocarina of Time 3D.
+The '''CTXB format''' ('''CTR Texture Binary''') is an image format used in Ocarina of Time 3D, Majora's Mask 3D, Luigi's Mansion 3D, and Ever Oasis
 Note: Nearly all this information was gathered from the source code of [https://github.com/xdanieldzd/Scarlet/blob/master/Scarlet.IO.ImageFormats/CTXB.cs Scarlet].
@@ Line 50: / Line 50: @@
 | 0006 || u8  || IsETC1 (if TextureFormat is ETC1RGB8NativeDMP or ETC1AlphaRGB8A4NativeDMP)
 |-
-| 0006 || u8  || IsCubemap
+| 0006 || u8  || IsCubemap (see [[#CubemapData|CubemapData]])
 |-
 | 0008 || u16 || Width
@@ Line 63: / Line 63: @@
 |-
 | 0014 || char[16] || Texture name
 |}

@@ Line 48: / Line 48: @@
 | 0004 || u16 || Mipmap Count
 |-
-| 0006 || u16 || Unknown (Always 0 or 1)
+| 0006 || u8  || IsETC1 (if TextureFormat is ETC1RGB8NativeDMP or ETC1AlphaRGB8A4NativeDMP)
 |-
 | 0008 || u16 || Width
@@ Line 140: / Line 142: @@
 |-
 | 0x8363 || UnsignedShort565
 |}