diff --git a/library/transformer/src/main/java/com/google/android/exoplayer2/transformer/Transformer.java b/library/transformer/src/main/java/com/google/android/exoplayer2/transformer/Transformer.java
index 9011a76786..9a71853a25 100644
--- a/library/transformer/src/main/java/com/google/android/exoplayer2/transformer/Transformer.java
+++ b/library/transformer/src/main/java/com/google/android/exoplayer2/transformer/Transformer.java
@@ -139,6 +139,14 @@ public final class Transformer {
      * Listener#onFallbackApplied(Composition, TransformationRequest, TransformationRequest)} will
      * be invoked with the actual applied values.
      *
+     * <p>If {@link TransformationRequest#hdrMode} is set to {@link
+     * TransformationRequest#HDR_MODE_EXPERIMENTAL_FORCE_INTERPRET_HDR_AS_SDR} and an {@link
+     * #setAssetLoaderFactory AssetLoader.Factory} is set, {@link TransformationRequest#hdrMode}
+     * will be ignored. In this case, if the {@link AssetLoader.Factory} passed produces HDR data,
+     * it will be automatically {@linkplain
+     * TransformationRequest#HDR_MODE_TONE_MAP_HDR_TO_SDR_USING_MEDIACODEC tone mapped to SDR using
+     * MediaCodec}.
+     *
      * @param transformationRequest The {@link TransformationRequest}.
      * @return This builder.
      */