commit 6ee192f4e981845db5fdff127bf2ee990cd05dbf
author Chris Craik <ccraik@google.com> Tue May 17 14:29:10 2016 -0700
committer Chris Craik <ccraik@google.com> Tue May 17 16:17:25 2016 -0700
tree df0f7c92b4f42ba3246fe420bfd78f1059809dec
parent a7b826b08aa1b185b0e46b648e5c2ed7f818ae09

Document that SurfaceView is synchronous in N

bug:28821062

Change-Id: I1c17949d93de3d1f89c504fc061f7d20dd451a4d

core/java/android/view/SurfaceView.java

diff --git a/core/java/android/view/SurfaceView.java b/core/java/android/view/SurfaceView.java
index ccb5ec4..d59c8ac 100644
--- a/core/java/android/view/SurfaceView.java
+++ b/core/java/android/view/SurfaceView.java
@@ -82,6 +82,13 @@
  * and
  * {@link SurfaceHolder.Callback#surfaceDestroyed SurfaceHolder.Callback.surfaceDestroyed()}.
  * </ul>
+ *
+ * <p class="note"><strong>Note:</strong> Starting in platform version
+ * {@link android.os.Build.VERSION_CODES#N}, SurfaceView's window position is
+ * updated synchronously with other View rendering. This means that translating
+ * and scaling a SurfaceView on screen will not cause rendering artifacts. Such
+ * artifacts may occur on previous versions of the platform when its window is
+ * positioned asynchronously.</p>
  */
 public class SurfaceView extends View {
     static private final String TAG = "SurfaceView";