Intervention Image Class

Image handling and manipulation based on PHP GD library. Made to work with Laravel 4 but runs also standalone.

Installation

You can install this Image class quick and easy with Composer.

Require the package via Composer in your composer.json.

"intervention/image": "dev-master"

Run Composer to update the new requirement.

$ composer update

The Image class are built to work with the Laravel 4 Framework. The integration is done in seconds.

Open your Laravel config file config/app.php and add the following lines.

In the $providers array add the service providers for this package.

'providers' => array(

    ...

    'Intervention\Image\ImageServiceProvider'

),

Add the facade of this package to the $aliases array.

'aliases' => array(

    ...

    'Image' => 'Intervention\Image\Facades\Image'

),

Usage

• Image::__construct - Create new instance of Image class
• Image::make - Open a new image resource from image file or create a new empty image
• Image::canvas - Create a new empty image resource
• Image::resize - Resize current image based on given width and/or height
• Image::grab - Cut out a detail of the image in given ratio and resize to output size
• Image::insert - Insert another image on top of the current image
• Image::brightness - Changes brightness of current image (-100 = min brightness, 0 = no change, +100 = max brightness)
• Image::contrast - Changes contrast of current image (-100 = min contrast, 0 = no change, +100 = max contrast)
• Image::pixelate - Pixelate current image
• Image::greyscale - Turn current image into a greyscale version
• Image::text - Write text in current image
• Image::fill - Fill image with given color at position x,y
• Image::rectangle - Draw rectangle in current image starting at point 1 and ending at point 2
• Image::line - Draw a line in current image starting at point 1 and ending at point 2
• Image::ellipse - Draw an ellipse centered at given coordinates
• Image::circle - Draw a circle centered at given coordinates
• Image::pixel - Set single pixel with given color at position x,y
• Image::pickColor - Picks and formats color at position in current image
• Image::reset - Reset to original image resource
• Image::save - Save image in filesystem

Code examples (Laravel)

Resize images

// create Image from file
$img = Image::make('public/foo.jpg');

// resize image to fixed size
$img->resize(300, 200);

// resize image to maximum width of 300px and keep ratio for height automatically
$img->resize(array('width' => '300'));

// Reset image resource to original
$img->reset();

// resize image to maximum height of 200px and keep ratio for width automatically
$img->resize(array('height' => '200'));

// save image in desired format and quality
$img->save('public/bar.jpg', 60);

Smart resizing

// use grab method to format images in a smart way combining cropping and resizing
$img = Image::make('public/foo.jpg');

// crop the best fitting 1:1 ratio (200x200) and resize to 200x200 pixel
$img->grab(200);

// crop the best fitting 5:3 (600x360) ratio and resize to 600x360 pixel
$img->grab(600, 360);

// crop the best fitting 1:1 (150x150) ratio and resize to 150x150 pixel
$img->grab(array('width' => '150'));

// save image
$img->save('public/bar.jpg');

Create empty images and add content

// create an empty Image resource (background color transparent)
$img = Image::canvas(640, 480);

// insert another image on top of current resource
$img->insert('public/bar.png');

// write some text in image
$img->text('Hello World', 10, 10);

// save image in desired format
$img->save('public/foo.jpg');

Image filters

// create Image from file
$img = Image::make('public/foo.jpg');

// turn image into greyscale version
$img->greyscale();

// modify brightness level
$img->brightness(80);

// modify contrast level
$img->contrast(-45);

// pixelate image with blocksize of 25x25 pixel
$img->pixelate(25);

Other examples

// create empty canvas
$img = Image::canvas(800, 600);

// fill image with color
$img->fill('cccccc');

// draw a filled rectangle
$img->rectangle('006729', 100, 100, 200, 200, true);

// draw a outline circle
$img->circle('ae051f', 400, 300, 100, false);

// draw a red line from point 10,10 to point 300,300 pixel
$img->line('ae051f', 10, 10, 300, 300);

Method chaining

// it is possible to chain all methods
$img1 = Image::canvas(800, 600);
$img2 = Image::make('public/img2.png');
$img1->resize(300, 200)->insert($img2)->save('public/bar.jpg');