This python module allows you to read Wavefront 3D object files
(`something.obj` and `something.mtl`) and use them as Python objects.
Currently Pyglet is required to render and display these objects.
Currently, only a subset of [the defined
### From Python
meshes = pywavefront.Wavefront('something.obj')
### Example Script
There are two pyglet example scripts with included `.obj` and `.mtl` files in the `example` directory. To run them, change to the `example`
directory and run either `./pyglet_demo.py` or `.pyglet_demo2.py`.
### Generating a Wavefront file with Blender
The following presumes you are using [Blender](http://www.blender.org/) to generate your mesh:
* Using Blender, create a mesh with a UV-mapped texture. The UV-mapping is important! If it is working properly, you will see the texture applied within Blender's 3d view.
* Export the mesh from Blender using the Wavefront format, including normals.
* Reference your `*.obj` file as in the pywavefront example above.
### Source distribution
Assuming you are in the top-level PyWavefront directory:
python setup.py install
pip install PyWavefront
All tests can be found in the `test` directory. To run the tests:
* Install nose: `pip install nose`
* Change to the top-level directory, e.g. `PyWavefront`, the directory that contains this `README` file.
* Run `nosetests`
* Jerek Shoemaker
* Kurt Yoder
* Zohar Jackson
PyWavefront is BSD-licensed; see file `LICENSE`.
TODO: Brief introduction on what you do with files - including link to relevant help section.