summaryrefslogtreecommitdiffstats
path: root/graphics/java
diff options
context:
space:
mode:
authorJamie Gennis <jgennis@google.com>2011-02-23 13:33:46 -0800
committerJamie Gennis <jgennis@google.com>2011-02-23 13:58:44 -0800
commitacf33974b3a870d904e662ae927947460c0d6b3f (patch)
tree21c0c7ed4ef49ea54719e0ad1b4f262541030af1 /graphics/java
parent16dc3073a2f06a77d9873e536f633a4adf575fce (diff)
downloadframeworks_base-acf33974b3a870d904e662ae927947460c0d6b3f.zip
frameworks_base-acf33974b3a870d904e662ae927947460c0d6b3f.tar.gz
frameworks_base-acf33974b3a870d904e662ae927947460c0d6b3f.tar.bz2
Expand on the SurfaceTexture API docs.
This change adds additional documentation explaining how a SurfaceTexture should be used in OpenGL ES. It describes some of the limitations of using the GL_TEXTURE_EXTERNAL_OES texture target. Change-Id: I9d3446a012376166b6c598b827a0aa0e9585d00f
Diffstat (limited to 'graphics/java')
-rw-r--r--graphics/java/android/graphics/SurfaceTexture.java8
1 files changed, 7 insertions, 1 deletions
diff --git a/graphics/java/android/graphics/SurfaceTexture.java b/graphics/java/android/graphics/SurfaceTexture.java
index 1fc2722..712cd1b 100644
--- a/graphics/java/android/graphics/SurfaceTexture.java
+++ b/graphics/java/android/graphics/SurfaceTexture.java
@@ -44,7 +44,13 @@ import android.os.Message;
* be done by transforming (1, 1, 0, 1).
*
* <p>The texture object uses the GL_TEXTURE_EXTERNAL_OES texture target, which is defined by the
- * OES_EGL_image_external OpenGL ES extension. This limits how the texture may be used.
+ * {@link http://www.khronos.org/registry/gles/extensions/OES/OES_EGL_image_external.txt
+ * GL_OES_EGL_image_external} OpenGL ES extension. This limits how the texture may be used. Each
+ * time the texture is bound it must be bound to the GL_TEXTURE_EXTERNAL_OES target rather than the
+ * GL_TEXTURE_2D target. Additionally, any OpenGL ES 2.0 shader that samples from the texture must
+ * declare its use of this extension using, for example, an "#extension GL_OES_EGL_image_external :
+ * require" directive. Such shaders must also access the texture using the samplerExternalOES GLSL
+ * sampler type.
*
* <p>SurfaceTexture objects may be created on any thread. {@link #updateTexImage} may only be
* called on the thread with the OpenGL ES context that contains the texture object. The