Files
filament/android/samples/sample-material-builder
Mathias Agopian 1b36f82c1e API BREAKAGE: this change aims to fix multi-view support (#2376)
* API BREAKAGE: this change aims to fix multi-view support


What has changed:
- View doesn't have a notion of clear color anymore
- View doesn't have a notion of discard flags anymore
- The clear color and color-buffer discard/clear flags are moved to Renderer
- Skybox can now be set to a constant color
- View have a blend-mode

What does is all mean:
"Clearing" (i.e.) setting its background is now handled by Skybox, by
setting a constant color to the Skybox. This should take care of
drawing views side by side.

When a view needs to be drawn on top of another, it's BlendMode needs to
be set to TRANSLUCENT and of course and, generally, it wither won't have
a skybox, or will have one that sets some translucent pixels.

As an optimization, a View with BlendMode::OPAQUE will have its
background cleared with the color specified in Renderer.

If the SwapChain already has some content, it's now possible to set
the Renderer to not discard the content, together with TRANSLUCENT views,
it's possible to draw on top of that content.


It is NOT possible to share depth/stencil buffers between views.

Fixes: #2369, #2372, #2364

* Address reviewers comments.

Note: WebGL is still broken with this PR
2020-04-10 15:54:14 -07:00
..

Android material-builder Sample

The material-builder sample shows how to generate materials programatically on the device as opposed to with the matc tool on the host machine. The cost is a binary size increase of your app due to the relatively larger size of the filamat library.

The buildMaterial method inside MainActivity.kt uses a MaterialBuilder() instance to compile a material package whose payload is sent to the engine where it is applied towards the Renderable.

Before building

The filamat static library is needed to fascilitate material building on the device. Compiling the library is slower and thus it is not built by the default build.sh command. To build, add the -l flag to the build.sh command:

./build.sh -i -p android release

Explanation of flags:

  • The -i flag installs the libraries to out/android-release/, so this sample can find them.
  • The -p flag and android argument choose Android as the platform to build for.