assimp/README

	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.