Transformer: Improve misc javadocs and exception logs.

PiperOrigin-RevId: 463971447
(cherry picked from commit 534740fd)

libraries/common/src/main/java/androidx/media3/common/C.java

@@ -1046,24 +1046,24 @@ public final class C {
 
 
   // LINT.IfChange(color_space)
   // LINT.IfChange(color_space)
   /**
   /**
-   * Video colorspaces. One of {@link Format#NO_VALUE}, {@link #COLOR_SPACE_BT709}, {@link
-   * #COLOR_SPACE_BT601} or {@link #COLOR_SPACE_BT2020}.
+   * Video colorspaces. One of {@link Format#NO_VALUE}, {@link #COLOR_SPACE_BT601}, {@link
+   * #COLOR_SPACE_BT709} or {@link #COLOR_SPACE_BT2020}.
    */
    */
   @UnstableApi
   @UnstableApi
   @Documented
   @Documented
   @Retention(RetentionPolicy.SOURCE)
   @Retention(RetentionPolicy.SOURCE)
   @Target(TYPE_USE)
   @Target(TYPE_USE)
-  @IntDef({Format.NO_VALUE, COLOR_SPACE_BT709, COLOR_SPACE_BT601, COLOR_SPACE_BT2020})
+  @IntDef({Format.NO_VALUE, COLOR_SPACE_BT601, COLOR_SPACE_BT709, COLOR_SPACE_BT2020})
   public @interface ColorSpace {}
   public @interface ColorSpace {}
   /**
   /**
-   * @see MediaFormat#COLOR_STANDARD_BT709
-   */
-  @UnstableApi public static final int COLOR_SPACE_BT709 = MediaFormat.COLOR_STANDARD_BT709;
-  /**
    * @see MediaFormat#COLOR_STANDARD_BT601_PAL
    * @see MediaFormat#COLOR_STANDARD_BT601_PAL
    */
    */
   @UnstableApi public static final int COLOR_SPACE_BT601 = MediaFormat.COLOR_STANDARD_BT601_PAL;
   @UnstableApi public static final int COLOR_SPACE_BT601 = MediaFormat.COLOR_STANDARD_BT601_PAL;
   /**
   /**
+   * @see MediaFormat#COLOR_STANDARD_BT709
+   */
+  @UnstableApi public static final int COLOR_SPACE_BT709 = MediaFormat.COLOR_STANDARD_BT709;
+  /**
    * @see MediaFormat#COLOR_STANDARD_BT2020
    * @see MediaFormat#COLOR_STANDARD_BT2020
    */
    */
   @UnstableApi public static final int COLOR_SPACE_BT2020 = MediaFormat.COLOR_STANDARD_BT2020;
   @UnstableApi public static final int COLOR_SPACE_BT2020 = MediaFormat.COLOR_STANDARD_BT2020;

libraries/common/src/main/java/androidx/media3/common/util/MediaFormatUtil.java

@@ -303,8 +303,8 @@ public final class MediaFormatUtil {
   /** Whether this is a valid {@link C.ColorSpace} instance. */
   /** Whether this is a valid {@link C.ColorSpace} instance. */
   private static boolean isValidColorSpace(int colorSpace) {
   private static boolean isValidColorSpace(int colorSpace) {
     // LINT.IfChange(color_space)
     // LINT.IfChange(color_space)
-    return colorSpace == C.COLOR_SPACE_BT709
-        || colorSpace == C.COLOR_SPACE_BT601
+    return colorSpace == C.COLOR_SPACE_BT601
+        || colorSpace == C.COLOR_SPACE_BT709
         || colorSpace == C.COLOR_SPACE_BT2020
         || colorSpace == C.COLOR_SPACE_BT2020
         || colorSpace == Format.NO_VALUE;
         || colorSpace == Format.NO_VALUE;
   }
   }

libraries/transformer/src/main/java/androidx/media3/transformer/DefaultCodec.java

@@ -24,6 +24,7 @@ import static androidx.media3.common.util.Util.SDK_INT;
 import android.content.Context;
 import android.content.Context;
 import android.media.MediaCodec;
 import android.media.MediaCodec;
 import android.media.MediaCodec.BufferInfo;
 import android.media.MediaCodec.BufferInfo;
+import android.media.MediaCrypto;
 import android.media.MediaFormat;
 import android.media.MediaFormat;
 import android.view.Surface;
 import android.view.Surface;
 import androidx.annotation.Nullable;
 import androidx.annotation.Nullable;
@@ -327,7 +328,7 @@ public final class DefaultCodec implements Codec {
           throw createTransformationException(
           throw createTransformationException(
               new IllegalStateException(
               new IllegalStateException(
                   "Codec output color format does not match configured color format. Configured: "
                   "Codec output color format does not match configured color format. Configured: "
-                      + configurationFormat.colorInfo
+                      + configuredOutputColor
                       + ". Actual: "
                       + ". Actual: "
                       + outputFormat.colorInfo));
                       + outputFormat.colorInfo));
         }
         }
@@ -445,6 +446,7 @@ public final class DefaultCodec implements Codec {
     return formatBuilder.build();
     return formatBuilder.build();
   }
   }
 
 
+  /** Calls and traces {@link MediaCodec#configure(MediaFormat, Surface, MediaCrypto, int)}. */
   private static void configureCodec(
   private static void configureCodec(
       MediaCodec codec,
       MediaCodec codec,
       MediaFormat mediaFormat,
       MediaFormat mediaFormat,
@@ -459,6 +461,7 @@ public final class DefaultCodec implements Codec {
     TraceUtil.endSection();
     TraceUtil.endSection();
   }
   }
 
 
+  /** Calls and traces {@link MediaCodec#start()}. */
   private static void startCodec(MediaCodec codec) {
   private static void startCodec(MediaCodec codec) {
     TraceUtil.beginSection("startCodec");
     TraceUtil.beginSection("startCodec");
     codec.start();
     codec.start();

libraries/transformer/src/main/java/androidx/media3/transformer/GlEffectsFrameProcessor.java

@@ -403,7 +403,7 @@ public final class GlEffectsFrameProcessor implements FrameProcessor {
   /**
   /**
    * Expands or shrinks the frame based on the {@link FrameInfo#pixelWidthHeightRatio} and returns a
    * Expands or shrinks the frame based on the {@link FrameInfo#pixelWidthHeightRatio} and returns a
    * new {@link FrameInfo} instance with scaled dimensions and {@link
    * new {@link FrameInfo} instance with scaled dimensions and {@link
-   * FrameInfo#pixelWidthHeightRatio} 1.
+   * FrameInfo#pixelWidthHeightRatio} of {@code 1}.
    */
    */
   private FrameInfo adjustForPixelWidthHeightRatio(FrameInfo frameInfo) {
   private FrameInfo adjustForPixelWidthHeightRatio(FrameInfo frameInfo) {
     if (frameInfo.pixelWidthHeightRatio > 1f) {
     if (frameInfo.pixelWidthHeightRatio > 1f) {