First implemtation of the waveform feature

src/FFMpeg/Media/Waveform.php

@@ -0,0 +1,101 @@
+<?php
+
+/*
+ * This file is part of PHP-FFmpeg.
+ *
+ * (c) Alchemy <info@alchemy.fr>
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace FFMpeg\Media;
+
+use Alchemy\BinaryDriver\Exception\ExecutionFailureException;
+use FFMpeg\Filters\Waveform\WaveformFilterInterface;
+use FFMpeg\Filters\Waveform\WaveformFilters;
+use FFMpeg\Driver\FFMpegDriver;
+use FFMpeg\FFProbe;
+use FFMpeg\Exception\RuntimeException;
+use FFMpeg\Coordinate\TimeCode;
+
+class Waveform extends AbstractMediaType
+{
+    /** @var Video */
+    private $video;
+
+    public function __construct(Video $video, FFMpegDriver $driver, FFProbe $ffprobe)
+    {
+        parent::__construct($video->getPathfile(), $driver, $ffprobe);
+        $this->video = $video;
+    }
+
+    /**
+     * Returns the video related to the waveform.
+     *
+     * @return Video
+     */
+    public function getVideo()
+    {
+        return $this->video;
+    }
+
+    /**
+     * {@inheritdoc}
+     *
+     * @return WaveformFilters
+     */
+    public function filters()
+    {
+        return new WaveformFilters($this);
+    }
+
+    /**
+     * {@inheritdoc}
+     *
+     * @return Waveform
+     */
+    public function addFilter(WaveformFilterInterface $filter)
+    {
+        $this->filters->add($filter);
+
+        return $this;
+    }
+
+    /**
+     * Saves the waveform in the given filename.
+     *
+     * @param string  $pathfile
+     *
+     * @return Waveform
+     *
+     * @throws RuntimeException
+     */
+    public function save($pathfile)
+    {
+        /**
+         * might be optimized with http://ffmpeg.org/trac/ffmpeg/wiki/Seeking%20with%20FFmpeg
+         * @see http://ffmpeg.org/ffmpeg.html#Main-options
+         */
+        $commands = array(
+            '-i', 'input', '-filter_complex',
+            '-frames:v', '1',
+            $this->pathfile
+        );
+
+        foreach ($this->filters as $filter) {
+            $commands = array_merge($commands, $filter->apply($this));
+        }
+
+        $commands = array_merge($commands, array($pathfile));
+
+        try {
+            $this->driver->command($commands);
+        } catch (ExecutionFailureException $e) {
+            $this->cleanupTemporaryFile($pathfile);
+            throw new RuntimeException('Unable to save waveform', $e->getCode(), $e);
+        }
+
+        return $this;
+    }
+}