Retro Modding Wiki - User contributions [en]

Donkey Kong Country: Tropical Freeze

2017-06-11T16:04:18Z

Cornyfisch: Add link to dependency group format

[[Donkey Kong Country: Tropical Freeze]] is the most recent Retro release, and their first game on the Wii U; along with the new console came a large overhaul of the engine, with a lot of old formats being removed, a lot of new ones introduced, and a lot of the remaining ones being overhauled completely.

__TOC__

== Formats ==

{| class="wikitable"
! Format
! Contents
|-
| [[ANIM (File Format)|ANIM]]
| Animation
|-
| [[ARC (File Format)|ARC]]
| Archive
|-
| [[CABH (File Format)|CABH]]
| Audio Bus Heirarchy
|-
| [[CAUD (File Format)|CAUD]]
| Audio Sound Effect
|-
| [[CHAR (File Format)|CHAR]]
| Character
|-
| [[CLSN (File Format)|CLSN]]
| Collision
|-
| [[CMDL (Tropical Freeze)|CMDL]]
| Model
|-
| [[CSMP (File Format)|CSMP]]
| Audio Sample
|-
| [[DCLN (Tropical Freeze)|DCLN]]
| Dynamic Collision
|-
| [[DGRP (File Format)|DGRP]]
| Dependency Group
|-
| [[FSMC (File Format)|FSMC]]
| Finite State Machine
|-
| [[GENP (File Format)|GENP]]
| Generic Particle System
|-
| [[GFX (File Format)|GFX]]
| Flash Movie
|-
| [[GFXL (File Format)|GFXL]]
| Flash Texture Library
|-
| [http://en.wikipedia.org/wiki/MPEG-4_Part_14 MP4]
| Video
|-
| [[LDTA (File Format)|LDTA]]
| Loose Data
|-
| [[LPRB (File Format)|LPRB]]
| Light Probe
|-
| [[MSBT (File Format)|MSBT]]
| Message Table
|-
| [[MTRL (File Format)|MTRL]]
| Material Shaders
|-
| [[PAK (Tropical Freeze)|PAK]]
| Packages
|-
| [[ROOM (File Format)|ROOM]]
| Room
|-
| [[RULE (File Format)|RSTC]]
| Rule Set
|-
| [[SKEL (File Format)|SKEL]]
| Skeleton
|-
| [[CMDL (Tropical Freeze)|SMDL]]
| Skinned Model
|-
| [[SPWN (File Format)|SPWN]]
| Spawn Particle System
|-
| [[SWSH (File Format)|SWSH]]
| Swoosh Particle System
|-
| [[TXTR (Tropical Freeze)|TXTR]]
| Texture
|-
| [[UINF (File Format)|UINF]]
| Universe Info
|-
| [[CMDL (Tropical Freeze)|WMDL]]
| World Model
|-
| [[XFRM (File Format)|XFRM]]
| Transform Particle System
|}

[[Category:Games]]
[[Category:Donkey Kong Country: Tropical Freeze]]

CHAR (Metroid Prime 3)

2015-07-29T00:11:09Z

Cornyfisch: This format is not used in DKCR

The '''CHAR format''' defines animated characters; it's the successor to the [[ANCS (File Format)|ANCS format]] from Prime 1 and 2, and the format is extremely similar.

{{research|major|This format hasn't been researched/documented very well yet, but it appears to be extremely similar to ANCS.}}

__TOC__

== Format ==

=== Header ===

{| class="wikitable"
! Size
! Type
! Description
|-
| 1
| char
| {{unknown|Unknown}}
|-
| 1
| char
| {{unknown|Unknown}}
|-
| -
| string
| '''Character name'''
|-
| 8
| [[CMDL (File Format)|CMDL]]
| '''Character model'''
|-
| 8
| [[CSKR (File Format)|CSKR]]
| '''Character skin'''
|-
| 4
| long
| {{unknown|Unknown}}
|-
| 8
| [[CINF (File Format)|CINF]]
| '''Character skeleton'''
|-
| 8
| [[SAND (File Format)|SAND]]
| '''Character sand'''
|}

[[Category:Metroid Prime 3: Corruption]]
[[Category:File Formats]]

CHAR (Donkey Kong Country Returns)

2015-07-29T00:10:09Z

Cornyfisch: Created page with "The '''CHAR format''' defines animated characters. It's the successor to the CHAR format from Prime 3. {{research|major|This format has not been resear..."

The '''CHAR format''' defines animated characters. It's the successor to the [[CHAR (File Format)|CHAR format]] from Prime 3.

{{research|major|This format has not been researched/documented very well yet, but it seems different from the Prime 3 format.}}

__TOC__

== Format ==

=== Header ===
The header is used to point to other important files defining an animated character. Unsigned 64bit IDs name these files.
It is possible that IDs are set to 0xFFFFFFFFFFFFFFFF, indicating a ''null'' value.

The strings are null-terminated ascii-character arrays.

{| class="wikitable"
! Size
! Type
! Description
|-
| 4
| u32
| {{unknown|'''Unknown'''; always 0x59BE000E - probably magic value}}
|-
| 19
| -
| {{unknown|Unknown}}
|-
| -
| string
| '''Character name'''
|-
| 8
| ID
| '''Character skeleton''' See [[CINF (File Format)|CINF]]
|-
| 8
| ID
| {{unknown|'''Unknown''' - These IDs point to [[CPRM (Donkey Kong Country Returns)|CPRM]] files}}
|-
| 4
| u32
| {{unknown|Unknown}}
|-
| 13
| string
| {{unknown|This is always "SkinnedModel"}}
|-
| 8
| ID
| '''Character model''' See [[CMDL (Donkey Kong Country Returns)]]
|-
| 8
| ID
| '''Character skin''' See [[CSKR (File Format)|CSKR]]
|}

=== Padding? ===

24 zero-bytes.

=== Chunks ===

{| class="wikitable"
! Size
! Type
! Description
|-
| 4
| u32
| '''Chunk Count''' (CC)
|-
| -
| Chunk[CC]
| '''Chunks'''
|}

==== Chunk ====

{| class="wikitable"
! Size
! Type
! Description
|-
| -
| string
| '''Chunk Name'''
|-
| 8
| ID
| '''File ID''' Often [[ANIM (File Format)|ANIM]] files
|-
| 4
| char[4]
| '''File Type''' Either "ANIM" or something else
|-
| 33
| -
| {{unknown|'''Unknown'''}}
|}

[[Category:Donkey Kong Country Returns]]
[[Category:File Formats]]

CMDL (Donkey Kong Country Returns)

2015-06-14T11:55:34Z

Cornyfisch: Fixed mantissa byte size

''See [[CMDL (File Format)]] for the other revisions of this format.''

The '''CMDL format''' is DKCR's model format. It's similar to the CMDL format found in the Metroid Prime trilogy, but with a lot of additions and changes, and some layout changes.

{{research|moderate|Where to begin? Materials need a lot of research (they're very similar if not the same as Metroid Prime 3). A lot of the visibility group data is unknown. The submesh headers contain a lot of unknowns, and the possible vertex format settings are unknown. Geometry should be split off into a separate article if it's confirmed that it's the same format that's used in MREA (which is fairly likely). Materials should also be split off once more is known about them.}}

__TOC__

== Format ==

Like the previous CMDL formats, DKCR CMDL files are split up into a number of 32-byte aligned ''sections''. Every section both starts and ends on a 32-byte boundary. These are used to separate different parts of the file; different types of sections typically indicate different sets of data. The header declares the section count and the size of each one; using these is the only way to navigate the file.

=== Header ===

{| class="wikitable"
! Offset
! Type
! Size
! Description
|-
| 0x0
| u32
| 4
| {{unknown|'''Unknown'''; always 0x9381000A - likely either magic value or 16-bit magic/version}}
|-
| 0x4
| u32
| 4
| '''Flags'''; see below
|-
| 0x8
| float[6]
| 0x18
| '''Model Bounding Box'''
|-
| 0x20
| u32
| 4
| '''Section count''' (SC)
|-
| 0x24
| u32
| 4
| '''Material set count'''
|-
| 0x28
| -
| -
| '''Visibility group data'''; present if flag 0x10 is set. See below for structure.
|-
| -
| u32[]
| 4 × SC
| '''Section sizes'''
|-
| colspan=4 {{unknown|End of header; pad to multiple of 32 before first section starts}}
|}

==== Flags ====

The following flags are possible:

{| class="wikitable"
! Bit
! Hex
! Description
|-
| 0
| 0x1
| {{unknown|Unknown}}
|-
| 1
| 0x2
| {{unknown|Unknown}}
|-
| 2
| 0x4
| {{unknown|Unknown}}
|-
| 3
| 0x8
| {{unknown|Unknown}}
|-
| 4
| 0x10
| Enable visibility groups
|-
| 5
| 0x20
| Store vertex positions as shorts
|}

==== Visibility Groups ====

Visibility group data is present in the header if bit 0x10 is set, after the material set count and before the section sizes. Visibility groups are used to toggle the visibility of certain meshes on or off during animations; for instance, Diddy's jetpack.

{| class="wikitable"
! Offset
! Type
! Size
! Description
|-
| 0x0
| u32
| 4
| {{unknown|'''Unknown'''}}
|-
| 0x4
| u32
| 4
| '''Visibility Group count'''
|}

The following structure repeats for each group:

{| class="wikitable"
! Offset
! Type
! Size
! Description
|-
| 0x0
| u32
| 4
| '''Name length'''
|-
| 0x4
| string
| -
| '''Visibility Group name'''
|}

Finally, it ends with this before the sizes begin:

{| class="wikitable"
! Offset
! Type
! Size
! Description
|-
| 0x0
| u32
| 4
| {{unknown|'''Unknown'''}}
|-
| 0x4
| u32
| 4
| {{unknown|'''Unknown'''}}
|-
| 0x8
| u32
| 4
| {{unknown|'''Unknown'''}}
|-
| 0xC
| u32
| 4
| {{unknown|'''Unknown'''}}
|-
| 0x10
| u32
| 4
| {{unknown|'''Unknown'''}}
|}

=== Materials ===

There's not much known about the material format currently; DKCR seems to use the same material format as Metroid Prime 3. The main difference in DKCR compared to Prime 3 is that in Prime 3, each material set would get its own section. In DKCR, every material set is in the same section. Each material set begins with a material count, and each material begins with its own size. The main thing that's needed to read geometry is the vertex attribute flags, which are located at 0xC in the material structure (not counting the size).

=== Geometry ===

==== Vertex Coordinates ====

Vertex coords can be stored as either floats or signed shorts, depending whether flag 0x20 is set in the header. If they're shorts, then they need to be divided by 0x2000 to get the corresponding float value. Since they're signed numbers, that means that 0 to 0x7FFF correspond to the range 0.0-4.0, and 0x8000 to 0xFFFF correspond to the range -4.0-0.0.

==== Normals ====

Vertex normals are usually stored as shorts. To get the corresponding float value, read as a signed short and divide by 0x4000.

==== Vertex Color ====

Normally unused, so this section is typically empty and zeroed out.

==== Float UV Coordinates ====

These are stored as a sequence of two floats.

==== Short UV Coordinates ====

Like the short vertex coordinates, these are stored as signed shorts that should be divided by 0x2000 to get the corresponding float value. The short UVs section has received a fairly significant increase in usage in DKCR compared to the Prime series; in the Prime games, they were generally only used for lightmaps, whereas in DKCR they're often used by pretty much anything.

==== Submesh Definitions ====

This section is very small and simple; it simply declares a submesh count and then lists the offsets to the end of each submesh. Following this section, there'll be one additional section per submesh.

{| class="wikitable"
! Offset
! Type
! Size
! Description
|-
| 0x0
| u32
| 4
| '''Submesh count''' (SC)
|-
| 0x4
| u32[]
| 4 × SC
| '''Submesh offsets''' (relative to the start of the first submesh)
|-
| colspan=4 {{unknown|Submesh sections begin}}
|}

==== Submesh ====

There will be one of these sections per submesh. Each submesh starts with a small 0x20-byte header; after that, the primitive data begins.

{| class="wikitable"
! Offset
! Type
! Size
! Description
|-
| 0x0
| float[3]
| 0xC
| '''Position''' (or pivot location); unknown purpose
|-
| 0xC
| u16
| 2
| '''Mantissa''' - always 0x8000
|-
| 0xE
| u16
| 2
| '''Primitive table size''' (''this value may not be reliable'')
|-
| 0x10
| u32
| 4
| {{unknown|'''Unknown'''; always 0?}}
|-
| 0x14
| u32
| 4
| {{unknown|'''Unknown'''; always 0?}}
|-
| 0x18
| u16
| 2
| {{unknown|'''Unknown'''; value varies, but is sometimes 0xFFFF}}
|-
| 0x1A
| u16
| 2
| '''Material ID'''
|-
| 0x1C
| u8
| 1
| {{unknown|'''Unknown'''; always 0xFF?}}
|-
| 0x1D
| u8
| 1
| '''Visibility Group index'''
|-
| 0x1E
| u16
| 2
| '''UV array flag'''; 0 indicates this submesh uses float UVs, 1 indicates it uses short UVs
|-
| 0x20
| colspan=3 {{unknown|End of header; primitive data starts}}
|}

The primitive data is a standard GX display list. Each primitive begins with a byte that contains the primitive type in the upper 5 bits, and the vertex format setting in the lower 3. After that is a 16-bit vertex count, followed by a series of 16-bit vertex attribute indices.

You'll need to check some settings on the material to read the primitive data properly; the material determines which vertex attributes are present.

There is no primitive count value; you'll need to continue reading data until you hit the end of the primitive table. There are a couple values you can use for reference; either the submesh's section size, or the submesh's end offset. It's not recommended to use the primitive table size value because that value has been shown to be inaccurate in some cases in the Prime series and this may be the case in DKCR as well.

There are 7 primitive types supported by GX, indicated in the upper 5 bits of the flag value. Note that the game only ever actually uses triangles, triangle strips, and triangle fans; however, all of these primitives are supported by GX and are therefore supported by the game, and so they could be used in custom model files.

{| class="wikitable"
! Value
! Primitive
|-
| 0x80
| Quads
|-
| 0x90
| Triangles
|-
| 0x98
| Triangle strip
|-
| 0xA0
| Triangle fan
|-
| 0xA8
| Lines
|-
| 0xB0
| Line strip
|-
| 0xB8
| Points
|}

[[Category:File Formats]]
[[Category:Donkey Kong Country Returns]]