Merge pull request #221 from BlueBayTravel/flip-manipulator

Flip manipulator

Author: reinink

docs/1.0/api/flip.md

@@ -0,0 +1,16 @@
+---
+layout: default
+title: Flip
+---
+
+# Flip
+
+## Flip `flip`
+
+Flips the image. Accepts `v`, `h` and `both`.
+
+~~~ html
+<img src="kayaks.jpg?h=500&flip=v">
+~~~
+
+[![© Photo Joel Reynolds](https://glide.herokuapp.com/1.0/kayaks.jpg?h=500&flip=v)](https://glide.herokuapp.com/1.0/kayaks.jpg?h=500&flip=v)

docs/1.0/api/quick-reference.md

@@ -8,6 +8,7 @@ title: Quick reference
 Name    | Function         | Description |
 ------- | ---------------- | ----------- | ----
 Orientation | `or` | Rotates the image. | [info](api/orientation/#orientation-or)
+Flip | `flip` | Flip the image. | [info](api/orientation/#flip-flip)
 Crop | `crop` | Crops the image to specific dimensions. | [info](api/crop/#crop-crop)
 Width | `w` | Sets the width of the image, in pixels. | [info](api/size/#width-w)
 Height | `h` | Sets the height of the image, in pixels. | [info](api/size//#height-h)
@@ -31,4 +32,4 @@ Watermark Alpha | `markalpha` | Sets the watermark opacity.  | [info](api/waterm
 Background | `bg` | Sets the background color of the image. | [info](api/background/#background-bg)
 Border | `border` | Add a border to the image. | [info](api/border/#border-border)
 Quality | `q` | Defines the quality of the image. | [info](api/encode/#quality-q)
-Format | `fm` | Encodes the image to a specific format. | [info](api/encode/#format-fm)
+Format | `fm` | Encodes the image to a specific format. | [info](api/encode/#format-fm)

src/Manipulators/Flip.php

@@ -0,0 +1,40 @@
+<?php
+
+namespace League\Glide\Manipulators;
+
+use Intervention\Image\Image;
+
+/**
+ * @property string $flip
+ */
+class Flip extends BaseManipulator
+{
+    /**
+     * Perform flip image manipulation.
+     * @param  Image $image The source image.
+     * @return Image The manipulated image.
+     */
+    public function run(Image $image)
+    {
+        if ($flip = $this->getFlip()) {
+            if ($flip === 'both') {
+                return $image->flip('h')->flip('v');
+            }
+
+            return $image->flip($flip);
+        }
+
+        return $image;
+    }
+
+    /**
+     * Resolve flip.
+     * @return string The resolved flip.
+     */
+    public function getFlip()
+    {
+        if (in_array($this->flip, ['h', 'v', 'both'], true)) {
+            return $this->flip;
+        }
+    }
+}

src/ServerFactory.php

@@ -16,6 +16,7 @@
 use League\Glide\Manipulators\Crop;
 use League\Glide\Manipulators\Encode;
 use League\Glide\Manipulators\Filter;
+use League\Glide\Manipulators\Flip;
 use League\Glide\Manipulators\Gamma;
 use League\Glide\Manipulators\Orientation;
 use League\Glide\Manipulators\Pixelate;
@@ -225,6 +226,7 @@ public function getManipulators()
             new Gamma(),
             new Sharpen(),
             new Filter(),
+            new Flip(),
             new Blur(),
             new Pixelate(),
             new Watermark($this->getWatermarks(), $this->getWatermarksPathPrefix()),

tests/Manipulators/FlipTest.php

@@ -0,0 +1,49 @@
+<?php
+
+namespace League\Glide\Manipulators;
+
+use Mockery;
+
+class FlipTest extends \PHPUnit_Framework_TestCase
+{
+    private $manipulator;
+
+    public function setUp()
+    {
+        $this->manipulator = new Flip();
+    }
+
+    public function tearDown()
+    {
+        Mockery::close();
+    }
+
+    public function testCreateInstance()
+    {
+        $this->assertInstanceOf('League\Glide\Manipulators\Flip', $this->manipulator);
+    }
+
+    public function testRun()
+    {
+        $image = Mockery::mock('Intervention\Image\Image', function ($mock) {
+            $mock->shouldReceive('flip')->andReturn($mock)->with('h')->once();
+            $mock->shouldReceive('flip')->andReturn($mock)->with('v')->once();
+        });
+
+        $this->assertInstanceOf(
+            'Intervention\Image\Image',
+            $this->manipulator->setParams(['flip' => 'h'])->run($image)
+        );
+
+        $this->assertInstanceOf(
+            'Intervention\Image\Image',
+            $this->manipulator->setParams(['flip' => 'v'])->run($image)
+        );
+    }
+
+    public function testGetFlip()
+    {
+        $this->assertSame('h', $this->manipulator->setParams(['flip' => 'h'])->getFlip());
+        $this->assertSame('v', $this->manipulator->setParams(['flip' => 'v'])->getFlip());
+    }
+}