Explicitly state that SurfaceTexture is not a TextureView-only concept
Bug: 242347605
Test: none
Change-Id: Ia9359e933a1836930ae3d6f59c6a110717fa30c9
diff --git a/graphics/java/android/graphics/SurfaceTexture.java b/graphics/java/android/graphics/SurfaceTexture.java
index ee0d647..dfe5012 100644
--- a/graphics/java/android/graphics/SurfaceTexture.java
+++ b/graphics/java/android/graphics/SurfaceTexture.java
@@ -25,6 +25,7 @@
import android.os.Looper;
import android.os.Message;
import android.view.Surface;
+import android.view.TextureView;
import java.lang.ref.WeakReference;
@@ -44,6 +45,10 @@
* frames from the image stream to be sent to the SurfaceTexture object rather than to the device's
* display.
*
+ * <p>A typical pattern is to use SurfaceTexture to render frames to a {@link TextureView}; however,
+ * a TextureView is not <i>required</i> for using the texture object. The texture object may be used
+ * as part of an OpenGL ES shader.
+ *
* <p>When sampling from the texture one should first transform the texture coordinates using the
* matrix queried via {@link #getTransformMatrix(float[])}. The transform matrix may change each
* time {@link #updateTexImage} is called, so it should be re-queried each time the texture image