From 64803940e6fcb1117200bc5a9f73982ffc311960 Mon Sep 17 00:00:00 2001 From: Leon Scroggins III Date: Mon, 20 Dec 2021 23:04:11 -0500 Subject: [PATCH] Update documentation for DISPLAY_DECORATION After some discussion, we've decided to always set the ScreenDecorations to DISPLAY_DECORATION. HWC can decide, based on the format, whether to truly treat it as DISPLAY_DECORATION, or to change to DEVICE composition. Update the documentation to reflect this change. See also I1da3199bacf5877e88876249c60c0a33fcd44c1e. Bug: 193170859 Test: NA Change-Id: I1fae74b360d1b9d79fc4afeab6f71089d4c8b7e5 --- .../hardware/graphics/composer3/Composition.aidl | 16 ++++++++++------ 1 file changed, 10 insertions(+), 6 deletions(-) diff --git a/graphics/composer/aidl/android/hardware/graphics/composer3/Composition.aidl b/graphics/composer/aidl/android/hardware/graphics/composer3/Composition.aidl index 4947463ba9..49cdffcf20 100644 --- a/graphics/composer/aidl/android/hardware/graphics/composer3/Composition.aidl +++ b/graphics/composer/aidl/android/hardware/graphics/composer3/Composition.aidl @@ -74,16 +74,20 @@ enum Composition { */ SIDEBAND = 5, /** - * A display decoration layer contains a buffer which is an 8 bit - * alpha mask. Pixels in the mask with an alpha of 0 (transparent) will - * show the content underneath, and pixels with an alpha of 255 will be - * be rendered in black. An alpha in between will show the content - * blended with black. This is useful, for example, to provide + * A display decoration layer contains a buffer which is used to provide * anti-aliasing on the cutout region/rounded corners on the top and * bottom of a display. * + * Pixels in the buffer with an alpha of 0 (transparent) will show the + * content underneath, and pixels with an alpha of 255 will be rendered in + * black. An alpha in between will show the underlying content blended with + * black. + * + * Some devices may support this flag with a buffer containing an 8 bit + * alpha mask. + * * Upon validateDisplay, the device may request a change from this type - * to CLIENT. + * to either DEVICE or CLIENT. */ DISPLAY_DECORATION = 6, }