summaryrefslogtreecommitdiff
path: root/libs/assimp/port/AndroidJNI/README.md
diff options
context:
space:
mode:
authorsanine <sanine.not@pm.me>2022-04-16 11:55:09 -0500
committersanine <sanine.not@pm.me>2022-04-16 11:55:09 -0500
commitdb81b925d776103326128bf629cbdda576a223e7 (patch)
tree58bea8155c686733310009f6bed7363f91fbeb9d /libs/assimp/port/AndroidJNI/README.md
parent55860037b14fb3893ba21cf2654c83d349cc1082 (diff)
move 3rd-party librarys into libs/ and add built-in honeysuckle
Diffstat (limited to 'libs/assimp/port/AndroidJNI/README.md')
-rw-r--r--libs/assimp/port/AndroidJNI/README.md32
1 files changed, 32 insertions, 0 deletions
diff --git a/libs/assimp/port/AndroidJNI/README.md b/libs/assimp/port/AndroidJNI/README.md
new file mode 100644
index 0000000..003b1da
--- /dev/null
+++ b/libs/assimp/port/AndroidJNI/README.md
@@ -0,0 +1,32 @@
+Build Asset Importer Lib for Android
+====================================
+This module provides a facade for the io-stream-access to files behind the android-asset-management within
+an Android-native application.
+- It is built as a static library
+- It requires Android NDK with android API > 9 support.
+
+### Building ###
+To use this module please provide following cmake defines:
+```
+-DASSIMP_ANDROID_JNIIOSYSTEM=ON
+-DCMAKE_TOOLCHAIN_FILE=$SOME_PATH/android.toolchain.cmake
+```
+
+"SOME_PATH" is a path to your cmake android toolchain script.
+
+
+The build script for this port is based on [android-cmake](https://github.com/taka-no-me/android-cmake).
+See its documentation for more Android-specific cmake options (e.g. -DANDROID_ABI for the target ABI).
+Check [Asset-Importer-Docs](https://assimp-docs.readthedocs.io/en/latest/) for more information.
+
+### Code ###
+A small example how to wrap assimp for Android:
+```cpp
+#include <assimp/port/AndroidJNI/AndroidJNIIOSystem.h>
+
+Assimp::Importer* importer = new Assimp::Importer();
+Assimp::AndroidJNIIOSystem *ioSystem = new Assimp::AndroidJNIIOSystem(app->activity);
+if ( nullptr != iosSystem ) {
+ importer->SetIOHandler(ioSystem);
+}
+```