Add examples: Manage animated GIF with ImageWorkshop

Author: jdecool

examples/manage-animated-gif/README.md

@@ -0,0 +1,13 @@
+This directory contains source code for the [Manage animated GIF with ImageWorkshop](../../doc/tutorials/manage-animated-gif.md) tutorial.
+
+An [online version](http://phpimageworkshop.com/tutorial/5/manage-animated-gif-with-imageworkshop.html) also exists.
+
+To use it, you need to install [Composer](https://getcomposer.org) dependency manager.
+
+```bash
+composer install
+
+php run.php
+```
+
+It will create `output.gif` file in the current directory.

examples/manage-animated-gif/composer.json

@@ -0,0 +1,11 @@
+{
+    "name": "image-workshop/example-animated-gif",
+    "description": "Source code for \"Manage animated GIF with ImageWorkshop\"",
+    "type": "project",
+    "license": "MIT",
+    "require": {
+        "sybio/gif-creator": "^1.0",
+        "sybio/gif-frame-extractor": "^1.0",
+        "sybio/image-workshop": "^2.0"
+    }
+}

examples/manage-animated-gif/images/original.gif

@@ -0,0 +1,38 @@
+<?php
+
+require __DIR__.'/vendor/autoload.php';
+
+use GifCreator\GifCreator;
+use GifFrameExtractor\GifFrameExtractor;
+use PHPImageWorkshop\ImageWorkshop;
+
+$gifPath = __DIR__.'/images/original.gif'; // Your animated GIF path
+if (GifFrameExtractor::isAnimatedGif($gifPath)) { // check this is an animated GIF
+
+    // Extractions of the GIF frames and their durations
+    $gfe = new GifFrameExtractor();
+    $frames = $gfe->extract($gifPath);
+
+    // Initialization of the watermark layer
+    $watermarkLayer = ImageWorkshop::initFromPath(__DIR__.'/images/watermark.png');
+
+    // For each frame, we add a watermark and we resize it
+    $retouchedFrames = array();
+    foreach ($frames as $frame) {
+
+        // Initialization of the frame as a layer
+        $frameLayer = ImageWorkshop::initFromResourceVar($frame['image']);
+
+        $frameLayer->resizeInPixel(350, null, true); // Resizing
+        $frameLayer->addLayerOnTop($watermarkLayer, 20, 20, 'LB'); // Watermarking
+
+        $retouchedFrames[] = $frameLayer->getResult();
+    }
+
+    // Then we re-generate the GIF
+    $gc = new GifCreator();
+    $gc->create($retouchedFrames, $gfe->getFrameDurations(), 0);
+
+    // And now save it !
+    file_put_contents(__DIR__.'/output.gif', $gc->getGif());
+}