source: OGRE/trunk/ogrenew/Tools/Wings3DExporter/README.txt @ 657

Revision 657, 2.0 KB checked in by mattausch, 19 years ago (diff)

added ogre dependencies and patched ogre sources

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