Add note recommending OpenGL tone-mapping

PiperOrigin-RevId: 547192957
This commit is contained in:
andrewlewis 2023-07-11 16:08:39 +01:00 committed by Rohit Singh
parent 5c8b142174
commit fcadecf2b1

View File

@ -173,7 +173,10 @@ public final class Composition {
/**
* Sets the {@link HdrMode} for HDR video input.
*
* <p>The default value is {@link #HDR_MODE_KEEP_HDR}.
* <p>The default value is {@link #HDR_MODE_KEEP_HDR}. Apps that need to tone-map HDR to SDR
* should generally prefer {@link #HDR_MODE_TONE_MAP_HDR_TO_SDR_USING_OPEN_GL} over {@link
* HDR_MODE_TONE_MAP_HDR_TO_SDR_USING_MEDIACODEC}, because its behavior is likely to be more
* consistent across devices.
*
* @param hdrMode The {@link HdrMode} used.
* @return This builder.