DCLN (Metroid Prime)

From Retro Modding Wiki
Jump to: navigation, search

This article is for the DCLN format from the Metroid Prime series and Donkey Kong Country Returns. See DCLN (File Format) for other revisions of this format.

The DCLN format stores one or more collision meshes, each partitioned via an OBB tree. These are used as dynamic collision data for actors and platforms. Most of the format is shared with the MREA format, but there are some sections that are unique to DCLN.

Format

The file can store multiple collision meshes; each one has its own chunk in the file.

Type Count Name Notes
u32 1 Collision Mesh Count Number of collision meshes in the file.
Collision Mesh Collision Mesh Count Collision Mesh Array Array of collision meshes.
End of File

Collision Mesh

Offset Type Count Name Notes MP1/2/3 DKCR
0x0 u32 1 Magic Always 0xDEAFBABE
0x4 u32 1 Version Possible values:
  • 0x2: Metroid Prime
  • 0x4: Metroid Prime 2/3
  • 0x5: Donkey Kong Country Returns
0x8 AABox 1 Mesh Bounding Box Bounding box of the collision mesh.
u32 1 Internal Memory Allocation Size Used to build CNode/CLeafData from the stored representation. Each node/leaf's size is aligned to the nearest 4-byte boundary.
Collision Index Data 1 Collision Index Data Index data for the collision mesh. This data section is what actually defines the collision mesh itself. This part of the format is shared with MREA.
OBB Tree 1 Collision OBB Tree OBB tree for the collision mesh. This is used to quickly locate triangles that an actor could potentially be colliding with.
End of Collision Mesh

OBB Tree

GravitySuitIcon.png To do:
OBB tree format documentation