Image manipulation

• Usage

The pixl library allows you to manipulate images through a consistent API using either GD or ImageMagick.

Usage

First you'll have to decide whether to use GD or ImageMagick. In this example we'll use the GD processor.

$image = new Image('my_image.png', new GD);

You can reuse the same processor instance as long as you edit your images sequentially.

The phpgetHeight method returns the height of your image.

$height = $image->getHeight();

The phpgetWidth method returns the width of your image.

$width = $image->getWidth();

The phpgetDimensions method returns an array containing both the height and width of your image.

$dimensions = $image->getDimensions();

The phpsnapshot method allows you to create a snapshot of your image.

$image->snapshot();

The phprestore method allows you to restore an image snapshot.

$image->restore();

The phprotate method allows you to rotate an image n degrees.

$image->rotate(90);

The phpresize method allows you to resize an image.

// Resize to 50% of original size

$image->resize(50);

// Resize to 300 x 300 pixels

$image->resize(300, 300);

// Resize to closest possible match while maintaining aspect ratio

$image->resize(300, 300, Image::RESIZE_AUTO);

// Base new size on given width while maintaining aspect ratio

$image->resize(300, 300, Image::RESIZE_WIDTH);

// Base new size on given height while maintaining aspect ratio

$image->resize(300, 300, Image::RESIZE_HEIGHT);

The phpcrop method allows you to crop an image. The two first parameters are the crop size while the last two are the X and Y coordinates of the cropped region's top left corner.

$image->crop(200, 200, 50, 50);

The phpflip method allows you to flip and image.

$image->flip();

// Flip the image vertically

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

The phpwatermark method allows you to add a watermark to your image.

$image->watermark('watermark.png');

// You can also position the watermark (default is top left)

$image->watermark('watermark.png', Image::WATERMARK_TOP_RIGHT);

$image->watermark('watermark.png', Image::WATERMARK_BOTTOM_LEFT);

$image->watermark('watermark.png', Image::WATERMARK_BOTTOM_RIGHT);

$image->watermark('watermark.png', Image::WATERMARK_CENTER);

// You can also set the watermark opacity in percent

$image->watermark('watermark.png', Image::WATERMARK_BOTTOM_RIGHT, 50);

The phpsharpen method allows you to sharpen the image.

$image->sharpen();

The phppixelate method will pixelate the image.

$image->pixelate();

// You can also set the size of the pixels

$image->pixelate(20);

The phpgreyscale method converts the image to greyscale.

$image->greyscale();

The phpsepia method converts the image to sepia.

$image->sepia();

The phpnegate will invert the colors in the image.

$image->negate();

The phpcolorize method allows you to colorize an image.

$image->colorize('FF0000');

The phpbrightness method allows you adjust the brightness of the image.

$image->brightness();

// You can also set a custom value (between -100 and 100)

$image->brightness(100);

The phpgetImageBlob returns the raw binary image data.

$image = $image->getImageBlob();

// You can also tell it to return a different image type

$image = $image->getImageBlob('jpg');

// You can also adjust the image quality in percent (default is 95%)

$image = $image->getImageBlob('jpg', 70);

As the name suggests the phpsave method will save your edited image to disk.

// Override original file

$image->save();

// Create a new file

$image->save('edited_image.png');

// You can also adjust the image quality in percent (default is 95%)

$image->save('edited_image.png', 70);