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

Merge "Tweak SC#setExtendedRangeBrightness docs" into udc-dev

Browse Source
This commit is contained in:
John Reck
2023-04-21 16:34:51 +00:00
committed by Android (Google) Code Review
parent 45da791fd3 e77e0eb06b
commit bd60655abf
1 changed files with 13 additions and 9 deletions
Download Patch File Download Diff File Expand all files Collapse all files

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

@@ -3864,14 +3864,14 @@ public final class SurfaceControl implements Parcelable {
* 100 nits and a max display brightness of 200 nits, this should * 100 nits and a max display brightness of 200 nits, this should
* be set to 2.0f. * 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 * such as HLG or PQ, should also set this to 1.0f and instead
* communicate extended content brightness information via * communicate extended content brightness information via
* metadata such as CTA861_3 or SMPTE2086. * 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 * @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" * 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 * may not be able to, or may choose not to, deliver the
* requested range. * requested range.
* *
* If unspecified, the system will attempt to provide the best range * <p>While requesting a large desired ratio will result in the most
* it can for the given ambient conditions & device state. However, * dynamic range, voluntarily reducing the requested range can help
* voluntarily reducing the requested range can help improve battery * improve battery life as well as can improve quality by ensuring
* life as well as can improve quality by ensuring greater bit depth * greater bit depth is allocated to the luminance range in use.
* 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 * @return this
**/ **/
public @NonNull Transaction setExtendedRangeBrightness(@NonNull SurfaceControl sc, public @NonNull Transaction setExtendedRangeBrightness(@NonNull SurfaceControl sc,