View source for MDL (Quake)

{{LanguageBar}}
{{quake topicon}}{{quake2 topicon}}{{gldsrc topicon}}{{quake3 topicon}}
{{TabsBar|main=MDL}}
{{Non-valve engine|engine}}

'''MDL''' (retroactively '''QMDL''') is a file format used by {{quake|4.1}} to store [[vertex animation|vertex-animated]] [[model]]s, as well as the required [[texture]]s. Unlike the [[MDL|file formats of the same name]] used by {{gldsrc|4.1}} and {{src|4.1}}, [[skeletal animation]] is not supported, only one texture can be used per [[skin]], and only one mesh can be used per model. Additionally, vertices are stored as arrays of 8-bit integer values (multiplied by a 32-bit floating point scalar), causing noticeable warbling or squirming of vertices when animated, a phenomenon known as "vertex swimming". Instead of storing the exact vertex normals for each vertex, QMDL uses a stores an index which points to a lookup table of 162 indices containing vertex normal data.

Prior to engine updates in late 2020, {{gldsrc|4.1}} was able to load Quake MDLs, although it required a custom renderer to actually appear in-game{{ref|1}}.
{{bug|Attempting to load a QMDL in current builds of GoldSrc will crash in OpenGL mode!<br>Older builds simply refused to render the model or load textures, both of which were circumnavigatable in single-player mods using [[custom renderer]]s.}}

== Derivatives ==

=== MD2 ===
{{quake2|4.1}} uses a slightly modified version of the original Quake MDL format. Unlike its predecessor, textures are now stored as external 8-bit [[PCX]] files, although the embedded color palette is ignored. Most source ports (as well as the 2023 remaster) add support for using full-color [[TGA]]s instead of 256-color PCX. Additional "pain" skins can also be defined for [[monster]]s, and are automatically switched to (via DLL code) if the monster sustains enough damage.

Unlike Quake 1 models, Quake 2 models are almost always in their own folder, with the model usually named {{file|tris|md2}} and the textures usually named some variation of {{file|skin|pcx}} and {{file|pain|pcx}} (but these naming conventions are not required).

Whereas Quake MDL stores a single scale and origin for all animations on the model, MD2 stores a separate scale and origin for each frame. This often results in MD2 models squirming more than Quake MDL, as vertex swimming can occur in an MD2 where a vertex would stay stationary in a Quake MDL.

=== Half-Life MDL ===
{{main|MDL (GoldSrc)}}
{{gldsrc|4.1}} uses a heavily modified version of the original Quake MDL format. Support for vertex animation is removed in favor of [[skeletal animation]]. Each texture has its own [[color palette]], and multiple textures can be used per [[skin]]. Textures can be flagged as using certain render modes, such as alphatest transparency, additive translucency, or matcap "chrome". The vertex normals are stored as explicit values, allowing for proper sharp edges, and multiple meshes can be used per-model, including selectable "submodels". Vertex precision has been increased to floating-point as well. Tiling [[UV]]s are supported as well, unlike QMDL and MD2, although only the Sven-Coop SDK version [[StudioMDL]] can will compile them correctly.

Despite the shared file extension, {{src|4.1|nt=0}} [[MDL (Source)|MDLs]] bear little resemblance to Quake or GoldSrc MDLs.

=== MD3 ===
{{Quake3|4.1}} uses an improved version of the MD2 model format used by Quake II. While it still uses [[vertex animation]], the vertex precision has been upgraded to 16-bit signed integer, making vertex wobbling often imperceptible except when the model is scaled up to large sizes, such as on the main screen of {{w|Return to Castle Wolfenstein}}. Like {{gldsrc|4.1}}, multiple textures can be used per skin, a model can have several (concurrently rendered) meshes, tiling UVs are supported, and animation frame rates are stored directly in the model file. instead of using a lookup table, vertex normals are stored as explicit spherical coordinates (8-bits each for longitude and latitude; radius is omitted and unnecessary). Like {{Source|4.1}}, models can use customizable [[material]]s, allowing for more control over the textures' appearance.

