* 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
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
-iflag installs the libraries toout/android-release/, so this sample can find them. - The
-pflag andandroidargument choose Android as the platform to build for.