|
@@ -1,18 +1,17 @@
|
|
|
Open Asset Import Library (assimp)
|
|
|
==================================
|
|
|
|
|
|
-Open Asset Import Library is a library to load various 3d file formats into a shared, in-memory format. It supports more than __40 file formats__ for import and a growing selection of file formats for export.
|
|
|
+Open Asset Import Library is a library that loads various 3D file formats into a shared, in-memory format. It supports more than __40 file formats__ for import and a growing selection of file formats for export.
|
|
|
|
|
|
### Current project status ###
|
|
|
[](https://opencollective.com/assimp)
|
|
|

|
|
|
[](https://www.codacy.com/gh/assimp/assimp/dashboard?utm_source=github.com&utm_medium=referral&utm_content=assimp/assimp&utm_campaign=Badge_Grade)
|
|
|
-[](https://gitter.im/assimp/assimp?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
|
|
|
[](http://isitmaintained.com/project/assimp/assimp "Average time to resolve an issue")
|
|
|
[](http://isitmaintained.com/project/assimp/assimp "Percentage of issues still open")
|
|
|
<br>
|
|
|
|
|
|
-APIs are provided for C and C++. There are various bindings to other languages (C#, Java, Python, Delphi, D). Assimp also runs on Android and iOS.
|
|
|
+APIs are provided for C and C++. Various bindings exist to other languages (C#, Java, Python, Delphi, D). Assimp also runs on Android and iOS.
|
|
|
Additionally, assimp features various __mesh post-processing tools__: normals and tangent space generation, triangulation, vertex cache locality optimization, removal of degenerate primitives and duplicate vertices, sorting by primitive type, merging of redundant materials and many more.
|
|
|
|
|
|
### Documentation ###
|
|
@@ -29,7 +28,7 @@ Clone [our model database](https://github.com/assimp/assimp-mdb).
|
|
|
- Find us on [https://discord.gg/s9KJfaem](https://discord.gg/kKazXMXDy2)
|
|
|
- Ask [the Assimp community on Reddit](https://www.reddit.com/r/Assimp/).
|
|
|
- Ask on [StackOverflow with the assimp-tag](http://stackoverflow.com/questions/tagged/assimp?sort=newest).
|
|
|
-- Nothing has worked? File a question or an issue-report at [The Assimp-Issue Tracker](https://github.com/assimp/assimp/issues)
|
|
|
+- Nothing has worked? File a question or an issue report at [The Assimp-Issue Tracker](https://github.com/assimp/assimp/issues)
|
|
|
|
|
|
#### Supported file formats ####
|
|
|
See [the complete list of supported formats](https://github.com/assimp/assimp/blob/master/doc/Fileformats.md).
|
|
@@ -46,7 +45,7 @@ Start by reading [our build instructions](https://github.com/assimp/assimp/blob/
|
|
|
* [Javascript/Node.js Interface](https://github.com/kovacsv/assimpjs)
|
|
|
* [Unity 3d Plugin](https://ricardoreis.net/trilib-2/)
|
|
|
* [Unreal Engine Plugin](https://github.com/irajsb/UE4_Assimp/)
|
|
|
-* [JVM](https://github.com/kotlin-graphics/assimp) Full jvm port (current [status](https://github.com/kotlin-graphics/assimp/wiki/Status))
|
|
|
+* [JVM](https://github.com/kotlin-graphics/assimp) Full JVM port (current [status](https://github.com/kotlin-graphics/assimp/wiki/Status))
|
|
|
* [HAXE-Port](https://github.com/longde123/assimp-haxe) The Assimp-HAXE-port.
|
|
|
* [Rust](https://github.com/jkvargas/russimp)
|
|
|
|
|
@@ -59,7 +58,7 @@ Open Asset Import Library is implemented in C++. The directory structure looks l
|
|
|
|
|
|
/code Source code
|
|
|
/contrib Third-party libraries
|
|
|
- /doc Documentation (doxysource and pre-compiled docs)
|
|
|
+ /doc Documentation (Doxygen source and pre-compiled docs)
|
|
|
/fuzz Contains the test code for the Google Fuzzer project
|
|
|
/include Public header C and C++ header files
|
|
|
/scripts Scripts are used to generate the loading code for some formats
|
|
@@ -79,7 +78,7 @@ The source code is organized in the following way:
|
|
|
code/AssetLib/<FormatName> Implementation for import and export of the format
|
|
|
|
|
|
### Contributing ###
|
|
|
-Contributions to assimp are highly appreciated. The easiest way to get involved is to submit
|
|
|
+I would greatly appreciate contributing to assimp. The easiest way to get involved is to submit
|
|
|
a pull request with your changes against the main repository's `master` branch.
|
|
|
|
|
|
## Contributors
|
|
@@ -101,7 +100,7 @@ Become a financial contributor and help us sustain our community. [[Contribute](
|
|
|
|
|
|
#### Organizations
|
|
|
|
|
|
-Support this project with your organization. Your logo will show up here with a link to your website. [[Contribute](https://opencollective.com/assimp/contribute)]
|
|
|
+You can support the project with your organization. Your logo will show up here with a link to your website. [[Contribute](https://opencollective.com/assimp/contribute)]
|
|
|
|
|
|
<a href="https://opencollective.com/assimp/organization/0/website"><img src="https://opencollective.com/assimp/organization/0/avatar.svg"></a>
|
|
|
|
|
@@ -111,6 +110,3 @@ Our license is based on the modified, __3-clause BSD__-License.
|
|
|
An _informal_ summary is: do whatever you want, but include Assimp's license text with your product -
|
|
|
and don't sue us if our code doesn't work. Note that, unlike LGPLed code, you may link statically to Assimp.
|
|
|
For the legal details, see the `LICENSE` file.
|
|
|
-
|
|
|
-### Why this name ###
|
|
|
-Sorry, we're germans :-), no English native speakers ...
|