README

A simple PHP libraty to manipulate images, it support GIF, PNG and JPG

Requirement

PHP >= 5.6 with GD support *For some additional features (for example image distortion) ImageMagick binaries are required.

Getting Started

Install library with composer

composer require jackal/image-merge

Usage

Minimal example

$imageMerge = new ImageMerge();
$imageBuilder = $imageMerge->getBuilder('/path/to/my/file.png'); #or URL, or resource, or binary content

$imageBuilder->resize(620,350)
$imageBuilder->rotate(90);

Get the image content directly to the output

[...]
echo $imageBuilder->getImage()->toPNG()->getContent();  

Save image to path

[...]
$builder->getImage()->toPNG('/path/to/the/image.png');

Get image Response object (Compatible with Symgony projects)

[...]
return $imageBuilder->getImage()->toPNG()

resize

At least one parameter is required In case just one parameter is passed, it will resize maintaining the aspect ratio of the image

$imageBuilder->resize(620,null);
#or
$imageBuilder->resize(null,200);

If both parameters are passed, it could stretch the image

$imageBuilder->resize(400,200);

thumbnail

Similar to Resize but in case the aspect ratio is not respected, it will crop the image (using cropCenter)

$imageBuilder->thumbnail(400,400);

rotate

Rotate the image (counterclockwise)

$imageBuilder->rotate(180);

*In case of particular angle (30, 45, etc..) it will create blank area to fill the empty spaces

grayscale

Add a graysclae filter to the image

$imageBuilder->grayScale();

brightness

Adjusts the brightness of the image

$imageBuilder->brightness(10);

blur

Adds blur effect on the image

$imageBuilder->blur(20);

pixelate

Adds "Pixel" effect on the image

$imageBuilder->pixelate(20);

crop and cropCenter

Crop Crop the image according to the x and y coords and the output dimention passed

$point_x = 10,
$point_y = 15;
$width = 50,
$height = 50;
$imageBuilder->crop($point_x,$point_y,$width,$height);

Crop at the center of the image according to the width and height of the output image

$width = 50,
$height = 50;
$imageBuilder->cropCenter($point_x,$point_y,$width,$height);

border

It adds border to the image (fill inside the rect)

$stroke = 20;
$colorHex = '3399ff';
$builder->border($stroke,$colorHex);

Experimental features that will likely change in the future

addText

It adds text inside the image

$text = new Jackal\ImageMerge\Model\Text\Text('this is the text', Font::arial(), 12, new Color('ABCDEF'));
$builder->addText($text, 10, 20);

addSquare

It adds a square (color-filled) on the image

$builder->addSquare(10, 10, 20, 20, 'ABCDEF');

===========================================================================

Author

• Luca Giacalone (AKA JackalOne)

License

This project is licensed under the MIT License