Call of Duty: XMODEL formats - Revision history

CoDEmanX: /* Faces */ 2nd number of TRI seems to be material, 3rd unknown, 4th sometimes zero?!

2011-11-30T16:33:51Z

Faces: 2nd number of TRI seems to be material, 3rd unknown, 4th sometimes zero?!

← Older revision		Revision as of 16:33, 30 November 2011
Line 243:		Line 243:
	*'''TRI''' description:		*'''TRI''' description:
	**Number of the object, the triangle belongs to		**Number of the object, the triangle belongs to
			**Material number,
	**''unknown number''		**''unknown number''
	**Material number,		**1 (static number? It's rarely 0)
	**1 (static number)
	*'''VERT''' description:		*'''VERT''' description:
	**Vertex number		**Vertex number
	**UV texture coords (2x float)		**UV texture coords (2x float)
	**Face normal vector, normalized (3x float)		**Face normal vector, normalized (3x float)


	=== Materials ===		=== Materials ===

CoDEmanX: Version 6 has extra commas in bone orientation and vertex section

2011-11-16T12:06:33Z

Version 6 has extra commas in bone orientation and vertex section

← Older revision		Revision as of 12:06, 16 November 2011
Line 42:		Line 42:
	[[File:Local Bone Axis.png\|thumb\|right\|Local bone axis, corresponding to vectors of the bone's rotation matrix]]		[[File:Local Bone Axis.png\|thumb\|right\|Local bone axis, corresponding to vectors of the bone's rotation matrix]]
	<pre>BONE 0		<pre>BONE 0
	OFFSET 0.000002 -2.222280 0.000042		OFFSET 0.000002, -2.222280, 0.000042
	SCALE 1.000000 1.000000 1.000000		SCALE 1.000000, 1.000000, 1.000000
	X 0.000000 -1.000000 -0.000001		X 0.000000, -1.000000, -0.000001
	Y 1.000000 0.000000 0.000000		Y 1.000000, 0.000000, 0.000000
	Z -0.000000 -0.000001 1.000000		Z -0.000000, -0.000001, 1.000000

	BONE 1		BONE 1
	OFFSET 4.866636 1.218493 37.227966		OFFSET 4.866636, 1.218493, 37.227966
	SCALE 1.000000 1.000000 1.000000		SCALE 1.000000, 1.000000, 1.000000
	X -0.008941 0.033732 -0.999391		X -0.008941, 0.033732, -0.999391
	Y -0.004868 -0.999420 -0.033689		Y -0.004868, -0.999420, -0.033689
	Z -0.999948 0.004564 0.009100		Z -0.999948, 0.004564, 0.009100
	...</pre>		...</pre>

Line 202:		Line 202:
	*'''MODEL''' data type definition (magic word)		*'''MODEL''' data type definition (magic word)
	*'''VERSION''' format version number		*'''VERSION''' format version number

			=== Bone orientations===
			Same as [[#Bone orientations\|Version 6]], but without commas:
			<pre>BONE 0
			OFFSET 0.000002 -2.222280 0.000042
			SCALE 1.000000 1.000000 1.000000
			X 0.000000 -1.000000 -0.000001
			Y 1.000000 0.000000 0.000000
			Z -0.000000 -0.000001 1.000000
			...</pre>


			=== Vertices ===
			Same as [[#Vertices\|Version 6]], but without commas:
			<pre>NUMVERTS 93
			VERT 0
			OFFSET -17.273228 -12.413740 43.184647
			BONES 2
			BONE 88 0.020674
			BONE 103 0.979326
			...</pre>

CoDEmanX: Corrected contentual mistakes

2011-11-11T23:41:07Z

Corrected contentual mistakes

← Older revision		Revision as of 23:41, 11 November 2011
Line 92:		Line 92:

	=== Faces ===		=== Faces ===
	[[File:Triangulated Cube with Normals.png\|thumb\|right\|Triangulated Cube~~, face~~ normals shown in blue, ~~selected~~ triangle in orange]]		[[File:Triangulated Cube with Normals 2.png\|thumb\|right\|Triangulated Cube. Face normals shown in light blue, vertex normals in dark blue. Selected triangle in orange]]
	Faces are flat surfaces described by vertices. Call of Duty doesn't support quads or polygons with 5+ vertices. Each face is made up of 3 vertices. Thus, a face is always a triangle. A triangle definition is started with a TRI line, followed by 3 blocks of VERT, NORMAL, COLOR and UV to set up all triangle properties.		Faces are flat surfaces described by vertices. Call of Duty doesn't support quads or polygons with 5+ vertices. Each face is made up of 3 vertices. Thus, a face is always a triangle. A triangle definition is started with a TRI line, followed by 3 blocks of VERT, NORMAL, COLOR and UV to set up all triangle properties.
	<pre>NUMFACES 6292		<pre>NUMFACES 6292
Line 129:		Line 129:
	**0 0 (static numbers)		**0 0 (static numbers)
	*'''VERT''' vertex number		*'''VERT''' vertex number
	*'''NORMAL''' ~~Face~~ normal vector, normalized (3x float)		*'''NORMAL''' Vertex normal vector, normalized (3x float, apparently not doing anything; face orientation is rather controlled by the order of the 3 vertices)
	*'''COLOR''' Vertex color (4x float, RGBA?)		*'''COLOR''' Vertex color (4x float, RGBA?)
	*'''UV''' description:		*'''UV''' description:

CoDEmanX: Added categories

2011-09-08T13:57:33Z

Added categories

← Older revision		Revision as of 13:57, 8 September 2011
Line 245:		Line 245:
	**Material number		**Material number
	**"texture file name"		**"texture file name"


			[[Category:Call of Duty 1]]
			[[Category:Call of Duty 2]]
			[[Category:Call of Duty 4]]
			[[Category:Call of Duty 5]]
			[[Category:Technical Reference]]
			[[Category:File formats]]

CoDEmanX: Format specs v5 and v6 completion

2011-08-28T17:02:49Z

Format specs v5 and v6 completion

Show changes

CoDEmanX: Initial post, xmodel_export v5 format specs

2011-08-28T13:12:41Z

Initial post, xmodel_export v5 format specs

New page

= Intermediate (*.XMODEL_EXPORT)=

== Version 5 (vCoD) ==

=== Header ===
<pre>// Source filename: 'C:\trees\model_source\character_models\character_lod\airborne_Low.max'
// Export time: Fri Aug 01 15:44:31 2003
MODEL
VERSION 5</pre>
*// Comments (optional)
*MODEL data type definition (magic word)
* VERSION number

=== Bone hierarchy table ===
[[File:Xmodel_TagTree.png|right|thumb|Visual bone hierarchy tree (section)]]
<pre>NUMBONES 73
BONE 0 -1 "TAG_ORIGIN"
BONE 1 0 "Bip01 Pelvis"
BONE 2 1 "Bip01 L Thigh"
BONE 3 1 "Bip01 R Thigh"
...</pre>
*NUMBONES number of bones (note: bone numeration starts with zero, BONE 0 + BONE 1 + BONE 2 = NUMBONES 3)
*BONE description:
**Bone number
**Bone parent number (-1 = root origin, a model can only have one!)
**Bone "name string" (has to be unique per model)

=== Bone orientations===
[[File:Local Bone Axis.png|thumb|right|Local bone axis, corresponding to vectors of the bone's rotation matrix]]
<pre>BONE 0
OFFSET 0.000002 -2.222280 0.000042
SCALE 1.000000 1.000000 1.000000
X 0.000000 -1.000000 -0.000001
Y 1.000000 0.000000 0.000000
Z -0.000000 -0.000001 1.000000

BONE 1
OFFSET 4.866636 1.218493 37.227966
SCALE 1.000000 1.000000 1.000000
X -0.008941 0.033732 -0.999391
Y -0.004868 -0.999420 -0.033689
Z -0.999948 0.004564 0.009100
...</pre>

*BONE number (as declared in the hierarchy table)
*OFFSET translations / position in the 3d space, like a coordinate (3x float)
*SCALE bone scale, appears to be always 1.000000 (3x float)

*X part of rotation matrix, basically the local x-axis of the bone (3x float)
*Y part of rotation matrix, basically the local y-axis of the bone = bone direction (3x float)
*Z part of rotation matrix, basically the local z-axis of the bone (3x float)

=== Vertices ===
<pre>NUMVERTS 93
VERT 0
OFFSET 0.091243 -5.213182 29.123474
BONES 3
BONE 3 0.333333
BONE 4 0.333333
BONE 2 0.333333

VERT 1
OFFSET 7.581652 -4.076623 29.466268
BONES 2
BONE 2 0.500000
BONE 4 0.500000</pre>
* NUMVERTS number of vertices in model
* Vertex description:
**VERT number
**OFFSET coordinate (3x float)
**BONES number of bones influencing this vertex
**BONE bone number as declared in the hierarchy table, normalized influence (float, between 0.000001 and 1.000000, all listed influences sum up to ~1.0)<br />The influences are controlled via weight painting in the 3d modelling application.

=== Faces ===
<pre>NUMFACES 172
TRI 0 0 0 1
VERT 10 0.873177 0.502103 0.514332 0.849479 0.117676
VERT 3 0.875169 0.254302 0.964290 0.262399 -0.035947
VERT 65 0.910332 0.493356 0.583699 0.238673 -0.776100
TRI 0 0 0 1
VERT 6 0.399969 0.721943 0.699542 -0.713791 -0.033821
VERT 3 0.470804 0.723883 0.964290 0.262399 -0.035947
VERT 2 0.503285 0.902194 0.830325 0.552277 0.074499
TRI 0 0 0 1
VERT 2 0.503285 0.902194 0.830325 0.552277 0.074499
VERT 1 0.435323 0.925295 0.690132 -0.722368 -0.043609
VERT 6 0.399969 0.721943 0.699542 -0.713791 -0.033821</pre>
*NUMFACES number of faces in model (face = triangle, quads are not supported!)
*Face description:
**TRI triangle belonging to object n, unknown number, material number, 1
**VERT vertex number, UV texture coords (2x float), face normal (3x float)

=== Objects ===
This data block seems to have no effect on an xmodel file.
<pre>NUMOBJECTS 3
OBJECT 0 "LowModel"
OBJECT 1 "lowhand"
OBJECT 2 "lowhand01"</pre>
*NUMOBJECTS number of objects in xmodel_export file
*Object description:
**OBJECT number, "name string"

=== Materials ===
<pre>NUMMATERIALS 7
MATERIAL 0 "body@air_chest.tga"
MATERIAL 1 "body@air_upperarm.tga"
MATERIAL 2 "body@air_forearm.tga"
MATERIAL 3 "body@air_upperleg.tga"
MATERIAL 4 "body@air_lowerleg.tga"
MATERIAL 5 "body@characterhand.tga"
MATERIAL 6 "body@air_boots.tga"</pre>
*NUMMATERIALS number of materials
*Material description:
**MATERIAL number, "texture file name"

== Version 6 (CoD2+) ==
=== Header ===
=== Bone hierarchy table ===
=== Bone orientations ===
=== Vertices ===
=== Faces ===
=== Objects ===
=== Materials ===

= Converted =
== Version ? ==
...