grandt / phpresizegif
GIF89a compliant Gif resizer, including transparency and optimized gifs with sub sized elements.
Installs: 308 178
Dependents: 7
Suggesters: 0
Security: 0
Stars: 11
Watchers: 3
Forks: 6
Open Issues: 1
Requires
- php: >=5.3.0
- grandt/binstring: >=0.2.0
This package is not auto-updated.
Last update: 2024-11-09 17:56:04 UTC
README
This package aims to implement a proper resizing of gif files encompassing the GIF89a specification.
Introduction
Most, if not all other publicly available gif resize packages fails with optimized gif files, those where only parts of the file are updated in subsequent frames. See these as a background image, with sprites moving about. The resulting gif will retain its aspect ratio.
The package is a bit pedantic in its approach. It was made as much for me to learn what Gifs were and how they work, as it was to solve specific problem.
Usage
The package needs to write to a file, the reasons for not just return a string is twofold. One being memory usage, the other is that you really don't want to be dynamically resizing often used gif files every time they are used.
Import
Add this requirement to your composer.json
file:
"grandt/phpresizegif": ">=1.0.3"
Composer
If you already have Composer installed, skip this part.
Packagist, the main composer repository has a neat and very short guide.
Or you can look at the guide at the Composer site.
The easiest for first time users, is to have the composer installed in the same directory as your composer.json file, though there are better options.
Run this from the command line:
php -r "readfile('https://getcomposer.org/installer');" | php
This will check your PHP installation, and download the composer.phar
, which is the composer binary. This file is not needed on the server though.
Once composer is installed you can create the composer.json
file to import this package.
{ "require": { "grandt/phpresizegif": ">=1.0.3" } }
Followed by telling Composer to install the dependencies.
php composer.phar install
this will download and place all dependencies defined in your composer.json
file in the vendor
directory.
Finally, you include the autoload.php
file in the new vendor
directory.
<?php require 'vendor/autoload.php'; . . .
Initialization
include "../vendor/autoload.php"; use grandt\ResizeGif\ResizeGif; $srcFile = "[path to original gif file]"; $dstFile = "[path to resized file]"; ResizeGif::ResizeToWidth($srcFile, $dstFile, 100);
To make a 100 pixel wide thumbnail
ResizeGif::ResizeToWidth($srcFile, $dstFile, 100);
To make a 100 pixel high thumbnail
ResizeGif::ResizeToHeight($srcFile, $dstFile, 100);
To double the size of the gif.
ResizeGif::ResizeByRatio($srcFile, $dstFile, 2.0);
To half the size of the gif.
ResizeGif::ResizeByRatio($srcFile, $dstFile, 0.5);