From 6ad394ac04da2bdc43a6493c24c7f7f7d3d158bf Mon Sep 17 00:00:00 2001
From: Chet Haase <chet@google.com>
Date: Tue, 5 Oct 2021 15:46:29 +0000
Subject: [PATCH] Updated Outline.offset() docs to clarify behavior

Bug: 202063656
Test: N/A, but added CTS sub-test for untested behavior
Change-Id: I86dc415879b23b92b9283c822094d4b811cd796f
---
 graphics/java/android/graphics/Outline.java | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/graphics/java/android/graphics/Outline.java b/graphics/java/android/graphics/Outline.java
index 5858e3988486c..b77865f423c6e 100644
--- a/graphics/java/android/graphics/Outline.java
+++ b/graphics/java/android/graphics/Outline.java
@@ -312,7 +312,10 @@ public final class Outline {
     }
 
     /**
-     * Offsets the Outline by (dx,dy)
+     * Offsets the Outline by (dx,dy). Offsetting is cumulative, so additional calls to
+     * offset() will add to previous offset values. Offset only applies to the current
+     * geometry (setRect(), setPath(), etc.); setting new geometry resets any existing
+     * offset.
      */
     public void offset(int dx, int dy) {
         if (mMode == MODE_ROUND_RECT) {