[ < ] | [ > ] | [ << ] | [ Up ] | [ >> ] | [Top] | [Contents] | [Index] | [ ? ] | [ Search: ] |
Assimp, the Open Asset Import Library, is an open source library providing a generic interface to load 3D models and scenes from a huge list of different file formats, including 3ds Max, Wavefront, LightWave, Blender, COLLADA, Milkshape.
This library can import the meshes, the material properties, the skeletal animations, the lights, cameras and complete scenes. The support for vertex and morph animations is planned but not yet implemented. The support for all these properties is quite good but may still vary depending on the file format used. Therefore, if the results are not good while using a given format, you may try to export to another format in order to test and see the difference.
The Assimp plugin that has been implemented in Crystal Space is integrated completely transparently into the CS loader system, meaning that it allows you to load any asset file of one of the format supported, just like if it was a file of the Crystal Space format, therefore without any further need to manipulate or import previously the file.
Technically speaking, the Assimp plugin implements the iBinaryLoaderPlugin
and iModelLoader
interfaces of Crystal Space, as any other CS-specific
loader plugin. Therefore, when the iLoader
or iThreadedLoader
are
used to load a file, the Assimp plugin will be selected if it supports the file
format. It will then analyze the file, and import the objects as genmeshes,
animeshes or whole scenes depending on the loader interface that was used.
If the iModelLoader
interface is used, then only one mesh will be created.
If there is any skeleton or animation defined, then the mesh will be an
Animesh, otherwise it will be a Genmesh.
If the iBinaryLoaderPlugin
is used, then a mesh factory will be created for all the
meshes defined in the file.
Additionally, if a mesh defined in the file contains points or line segments, then
an extra render mesh will be added to the main mesh (using
iMeshFactoryWrapper::AddExtraRenderMesh()
).
An example has been added in the ‘data’ directory with the ‘Seymour’ COLLADA animated test model. It is composed of one data file and one texture file that have been packed in a ZIP file in ‘CS/data/seymour.zip’. This model can be loaded in ‘viewmesh’ using the following command:
viewmesh -R=data/seymour.zip Seymour.dae
A problem that has been mentioned about the Assimp library is that it does not yet support the import of vertex and morph animations. To overcome this, some tools have been added to Crystal Space in order to load and merge an Animesh with its morph targets defined in several different files. See the dedicated section for more info on this.
By default, the Assimp plugin would report only error and warning messages. If you
want to access to more detailed reporting messages, you can use the iVerbosityManager
in order to enable the verbosity of the ‘assimpldr’ plugin. This can be made e.g.
at launch time, by adding the following command-line option to the call to your program:
-verbose=assimpldr
Additional messages are also reported when the Assim plugin has been compiled in the ‘Debug’ compilation mode.
[ < ] | [ > ] | [ << ] | [ Up ] | [ >> ] | [Top] | [Contents] | [Index] | [ ? ] |
This document was generated using texi2html 1.76.