Add support for upscale effect

Author: const-cloudinary

src/Transformation/Effect/Generative/GenerativeEffect.php

@@ -17,8 +17,9 @@ abstract class GenerativeEffect
 {
     const GENERATIVE_RECOLOR = 'gen_recolor';
     const GENERATIVE_REMOVE  = 'gen_remove';
-    const GENERATIVE_REPLACE  = 'gen_replace';
-    const GENERATIVE_RESTORE  = 'gen_restore';
+    const GENERATIVE_REPLACE = 'gen_replace';
+    const GENERATIVE_RESTORE = 'gen_restore';
+    const UPSCALE            = 'upscale';
 
     use GenerativeEffectTrait;
 }

src/Transformation/Effect/Generative/GenerativeEffectTrait.php

@@ -74,4 +74,15 @@ public static function generativeReplace($fromPrompt, $toPrompt, $preserveGeomet
     {
         return new GenerativeReplace($fromPrompt, $toPrompt, $preserveGeometry, $detectMultiple);
     }
+
+    /**
+     * Uses AI-based prediction to add fine detail while upscaling small images.
+     * This 'super-resolution' feature scales each dimension by four, multiplying the total number of pixels by 16.
+     *
+     * @return GenerativeEffectAction
+     */
+    public static function upscale()
+    {
+        return new GenerativeEffectAction(GenerativeEffect::UPSCALE);
+    }
 }

tests/Unit/Transformation/Image/GenerativeEffectTest.php

@@ -94,4 +94,12 @@ public function testGenerativeReplace()
             (string)Effect::generativeReplace('balloon', 'airplane')->preserveGeometry(false)->detectMultiple()
         );
     }
+
+    public function testGenerativeUpscale()
+    {
+        self::assertEquals(
+            'e_upscale',
+            (string)Effect::upscale()
+        );
+    }
 }