gif-endec is a GIF encoder and decoder. It allows you to split animated GIFs into separate frames. You can also extract frame durations and disposal method (disposal method indicates the way in which the graphic is to be treated after being displayed).
Thanks to some code optimizations, this library decodes animated GIFs much faster than Sybio/GifFrameExtractor. It also optimizes memory usage, allowing you to process decoded frames one after another. It doesn't load all frames to memory at once.
Install this package with Composer.
composer require stil/gif-endecIn this example we'll split this animated GIF into separate frames.
<?php
require __DIR__ . '/../vendor/autoload.php';
use GIFEndec\Events\FrameDecodedEvent;
use GIFEndec\IO\FileStream;
use GIFEndec\Decoder;
/**
* Open GIF as FileStream
*/
$gifStream = new FileStream("path/to/animation.gif");
/**
* Create Decoder instance from MemoryStream
*/
$gifDecoder = new Decoder($gifStream);
/**
* Run decoder. Pass callback function to process decoded Frames when they're ready.
*/
$gifDecoder->decode(function (FrameDecodedEvent $event) {
/**
* Convert frame index to zero-padded strings (001, 002, 003)
*/
$paddedIndex = str_pad($event->frameIndex, 3, '0', STR_PAD_LEFT);
/**
* Write frame images to directory
*/
$event->decodedFrame->getStream()->copyContentsToFile(
__DIR__ . "/frames/frame{$paddedIndex}.gif"
);
// Or get binary data as string:
// $frame->getStream()->getContents()
/**
* You can access frame duration using Frame::getDuration() method, ex.:
*/
echo $event->decodedFrame->getDuration() . "\n";
});The result frames will be written to directory:
If your GIF is saved using transparency, some frames might look like this:
In following example you'll see how to render GIF frames.
<?php
require __DIR__ . '/../vendor/autoload.php';
use GIFEndec\Events\FrameRenderedEvent;
use GIFEndec\IO\FileStream;
use GIFEndec\Decoder;
use GIFEndec\Renderer;
/**
* Open GIF as FileStream
*/
$gifStream = new FileStream("path/to/animation.gif");
/**
* Create Decoder instance from MemoryStream
*/
$gifDecoder = new Decoder($gifStream);
/**
* Create Renderer instance
*/
$gifRenderer = new Renderer($gifDecoder);
/**
* Run decoder. Pass callback function to process decoded Frames when they're ready.
*/
$gifRenderer->start(function (FrameRenderedEvent $event) {
/**
* $gdResource is a GD image resource. See http://php.net/manual/en/book.image.php
*/
/**
* Write frame images to directory
*/
imagepng($event->renderedFrame, __DIR__ . "/frames/frame{$event->frameIndex}.png");
});Assume now, that we want to slow down this skateboarder animation a little bit, so we can see how to make such trick.
We already have splitted frames in skateboarder/frame*.gif directory.
<?php
use GIFEndec\Color;
use GIFEndec\Encoder;
use GIFEndec\Frame;
use GIFEndec\IO\FileStream;
$gif = new Encoder();
foreach (glob('skateboarder/frame*.gif') as $file) {
$stream = new FileStream($file);
$frame = new Frame();
$frame->setDisposalMethod(1);
$frame->setStream($stream);
$frame->setDuration(30); // 0.30s
$frame->setTransparentColor(new Color(255, 255, 255));
$gif->addFrame($frame);
}
$gif->addFooter(); // Required after you're done with adding frames
// Copy result animation to file
$gif->getStream()->copyContentsToFile('skateboarder/animation.gif');This is how our slowed down animation would look like:
Disposal Method indicates the way in which the graphic is to be treated after being displayed.
Values : 0 - No disposal specified. The decoder is
not required to take any action.
1 - Do not dispose. The graphic is to be left
in place.
2 - Restore to background color. The area used by the
graphic must be restored to the background color.
3 - Restore to previous. The decoder is required to
restore the area overwritten by the graphic with
what was there prior to rendering the graphic.
4-7 - To be defined.