c581b755fd
* WIP Add helper to upload Android bitmaps to textures * Add missing file * Pass custom constants for bitmap formats * Add sample app for texturing * Update the README for samples * Rename variable from callback to autoBitmap
52 lines
2.1 KiB
Markdown
52 lines
2.1 KiB
Markdown
# Filament sample Android apps
|
|
|
|
This directory contains several sample Android applications that demonstrate how to use the
|
|
Filament APIs:
|
|
|
|
- `hello-triangle`: Minimal example showing how to setup a rendering surface for Filament
|
|
- `lit-cube`: Shows how to create a light and a mesh with the attributes required for lighting
|
|
- `image-based-lighting`: Demonstrates how to create image-based lights and load complex meshes
|
|
- `textured-object`: Demonstrates how to load and use textures for complex materials
|
|
|
|
## Prerequisites
|
|
|
|
Before you start, make sure to read [Filament's README](../../README.md). You need to be able to
|
|
compile Filament's native library and Filament's AAR for this project. The easiest way to proceed
|
|
is to install all the required dependencies and to run the following commands at the root of the
|
|
source tree:
|
|
|
|
```
|
|
$ ./build.sh -p desktop -i release
|
|
$ ./build.sh -p android release
|
|
```
|
|
|
|
This will build all the native components and the AAR required by this sample application.
|
|
|
|
If you do not use the build script, you must set the `filament_tools_dir` property when invoking
|
|
Gradle, either from the command line or from `local.properties`. This property must point to the
|
|
distribution/install directory for desktop (produced by make/ninja install). This directory must
|
|
contain `bin/matc` and `bin/cmgen`.
|
|
|
|
Example:
|
|
```
|
|
$ ./gradlew -Pfilament_tools_dir=../../dist-release assembleDebug
|
|
```
|
|
|
|
## Important: SDK location
|
|
|
|
|
|
Either ensure your `ANDROID_HOME` environment variable is set or make sure each project contains a
|
|
`local.properties` file with the `sdk.dir` property pointing to your installation of the Android
|
|
SDK. This includes the project `filament-android` in the parent directory.
|
|
|
|
## Android Studio
|
|
|
|
Due to issues with composite builds in Android Studio 3.1, it is highly recommended to use
|
|
Android Studio 3.2 or higher to open this project.
|
|
|
|
## Compiling
|
|
|
|
To compile and run each sample make sure you have selected the appropriate build variant
|
|
(arm7, arm8, x86 or x86_64). If you are not sure you can simply select the "universal"
|
|
variant which includes all the other ones.
|