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 use our Github-Project-Space, which you can find Here 

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.

 

Join us in the web

On twitter: @AssetImpLib

On facebook: The Assimp group on facebook

 

 Impressum 


Kim Kulling
Vilmring 24
23560 Luebeck

Contact:
Telephone: +49 451 / 5859083
e-Mail:       Diese E-Mail-Adresse ist vor Spambots geschützt! Zur Anzeige muss JavaScript eingeschaltet sein!
Website:    www.kimkulling.de

New feature poll on Patreon (2018-04-20)

There is a new poll on our Patreon-page. You can use it to priotize your most wanted feature, Just check Vote for the next features to get involved.

News from the FBX-front (2018-03-31)

In the last month we got a lot of pull-requests to get the FBX-importer more stable:

  • The animtion support got a lot of bug-fixes
  • There is an experimental exporter for binary-FBX-files on the current master
  • There is an ASCII-exporter for the FBX-format in the pipeline

The 3MF-support got some updates as well_

  • The meta-data of 3MF-files will now imported and exported
  • I made some bugfixes to get this more stable

 

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.