README 1.8 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556
  1. jassimp
  2. -------
  3. Java binding for assimp.
  4. The class model used by jassimp is not a one-to-one mapping of assimps class/
  5. structure model (due to performance considerations). Please read the javadoc
  6. descriptions of AiMesh and AiWrapperProvider.
  7. The jassimp.lwjgl package contains a LWJGL specific wrapper provider and some
  8. application examples using this wrapper
  9. How To Build
  10. ------------
  11. I) native library, for example by issuing this command in jassimp-native/src:
  12. $ gcc jassimp.cpp -I/usr/lib/jvm/default/include/ \
  13. -I/usr/lib/jvm/default/include/linux -lassimp -shared -fPIC -o libjassimp.so
  14. libjassimp.so is required at runtime and must be located in java.library.path.
  15. II) Java binding
  16. The java library is built using ant. Executing "ant" in the port/jassimp
  17. directory should be sufficient to build the library including docs. You
  18. still need to build the native library separately, see above
  19. The java build is configured to create java 1.6 classes
  20. Limitations
  21. -----------
  22. Not all data imports have been tested yet, especially the countless texture
  23. parameters. If you find bugs please report them.
  24. jassimp supports most of assimps features. Current limitations are
  25. * only importing scenes is supported. There are some methods that allow a
  26. modification of the returned objects, but these should be considered as
  27. work in progress. Full blown export support is planned for a future release
  28. * no support for mesh animations
  29. * no support for embedded textures
  30. * no support for importer configurations
  31. * some texture related material properties are not exposed via the API but only
  32. accessible by traversing the list of properties. However this limitation is
  33. also present in the c-API ...
  34. License
  35. -------
  36. The license for jassimp is the same as the main Assimp license.