From eef791e9a1469dbf496e79c2283f59a214245385 Mon Sep 17 00:00:00 2001 From: David 'Digit' Turner Date: Wed, 13 Jan 2010 16:50:57 -0800 Subject: [PATCH] Update documentation for OpenGL ES 1.0 / 1.1 / 2.0 --- ndk/docs/CHANGES.TXT | 7 ++++++- ndk/docs/STABLE-APIS.TXT | 27 +++++++++++++++++++++++++++ 2 files changed, 33 insertions(+), 1 deletion(-) diff --git a/ndk/docs/CHANGES.TXT b/ndk/docs/CHANGES.TXT index c6db521e8..e36a82f50 100644 --- a/ndk/docs/CHANGES.TXT +++ b/ndk/docs/CHANGES.TXT @@ -1,7 +1,7 @@ Android NDK ChangeLog: ------------------------------------------------------------------------------- -current version +android-ndk-r3 IMPORTANT BUG FIXES: @@ -70,6 +70,11 @@ IMPORTANT CHANGES: folder corresponding to the old ABI. +- Updated the STABLE-APIS.TXT document to clarify the OpenGL ES 1.0/1.1/2.0 + issues regarding specific devices (i.e. 1.0 supported everywhere, 1.1 and + 2.0 on specific devices only, need for tag in manifest). + + OTHER FIXES & CHANGES: - Actually use the awk version detected by host-setup.sh during the build. diff --git a/ndk/docs/STABLE-APIS.TXT b/ndk/docs/STABLE-APIS.TXT index 48e6b5aeb..0ffeb25e4 100644 --- a/ndk/docs/STABLE-APIS.TXT +++ b/ndk/docs/STABLE-APIS.TXT @@ -138,6 +138,29 @@ as in: LOCAL_LDLIBS := -lGLESv1_CM.so + +The '1.x' here refers to both versions 1.0 and 1.1 of the OpenGL ES APIs. +Please note that: + + - OpenGL ES 1.0 is supported on *all* Android-based devices. + - OpenGL ES 1.1 is fully supported only on specific devices that + have the corresponding GPU. + +This is because Android comes with a 1.0-capable software renderer that can +be used on GPU-less devices. + +Developers should query the OpenGL ES version string and extension string +to know if the current device supports the features they need. See the +description of glGetString() in the specification to see how to do that: + + http://www.khronos.org/opengles/sdk/1.1/docs/man/glGetString.xml + +Additionally, developers must put a tag in their manifest +file to indicate which version of OpenGL ES their application requires. See +the documentation linked below for details: + + http://developer.android.com/guide/topics/manifest/uses-feature-element.html + Please note that, at the moment, native headers and libraries for the EGL APIs are *not* available. EGL is used to perform surface creation and flipping (instead of rendering). The corresponding operations must be performed in your @@ -173,6 +196,10 @@ as in: LOCAL_LDLIBS := -lGLESv2.so +Not all devices support OpenGL ES 2.0, developers should thus query the +implementation's version and extension strings, and put a +tag in their Android manifest. See Section III above for details. + Please note that, at the moment, native headers and libraries for the EGL APIs are *not* available. EGL is used to perform surface creation and flipping (instead of rendering). The corresponding operations must be performed in your