glukash/glu-image

GluImage

glukash\glu-image is a PHP image manipulation helper library., _(*1)

The package includes ServiceProvider and Facade for easy Laravel 4 integration., _(*2)

Purpose

• The package supports two image manipulation methods: resize and crop.
• Easly resize and crop jpg, png, and gif images.
• Supports animated gif using GD Library. (No Imagick, Gmagick is needed).

Dependencies

The package uses:, _(*3)

• Intervention/image
• glukash/GifCreator forked version of Sybio/GifCreator
• Sybio/GifFrameExtractor

Requirements

• PHP >=5.3
• GD Library (>=2.0)

Quick Installation

To install through composer, put the following in your composer.json file:, _(*4)

{
    "repositories": [
        {
            "type": "git",
            "url": "https://github.com/glukash/GifCreator"
        }
    ],
    "require": {
        "glukash/glu-image": "0.*"
    }
}

Without adding the "repositories" key, composer will pull the original Sybio/GifCreator and you will not be able to chain methods on animated gif files after first save()., _(*5)

{
    "repositories": [
        {
            "type": "git",
            "url": "https://github.com/glukash/GifCreator"
        }
    ]
}

Laravel Integration

Add Intervention\Image and Glukash\GluImage service providers in app/config/app.php., _(*6)

'providers' => array(

    // ...
    'Intervention\Image\ImageServiceProvider',
    'Glukash\GluImage\GluImageServiceProvider',
),

Add GluImage alias in app/config/app.php., _(*7)

'aliases' => array(

    // ...

    'GluImage' => 'Glukash\GluImage\Facades\GluImage',
),

If you want to use Intervention\Image package directly, add InterImage alias in app/config/app.php. This is not a necessary step for using GluImage., _(*8)

'aliases' => array(

    // ...

    'InterImage' => 'Intervention\Image\Facades\Image',
),

Code Examples

$img = GluImage::get( $path_to_images.'/01.jpg' );
$img->resize(540,360);
$img->save( $path_to_images.'/01-resized.jpg' );

// ...

GluImage::get( $path_to_images.'/01.jpg' )->resize(540,360)->save( $path_to_images.'/01-resized.jpg' );

// ...

GluImage::get( $path_to_images.'/01.jpg' )->crop(540,360)->save( $path_to_images.'/01-cropped.jpg' );

// ...

// one chain creates two different files
GluImage::get( $path_to_images.'/01.jpg' )
    ->resize(540,360)
    ->save( $path_to_images.'/01-resized1.jpg' )
    ->resize(360,220)
    ->save( $path_to_images.'/01-resized2.jpg' );

// ...

// chaining another methods after save() method for animated gif files 
// is available only with forked version of GifCreator
GluImage::get( $path_to_images.'/01.gif' )
    ->resize(540,360)
    ->save( $path_to_images.'/01-resized.gif' )
    ->crop(360,220)
    ->save( $path_to_images.'/01-resized-and-cropped.gif' );

License

GluImage is licensed under the MIT License., _(*9)

Copyright 2014 Lukasz Gaszyna, _(*10)