Overlay: Add javadoc for why we fly overlays vertically.

Otherwise, apps overriding BitmapOverlay.getVertexTransformation may not
realize this is being done, and may ask why bitmaps are flipped vertically from
what they expect

Reference: #1128
PiperOrigin-RevId: 621544348

libraries/effect/src/main/java/androidx/media3/effect/BitmapOverlay.java

@@ -170,6 +170,12 @@ public int getTextureId(long presentationTimeUs) throws VideoFrameProcessingExce
     return lastTextureId;
   }
 
+  /**
+   * {@inheritDoc}
+   *
+   * <p>Flips the overlay vertically to convert between Android and OpenGL texture coordinate
+   * systems.
+   */
   @Override
   public float[] getVertexTransformation(long presentationTimeUs) {
     // Whereas the Android system uses the top-left corner as (0,0) of the