Android/frameworks_base
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Merge "Add more docs per API council feedback"

Browse Source
This commit is contained in:
TreeHugger Robot
2022-02-11 02:25:05 +00:00
committed by Android (Google) Code Review
parent 883aa9870d a96a6df156
commit fca54fd47e
2 changed files with 16 additions and 4 deletions
Download Patch File Download Diff File Expand all files Collapse all files

3
core/java/android/hardware/HardwareBuffer.java
View File

@@ -131,7 +131,8 @@ public final class HardwareBuffer implements Parcelable, AutoCloseable {
/** Usage: The buffer will be written to by the GPU */
public static final long USAGE_GPU_COLOR_OUTPUT = 1 << 9;
/**
* The buffer will be used as a composer HAL overlay layer.
* The buffer will be used as a hardware composer overlay layer. That is, it will be displayed
* using the system compositor via {@link SurfaceControl}
*
* This flag is currently only needed when using
* {@link android.view.SurfaceControl.Transaction#setBuffer(SurfaceControl, HardwareBuffer)}

17
core/java/android/view/SurfaceControl.java
View File

@@ -3700,21 +3700,32 @@ public final class SurfaceControl implements Parcelable {
/**
* Sets the buffer transform that should be applied to the current buffer.
*
* This can be used in combination with
* {@link AttachedSurfaceControl#addOnBufferTransformHintChangedListener(AttachedSurfaceControl.OnBufferTransformHintChangedListener)}
* to pre-rotate the buffer for the current display orientation. This can
* improve the performance of displaying the associated buffer.
*
* @param sc The SurfaceControl to update
* @param transform The transform to apply to the buffer.
* @return this
*/
public @NonNull Transaction setBufferTransform(@NonNull SurfaceControl sc,
/* TODO: Mark the intdef */ int transform) {
@SurfaceControl.BufferTransform int transform) {
checkPreconditions(sc);
nativeSetBufferTransform(mNativeObject, sc.mNativeObject, transform);
return this;
}
/**
* Updates the region for the content on this surface updated in this transaction.
* Updates the region for the content on this surface updated in this transaction. The
* damage region is the area of the buffer that has changed since the previously
* sent buffer. This can be used to reduce the amount of recomposition that needs
* to happen when only a small region of the buffer is being updated, such as for
* a small blinking cursor or a loading indicator.
*
* If unspecified, the complete surface is assumed to be damaged.
* @param sc The SurfaceControl on which to set the damage region
* @param region The region to set. If null, the entire buffer is assumed dirty. This is
* equivalent to not setting a damage region at all.
*/
public @NonNull Transaction setDamageRegion(@NonNull SurfaceControl sc,
@Nullable Region region) {