Support for filters

Author: pascalbaljet

README.md

@@ -13,7 +13,7 @@ This package provides an integration with FFmpeg for Laravel 5.1 and higher. The
 You can install the package via composer:
 
 ``` bash
-composer require pbmedia/laravel-ffmpeg dev-master
+composer require pbmedia/laravel-ffmpeg
 ```
 
 Add the service provider and facade to your ```app.php``` config file:
@@ -65,6 +65,33 @@ FFMpeg::fromDisk('videos')
     ->save('FrameAt10sec.png');
 ```
 
+You can add filters through a ```Closure``` or by using PHP-FFMpeg's Filter objects:
+
+``` php
+FFMpeg::fromDisk('videos')
+    ->open('steve_howe.mp4')
+    ->addFilter(function ($filters) {
+        $filters->resize(new \FFMpeg\Coordinate\Dimension(640, 480));
+    })
+    ->export()
+    ->toDisk('converted_videos')
+    ->inFormat(new \FFMpeg\Format\Video\X264)
+    ->save('small_steve.mkv');
+
+// or
+
+$start = \FFMpeg\Coordinate\TimeCode::fromSeconds(5)
+$clipFilter = new \FFMpeg\Filters\Video\ClipFilter($start);
+
+FFMpeg::fromDisk('videos')
+    ->open('steve_howe.mp4')
+    ->addFilter($clipFilter)
+    ->export()
+    ->toDisk('converted_videos')
+    ->inFormat(new \FFMpeg\Format\Video\X264)
+    ->save('short_steve.mkv');
+```
+
 Chain multiple convertions:
 
 ``` php
@@ -77,19 +104,16 @@ FFMpeg::open('my_movie.mov')
     // export to FTP, converted in WMV
     ->export()
     ->toDisk('ftp')
-    ->inFormat(new FFMpeg\Format\Video\WMV)
+    ->inFormat(new \FFMpeg\Format\Video\WMV)
     ->save('my_movie.wmv')
 
     // export to Amazon S3, converted in X264
     ->export()
     ->toDisk('s3')
-    ->inFormat(new FFMpeg\Format\Video\X264)
+    ->inFormat(new \FFMpeg\Format\Video\X264)
     ->save('my_movie.mkv');
 ```
 
-## To do
-* Writing test for exporting frames
-
 ## Changelog
 
 Please see [CHANGELOG](CHANGELOG.md) for more information what has changed recently.

src/Media.php

@@ -2,6 +2,7 @@
 
 namespace Pbmedia\LaravelFFMpeg;
 
+use Closure;
 use FFMpeg\Coordinate\TimeCode;
 use FFMpeg\Media\MediaTypeInterface;
 
@@ -56,6 +57,19 @@ public function getFrameFromTimecode(TimeCode $timecode): Frame
         return new Frame($this->getFile(), $frame);
     }
 
+    public function addFilter(): Media
+    {
+        $arguments = func_get_args();
+
+        if (isset($arguments[0]) && $arguments[0] instanceof Closure) {
+            call_user_func_array($arguments[0], [$this->media->filters()]);
+        } else {
+            call_user_func_array([$this->media, 'addFilter'], $arguments);
+        }
+
+        return $this;
+    }
+
     protected function selfOrArgument($argument)
     {
         return ($argument === $this->media) ? $this : $argument;

tests/AudioVideoTest.php

@@ -2,6 +2,9 @@
 
 namespace Pbmedia\LaravelFFMpeg\Tests;
 
+use FFMpeg\Coordinate\Dimension;
+use FFMpeg\Coordinate\TimeCode;
+use FFMpeg\Filters\Video\ClipFilter;
 use FFMpeg\Media\Video;
 use Illuminate\Contracts\Filesystem\Factory as Filesystems;
 use Mockery;
@@ -48,6 +51,30 @@ public function testDiskClass()
         $this->assertEquals($disk->getPath(), $this->srcDir . '/');
     }
 
+    public function testAddingAFilterWithAClosure()
+    {
+        $media = $this->getVideoMedia();
+
+        $this->assertCount(0, $media->getFiltersCollection());
+
+        $media->addFilter(function ($filters) {
+            $filters->resize(new Dimension(640, 480));
+        });
+
+        $this->assertCount(1, $media->getFiltersCollection());
+    }
+
+    public function testAddingAFilterWithAnObject()
+    {
+        $media = $this->getVideoMedia();
+
+        $this->assertCount(0, $media->getFiltersCollection());
+
+        $media->addFilter(new ClipFilter(TimeCode::fromSeconds(5)));
+
+        $this->assertCount(1, $media->getFiltersCollection());
+    }
+
     public function testExportingToLocalDisk()
     {
         $media    = $this->getGuitarMedia();