| 1 | |
|---|
| 2 | WHAT |
|---|
| 3 | |
|---|
| 4 | This is wings-ogre, my Wings3D to OGRE converter written in Python. |
|---|
| 5 | |
|---|
| 6 | Please send feedback, suggestions and bug reports to: |
|---|
| 7 | |
|---|
| 8 | Attila Tajti <attis@spacehawks.hu> |
|---|
| 9 | |
|---|
| 10 | I'm also used to be around #Ogre3D on irc.freenode.net. |
|---|
| 11 | |
|---|
| 12 | |
|---|
| 13 | FEATURES |
|---|
| 14 | |
|---|
| 15 | It's basically a couple of Python modules to load and process the |
|---|
| 16 | structured Erlang binary file produced by Wings and save it in |
|---|
| 17 | Ogre XML. It does the following: |
|---|
| 18 | |
|---|
| 19 | - loads the polygon data |
|---|
| 20 | - handles UV coordinates, material |
|---|
| 21 | diffuse/ambient/specular/shininess values |
|---|
| 22 | - handle copying vertices at hard edges (like smoothing groups in Max) |
|---|
| 23 | - triangulates polygons using the ear-clipping method |
|---|
| 24 | - writes internal images in the .wings file into PNG format |
|---|
| 25 | - uses an own primitiev XML module, so no libxml2 dependency |
|---|
| 26 | |
|---|
| 27 | |
|---|
| 28 | USAGE |
|---|
| 29 | |
|---|
| 30 | Copy the .wings file to the directory containing the python files. Then |
|---|
| 31 | execute ./w2o.py <files> from the command line, eg: |
|---|
| 32 | |
|---|
| 33 | % tar -xzf wings-ogre-0.9.tar.gz |
|---|
| 34 | % cd wings-ogre-0.9 |
|---|
| 35 | % cp ~/models/test.wings |
|---|
| 36 | % ./w2o.py test.wings |
|---|
| 37 | |
|---|
| 38 | This will result in a .mesh.xml file. It has to be converted to a .mesh |
|---|
| 39 | via the the XML converter: |
|---|
| 40 | |
|---|
| 41 | % OgreXMLConverter test.mesh.xml |
|---|
| 42 | |
|---|
| 43 | The w2o.py program will also export internal Wings textures, using the name |
|---|
| 44 | of the material (not the name of the image) as filename. |
|---|
| 45 | |
|---|
| 46 | |
|---|
| 47 | REQUIREMENTS |
|---|
| 48 | |
|---|
| 49 | (These should be available on a recent Linux system) |
|---|
| 50 | |
|---|
| 51 | Python 2.2 |
|---|
| 52 | Python Imaging Library (for Image export) |
|---|
| 53 | |
|---|
| 54 | |
|---|
| 55 | TODO |
|---|
| 56 | |
|---|
| 57 | Speed things up. The exporter is terribly slow. This is mainly because |
|---|
| 58 | of the soft/hard edge detection stuff. |
|---|
| 59 | |
|---|
| 60 | |
|---|
| 61 | NOTES |
|---|
| 62 | |
|---|
| 63 | The xmlout module may be used using Temas's Blender exporter to remove |
|---|
| 64 | the libxml2 dependency. Don't use xmlout for anything more serious, though. |
|---|
| 65 | |
|---|
| 66 | |
|---|
| 67 | ACKNOWLEDGEMENTS |
|---|
| 68 | |
|---|
| 69 | The work of these people were particularily helpful for me: |
|---|
| 70 | |
|---|
| 71 | Thomas 'temas' Muldowney - the OGRE Blender exporter |
|---|
| 72 | Anthony D'Agostino - IO Suide for Blender |
|---|
| 73 | |
|---|
| 74 | |
|---|
| 75 | LINKS |
|---|
| 76 | |
|---|
| 77 | http://ogre.sf.net - OGRE homepage |
|---|
| 78 | |
|---|
| 79 | http://www.wings3d.org - Wings 3D homepage |
|---|
| 80 | |
|---|
| 81 | http://www.python.org - Python homepage |
|---|
| 82 | |
|---|
| 83 | http://www.pythonware.com/products/pil/ - Python Imaging Library homepage |
|---|
| 84 | |
|---|
| 85 | |
|---|
