Loading core/java/android/view/SurfaceControl.java +13 −9 Original line number Original line Diff line number Diff line Loading @@ -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" Loading @@ -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, Loading Loading
core/java/android/view/SurfaceControl.java +13 −9 Original line number Original line Diff line number Diff line Loading @@ -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" Loading @@ -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, Loading