=== MD5 ===
{{doom3|4.1}} drops vertex animation in favor of [[skeletal animation]]. Unlike its predecessors, MD5 models are not "compiled" to binary, instead being plain-text. MD5 is split into {{mono|md5mesh}} and {{mono|md5anim}} files, with each mesh and animation being contained in a separate file. MD5 models do not store vertex normal information{{ref|2}}, instead relying upon [[normal map]]s to determine surface normals.

The Kex Engine remasters of {{quake|4.1}} and {{quake2|4.1}} support using MD5 models instead of QMDL or MD2 models. Unlike Doom 3, these remasters use a single {{mono|md5anim}} file for all animations. Since {{idtech2|4.1}} does not use [[normal map]]s, implicit vertex normals are calculated by the engine at runtime by interpolating between surface normals.

=== Others ===
* AQM (Advanced Quake Model) - ??? (used by the q2mdl editor for QMDL and MD2 models; seems to have skeletal support)
* BMD5 - Version of MD5 format using binary data instead of plain-text; introduced in Doom 3 BFG to reduce load times for consoles
* GLM - Raven Software's Ghoul2 Model based on MD3, to allow for skeletal animation and dismemberment in Soldier of Fortune 2 and the Star Wars: Jedi Knight games
* MD16 - Variant of QMDL with all values upgraded to 16-bit floating point
::{{modernConfirm|Does MD16 also upgrade to using explicit vertex normals, instead of a lookup table?}}
* MDC - Compressed form of MD3, wherein animation frames may store vertex positions as 8-bit offsets instead of absolute 16-bit positions. Frames which are compressed this way use indexed normals, like QMDL and MD2 (but with a larger lookup table), but uncompressed frames store explicit normals in the same manner as MD3.
* MD4 - Unfinished skeletal-animated successor to MD3 developed alongside Quake III (not included in source code release)
** MDS - Grey Matter Studios' completed version of MD4, used in Return to Castle Wolfenstein 
*** MDM/MDX - Derivative of MDS used by Wolfenstein Enemy Territory, which splits the model into separate MDM (model) and MDX (animation) files, like with MD5.
** MDR - Raven Software's completed version of MD4, used in Star Trek Elite Force I+II
* IQM (Inter-Quake Model) - skeletal model, supporting explicit vertex normals{{ref|2}}, vertex colors, and bone scaling; used as a newer alternative for MD5 in various IdTech 2+3 source ports
** IQE (IQM Export) - plain-text version of IQM

== Trivia ==
* [[VRAD]] uses the same normals table as Quake MDLs for calculating the direction of bounced lighting.

== External links==
* [http://tfc.duke.free.fr/coding/mdl-specs-en.html Technical documentation of the QMDL format]
* [http://tfc.duke.free.fr/coding/md2-specs-en.html Technical documentation of the MD2 format]
* [https://icculus.org/homepages/phaethon/q3a/formats/md3format.html Technical documentation of the MD3 format]
* [https://mino-git.github.io/rtcw-wet-blender-model-tools/developer_guide.html Technical documentation of the MD3, MDC, MDS, and MDM/MDX formats]
* [http://sauerbraten.org/iqm/ Technical documentation of the IQM and IQE formats]
* {{quakewiki|mdl|MDL on the Quake Wiki}}
* {{quakewiki|FTEQW File Formats|FTEQW File Formats on the Quake Wiki}} - list of file formats supported by {{fte|4.1}} (being most of the formats listed above), including brief explanations of each model format
* [https://github.com/id-Software/Quake-2-Tools/blob/master/qdata/anorms.h {{mono|anorms.h}}] - Lookup table of 162 precalculated vertex normals used by QMDL and MD2 to store vertex normals for the meshes.
** [https://github.com/id-Software/Enemy-Territory/blob/master/src/renderer/anorms256.h {{mono|anorms256.h}}] - Extended version of anorms used by MDC, containing 256 precalculated vertex normals instead of 162.

== References ==
<ol>
<li>[https://github.com/ValveSoftware/halflife/issues/3005 <nowiki>Quake 1 models now crash the game on load · Issue #3005 · ValveSoftware/halflife</nowiki>]
<li>[https://unvanquished.net/introducing-the-iqm-model-format/ Introducing the IQM model format - Unvanquished]
</ol>

[[Category:File formats]]