HOW TO GET BASIC SHAPES (SPHERE, CUBE, ...) EASILY
You can simply use the NFF (Neutral File Format) for this task. NFF is quite a simple, text-based format that allows you to create spheres, cones and cylinders with just a single line. To get a sphere with position (x,y,z) and radius r, use a file with this contents:

testsphere.nff

--- begin of file
s x y z r
--- end of file

The full specification of the NFF format can be found here. However, ASSIMP extends this specification and supports more basic shapes, including all platonic solids ('#' starts a comment line):
testplatonicsolids.nff

--- begin of file
# A tetrahedron at -10 0 0 with a 'radius' of 2
tet -10 0 0 2
# A cube at -7 0 0 with a 'radius' (a/2) of 2
hex -7 0 0 2
# An octahedron at -4 0 0 with a 'radius' of 2
hex -4 0 0 2
# A dodecahedron at -1 0 0 with a 'radius' (a/2) of 2
hex -1 0 0 2
# An icosahedron at 2 0 0 with a 'radius' (a/2) of 2
# This is a non-tesselated sphere. 'tess' sets the number of subdivisions.
# The default value for spheres is 4.
tess 0 s 2 0 0 2
--- end of file
(the 'radius' is the radius of the respective circumscribed sphere)

ASSIMP - Frequently Asked Questions (FAQ)

Am I allowed to use the library in a commercial product?


Yes. ASSIMP is licensed under a modified BSD license. Its contents in just one sentence: you may use the library for free, in commercial or non-commercial applications, but you must include our license with your product and you may not advertise with us.

Does ASSIMP depend on D3D(X)?

No. AssimpView does (it uses D3D9 for rendering).

Is ASSIMP able to export models?

Yes (as of 2013). Due to popular demand, assimp now supports an export API that is similar to the import side. Supported file formats include Obj, X, Collada, STL and more.

For which languages is the API provided?

The ASSIMP API is provided both as a plain-C interface and as an object-oriented C++ interface, which is the main API. All ports (jAssimp, Assimp.net, ...) and even the C-style API are just wrappers around this interface. Therefore, if your project allows the use of C++, you should use the C++-API.

Is this library thread-safe?

Yes. ASSIMP is completely thread-safe, as long as you create an extra 'Importer' instance for each thread. The C-API and all ports are doing this automatically for you. There are some restrictions regarding thread-safety with the -noboost workaround, don't forget to read the corresponding doc sections!

Why is it so slow?

Probably because of a excessively-validating STL implementation. There's a section in the documentation which describes how to fine-tune the performance of Microsoft's STL implementation and also another to promote STLport as a good and fast alternative. Oh yes, and try a release build with full optimizations turned on first.

Can I write a new loader for the library?

Sure, as long as you're able to write stable code and the format is not too exotic ... We'd highly appreciate any help. Why are you still reading this? Come on, start coding! :-) AssimpView complains about a missing d3dx9_3n.dll
The latest DirectX Runtimes should solve the problem.

Are you guys crazy or how did you come up with that name?

We think it's a good name, although the pun was merely unintentional. Really.

Who are you, the guys behind this library?

We are mostly professional software engineers, but not in the games industry. It's just a hobby. So far we have not much spare time. Any assistance (e.g. new loaders, bugfixes) is highly appreciated.

FEEDBACK/DISCUSS

Please post feature requests and bug reports on our mailing list, which can be found here .
Alternatively you can also use our Project Forums.

 

CONSULTING

Occasionally, we do offer consulting for Assimp related stuff. If you might need our help to integrate Assimp into your project, or if you want to sponsor Assimp development (i.e. add a particular feature), please get into touch with Kim and we'll see if we can do it.



CHAT VIA GITTER

And we also have an Gitter-channel at github. You can easily join us via: Gitter-Chat.

 

 

DEVELOPERS 

(Spambot, die!  Underlined characters are not part of the mail address.)

Alexander Gessler Github 
Aramis' mail address


Thomas Schulze Website
Schrompf' mail address


Kim Kulling WebsiteGithub
Kimmi's mail address


David Nadlinger 
Klickverbot's mail address

( D bindings )

 


Other maintainers: including Matthias Gubisch (C# bindings), Jonathan Klein (Ogre XML), Mark Sibly (B3D). The best strategy to find out who's responsible for a particular port or importer is to either ask on the ML, or to check the commit log.

Over time, a lot of people contributed to Assimp. A full list can be found in the CREDITS file.

A new website ( 2018-02-03 )

To make life easier for me I satrted to use Joomble for the Asset-Importer-Lib website. To get things running I just copied all the old content to this. In the next months I will add some more content. Feel free to give any feedback.

I am not a good web-designer :-) ...

 

The Assimp-Blog ( 2018-01-20 )

Here I will give you some updates about the latest changes in Asset-Importer-Lib.

LICENSE

Assimp is released as Open Source under the terms of a 3-clause BSD license.




Copyright (c) 2006-2015 assimp team
All rights reserved.

Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:

  • Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.
  • Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.
  • Neither the name of the assimp team nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission.

THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.




An exception applies to all test models in Assimp's repository. They're generally free for testing and private use, but not necessarily for commercial use. There's usually an accompanying info file containing detailed license information.