assimp.assimp

Open Asset Import Library (Assimp) Readme
-----------------------------------------

Here you can find information regarding Open Asset Import Library:

1. Overview
1.1 Supported file formats
1.2 File structure
2. Build the Asset Import Library
3. Help
4. License



1. Overview
1.1 Supported file formats

The Asset Import Library provides a lot of model formats:
- 3DS
- ASE
- DXF
- HMP
- MD2
- MD3
- MD5
- MDC
- MDL
- NFF
- PLY
- STL
- X
- LWO
- OBJ
- SMD

- Collada

- LWO

- Ogre XML

- partly LWS

- .. + many more, see http://assimp.sourceforge.net/main_features_formats.html for a full list.


1.2 Repository structure

Open Asset Import Library is implemented in C++ and provides a C-interface. The directory structure is:

/bin Binaries of the Asset Import Library.
/code Code of the Asset Import Library.
/contrib Third-party-libraries used by the Asset Import Library.
/doc Documentation (doxygen generated and data structure as a xml file)
/include Public headers.
/lib Static library location for Windows.
/obj Object file location for Windows.
/port Ports to other languages.

/test Unit- and regression tests, model test suite.
/tools Tools (viewer, command line `assimp`).
/workspaces Build enviroments for vc,xcode,...



2. Build the Asset Import Library

Take a look into the INSTALL file.



3. Help

For more help go to http://assimp.sourceforge.net/ (or, for germans, http://www.zfx.info). Or take a look into the doc-folder, which contains the doxygen-generated documentation in HTMl format (CHMs for Windows are as well contained in some distributions and located right here in the root folder).


4. License

The license of the Asset Import Library is based on the BSD-License. It is contained in the LICENSE file.