From c5ad95c2c3f22214b68817951e4c24e5bda72266 Mon Sep 17 00:00:00 2001
From: Oliver Vogel <oliver@olivervogel.com>
Date: Sun, 31 Dec 2023 18:19:30 +0100
Subject: [PATCH] Add specializable decoders

---
 src/Decoders/AbstractDecoder.php      | 16 ++++++++++++++++
 src/Decoders/FilePathImageDecoder.php |  7 +++++++
 src/Drivers/AbstractDecoder.php       |  2 +-
 src/Drivers/AbstractDriver.php        |  5 +++++
 src/Drivers/Gd/Driver.php             |  4 ++--
 src/ImageManager.php                  |  1 +
 src/Interfaces/DriverInterface.php    |  3 ++-
 7 files changed, 34 insertions(+), 4 deletions(-)
 create mode 100644 src/Decoders/AbstractDecoder.php
 create mode 100644 src/Decoders/FilePathImageDecoder.php

diff --git a/src/Decoders/AbstractDecoder.php b/src/Decoders/AbstractDecoder.php
new file mode 100644
index 00000000..09c707aa
--- /dev/null
+++ b/src/Decoders/AbstractDecoder.php
@@ -0,0 +1,16 @@
+<?php
+
+namespace Intervention\Image\Decoders;
+
+use Intervention\Image\Exceptions\DecoderException;
+use Intervention\Image\Interfaces\ColorInterface;
+use Intervention\Image\Interfaces\DecoderInterface;
+use Intervention\Image\Interfaces\ImageInterface;
+
+abstract class AbstractDecoder implements DecoderInterface
+{
+    public function decode(mixed $input): ImageInterface|ColorInterface
+    {
+        throw new DecoderException('Object must be specialized by the driver first.');
+    }
+}
diff --git a/src/Decoders/FilePathImageDecoder.php b/src/Decoders/FilePathImageDecoder.php
new file mode 100644
index 00000000..342bb6e9
--- /dev/null
+++ b/src/Decoders/FilePathImageDecoder.php
@@ -0,0 +1,7 @@
+<?php
+
+namespace Intervention\Image\Decoders;
+
+class FilePathImageDecoder extends AbstractDecoder
+{
+}
diff --git a/src/Drivers/AbstractDecoder.php b/src/Drivers/AbstractDecoder.php
index 610ae188..9ffc394c 100644
--- a/src/Drivers/AbstractDecoder.php
+++ b/src/Drivers/AbstractDecoder.php
@@ -11,7 +11,7 @@ use Intervention\Image\Interfaces\DecoderInterface;
 use Intervention\Image\Interfaces\ImageInterface;
 use Intervention\Image\Traits\CanBuildFilePointer;
 
-abstract class AbstractDecoder implements DecoderInterface
+abstract class AbstractDecoder extends DriverSpecialized implements DecoderInterface
 {
     use CanBuildFilePointer;
 
diff --git a/src/Drivers/AbstractDriver.php b/src/Drivers/AbstractDriver.php
index 5fc26e15..89c2ab97 100644
--- a/src/Drivers/AbstractDriver.php
+++ b/src/Drivers/AbstractDriver.php
@@ -3,6 +3,7 @@
 namespace Intervention\Image\Drivers;
 
 use Intervention\Image\Analyzers\AbstractAnalyzer;
+use Intervention\Image\Decoders\AbstractDecoder;
 use Intervention\Image\Encoders\AbstractEncoder;
 use Intervention\Image\Exceptions\NotSupportedException;
 use Intervention\Image\Interfaces\AnalyzerInterface;
@@ -69,6 +70,10 @@ abstract class AbstractDriver implements DriverInterface
             return false;
         }
 
+        if ($input instanceof AbstractDecoder) {
+            return false;
+        }
+
         return true;
     }
 }
diff --git a/src/Drivers/Gd/Driver.php b/src/Drivers/Gd/Driver.php
index 8c53957c..d1598eb7 100644
--- a/src/Drivers/Gd/Driver.php
+++ b/src/Drivers/Gd/Driver.php
@@ -103,9 +103,9 @@ class Driver extends AbstractDriver
      *
      * @see DriverInterface::handleInput()
      */
-    public function handleInput(mixed $input): ImageInterface|ColorInterface
+    public function handleInput(mixed $input, array $decoders = []): ImageInterface|ColorInterface
     {
-        return (new InputHandler())->handle($input);
+        return (new InputHandler($decoders))->handle($input);
     }
 
     /**
diff --git a/src/ImageManager.php b/src/ImageManager.php
index ad93e39a..1dc61ca7 100644
--- a/src/ImageManager.php
+++ b/src/ImageManager.php
@@ -6,6 +6,7 @@ use Intervention\Image\Interfaces\DriverInterface;
 use Intervention\Image\Interfaces\ImageInterface;
 use Intervention\Image\Drivers\Gd\Driver as GdDriver;
 use Intervention\Image\Drivers\Imagick\Driver as ImagickDriver;
+use Intervention\Image\Interfaces\DecoderInterface;
 
 final class ImageManager
 {
diff --git a/src/Interfaces/DriverInterface.php b/src/Interfaces/DriverInterface.php
index ec936237..057aa429 100644
--- a/src/Interfaces/DriverInterface.php
+++ b/src/Interfaces/DriverInterface.php
@@ -40,9 +40,10 @@ interface DriverInterface
      * Handle given input by decoding it to ImageInterface or ColorInterface
      *
      * @param mixed $input
+     * @param array $decoders
      * @return ImageInterface|ColorInterface
      */
-    public function handleInput(mixed $input): ImageInterface|ColorInterface;
+    public function handleInput(mixed $input, array $decoders = []): ImageInterface|ColorInterface;
 
     /**
      * Return color processor for the given colorspace