assimp/port/jassimp
Danke Xie 2e831604e9 Use SmartLocalRef to automatically release localrefs in jassimp.cpp
- Add SmartLocalRef class
- Use it to automatically delete localrefs of Java objects, generated
  by FindClass, createInstance, getField, NewStringUTF, etc.
- Tested with models with more than 512 nodes.
2015-12-19 01:30:02 -08:00
..
jassimp/src/jassimp Add new light type 'ambient' to match light.h 2015-11-15 16:49:39 -08:00
jassimp-native Use SmartLocalRef to automatically release localrefs in jassimp.cpp 2015-12-19 01:30:02 -08:00
README README: Add a few lines on how to compile jassimp-native 2014-12-06 15:53:56 +01:00
build.xml make use of travis languages, build java jar too. 2015-03-21 10:32:15 +01:00

README

jassimp
-------

Java binding for assimp.

The class model used by jassimp is not a one-to-one mapping of assimps class/
structure model (due to performance considerations). Please read the javadoc
descriptions of AiMesh and AiWrapperProvider.

The jassimp.lwjgl package contains a LWJGL specific wrapper provider and some
application examples using this wrapper



How To Build
------------

 I) native library, for example by issuing this command in jassimp-native/src:

    $ gcc jassimp.cpp -I/usr/lib/jvm/default/include/ \
      -I/usr/lib/jvm/default/include/linux -lassimp -shared -fPIC -o libjassimp.so

    libjassimp.so is required at runtime and must be located in java.library.path.

II) Java binding
    The java library is built using ant. Executing "ant" in the port/jassimp
    directory should be sufficient to build the library including docs. You
    still need to build the native library separately, see above
    
    The java build is configured to create java 1.6 classes



Limitations
-----------

Not all data imports have been tested yet, especially the countless texture
parameters. If you find bugs please report them.

jassimp supports most of assimps features. Current limitations are
* only importing scenes is supported. There are some methods that allow a
  modification of the returned objects, but these should be considered as
  work in progress. Full blown export support is planned for a future release 
* no support for mesh animations
* no support for embedded textures
* no support for importer configurations
* no support for the custom I/O API of assimp
* some texture related material properties are not exposed via the API but only 
  accessible by traversing the list of properties. However this limitation is
  also present in the c-API ...


License
-------

The license for jassimp is the same as the main Assimp license.