meriksk/php-image

Image lib

PHP-Image Library

, _(*1)

The Image class offers a bunch of image processing features using GD or IMagick., _(*2)

Requirements

• PHP >=5.6

Supported Image Libraries

• GD Library (>=2.0)
• Imagick PHP extension (>=6.5.7)

Setup

The preferred way to install this extension is through Composer. If you do not have Composer, you may install it by following the instructions at getcomposer.org., _(*3)

Either run, _(*4)

composer require meriksk/php-image

or add, _(*5)

"meriksk/php-image": "~1.0" 

to your composer.json and run composer update, _(*6)

Usage

• Open image
• Resize image
• Crop image

Open image

Because this class uses namespacing, when instantiating the object, you need to either use the fully qualified namespace:, _(*7)

$image = new \meriksk\PhpImage\Image($filename);

or alias it:, _(*8)

use \meriksk\PhpImage\Image;

$image = new Image($filename);

This class can use Imagick or GD extension - whichever is available. Imagick extension is preferred if is available. You can force the extension for manipulating images as follows:, _(*9)

$image = new Image($filename, Image::DRIVER_IMAGICK);

Save image

Library supports three formats of image: 'jpeg', 'png' and 'gif'. By default they quality is set to 75. When saving to disk or outputting into the browser, the script assumes the same output type and quality as input., _(*10)

$image->save($filename);

Save in a different type to the source:, _(*11)

$image->save($filename, 60, 'png');

Output image

To render the image directly into the browser, you can call:, _(*12)

$image->toScreen(60, 'png');

Resize

resize, _(*13)

$image = $image->resize($width, $height, $allow_enlarge);

resize to width, _(*14)

$image = $image->resizeToWidth($width, $allow_enlarge);

resize to height, _(*15)

$image = $image->resizeToHeight($height, $allow_enlarge);

resize to best fit, _(*16)

$image = $image->resizeToBestFit($max_width, $max_height, $allow_enlarge);

resize to long side, _(*17)

$image = $image->resizeToLongSide($max, $allow_enlarge);

resize to short side, _(*18)

$image = $image->resizeToShortSide($max, $allow_enlarge);

Crop

** manual crop **, _(*19)

$image->crop($x, $y, $width, $height, $allow_enlarge);

** automatic crop **, _(*20)

$image->autoCrop($width, $height, $position);

Thumbnail

$image->thumbnail($width, $height, $fill, $allow_enlarge);

Rotate image

Rotating is counter clockwise;, _(*21)

Rotate on 90 degrees:, _(*22)

$image->rotate(90);

Rotate on 45 degrees, and fill empty field with white color:, _(*23)

$image->rotate(45, '#FFFFFF');

Flip image

Flip in vertical direction:, _(*24)

$image->flip();

Flip in horisontal direction:, _(*25)

$image->flip(Image::FLIP_HORIZONTAL);

Flip in both directions:, _(*26)

$image->flip(Image::FLIP_BOTH);

Filters

todo, _(*27)