| Both sides previous revisionPrevious revisionNext revision | Previous revision |
| tools:blenderexportscripts [2020/04/21 10:46] – dragonlord | tools:blenderexportscripts [2022/06/08 09:05] (current) – dragonlord |
|---|
| </WRAP> | </WRAP> |
| |
| Blender3D is a really good and especially free-software application that is well suited to deliver the models and animations needed for the project. To work with Blender3D there will be some Python Scripts available in the Drag[en]gine Source Code package. | ====== Blender3D Export Scripts ====== |
| |
| The Drag[en]gine Exporter is a python script composed of multiple export modules. All formats are XML formats which allow you to post process them before importing into the map editor or writing your own exporters. The following file formats can be exported. | Blender3D is an excellent free-software application that is well suited to deliver models and animations needed for any game development project. Incorporating Blender3D authored resources is done via the Drag[en]gine Exporter. |
| |
| * Models in the *.model.xml format. Exported are the model geometry, bone weighting informations, edge creasing, textures ( materials ) and textue coordinates. Exported models are immediatly usable in the game engine. | |
| * Animations in the *.anim.xml format. Exported are all Actions which are not flagged invisible. Each Action is exported as one move with the same name. For each bone the position, rotation and size is saved on a keyframe basis with unrestricted intervals. There is no need to align keyframes of all bones as you can place them wherever you want. The playtime is considered from frame 1 up to the last keyframe placed in the Action. A frame rate of 50 frames per second is assumed. Later versions of the script will allow you to alter this value. Exported animations are immediatly usable in the game engine. | The Drag[en]gine Exporter is a Python script composed of multiple export modules that produce the XML formats that are most suitable for the map editor. The choice of XML here means that you can post process any resources, before importing into the map editor or even write your own exporters for functionality not covered by the engine. |
| * Rigs in the *.rig.xml format. Exported is the bone structure with bone relationships. Space is left open for physical properties which Blender3D can not take care of. As this is an XML file you can alter and use it immediably. Exported rigs can be used directly in the game engine. | |
| * Terrain Patches in the *.terrain.xml format. Exported are the geometry, edge creasing and textures ( materials ). Exported texture informations contain the projection settings from Blender3D mapped to the game engine. Currently supported are Flat Mapping, Cube Mapping and UV Mapping. Exported terrain patches have to be imported into a map using the map editor. Later versions of the script will also allow to export entire scenes into a map file so you can only befit it with entities later on in the map editor. | The following file formats can be exported: |
| | |
| | * Models in the *.demodel format describe model geometry, bone weighting information, edge creasing, textures (materials), texture coordinates and [[gamedev:lod#blender3d_export_scripts|LODs]]. |
| | * [[gamedev:deigde:editors:animator|Animations]] in the *.deanim format describe Actions which are not flagged invisible. Each Action is exported as one move with the same name. For each bone, the position, rotation and size are saved per keyframe. There is no need to align keyframes of all bones as the engine works such details out for you. The playtime is considered from frame 1 up to the last keyframe placed in the Action. A frame rate of 50 frames per second is assumed. Later versions of the script will allow you to alter this value. |
| | * [[gamedev:deigde:editors:rig|Rigs]] in the [[formats:modules:derigxml:xml_rig_file_.rig.xml|*.derig]] format describe the bone structure and bone relationships including physical properties which Blender3D does not typically handle. |
| | * [[gamedev:occmesh|Occlusion Meshes]] in the *.deoccmesh format describe similar information to .demodel but exports only model geometry and bone weighting. |
| | * [[gamedev:navigation|Navigation Spaces]] in the *.denavspace format describe similar information to .demodel but exports only model geometry. |
| | |
| | Resources exported from Blender3D in these formats can be used immediatelyby the game engine. |
| |
| ====== Installation ====== | ====== Installation ====== |
| |
| The addon scripts can be installed using the regular way in blender to install addons. The file is located here (after installing IGDE): | The addon scripts can be installed using the typical Blender3D workflow for [[https://docs.blender.org/manual/en/latest/editors/preferences/addons.html|installing addons]]. |
| * Linux: /usr/share/deigde/tools/blender-addon.zip | |
| * Windows: C:\Program Files\DEIGDE\Share\tools\blender-addon.zip | You can download the zip file from: [[https://github.com/LordOfDragons/dragengine/releases/latest]], file **blender-addon-dragengine-*.zip** where * is the version number. |
| | |
| | Click the "Install" button and select the plugin zip file. |
| | |
| | Once the plugins are installed the list shows the plugin. Click the check box to activate the plugin. |
| | |
| | Now various panels are added to Blender3D's views and properties with the title "Drag[en]gine". To export resources find the "Drag[en]gine Resources" sub menu in the File->Export menu. |
| |
| ====== Example Blend Files ====== | ====== Example Blend Files ====== |
| |
| Example blend files can be found in the [[https://github.com/LordOfDragons/deexamples|Drag[en]gine Example Projects]] repository for example in the [[https://github.com/LordOfDragons/deexamples/tree/master/exampleApp/data/develop|Example Application]]. | Example blend files can be found in the [[https://github.com/LordOfDragons/deexamples|Drag[en]gine Example Projects]] repository. For a more complete example, look in the [[https://github.com/LordOfDragons/deexamples/tree/master/exampleApp/data/develop|Example Application]]. |
| |
