gles3jni is an Android C++ sample that demonstrates how to use OpenGL ES 3.0 from JNI/native code.
The sample can be built two different ways:
- Compatible with API level 11 and later [*1]
- Require API level 18 or later. Both versions include an OpenGL ES 2.0 fallback path for devices that don't support OpenGL ES 3.0.
The OpenGL ES 3.0 rendering path uses a few new features compared to the OpenGL ES 2.0 path:
- Instanced rendering and vertex attribute divisor to reduce the number of draw calls and uniform changes.
- Vertex array objects to reduce the number of calls required to set up vertex attribute state on each frame.
- Explicit assignment of attribute locations, eliminating the need to query assignments.
[*1] The only dependency on API level 11 is the call to setEGLContextClientVersion in GLES3JNIView. With a custom EGLConfigChooser and EGLContextFactory the sample would be compatible with older API levels.
- Android Studio 1.3+ with NDK bundle.
- Download Android Studio
- Launch Android Studio.
- Open the sample directory.
- Open File/Project Structure...
- Click Download or Select NDK location.
- Click Tools/Android/Sync Project with Gradle Files.
- Click Run/Run 'app'.
Optionally you can switch API level version with:
$ cp app/src/main/AndroidManifest-$N.xml app/src/main/AndroidManifest.xml
$ cp app/build-$N.gradle app/build.gradle
where $N
is the desired minSdkVersion: '11' or '18'.
If you've found an error in these samples, please file an issue.
Patches are encouraged, and may be submitted by forking this project and submitting a pull request through GitHub. Please see CONTRIBUTING.md for more details.
Copyright 2015 Google, Inc.
Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.