diff options
| author | 2023-04-21 16:34:51 +0000 | |
|---|---|---|
| committer | 2023-04-21 16:34:51 +0000 | |
| commit | bd60655abfd2dba6809e369a0ac1aacce3e37ee9 (patch) | |
| tree | 5e37418eaa1cfcd4e3553d9033f5c4e696305c27 | |
| parent | 45da791fd3764b03731baa8cd5a56b86c7bd9ecc (diff) | |
| parent | e77e0eb06be61ccb75c838ec41d63d6574265296 (diff) | |
Merge "Tweak SC#setExtendedRangeBrightness docs" into udc-dev
| -rw-r--r-- | core/java/android/view/SurfaceControl.java | 22 |
1 files changed, 13 insertions, 9 deletions
diff --git a/core/java/android/view/SurfaceControl.java b/core/java/android/view/SurfaceControl.java index 2fa03c5ba92e..99deac4c8cf4 100644 --- a/core/java/android/view/SurfaceControl.java +++ b/core/java/android/view/SurfaceControl.java @@ -3864,14 +3864,14 @@ public final class SurfaceControl implements Parcelable { * 100 nits and a max display brightness of 200 nits, this should * be set to 2.0f. * - * Default value is 1.0f. + * <p>Default value is 1.0f. * - * Transfer functions that encode their own brightness ranges, + * <p>Transfer functions that encode their own brightness ranges, * such as HLG or PQ, should also set this to 1.0f and instead * communicate extended content brightness information via * metadata such as CTA861_3 or SMPTE2086. * - * Must be finite && >= 1.0f + * <p>Must be finite && >= 1.0f * * @param desiredRatio The desired hdr/sdr ratio. This can be used to communicate the max * desired brightness range. This is similar to the "max luminance" @@ -3880,13 +3880,17 @@ public final class SurfaceControl implements Parcelable { * may not be able to, or may choose not to, deliver the * requested range. * - * If unspecified, the system will attempt to provide the best range - * it can for the given ambient conditions & device state. However, - * voluntarily reducing the requested range can help improve battery - * life as well as can improve quality by ensuring greater bit depth - * is allocated to the luminance range in use. + * <p>While requesting a large desired ratio will result in the most + * dynamic range, voluntarily reducing the requested range can help + * improve battery life as well as can improve quality by ensuring + * greater bit depth is allocated to the luminance range in use. * - * Must be finite && >= 1.0f + * <p>Default value is 1.0f and indicates that extended range brightness + * is not being used, so the resulting SDR or HDR behavior will be + * determined entirely by the dataspace being used (ie, typically SDR + * however PQ or HLG transfer functions will still result in HDR) + * + * <p>Must be finite && >= 1.0f * @return this **/ public @NonNull Transaction setExtendedRangeBrightness(@NonNull SurfaceControl sc, |