explain autobuilds
[xonotic/xonotic.wiki.git] / Blender-to-dpm.md
1 Blender to dpm, a mini tutorial
2 ===============================
3
4 Pre-required tools and reading
5 ------------------------------
6
7 -   Go here - http://developer.valvesoftware.com/wiki/Blender#Installation and download the export script.
8 -   Rig / Animate as outlined here - http://developer.valvesoftware.com/wiki/Animation_in_Blender.
9 -   Only works with Blender 248a -- 249b (2.50 is a no go).
10
11 Blender work flow
12 -----------------
13
14 -   Select your mesh and armature, export as smd. select Static Mesh. You only need to re-export this smd if the mesh or the rig change.
15 -   Now export as Animation Sequence. Preferably you have one track (and smd file) per animation. name it so you know what it is (modelname_attack1.smd for example).
16 -   You could possibly use the “Animation Sequence ( ALL )” or “All…” options, but I haven’t tried so i cant say if it works.
17
18 dpmodel work flow
19 -----------------
20
21 -   dpmodel needs and a text file telling it how to bake the mesh and animation(s) into a dpm. This text file should look something like:
22
23     ```
24     # save the model as model.dpm
25     model model
26     # move the model this much before saving
27     origin 0 0 0
28     # rotate the model 90 degrees around vertical
29     rotate 90
30     # scale the model by this amount, 0.5 would be half size and 2.0 would be double size
31     scale 1
32     # load the mesh file, this is stored into the dpm as frame 0
33     scene model.smd
34     # Each following (if any) smd's are animations
35     scene model_action1.smd fps 30
36     scene model_action2.smd fps 30
37     ```
38
39 -   Place all smd’s and the text file in the same place, execute `dpmodel whatever_you_named_that_text_file`. If all goes well you should now have a working dpm (and .framegroups file if its animated)
40
41 Caveats:
42 --------
43
44 -   Your mesh needs to have a material assigned to it. The name of the material is what dp will look for to use as texture/shader on the model/mesh/es.
45 -   Blender exports what you got selected. make sure you have the relevant (and only the relevant) objects selected.
46 -   If export script fail with a encoding error, open it in a text editor and remove the whole top comment block (lines starting with \#). There’s an illegal character in there according to pyton. I haven’t bothered to check closer witch one it could be.
47