Document that getTransformMatrix can inset
Bug: 152621633
Test: none, docs only change
Change-Id: I4a357affdf698c8eb70ed7abbfa828586b2da0ec
diff --git a/graphics/java/android/graphics/SurfaceTexture.java b/graphics/java/android/graphics/SurfaceTexture.java
index 697daa8..cd878c5 100644
--- a/graphics/java/android/graphics/SurfaceTexture.java
+++ b/graphics/java/android/graphics/SurfaceTexture.java
@@ -307,6 +307,11 @@
* The matrix is stored in column-major order so that it may be passed directly to OpenGL ES via
* the glLoadMatrixf or glUniformMatrix4fv functions.
*
+ * If the underlying buffer has a crop associated with it, the transformation will also include
+ * a slight scale to cut off a 1-texel border around the edge of the crop. This ensures that
+ * when the texture is bilinear sampled that no texels outside of the buffer's valid region
+ * are accessed by the GPU, avoiding any sampling artifacts when scaling.
+ *
* @param mtx the array into which the 4x4 matrix will be stored. The array must have exactly
* 16 elements.
*/