CMDL (Metroid Prime) - Revision history

>Aruki: /* Tools */

2017-03-28T06:12:40Z

Tools

← Older revision		Revision as of 06:12, 28 March 2017
Line 99:		Line 99:
	== Tools ==		== Tools ==

	* [https://drive.google.com/file/d/0B9MLV21H7SDvYXRtTWlFRGQ3ZjA/edit?usp=sharing ~~Parax~~'s CMDL Maxscript] will import CMDL files into 3DS Max.		* [https://drive.google.com/file/d/0B9MLV21H7SDvYXRtTWlFRGQ3ZjA/edit?usp=sharing Aruki's CMDL Maxscript] will import CMDL files into 3DS Max.

	[[Category:File Formats]]		[[Category:File Formats]]

>Aruki at 10:33, 25 May 2016

2016-05-25T10:33:55Z

← Older revision		Revision as of 10:33, 25 May 2016
Line 7:		Line 7:
	== Format ==		== Format ==

	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.		CMDL files are split up into a number of 32-byte aligned ''data sections''. Every data section both starts and ends on a 32-byte boundary. These are used to separate different parts of the file; different data sections typically indicate different sets of data. The header declares the data section count and the size of each one; using these is the only way to navigate the file.

	=== Header ===		=== Header ===
Line 13:		Line 13:
	{\| class="wikitable"		{\| class="wikitable"
	! Offset		! Offset
	! ~~Size~~		! Type
	! ~~Description~~		! Count
			! Name
			! Notes
	\|-		\|-
	\| 0x0		\| 0x0
	\| 4		\| u32
	\| '''Magic'''~~; always~~ 0xDEADBABE		\| 1
			\| '''Magic'''
			\| Always <code>0xDEADBABE</code>.
	\|-		\|-
	\| 0x4		\| 0x4
	\| 4		\| u32
	\| '''Version'''~~; see below~~		\| 1
			\| '''Version'''
			\| See [[CMDL (File Format)\|hub article]] for a list of possible version numbers.
	\|-		\|-
	\| 0x8		\| 0x8
	\| 4		\| u32
	\| '''Flags'''~~; see~~ below		\| 1
			\| '''Flags'''
			\| [[#Flags\|See below]]
	\|-		\|-
	\| 0xC		\| 0xC
	\| ~~0x18~~		\| float
	\| '''Axis-~~aligned bounding box~~'''		\| 6
			\| '''Model Axis-Aligned Bounding Box'''
			\|
	\|-		\|-
	\| 0x24		\| 0x24
	\| 4		\| u32
	\| '''Section ~~count~~''' ~~(SC)~~		\| 1
			\| '''Data Section Count'''
			\| Count of data sections in the file.
	\|-		\|-
	\| 0x28		\| 0x28
	\| 4		\| u32
	\| '''Material ~~set count~~'''		\| 1
			\| '''Material Set Count'''
			\| Count of material sets in the model. There will be one materials section per set in the file.
	\|-		\|-
	\| 0x2C		\| 0x2C
	\| ~~4 × SC~~		\| u32
	\| '''Section ~~sizes~~'''		\| ''Data Section Count''
	\|}		\| '''Data Section Sizes'''
			\|
	~~Following the end of the header, the file is padded to 32 bytes before the first section starts.~~

	~~==== Version ====~~

	~~{\| class="wikitable"~~
	~~! Version~~
	~~! Game~~
	\|-
	~~\| 2~~
	~~\| Metroid Prime~~
	\|-
	~~\| 3~~
	~~\| Metroid Prime 2 Demo~~
	\|-
	~~\| 4~~
	~~\| Metroid Prime 2~~
	\|-		\|-
	\| 5		\| colspan=5 {{unknown\|End of header; pad to 32 bytes before section data begins}}
	\| ~~Metroid Prime 3~~
	\|}		\|}

>Aruki: /* Flags */

2016-04-09T17:14:40Z

Flags

← Older revision		Revision as of 17:14, 9 April 2016
Line 75:		Line 75:
	\| 0		\| 0
	\| 0x1		\| 0x1
	\| ~~Appears to do nothing~~		\| Indicates the model is skinned (no ingame effect)
	\|-		\|-
	\| 1		\| 1

>Aruki: /* Materials */

2016-01-15T03:05:47Z

Materials

← Older revision		Revision as of 03:05, 15 January 2016
Line 88:		Line 88:
	=== Materials ===		=== Materials ===

	''See [[Materials (Metroid Prime)]]''		''See [[Materials (Metroid Prime)]] and [[Materials (Metroid Prime 3)]]''

	CMDL files can have multiple material sets; each set will get its own section. The main catch with reading materials is to mind the version number; extra values were added starting in version 3 (Echoes Demo).		CMDL files can have multiple material sets; each set will get its own section. The main catch with reading materials is to mind the version number; extra values were added starting in version 3 (Echoes Demo).

	Metroid Prime 3 ~~uses a completely different~~ material ~~format; there's not much understood about it currently, though~~.		The material format was completely revamped in Metroid Prime 3, but the way the format supports multiple material sets is the same.

	=== Geometry ===		=== Geometry ===

>Aruki at 15:14, 3 July 2015

2015-07-03T15:14:02Z

← Older revision		Revision as of 15:14, 3 July 2015
Line 1:		Line 1:
	''See [[CMDL (File Format)]] for the other revisions of this format.''		''This article is for the CMDL format from the Metroid Prime series. See [[CMDL (File Format)]] for the other revisions of this format.''

	The '''CMDL format''' is the model format used in the Metroid Prime series. The format's stayed relatively consistent throughout the trilogy, with modifications only really being made to the materials section.		The '''CMDL format''' is the model format used in the Metroid Prime series. The format's stayed relatively consistent throughout the trilogy, with modifications only really being made to the materials section.

>Aruki: /* Materials */

2015-02-09T21:16:49Z

Materials

← Older revision		Revision as of 21:16, 9 February 2015
Line 91:		Line 91:

	CMDL files can have multiple material sets; each set will get its own section. The main catch with reading materials is to mind the version number; extra values were added starting in version 3 (Echoes Demo).		CMDL files can have multiple material sets; each set will get its own section. The main catch with reading materials is to mind the version number; extra values were added starting in version 3 (Echoes Demo).

			Metroid Prime 3 uses a completely different material format; there's not much understood about it currently, though.

	=== Geometry ===		=== Geometry ===

>Aruki: /* Tools */

2015-01-28T17:34:22Z

Tools

← Older revision		Revision as of 17:34, 28 January 2015
Line 100:		Line 100:
	== Tools ==		== Tools ==

	* [https://drive.google.com/file/d/0B9MLV21H7SDvYXRtTWlFRGQ3ZjA/edit?usp=sharing Parax's CMDL Maxscript]] will import CMDL files into 3DS Max.		* [https://drive.google.com/file/d/0B9MLV21H7SDvYXRtTWlFRGQ3ZjA/edit?usp=sharing Parax's CMDL Maxscript] will import CMDL files into 3DS Max.

	[[Category:File Formats]]		[[Category:File Formats]]

>Aruki at 17:33, 28 January 2015

2015-01-28T17:33:59Z

← Older revision		Revision as of 17:33, 28 January 2015
Line 97:		Line 97:

	There are a couple little catches when reading the CMDL geometry format. First, the short UV array will always be completely empty (size of 0) whenever it's present; however, if the corresponding flag isn't set in the header, then the short UV section will be omitted entirely. Second, even though the header has a flag to indicate the format of the normals, the vertex format setting in the primitive data is what actually controls how the normals are read. Finally, an extra vertex attribute was added starting in version 4 that you'll need to watch out for; it precedes the position attribute.		There are a couple little catches when reading the CMDL geometry format. First, the short UV array will always be completely empty (size of 0) whenever it's present; however, if the corresponding flag isn't set in the header, then the short UV section will be omitted entirely. Second, even though the header has a flag to indicate the format of the normals, the vertex format setting in the primitive data is what actually controls how the normals are read. Finally, an extra vertex attribute was added starting in version 4 that you'll need to watch out for; it precedes the position attribute.

			== Tools ==

			* [https://drive.google.com/file/d/0B9MLV21H7SDvYXRtTWlFRGQ3ZjA/edit?usp=sharing Parax's CMDL Maxscript]] will import CMDL files into 3DS Max.

	[[Category:File Formats]]		[[Category:File Formats]]

>Aruki at 15:03, 28 January 2015

2015-01-28T15:03:22Z

← Older revision		Revision as of 15:03, 28 January 2015
Line 1:		Line 1:
			''See [[CMDL (File Format)]] for the other revisions of this format.''

	The '''CMDL format''' is the model format used in the Metroid Prime series. The format's stayed relatively consistent throughout the trilogy, with modifications only really being made to the materials section.		The '''CMDL format''' is the model format used in the Metroid Prime series. The format's stayed relatively consistent throughout the trilogy, with modifications only really being made to the materials section.

>Aruki: Created page with "The '''CMDL format''' is the model format used in the Metroid Prime series. The format's stayed relatively consistent throughout the trilogy, with modifications only really be..."

2015-01-26T03:23:55Z

Created page with "The '''CMDL format''' is the model format used in the Metroid Prime series. The format's stayed relatively consistent throughout the trilogy, with modifications only really be..."

New page

The '''CMDL format''' is the model format used in the Metroid Prime series. The format's stayed relatively consistent throughout the trilogy, with modifications only really being made to the materials section.

__TOC__

== Format ==

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
! Size
! Description
|-
| 0x0
| 4
| '''Magic'''; always 0xDEADBABE
|-
| 0x4
| 4
| '''Version'''; see below
|-
| 0x8
| 4
| '''Flags'''; see below
|-
| 0xC
| 0x18
| '''Axis-aligned bounding box'''
|-
| 0x24
| 4
| '''Section count''' (SC)
|-
| 0x28
| 4
| '''Material set count'''
|-
| 0x2C
| 4 × SC
| '''Section sizes'''
|}

Following the end of the header, the file is padded to 32 bytes before the first section starts.

==== Version ====

{| class="wikitable"
! Version
! Game
|-
| 2
| Metroid Prime
|-
| 3
| Metroid Prime 2 Demo
|-
| 4
| Metroid Prime 2
|-
| 5
| Metroid Prime 3
|}

==== Flags ====

{| class="wikitable"
! Bit
! Hex
! Description
|-
| 0
| 0x1
| Appears to do nothing
|-
| 1
| 0x2
| Toggle short normals
|-
| 2
| 0x4
| Enable short UV array
|}

=== Materials ===

''See [[Materials (Metroid Prime)]]''

CMDL files can have multiple material sets; each set will get its own section. The main catch with reading materials is to mind the version number; extra values were added starting in version 3 (Echoes Demo).

=== Geometry ===

''See [[Geometry (Metroid Prime)]]''

There are a couple little catches when reading the CMDL geometry format. First, the short UV array will always be completely empty (size of 0) whenever it's present; however, if the corresponding flag isn't set in the header, then the short UV section will be omitted entirely. Second, even though the header has a flag to indicate the format of the normals, the vertex format setting in the primitive data is what actually controls how the normals are read. Finally, an extra vertex attribute was added starting in version 4 that you'll need to watch out for; it precedes the position attribute.

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