summaryrefslogtreecommitdiff
path: root/core/java/android/view/ViewRoot.java
diff options
context:
space:
mode:
authorRobert Carr <racarr@google.com>2021-05-05 13:22:57 -0700
committerRobert Carr <racarr@google.com>2021-05-05 14:28:25 -0700
commit599f912e4e3611ca5d537b6780c026bcf44e8395 (patch)
tree1c0e13a7bb3bc3796f30c9535d6b1f9bf66fa373 /core/java/android/view/ViewRoot.java
parent0e4d7f142b781bb6721c574592ba62a062bad183 (diff)
AttachedSurfaceControl: Respond to API feedback.
"Root" is eliminated from the interface name as it is a property of the object and not the interface, but remains highlighted in the getters to express the relationship between the called and returned object. Bug: 185365821 Test: Existing tests pass Change-Id: I163fc23f2c37c984ef3ffeb7514c4d8c1c1a3f90
Diffstat (limited to 'core/java/android/view/ViewRoot.java')
-rw-r--r--core/java/android/view/ViewRoot.java53
1 files changed, 0 insertions, 53 deletions
diff --git a/core/java/android/view/ViewRoot.java b/core/java/android/view/ViewRoot.java
deleted file mode 100644
index 3c755981a440..000000000000
--- a/core/java/android/view/ViewRoot.java
+++ /dev/null
@@ -1,53 +0,0 @@
-/*
- * Copyright (C) 2021 The Android Open Source Project
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- * http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- */
-package android.view;
-
-import android.annotation.NonNull;
-import android.annotation.Nullable;
-import android.annotation.UiThread;
-
-/**
- * Provides an interface to the root-Surface of a View Hierarchy or Window. This
- * is used in combination with the {@link android.view.SurfaceControl} API to enable
- * attaching app created SurfaceControl to the ViewRoot's surface hierarchy, and enable
- * SurfaceTransactions to be performed in sync with the ViewRoot drawing. This object
- * is obtained from {@link android.view.View#getViewRoot} and
- * {@link android.view.Window#getViewRoot}. It must be used from the UI thread of
- * the object it was obtained from.
- */
-@UiThread
-public interface ViewRoot {
- /**
- * Create a transaction which will reparent {@param child} to the ViewRoot. See
- * {@link SurfaceControl.Transaction#reparent}. This transacton must be applied
- * or merged in to another transaction by the caller, otherwise it will have
- * no effect.
- *
- * @param child The SurfaceControl to reparent.
- * @return A new transaction which performs the reparent operation when applied.
- */
- @Nullable SurfaceControl.Transaction buildReparentTransaction(@NonNull SurfaceControl child);
-
- /**
- * Consume the passed in transaction, and request the ViewRoot to apply it with the
- * next draw. This transaction will be merged with the buffer transaction from the ViewRoot
- * and they will show up on-screen atomically synced.
- *
- * This will not cause a draw to be scheduled, and if there are no other changes
- * to the View hierarchy you may need to call {@link android.view.View#invalidate}
- */
- boolean applyTransactionOnDraw(@NonNull SurfaceControl.Transaction t);
-}