CMDL (Tropical Freeze): Difference between revisions

Tropical Freeze features a new model format (necessitated by the hardware jump from Wii to Wii U) that bears little-to-no resemblance to the CMDL format of past games. There are three extensions used for models:

 

 

{{research|2|There's a lot of unknown data.}}

 

| [[#GPU Data|GPU Data]]

 

=== Skinned Model Header ===

 

| [[Chunk Descriptor (Tropical Freeze)|Chunk Descriptor]]

| colspan=5 {{unknown|End of Skinned Model Header}}

 

 

| Chunk ID is <code>WDHD</code>

 

 

This seems to be an updated version of the [[AROT (MREA Section)|AROT]] format seen in previous Retro games.

 

| Always 1. Version number?

| Bounds of the entire octree; matches the bounding box from the main model header.

! Type

! Count

| [[Chunk Descriptor (Tropical Freeze)|Chunk Descriptor]]

| u32

| {{unknown}}

| u32

| {{unknown}}

| u32

| {{unknown}}

| u32

| {{unknown}}

| u32

| {{unknown}}

| {{AABox}}

| 1

| '''Model Bounding Box'''

|-

| '''Model Data Source Count'''

| 0x48

| [[#Model Data Source|Model Data Source]]

| '''Model Data Source Array'''

 

 

| Controls the type of data present in this data source. Valid values are 0, 1, 2, or 3.

 

 

 

 

| '''Wind Set Array'''

 

 

{| class="wikitable"

 

 

 

The MTRL section has a 32-bit material count, then lays out its materials one after the other. Materials are composed of basically a [[MTRL (File Format)|MTRL asset ID]] which contains the shader the material is rendered with, then per-instance material parameters (textures, scalar/color parameters, etc).

| {{FourCC}}

| 1

| {{FourCC}}

| 1

| {{Color4f}}

| 1

|  

| {{Color4f}}

| 1

| {{Color4f}}

| 1

| {{Color4f}}

| 1

=== Render Meshes ===

The MESH section defines render meshes.

! Type

! Count

! Name

| [[Chunk Descriptor (Tropical Freeze)|Chunk Descriptor]]

| '''MESH Chunk Descriptor'''

| u32

| 1

|  

| [[#Render Mesh|Render Mesh]]

| '''Render Mesh Array'''

|  

{| class="wikitable"

! Type

! Count

| u32

| {{unknown}}

| Always 3?

| u16

| '''Material Index'''

| '''Vertex Buffer Index'''

| '''Index Buffer Index'''

| u32

| '''Start Index'''

| u32

| '''Index Count'''

| u32

| {{unknown}}

| {{unknown}}

| colspan=4 {{unknown|End of Render Mesh}}

! Type

! Count

! Name

| [[Chunk Descriptor (Tropical Freeze)|Chunk Descriptor]]

| '''VBUF Chunk Descriptor'''

| u32

| 1

| '''Vertex Buffer Count'''

| [[#Vertex Buffer|Vertex Buffer]]

| '''Vertex Buffer Array'''

| The model will contain a separate vertex buffer for every unique vertex configuration needed.

{| class="wikitable"

! Type

! Count

! Name

| u32

| 1

| '''Vertex Count'''

| u32

| 1

| '''Vertex Component Count'''

| Number of components in each vertex.

| [[#Vertex Component|Vertex Component]]

| Definitions for each component in the vertex.

==== Vertex Component ====

{| class="wikitable"

! Type

! Count

| u32

| {{unknown}}

| u32

| u32

| u32

| {{unknown}}

| u32

| {{unknown}}

| Likely component type/format

| colspan=4 {{unknown|End of Vertex Component}}

Just like how the VBUF section defines vertex buffers, the IBUF section defines index buffers. Each index buffer only has one value associated with it, so it's fairly simple, and you generally will only see one or two index buffers per file (as there's only two possible index buffer configurations).

! Type

! Count

! Name

| [[Chunk Descriptor (Tropical Freeze)|Chunk Descriptor]]

| '''IBUF Chunk Descriptor'''

| u32

| 1

| '''Index Buffer Count'''

| [[#Index Buffer|Index Buffer]]

| '''Index Buffer Array'''

|  

! Type

! Name

| u32

| '''Format'''

| 1 means unsigned short; 2 means unsigned long.

| colspan=3 {{unknown|End of Index Buffer}}

The PAK metadata for the model formats contains mainly information related to the size and layout of the GPU section, and the metadata required to locate and decompress specific buffers within it.

! Type

! Count

! Name

| u32

| 1

| {{unknown}}

| Always 4?

| u32

| 1

| '''GPU Section Offset'''

| u32

| 1

| '''Read Buffer Count'''

| [[#Read Buffer Info|Read Buffer Info]]

| ''Read Buffer Count''

| '''Read Buffer Array'''

| u32

| 1

| '''Vertex Buffer Count'''

| [[#Buffer Info|Buffer Info]]

| ''Vertex Buffer Count''

| '''Vertex Buffer Info Array'''

| u32

| 1

| '''Index Buffer Count'''

| Number of index buffers in the model.

| [[#Buffer Info|Buffer Info]]

=== Read Buffer Info ===

For large models, the GPU section may be split into multiple read buffers. All offsets into the GPU section will be relative to the beginning of the chosen buffer.

! Type

! Name

| u32

| u32

| colspan=3 {{unknown|End of Read Buffer Info}}

=== Buffer Info ===

This structure is used for both vertex and index buffers.

! Type

! Name

| u32

| '''Read Buffer Index'''

| u32

| '''Start Offset'''

| Starting offset of this buffer, relative to the start of the chosen read buffer.

| u32

| '''Compressed Size'''

| u32

| '''Decompressed Size'''

| colspan=3 {{unknown|End of Buffer Info}}