View source for Studiomdl

{{otherlang2|ru=Studiomdl:ru|es=Studiomdl:es}}

:''For a guide to studiomdl's usage, see [[Compiling a model]].''

{{toc-right}}

'''Studiomdl''' is the [[command-line]] tool used to compile [[model]]s from the intermediate [[Studio Model Data]] format exported from modeling packages to the binary .mdl format that is read by the Source engine.

It can be found at <code>steam/steamapps/<account>/sourcesdk/bin/[orangebox|ep1]/bin/studiomdl.exe</code>.

{{tip|The name "studio" is a throwback to the development of [[Half-Life 1]], during which Valve used [[3D Studio Max]] to create their models.}}

== Parameters ==

The only parameter required is a [[Qc|QC file]]. Any others must come ''before'' it.

 studiomdl [options] <path\QC>

=== General ===

; <code>-game <gamedir></code>
: Override system-wide game path.
;<code>-quiet</code>
:Theoretically suppresses console output. In practice does nothing.
;<code>-x360</code>
:Enable Xbox 360 output (OB).
;<code>-nox360</code>
:Disable Xbox 360 output (Ep1).
;<code>-nowarnings</code>
:Disable warnings.

=== Animation ===

; <code>-definebones</code>
: See [[$definebone]].
; <code>-printbones</code>
: Writes extra bone info to the console.
; <code>-printgraph</code>
: Writes some kind of animation weight graph to the console.
; <code>-overridedefinebones</code>
: Equivalent to specifying [[$unlockdefinebones]] in QC.

=== Performance ===

; <code>-fullcollide</code>
: Don't truncate really big [[collision mesh]]es (Ep1 only; OB uses [[$maxconvexpieces]]).
; <code>-striplods</code>
: Ignore all [[$lod]] commands.
;<code>-minlod <lod></code>
:Throw away data from LODs above the given one (see [[$minlod]]).
;<code>-perf</code>
:Report performance info in console.
;<code>-mdlreport <path\model.mdl></code>
:Report performance info for an already-compiled model. A QC file is not needed when using this command.
;<code>-mdlreportspreadsheet</code>
:Report performance info as a comma-delimited spreadsheet. {{TODO|Usage}}

=== Debug ===

;<code>-d</code>
:Dumps various [[glview]] files (10 per LOD per VTX file),
;<code>-h</code>
:Dump [[hitbox]]es to console,
;<code>-n</code>
:Tag bad normals.
;<code>-dumpmaterials</code>
:Dump names of used materials to the console.
;<code>-i</code>
:Ignore warnings.
;<code>-t</code>
: Replaces all materials with the default pink check pattern

=== Unknown ===

;<code>-a <normal_blend_angle></code>
:?
;<code>-checklengths</code>
:?
;<code>-f</code>
:Flip all triangles.
;<code>-r</code>
:"Tag reversed"..?
;<code>-vsi <path\[QC|MDL]></code>
:Generate stripping information .vsi file. Works with QC and MDL. (Some sort of memory optimisation function? Possibly related to Xbox 360.)
;<code>-stripmodel</code>
:Process binary model files (VSI?) and strip extra lod data.
;<code>-stripvhv</code>
: Strip hardware verts to match the stripped model.

== Output files ==

;<code>mymodel.mdl</code>
:[[Skeleton]], animations, bounding/hit boxes, surface materials, [[lod]] index...
;<code>mymodel.sw.vtx</code>
;<code>mymodel.dx80.vtx</code>
;<code>mymodel.dx90.vtx</code>
:Vertex data optimised for DirectX 7, 8 and 9 respectively
;<code>mymodel.vvd</code>
:Remaining hardware-agnostic vertex data, including the [[UV map]]
;<code>mymodel.phy</code>
:Collision mesh data

== See also ==

* [[Compiling a model#Common_errors|Common Studiomdl errors]]
* [[Studiocompiler]], a graphical interface for studiomdl
* [[GUIStudioMDL]], another graphical interface
* [[Source Model Compiler]], a web based model compiler and QC generator.

{{SDKTools}}

[[Category:Modeling]]