Added '-depth' '-flatten' and '-colorspace' options

Author: Andrei Tomita

Command.php

@@ -562,6 +562,37 @@ public function autoOrient(): self
         return $this;
     }
 
+    /**
+     * @see https://imagemagick.org/script/command-line-options.php#depth
+     */
+    public function depth(int $depth): self
+    {
+        $this->command[] = '-depth ' . $depth;
+
+        return $this;
+    }
+
+    /**
+     * @see https://imagemagick.org/script/command-line-options.php#flatten
+     */
+    public function flatten(): self
+    {
+        $this->command[] = '-flatten';
+
+        return $this;
+    }
+
+    /**
+     * @see https://imagemagick.org/script/command-line-options.php#colorspace
+     */
+    public function colorspace(string $colorspace): self
+    {
+        $this->command[] = '-colorspace';
+        $this->command[] = $this->ref->colorspace($colorspace);
+
+        return $this;
+    }
+
     /**
      * /!\ Append a raw command to ImageMagick.
      * Not safe! Use at your own risks!

References.php

@@ -59,6 +59,14 @@ public function __construct()
         }
     }
 
+    /**
+     * @return string[]
+     */
+    public function getColorspaceValuesReference(): array
+    {
+        return $this->config['colorspace_values'];
+    }
+
     /**
      * @return string[]
      */
@@ -120,6 +128,28 @@ public function color(string $color): string
         ));
     }
 
+    /**
+     * Checks that colorspace value is valid in the references.
+     */
+    public function colorspace(string $colorspace): string
+    {
+        $colorspace = \mb_strtolower(\trim($colorspace));
+
+        $references = $this->getColorspaceValuesReference();
+
+        if (\in_array($colorspace, $references, true)) {
+            return $colorspace;
+        }
+
+        throw new \InvalidArgumentException(\sprintf(
+            'The specified colorspace value (%s) is invalid.'."\n".
+            'The available values are:'."\n%s\n".
+            'Please refer to ImageMagick command line documentation:'."\n%s",
+            $colorspace, \implode(', ', $references),
+            'http://www.imagemagick.org/script/command-line-options.php#colorspace'
+        ));
+    }
+
     /**
      * Checks that a rotation option is correct according to ImageMagick command line reference.
      *

Resources/references.php

@@ -21,6 +21,39 @@
         'gif',
         'png',
     ],
+    'colorspace_values' => [
+        'CMY',
+        'CMYK',
+        'Gray',
+        'HCL',
+        'HCLp',
+        'HSB',
+        'HSI',
+        'HSL',
+        'HSV',
+        'HWB',
+        'Lab',
+        'LCHab',
+        'LCHuv',
+        'LMS',
+        'Log',
+        'Luv',
+        'OHTA',
+        'Rec601YCbCr',
+        'Rec709YCbCr',
+        'RGB',
+        'scRGB',
+        'sRGB',
+        'Transparent',
+        'xyY',
+        'XYZ',
+        'YCbCr',
+        'YCC',
+        'YDbDr',
+        'YIQ',
+        'YPbPr',
+        'YUV'
+    ],
     'colors' => [
         'snow',
         'snow1',