MD2 - Revision history

FREDZ at 12:24, 21 March 2025

2025-03-21T12:24:47Z

← Older revision		Revision as of 12:24, 21 March 2025
Line 80:		Line 80:
	</syntaxhighlight>		</syntaxhighlight>

	* '''vertex[3]''': The three bytes represent the x, y, and z coordinates of this vertex. This is not the "real" vertex coordinate. This is a scaled version of the coordinate, scaled so that each of the three numbers fit within one byte. To scale the vertex back to the "real" coordinate, multiply each ~~byte~~ by ~~its~~ respective float scale in the frame_t structure, and then add the respective float translation. This provides the vertex coordinate relative to the model's origin.		* '''vertex[3]''': The three bytes represent the x, y, and z coordinates of this vertex. This is not the "real" vertex coordinate. This is a scaled version of the coordinate, scaled so that each of the three numbers fit within one byte. To scale the vertex back to the "real" coordinate, multiply each of the bytes by their respective float scale in the frame_t structure, and then add the respective float translation. This provides the vertex coordinate relative to the model's origin, which is at the origin, (0, 0, 0).

	* '''lightNormalIndex''': This is an index into a table of normals kept by Quake2. The table can be obtained from [https://www.quaddicted.com/files/idgames2/idstuff/quake2/source/old/q2source_12_11.zip this zip file], released by [http://www.idsoftware.com id Software], containing the source code of tools used for Quake2.		* '''lightNormalIndex''': This is an index into a table of normals kept by Quake2. The table can be obtained from [https://www.quaddicted.com/files/idgames2/idstuff/quake2/source/old/q2source_12_11.zip this zip file], released by [http://www.idsoftware.com id Software], containing the source code of tools used for Quake2.
Line 102:		Line 102:

	== TRIANGLES ==		== TRIANGLES ==
	Quake 2 models are made up of only triangles. At offsetTriangles in the file~~, there~~ is an array of triangle_t structures. The array contains numTriangles structures.		Quake 2 models are made up of only triangles. At offsetTriangles in the file is an array of triangle_t structures. The array contains numTriangles structures.

	<syntaxhighlight lang="c">		<syntaxhighlight lang="c">
Line 112:		Line 112:
	</syntaxhighlight>		</syntaxhighlight>

	* '''vertexIndices[3]''': ~~Indices~~ into the array of vertices in each frame. ~~Each~~ triangle always ~~consists~~ of the same three indices in each frame's array of vertices. ~~The~~ triangles stay intact, ~~but~~ their vertices ~~move~~ around ~~in each frame~~.		* '''vertexIndices[3]''': These three shorts are indices into the array of vertices in each frame. In other words, the number of triangles in a `.mdx` file is fixed, and each triangle is always made of the same three indices into each frame's array of vertices. So, in each frame, the triangles themselves stay intact, their vertices are just moved around.
	* '''textureIndices[3]''': ~~Indices~~ into the array of texture coordinates.
			* '''textureIndices[3]''': These three shorts are indices into the array of texture coordinates.

	== SKINS ==		== SKINS ==
Line 130:		Line 131:

	== GL COMMANDS ==		== GL COMMANDS ==
	At offsetGlCommands bytes into the file, there is the gl command list, which is made up of a series of numGlCommands int's and float's, organized into groups. Each group starts with an int. If it is positive, it is followed by that many glCommandVertex_t structures, which form a triangle strip. If it is negative, it is followed by -x glCommandVertex_t structures, which fo rm a triangle fan. A 0 indicates the end of the list. The list is an optimized way of issuing commands when rendering with [http://www.opengl.org OpenGL].

			At offsetGlCommands bytes into the file, there is the gl command list, which is made up of a series of numGlCommands int's and float's, organized into groups. Each group starts with an int.
			* If it is positive, it is followed by that many glCommandVertex_t structures, which form a triangle strip.
			* If it is negative, it is followed by -x glCommandVertex_t structures, which fo rm a triangle fan.
			* A 0 indicates the end of the list.
			The list is an optimized way of issuing commands when rendering with [http://www.opengl.org OpenGL].


	<syntaxhighlight lang="c">		<syntaxhighlight lang="c">
Line 140:		Line 148:
	</syntaxhighlight>		</syntaxhighlight>

	* '''s, t''': These two floats map a vertex onto a skin. The horizontal axis position is given by ~~'''~~s~~'''~~, and the vertical axis position is given by ~~'''~~t~~'''~~. The ~~ranges~~ for ~~'''~~s~~'''~~ and ~~'''~~t~~''' are~~ 0.0 to 1.0.		* '''s, t''': These two floats are used to map a vertex onto a skin. The horizontal axis position is given by s, and the vertical axis position is given by t. The range for s and for t is 0.0 to 1.0. Note that the ranges are different than in the textureCoordinate_t structure. They are stored as floats here because that's the way Quake 2 passes them to [http://www.opengl.org OpenGL].

	Note that the ranges are different than in the textureCoordinate_t structure. They are stored as floats here because that's the way ~~Quake2~~ passes them to [http://www.opengl.org OpenGL].

	* '''vertexIndex''': Index into the array of vertices stored in each frame.		* '''vertexIndex''': Index into the array of vertices stored in each frame.

FREDZ: /* MAXIMUMS */

2025-03-21T02:11:11Z

MAXIMUMS

← Older revision		Revision as of 02:11, 21 March 2025
Line 147:		Line 147:

	== MAXIMUMS ==		== MAXIMUMS ==
	~~Quake 2~~ has ~~predefined~~ limits:		Quake2 has some pre-defined limits, so that dynamic memory does not need to be used. You can use these to your advantage to speed up loading if you want.
	* [[#TRIANGLES\|Triangles]]: 4096		* [[#TRIANGLES\|Triangles]]: 4096
	* Vertices: 2048		* Vertices: 2048

FREDZ: /* MAXIMUMS */

2025-03-21T02:10:27Z

MAXIMUMS

← Older revision		Revision as of 02:10, 21 March 2025
Line 148:		Line 148:
	== MAXIMUMS ==		== MAXIMUMS ==
	Quake 2 has predefined limits:		Quake 2 has predefined limits:
	* Triangles: 4096		* [[#TRIANGLES\|Triangles]]: 4096
	* Vertices: 2048		* Vertices: 2048
	* Texture Coordinates: 2048		* Texture Coordinates: 2048
	* Frames: 512		* [[#FRAMES\|Frames]]: 512
	* Skins: 32		* [[#SKINS\|Skins]]: 32

	Quake and Quake2 are trademarks of [http://www.idsoftware.com id Software]. All trademarks are properties of their respective owners.		Quake and Quake2 are trademarks of [http://www.idsoftware.com id Software]. All trademarks are properties of their respective owners.

FREDZ: /* GL COMMANDS */

2025-03-21T02:06:36Z

GL COMMANDS

← Older revision		Revision as of 02:06, 21 March 2025
Line 130:		Line 130:

	== GL COMMANDS ==		== GL COMMANDS ==
	At offsetGlCommands bytes into the file, there is the gl command list, which is made up of a series of numGlCommands int's and float's, organized into groups. Each group starts with an int. If it is positive, it is followed by that many glCommandVertex_t structures, which form a triangle strip. If it is negative, it is followed by -x glCommandVertex_t structures, which fo rm a triangle fan. A 0 indicates the end of the list. The list is an optimized way of issuing commands when rendering with ~~OpenGl~~.		At offsetGlCommands bytes into the file, there is the gl command list, which is made up of a series of numGlCommands int's and float's, organized into groups. Each group starts with an int. If it is positive, it is followed by that many glCommandVertex_t structures, which form a triangle strip. If it is negative, it is followed by -x glCommandVertex_t structures, which fo rm a triangle fan. A 0 indicates the end of the list. The list is an optimized way of issuing commands when rendering with [http://www.opengl.org OpenGL].

	<syntaxhighlight lang="c">		<syntaxhighlight lang="c">
Line 142:		Line 142:
	* '''s, t''': These two floats map a vertex onto a skin. The horizontal axis position is given by '''s''', and the vertical axis position is given by '''t'''. The ranges for '''s''' and '''t''' are 0.0 to 1.0.		* '''s, t''': These two floats map a vertex onto a skin. The horizontal axis position is given by '''s''', and the vertical axis position is given by '''t'''. The ranges for '''s''' and '''t''' are 0.0 to 1.0.

	Note that the ranges are different than in the textureCoordinate_t structure. They are stored as floats here because that's the way Quake2 passes them to ~~OpenGl~~.		Note that the ranges are different than in the textureCoordinate_t structure. They are stored as floats here because that's the way Quake2 passes them to [http://www.opengl.org OpenGL].

	* '''vertexIndex''': Index into the array of vertices stored in each frame.		* '''vertexIndex''': Index into the array of vertices stored in each frame.

FREDZ: /* FRAMES */

2025-03-21T02:05:36Z

FRAMES

← Older revision		Revision as of 02:05, 21 March 2025
Line 99:		Line 99:
	* '''vertices[1]''': An array of numVertices triangleVertex_t structures.		* '''vertices[1]''': An array of numVertices triangleVertex_t structures.

	'''frame_t''' is a variable-sized structure; however, all frame_t structures within the same file will have the same size ('''numVertices''' in the header).		'''frame_t''' is a variable-sized structure; however, all frame_t structures within the same file will have the same size ('''numVertices''' in the [[#HEADER\|header]]).

	== TRIANGLES ==		== TRIANGLES ==

FREDZ: /* HEADER */

2025-03-21T02:04:47Z

HEADER

FREDZ: /* GL COMMANDS */

2025-03-21T01:59:44Z

GL COMMANDS

← Older revision		Revision as of 01:59, 21 March 2025
Line 130:		Line 130:

	== GL COMMANDS ==		== GL COMMANDS ==
	At offsetGlCommands bytes into the file, there is the gl command list, made up of numGlCommands ~~ints~~ and ~~floats~~, organized into groups. Each group starts with an int. If positive, it is followed by that many glCommandVertex_t structures ~~(forming~~ a triangle strip). If negative, it is followed by -x glCommandVertex_t structures ~~(forming~~ a triangle fan). A 0 indicates the end of the list.		At offsetGlCommands bytes into the file, there is the gl command list, which is made up of a series of numGlCommands int's and float's, organized into groups. Each group starts with an int. If it is positive, it is followed by that many glCommandVertex_t structures, which form a triangle strip. If it is negative, it is followed by -x glCommandVertex_t structures, which fo rm a triangle fan. A 0 indicates the end of the list. The list is an optimized way of issuing commands when rendering with OpenGl.

	<syntaxhighlight lang="c">		<syntaxhighlight lang="c">
Line 142:		Line 142:
	* '''s, t''': These two floats map a vertex onto a skin. The horizontal axis position is given by '''s''', and the vertical axis position is given by '''t'''. The ranges for '''s''' and '''t''' are 0.0 to 1.0.		* '''s, t''': These two floats map a vertex onto a skin. The horizontal axis position is given by '''s''', and the vertical axis position is given by '''t'''. The ranges for '''s''' and '''t''' are 0.0 to 1.0.

	Note that the ranges are different ~~from those~~ in the ~~[[#textureCoordinate\|~~textureCoordinate_t]] structure. They are stored as floats here because that's the way Quake2 passes them to ~~OpenGL~~.		Note that the ranges are different than in the textureCoordinate_t structure. They are stored as floats here because that's the way Quake2 passes them to OpenGl.

	* '''vertexIndex''': Index into the array of ~~[[#frame_vertices\|~~vertices]] stored in each ~~[[#~~frame~~\|frame]]~~.		* '''vertexIndex''': Index into the array of vertices stored in each frame.

	== MAXIMUMS ==		== MAXIMUMS ==

FREDZ: /* SKINS */

2025-03-21T01:57:28Z

SKINS

← Older revision		Revision as of 01:57, 21 March 2025
Line 125:		Line 125:
	</syntaxhighlight>		</syntaxhighlight>

	* '''s, t''': These two shorts are used to map a vertex onto a skin. The horizontal axis position is given by ~~'''~~s~~'''~~, and the vertical axis position is given by ~~'''~~t~~'''~~. The range for ~~'''~~s~~'''~~ is greater than or equal to 0 and less than ~~[[#model_skinWidth\|~~skinWidth]] (0 ≤ s < skinWidth). The range for ~~'''~~t~~'''~~ is greater than or equal to 0 and less than ~~[[#model_skinHeight\|~~skinHeight]] (0 ~~≤ t~~ < skinHeight).		* '''s, t''': These two shorts are used to map a vertex onto a skin. The horizontal axis position is given by s, and the vertical axis position is given by t. The range for s is greater than or equal to 0 and less than skinWidth (0 <= s < skinWidth). The range for t is greater than or equal to 0 and less than skinHeight (0 <= s < skinHeight).

	Note that the ranges are different ~~from those~~ in the ~~[[#glCommandVertex_s\|~~s]] and ~~[[#glCommandVertex_t\|~~t]] members of the ~~[[#~~glCommandVertex~~\|glCommandVertex]]~~ structure.		Note that the ranges are different than in the s and t members of the glCommandVertex structure.

	== GL COMMANDS ==		== GL COMMANDS ==

FREDZ at 00:52, 21 March 2025

2025-03-21T00:52:02Z

← Older revision		Revision as of 00:52, 21 March 2025
Line 3:		Line 3:

	== INTRO ==		== INTRO ==

	This page will try and give some sort of technical documentation on the Quake2 model format (.md2).		This page will try and give some sort of technical documentation on the Quake2 model format (.md2).

Line 11:		Line 10:

	== HEADER ==		== HEADER ==

	The header comes right at the start of the file. The information in the header is needed to load different parts of the model.		The header comes right at the start of the file. The information in the header is needed to load different parts of the model.

Line 72:		Line 70:

	== FRAMES ==		== FRAMES ==

	Each frame contains the positions in 3D space for each vertex of each triangle that makes up the model. Quake 2 (and Quake) models contain only triangles.		Each frame contains the positions in 3D space for each vertex of each triangle that makes up the model. Quake 2 (and Quake) models contain only triangles.

Line 83:		Line 80:
	</syntaxhighlight>		</syntaxhighlight>

	* '''vertex''': The three bytes represent the x, y, and z coordinates of this vertex. This is not the "real" vertex coordinate. This is a scaled version of the coordinate, scaled so that each of the three numbers fit within one byte. To scale the vertex back to the "real" coordinate, ~~you need to first~~ multiply each ~~of the bytes~~ by ~~their~~ respective float ~~[[#frame_scale\|~~scale]] in the ~~[[#frame\|~~frame_t]] structure, and then add the respective float [[~~#frame_translate\|translation]~~], ~~also in~~ the [[~~#frame\|~~frame_t]] ~~structure~~.		* '''vertex[3]''': The three bytes represent the x, y, and z coordinates of this vertex. This is not the "real" vertex coordinate. This is a scaled version of the coordinate, scaled so that each of the three numbers fit within one byte. To scale the vertex back to the "real" coordinate, multiply each byte by its respective float scale in the frame_t structure, and then add the respective float translation. This provides the vertex coordinate relative to the model's origin.

			* '''lightNormalIndex''': This is an index into a table of normals kept by Quake2. The table can be obtained from [https://www.quaddicted.com/files/idgames2/idstuff/quake2/source/old/q2source_12_11.zip this zip file], released by [http://www.idsoftware.com id Software], containing the source code of tools used for Quake2.

			<syntaxhighlight lang="c">
			typedef struct
			{
			float scale[3];
			float translate[3];
			char name[16];
			triangleVertex_t vertices[1];
			} frame_t;
			</syntaxhighlight>

			* '''scale[3]''': A scale used by the vertex member of triangleVertex_t.
			* '''translate[3]''': A translation used by the vertex member of triangleVertex_t.
			* '''name[16]''': The name of the frame.
			* '''vertices[1]''': An array of numVertices triangleVertex_t structures.

	* '''~~lightNormalIndex~~'''~~: This~~ is ~~an index into~~ a ~~table of normals kept by Quake2~~.		'''frame_t''' is a variable-sized structure; however, all frame_t structures within the same file will have the same size ('''numVertices''' in the header).

	== TRIANGLES ==		== TRIANGLES ==
			Quake 2 models are made up of only triangles. At offsetTriangles in the file, there is an array of triangle_t structures. The array contains numTriangles structures.
	Quake 2 models are made up of only triangles. At ~~[[#model_offsetTriangles\|~~offsetTriangles]] in the file is an array of ~~[[#triangle\|~~triangle_t]] structures.

	<syntaxhighlight lang="c">		<syntaxhighlight lang="c">
Line 99:		Line 112:
	</syntaxhighlight>		</syntaxhighlight>

	* '''vertexIndices''': ~~These three shorts are indices~~ into the array of ~~[[#frame_vertices\|~~vertices]] in each ~~[[#~~frame\|frame]].		* '''vertexIndices[3]''': Indices into the array of vertices in each frame. Each triangle always consists of the same three indices in each frame's array of vertices. The triangles stay intact, but their vertices move around in each frame.
			* '''textureIndices[3]''': Indices into the array of texture coordinates.
	* '''textureIndices''': ~~These three shorts are indices~~ into the array of ~~[[#textureCoordinate\|~~texture coordinates]].

	== SKINS ==		== SKINS ==
			There is an array of '''numSkins''' skin names stored at '''offsetSkins''' in the file. Each skin name is a '''char[64]'''. The name is a path to the skin, relative to the base game directory (e.g., baseq2 for "standard" Quake2). The skin files are regular PCX files.
	There is an array of ~~[[#model_numSkins\|~~numSkins]] skin names stored at ~~[[#model_offsetSkins\|~~offsetSkins~~]] into~~ the file. Each skin name is a char[64]. The name is ~~really~~ a path to the skin, relative to the base game directory (baseq2 for "standard" Quake2). The skin files are regular PCX files.

	~~== TEXTURE COORDINATES ==~~

	<syntaxhighlight lang="c">		<syntaxhighlight lang="c">
Line 115:		Line 124:
	} textureCoordinate_t;		} textureCoordinate_t;
	</syntaxhighlight>		</syntaxhighlight>

			* '''s, t''': These two shorts are used to map a vertex onto a skin. The horizontal axis position is given by '''s''', and the vertical axis position is given by '''t'''. The range for '''s''' is greater than or equal to 0 and less than [[#model_skinWidth\|skinWidth]] (0 ≤ s < skinWidth). The range for '''t''' is greater than or equal to 0 and less than [[#model_skinHeight\|skinHeight]] (0 ≤ t < skinHeight).

			Note that the ranges are different from those in the [[#glCommandVertex_s\|s]] and [[#glCommandVertex_t\|t]] members of the [[#glCommandVertex\|glCommandVertex]] structure.

	== GL COMMANDS ==		== GL COMMANDS ==
			At offsetGlCommands bytes into the file, there is the gl command list, made up of numGlCommands ints and floats, organized into groups. Each group starts with an int. If positive, it is followed by that many glCommandVertex_t structures (forming a triangle strip). If negative, it is followed by -x glCommandVertex_t structures (forming a triangle fan). A 0 indicates the end of the list.
	At ~~[[#model_offsetGlCommands\|~~offsetGlCommands]] bytes into the file, there is the gl command list.

	<syntaxhighlight lang="c">		<syntaxhighlight lang="c">
Line 128:		Line 140:
	</syntaxhighlight>		</syntaxhighlight>

	~~== MAXIMUMS ==~~		* '''s, t''': These two floats map a vertex onto a skin. The horizontal axis position is given by '''s''', and the vertical axis position is given by '''t'''. The ranges for '''s''' and '''t''' are 0.0 to 1.0.

			Note that the ranges are different from those in the [[#textureCoordinate\|textureCoordinate_t]] structure. They are stored as floats here because that's the way Quake2 passes them to OpenGL.

	~~Quake2 has some pre-defined limits~~:		* '''vertexIndex''': Index into the array of [[#frame_vertices\|vertices]] stored in each [[#frame\|frame]].

	* ~~'''~~Triangles~~'''~~: 4096		== MAXIMUMS ==
	* ~~'''~~Vertices~~'''~~: 2048		Quake 2 has predefined limits:
	* ~~'''~~Texture Coordinates~~'''~~: 2048		* Triangles: 4096
	* ~~'''~~Frames~~'''~~: 512		* Vertices: 2048
	* ~~'''~~Skins~~'''~~: 32		* Texture Coordinates: 2048
			* Frames: 512
			* Skins: 32

	Quake and Quake2 are trademarks of [http://www.idsoftware.com id Software].		Quake and Quake2 are trademarks of [http://www.idsoftware.com id Software]. All trademarks are properties of their respective owners.
	All trademarks ~~used~~ are properties of their respective owners.

FREDZ at 23:55, 18 March 2025

2025-03-18T23:55:51Z

← Older revision		Revision as of 23:55, 18 March 2025
Line 37:		Line 37:
	</syntaxhighlight>		</syntaxhighlight>

	~~=== magic ===~~		* '''magic''': A "magic number" used to identify the file. The magic number is 844121161 in decimal (0x32504449 in hexadecimal). The magic number is equal to the int "IDP2" (id polygon 2), which is formed by ('I' + ('D' << 8) + ('P' << 16) + ('2' << 24)).
	'''~~int~~ magic''': A "magic number" used to identify the file. The magic number is 844121161 in decimal (0x32504449 in hexadecimal). The magic number is equal to the int "IDP2" (id polygon 2), which is formed by ('I' + ('D' << 8) + ('P' << 16) + ('2' << 24)).

	~~=== version ===~~		* '''version''': Version number of the file. Always 8.
	'''~~int~~ version''': Version number of the file. Always 8.

	~~=== skinWidth ===~~		* '''skinWidth''': Width of the skin(s) in pixels.
	'''~~int~~ skinWidth''': Width of the skin(s) in pixels.

	~~=== skinHeight ===~~		* '''skinHeight''': Height of the skin(s) in pixels.
	'''~~int~~ skinHeight''': Height of the skin(s) in pixels.

	~~=== frameSize ===~~		* '''frameSize''': Size of each [[#FRAMES\|frame]] in bytes.
	'''~~int~~ frameSize''': Size of each [[#FRAMES\|frame]] in bytes.

	~~=== numSkins ===~~		* '''numSkins''': Number of skins associated with this model.
	'''~~int~~ numSkins''': Number of skins associated with this model.

	~~=== numVertices ===~~		* '''numVertices''': Number of [[#triangleVertex\|vertices]] in each frame.
	'''~~int~~ numVertices''': Number of [[#triangleVertex\|vertices]] in each frame.

	~~=== numTexCoords ===~~		* '''numTexCoords''': Number of texture coordinates (not necessarily the same as the number of vertices).
	'''~~int~~ numTexCoords''': Number of texture coordinates (not necessarily the same as the number of vertices).

	~~=== numTriangles ===~~		* '''numTriangles''': Number of triangles in each frame.
	'''~~int~~ numTriangles''': Number of triangles in each frame.

	~~=== numGlCommands ===~~		* '''numGlCommands''': Number of dwords (4 bytes) in the gl command list.
	'''~~int~~ numGlCommands''': Number of dwords (4 bytes) in the gl command list.

	~~=== numFrames ===~~		* '''numFrames''': Number of [[#FRAMES\|frames]].
	'''~~int~~ numFrames''': Number of [[#FRAMES\|frames]].

	~~=== offsetSkins ===~~		* '''offsetSkins''': Offset, in bytes from the start of the file, to the list of skin names.
	'''~~int~~ offsetSkins''': Offset, in bytes from the start of the file, to the list of skin names.

	~~=== offsetTexCoords ===~~		* '''offsetTexCoords''': Offset, in bytes from the start of the file, to the list of texture coordinates.
	'''~~int~~ offsetTexCoords''': Offset, in bytes from the start of the file, to the list of texture coordinates.

	~~=== offsetTriangles ===~~		* '''offsetTriangles''': Offset, in bytes from the start of the file, to the list of triangles.
	'''~~int~~ offsetTriangles''': Offset, in bytes from the start of the file, to the list of triangles.

	~~=== offsetFrames ===~~		* '''offsetFrames''': Offset, in bytes from the start of the file, to the list of [[#FRAMES\|frames]].
	'''~~int~~ offsetFrames''': Offset, in bytes from the start of the file, to the list of [[#FRAMES\|frames]].

	~~=== offsetGlCommands ===~~		* '''offsetGlCommands''': Offset, in bytes from the start of the file, to the gl command list.
	'''~~int~~ offsetGlCommands''': Offset, in bytes from the start of the file, to the gl command list.

	~~=== offsetEnd ===~~		* '''offsetEnd''': Offset, in bytes from the start of the file, to the end (size of the file).
	'''~~int~~ offsetEnd''': Offset, in bytes from the start of the file, to the end (size of the file).

	== FRAMES ==		== FRAMES ==
Line 100:		Line 83:
	</syntaxhighlight>		</syntaxhighlight>

	~~=== vertex ===~~		* '''vertex''': The three bytes represent the x, y, and z coordinates of this vertex. This is not the "real" vertex coordinate. This is a scaled version of the coordinate, scaled so that each of the three numbers fit within one byte. To scale the vertex back to the "real" coordinate, you need to first multiply each of the bytes by their respective float [[#frame_scale\|scale]] in the [[#frame\|frame_t]] structure, and then add the respective float [[#frame_translate\|translation]], also in the [[#frame\|frame_t]] structure.
	'''~~byte~~ vertex~~[3]~~''': The three bytes represent the x, y, and z coordinates of this vertex. This is not the "real" vertex coordinate. This is a scaled version of the coordinate, scaled so that each of the three numbers fit within one byte. To scale the vertex back to the "real" coordinate, you need to first multiply each of the bytes by their respective float [[#frame_scale\|scale]] in the [[#frame\|frame_t]] structure, and then add the respective float [[#frame_translate\|translation]], also in the [[#frame\|frame_t]] structure.

	~~=== lightNormalIndex ===~~		* '''lightNormalIndex''': This is an index into a table of normals kept by Quake2.
	'''~~byte~~ lightNormalIndex''': This is an index into a table of normals kept by Quake2.

	== TRIANGLES ==		== TRIANGLES ==
Line 118:		Line 99:
	</syntaxhighlight>		</syntaxhighlight>

	~~=== vertexIndices ===~~		* '''vertexIndices''': These three shorts are indices into the array of [[#frame_vertices\|vertices]] in each [[#frame\|frame]].
	'''~~short~~ vertexIndices~~[3]~~''': These three shorts are indices into the array of [[#frame_vertices\|vertices]] in each [[#frame\|frame]].

	~~=== textureIndices ===~~		* '''textureIndices''': These three shorts are indices into the array of [[#textureCoordinate\|texture coordinates]].
	'''~~short~~ textureIndices~~[3]~~''': These three shorts are indices into the array of [[#textureCoordinate\|texture coordinates]].

	== SKINS ==		== SKINS ==

← Older revision		Revision as of 02:04, 21 March 2025
Line 47:		Line 47:
	* '''numSkins''': Number of skins associated with this model.		* '''numSkins''': Number of skins associated with this model.

	* '''numVertices''': Number of ~~[[#triangleVertex\|~~vertices]] in each frame.		* '''numVertices''': Number of vertices in each frame.

	* '''numTexCoords''': Number of texture coordinates (not necessarily the same as the number of vertices).		* '''numTexCoords''': Number of texture coordinates (not necessarily the same as the number of vertices).
Line 53:		Line 53:
	* '''numTriangles''': Number of triangles in each frame.		* '''numTriangles''': Number of triangles in each frame.

	* '''numGlCommands''': Number of dwords (4 bytes) in the gl command list.		* '''numGlCommands''': Number of dwords (4 bytes) in the [[#GL_COMMANDS\|GL command list]].

	* '''numFrames''': Number of [[#FRAMES\|frames]].		* '''numFrames''': Number of [[#FRAMES\|frames]].

	* '''offsetSkins''': Offset, in bytes from the start of the file, to the list of skin names.		* '''offsetSkins''': Offset, in bytes from the start of the file, to the list of [[#SKINS\|skin]] names.

	* '''offsetTexCoords''': Offset, in bytes from the start of the file, to the list of texture coordinates.		* '''offsetTexCoords''': Offset, in bytes from the start of the file, to the list of texture coordinates.

	* '''offsetTriangles''': Offset, in bytes from the start of the file, to the list of triangles.		* '''offsetTriangles''': Offset, in bytes from the start of the file, to the list of [[#TRIANGLES\|triangles]].

	* '''offsetFrames''': Offset, in bytes from the start of the file, to the list of [[#FRAMES\|frames]].		* '''offsetFrames''': Offset, in bytes from the start of the file, to the list of [[#FRAMES\|frames]].

	* '''offsetGlCommands''': Offset, in bytes from the start of the file, to the gl command list.		* '''offsetGlCommands''': Offset, in bytes from the start of the file, to the [[#GL_COMMANDS\|GL command list]].

	* '''offsetEnd''': Offset, in bytes from the start of the file, to the end (size of the file).		* '''offsetEnd''': Offset, in bytes from the start of the file, to the end (size of the file).