From 78c419e566dc929c34428e4977e4b1071837dd27 Mon Sep 17 00:00:00 2001
From: tofunmi <tofunmi@google.com>
Date: Fri, 12 Jan 2024 04:50:24 -0800
Subject: [PATCH] Extension to Gaussian Blur: support changing blur over time

PiperOrigin-RevId: 597809380
---
 .../media3/effect/GaussianBlurTest.java       |  24 ++++++++++++++++++
 .../androidx/media3/effect/GaussianBlur.java  |   3 +--
 .../media3/effect/GaussianFunction.java       |  19 ++++++++++++++
 .../media3/effect/SeparableConvolution.java   |   8 ++++--
 .../SeparableConvolutionShaderProgram.java    |  23 +++++++++++------
 .../bitmap/GaussianBlurTest/pts_71000.png     | Bin 0 -> 8635 bytes
 6 files changed, 65 insertions(+), 12 deletions(-)
 create mode 100644 libraries/test_data/src/test/assets/media/bitmap/GaussianBlurTest/pts_71000.png

diff --git a/libraries/effect/src/androidTest/java/androidx/media3/effect/GaussianBlurTest.java b/libraries/effect/src/androidTest/java/androidx/media3/effect/GaussianBlurTest.java
index bb2cd74f1f..c967e0f225 100644
--- a/libraries/effect/src/androidTest/java/androidx/media3/effect/GaussianBlurTest.java
+++ b/libraries/effect/src/androidTest/java/androidx/media3/effect/GaussianBlurTest.java
@@ -99,4 +99,28 @@ public class GaussianBlurTest {
     assertThat(actualPresentationTimesUs).containsExactly(32_000L);
     getAndAssertOutputBitmaps(textureBitmapReader, actualPresentationTimesUs, testId, ASSET_PATH);
   }
+
+  @Test
+  @RequiresNonNull({"textureBitmapReader", "testId"})
+  public void gaussianBlur_sigmaChangesWithTime_differentFramesHaveDifferentBlurs()
+      throws Exception {
+    ImmutableList<Long> frameTimesUs = ImmutableList.of(32_000L, 71_000L);
+    ImmutableList<Long> actualPresentationTimesUs =
+        generateAndProcessFrames(
+            BLANK_FRAME_WIDTH,
+            BLANK_FRAME_HEIGHT,
+            frameTimesUs,
+            new SeparableConvolution() {
+              @Override
+              public ConvolutionFunction1D getConvolution(long presentationTimeUs) {
+                return new GaussianFunction(
+                    presentationTimeUs < 40_000L ? 5f : 20f, /* numStandardDeviations= */ 2.0f);
+              }
+            },
+            textureBitmapReader,
+            TEXT_SPAN_CONSUMER);
+
+    assertThat(actualPresentationTimesUs).containsExactly(32_000L, 71_000L);
+    getAndAssertOutputBitmaps(textureBitmapReader, actualPresentationTimesUs, testId, ASSET_PATH);
+  }
 }
