Compilation d'un modèle

Les modèles ont besoin d'être compilés pour être utilisés dans Source. Trois éléments interviennent afin d'obtenir un modèle compilé :

1. Plusieurs fichiers SMD dérivants le modèle . Voir Exporté un modèles pour plus d'informations.
2. Un fichier texte QC qui définit comment seront interprétés les fichiers SMD lors de la compilation.
3. Studiomdl, le programme fourni avec le SDK pour compiler vos modèle. Pour plus de simplicité vous pouvez utilisé une interface graphique, voir liens plus bas.

Mise en place

La seule étape que vous devez faire avant de compiler est de choisir le dossier VPROJECT actuel. Les models seront compilés dans le dossier du jeu choisi. Vous pouvez le configurer ainsi :

1. Globalement, en sélectionnant votre jeu\mod dans la liste de démarrage du SDK.
2. Pour Studiomdl seulement, en démarrant avec -game "<chemin complet vers le dossier de votre gameinfo.txt>"
    Astuce: La plupart des outils SDK acceptent -game.

Syntaxe intelligente

Éditer un fichier devient beaucoup plus facile avec un éditeur de texte avancé avec support de la syntaxe. Il y a deux éditeurs avec support de la syntaxe pour les fichiers QC :

• Notepad++
• ConTEXT

Créer un fichier QC

Un fichier QC est simplement un fichier contenant du texte avec l'extension .qc. Vous pouvez le sauvegarder n'importe où, le nommer comme vous voulez, mais pour mieux être organisé, il est recommandé de placer le fichier QC dans le même dossier que les SMDs avec le même nom que les SMDs.

Dans le fichier QC il dois y avoir plusieurs commandes informant studiomdl sur la location des SMD, ou les fichiers seront compilé (par rapport au VPROJECT), comment sera l'animation, et plus... Vous trouverez toutes les commandes nécessaires ici : Category:QC Commands.

Exemple

Emplacements des fichiers

The default location for SMDs is the same folder as the QC file. You can access other locations:

• With an absolute path (e.g. C:\modelsrc\my_model\)
• With a relative path (e.g. .\subfolder or ..\)
   Astuce: A single period is the current folder. Two periods is the one above it. ..\..\ goes two levels up.
• With $pushd and $popd.

Voici un simple fichier QC, pour compilé un simple modèle statique sans animation, ou quelconque propriétés spéciales :

$modelname	"props_sdk\myfirstmodel.mdl"
$body mybody	"myfirstmodel-ref.smd"
$staticprop
$surfaceprop	combine_metal
$cdmaterials	"models\props_sdk"

$sequence idle	"myfirstmodel-idle.smd" loop fps 15

$collisionmodel	"myfirstmodel-phys.smd" { $concave }

 Attention: Tous les modèles doivent avoir au moins une $sequence, même si il n'est pas animé.

Modèles physique

• Si votre modèles est destiné à être utilisé avec le moteur de physique, voir prop_data.

Compiling

With your text editor

The easiest way to compile a model is with the built-in launch features of advanced text editors.

• With Notepad++
• With ConTEXT

With a batch file

If you can't (or don't want to) use an advanced text editor, you will be compiling QCs by dragging them onto studiomdl in Windows. You can find the executable file in sourcesdk/bin/[orangebox|ep1]/bin/.

The process will be easier if you create a .cmd file somewhere more accessible to automate it. This is simply a renamed .txt file containing something like this:

"%sourcesdk%/bin/orangebox/bin/studiomdl" "%1"
pause

Drop your QC file onto the CMD as you would studiomdl itself; it's essentially a shortcut to the executable.

Erreurs Communes

• Error opening <model>! (Check for write enable)

  Studiomdl ne peut pas créer de dossier qui n'existe pas; vous devez créer manuellement le dossier de destination de votre .mdl.

• Costly collision model

  La limite d'un modèle de collisions est de 20 éléments, mais vous pouvez passer par dessus cette limitations.

• Duplicate weightlist pelvisonly
• Short conversion out of range
• WARNING: (4768124) : ERROR: 'EXCEPTION ACCESS VIOLATION' (assert: 1)

  Si vous recevez EXCEPTION_ACCESS_VIOLATION sans de code d'erreur, essayer de compilé avec HLMV démarré.

SDK samples

The SDK has numerous sample models, including several fully-articulated characters and players. They can be found at sourcesdk_content\<game>\modelsrc\.

sdk

Complète SMD sources à la fois pour les modèles de joueurs dans DODS!

cstrike

"Urban CT" player model

Several static props

generic

A tweaked ValveBiped rig (no meshes)

hl2

Airboat and Buggy

Antlion Guard

Male citizen (only has a few animations)

Some CS stuff that is probably a duplicate of \cstrike's content

Viewmodels for all HL2 weapons

hl2mp

All with multiplayer animations only:

Combine soldier

Metrocop

Male rebel

See also

• QC
• Category:QC Commands
• studiomdl
• Studiocompiler, a graphical interface for studiomdl
• GUIStudioMDL, another graphical interface
• Highlighting and Compiling QCs with ConTEXT
• Notepad++ VDF languages