diff --git a/libraries/effect/src/main/java/androidx/media3/effect/GaussianBlur.java b/libraries/effect/src/main/java/androidx/media3/effect/GaussianBlur.java
index c7a699dba0..e4c2e06939 100644
--- a/libraries/effect/src/main/java/androidx/media3/effect/GaussianBlur.java
+++ b/libraries/effect/src/main/java/androidx/media3/effect/GaussianBlur.java
@@ -51,11 +51,10 @@ public final class GaussianBlur extends SeparableConvolution {
    */
   public GaussianBlur(float sigma) {
     this(sigma, /* numStandardDeviations= */ 2.0f);
-    ;
   }
 
   @Override
-  public ConvolutionFunction1D getConvolution() {
+  public ConvolutionFunction1D getConvolution(long presentationTimeUs) {
     return new GaussianFunction(sigma, numStandardDeviations);
   }
 }
diff --git a/libraries/effect/src/main/java/androidx/media3/effect/GaussianFunction.java b/libraries/effect/src/main/java/androidx/media3/effect/GaussianFunction.java
index 5eeec38439..0cffa35c0d 100644
--- a/libraries/effect/src/main/java/androidx/media3/effect/GaussianFunction.java
+++ b/libraries/effect/src/main/java/androidx/media3/effect/GaussianFunction.java
@@ -21,7 +21,9 @@ import static java.lang.Math.exp;
 import static java.lang.Math.sqrt;
 
 import androidx.annotation.FloatRange;
+import androidx.annotation.Nullable;
 import androidx.media3.common.util.UnstableApi;
+import java.util.Objects;
 
 /**
  * Implementation of a symmetric Gaussian function with a limited domain.
@@ -68,4 +70,21 @@ public final class GaussianFunction implements ConvolutionFunction1D {
     return (float)
         (exp(-samplePositionOverSigma * samplePositionOverSigma / 2) / sqrt(2 * PI) / sigma);
   }
+
+  @Override
+  public boolean equals(@Nullable Object o) {
+    if (this == o) {
+      return true;
+    }
+    if (!(o instanceof GaussianFunction)) {
+      return false;
+    }
+    GaussianFunction that = (GaussianFunction) o;
+    return Float.compare(that.sigma, sigma) == 0 && Float.compare(that.numStdDev, numStdDev) == 0;
+  }
+
+  @Override
+  public int hashCode() {
+    return Objects.hash(sigma, numStdDev);
+  }
 }
diff --git a/libraries/effect/src/main/java/androidx/media3/effect/SeparableConvolution.java b/libraries/effect/src/main/java/androidx/media3/effect/SeparableConvolution.java
index 1fd760bd96..2cf51f5db6 100644
--- a/libraries/effect/src/main/java/androidx/media3/effect/SeparableConvolution.java
+++ b/libraries/effect/src/main/java/androidx/media3/effect/SeparableConvolution.java
@@ -46,8 +46,12 @@ public abstract class SeparableConvolution implements GlEffect {
     this.scaleFactor = scaleFactor;
   }
 
-  /** Returns a {@linkplain ConvolutionFunction1D 1D convolution function}. */
-  public abstract ConvolutionFunction1D getConvolution();
+  /**
+   * Returns a {@linkplain ConvolutionFunction1D 1D convolution function}.
+   *
+   * @param presentationTimeUs The presentation timestamp of the input frame, in microseconds.
+   */
+  public abstract ConvolutionFunction1D getConvolution(long presentationTimeUs);
 
   @Override
   public GlShaderProgram toGlShaderProgram(Context context, boolean useHdr)
diff --git a/libraries/effect/src/main/java/androidx/media3/effect/SeparableConvolutionShaderProgram.java b/libraries/effect/src/main/java/androidx/media3/effect/SeparableConvolutionShaderProgram.java
index 70ace03a9c..1b2b7aeab9 100644
--- a/libraries/effect/src/main/java/androidx/media3/effect/SeparableConvolutionShaderProgram.java
+++ b/libraries/effect/src/main/java/androidx/media3/effect/SeparableConvolutionShaderProgram.java
@@ -34,6 +34,7 @@ import com.google.common.util.concurrent.MoreExecutors;
 import java.io.IOException;
 import java.nio.ShortBuffer;
 import java.util.concurrent.Executor;
+import org.checkerframework.checker.nullness.qual.MonotonicNonNull;
 
 /**
  * A {@link GlShaderProgram} for performing separable convolutions.
@@ -87,6 +88,7 @@ import java.util.concurrent.Executor;
   private float functionLutCenterX;
   private float functionLutDomainStart;
   private float functionLutWidth;
+  private @MonotonicNonNull ConvolutionFunction1D lastConvolutionFunction;
 
   /**
    * Creates an instance.
@@ -108,11 +110,12 @@ import java.util.concurrent.Executor;
     inputListener = new InputListener() {};
     outputListener = new OutputListener() {};
     errorListener = (frameProcessingException) -> {};
-
     errorListenerExecutor = MoreExecutors.directExecutor();
     lastInputSize = Size.ZERO;
     intermediateSize = Size.ZERO;
     outputSize = Size.ZERO;
+    lastConvolutionFunction = null;
+
     try {
       glProgram = new GlProgram(context, VERTEX_SHADER_PATH, FRAGMENT_SHADER_PATH);
       sharpTransformGlProgram =
@@ -160,7 +163,7 @@ import java.util.concurrent.Executor;
             + " first.");
     try {
       ensureTexturesAreConfigured(
-          glObjectsProvider, new Size(inputTexture.width, inputTexture.height));
+          glObjectsProvider, new Size(inputTexture.width, inputTexture.height), presentationTimeUs);
       outputTextureInUse = true;
       renderHorizontal(inputTexture);
       renderVertical();
@@ -269,10 +272,15 @@ import java.util.concurrent.Executor;
     renderOnePass(intermediateTexture.texId, /* isHorizontal= */ false);
   }
 
-  private void ensureTexturesAreConfigured(GlObjectsProvider glObjectsProvider, Size inputSize)
+  private void ensureTexturesAreConfigured(
+      GlObjectsProvider glObjectsProvider, Size inputSize, long presentationTimeUs)
       throws GlUtil.GlException {
-    // Always update the function texture, as it could change on each render cycle.
-    updateFunctionTexture(glObjectsProvider);
+    ConvolutionFunction1D currentConvolutionFunction =
+        convolution.getConvolution(presentationTimeUs);
+    if (!currentConvolutionFunction.equals(lastConvolutionFunction)) {
+      updateFunctionTexture(glObjectsProvider, currentConvolutionFunction);
+      lastConvolutionFunction = currentConvolutionFunction;
+    }
 
     // Only update intermediate and output textures if the size changes.
     if (inputSize.equals(lastInputSize)) {
@@ -295,11 +303,10 @@ import java.util.concurrent.Executor;
    * Creates a function lookup table for the convolution, and stores it in a 16b floating point
    * texture for GPU access.
    */
-  private void updateFunctionTexture(GlObjectsProvider glObjectsProvider)
+  private void updateFunctionTexture(
+      GlObjectsProvider glObjectsProvider, ConvolutionFunction1D convolutionFunction)
       throws GlUtil.GlException {
 
-    ConvolutionFunction1D convolutionFunction = convolution.getConvolution();
-
     int lutRasterSize =
         (int)
             Math.ceil(
diff --git a/libraries/test_data/src/test/assets/media/bitmap/GaussianBlurTest/pts_71000.png b/libraries/test_data/src/test/assets/media/bitmap/GaussianBlurTest/pts_71000.png
new file mode 100644
index 0000000000000000000000000000000000000000..fbcd00b8857f7f750e2d087d21f041cbdbf57123
GIT binary patch
literal 8635
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
N002ovPDHLkV1j<Bhw=ab

literal 0
HcmV?d00001