wapmorgan/imagery

Simple image editor for resizing, cropping, making collages and other elementary actions with images.

Imagery simplifies image manipulations.

Imagery supports: - resizing - cropping - flipping and rotating - making collages - applying filters and effects, _(*1)

, _(*2)

1. Installation
2. API

Installation

• Composer package:

  composer require wapmorgan/imagery

API

Imagery

use Imagery\Imagery;

Opening

Create new Imagery object: - $image = Imagery::open($filename); - from a file. - $image = Imagery::create($width, $height); - new image - $image = new Imagery(imagecreatefrombmp('image.bmp')); - from a resource, _(*3)

Saving

• public function save($filename, $quality = 75, $format = null) - saves image to disk. Quality is an integer value between 0 (worst) and 100 (best). Default is 75. Quality is applicable only to JPEG, PNG, WEBP. If $format can not be determined by filename extension, specifcy it explicitly.

Formats supports:, _(*4)

Properties

• $image->width - width of image
• $image->height - height of image
• $image->resource - original gd-resource of image (you can use it with gd-functions)

Resize && Zoom

• public function resize(int $width, int $height) - resizes an image to $width X $height
• public function zoomWidthTo(int $size) - changes proportionally image width to $size
• public function zoomHeightTo(int $size) - changes proportionally image height to $size
• public function zoomMaxSide(int $size) - zoomes proportionally larger side to $size, if needed

Crop

• public function crop($x, $y, $x2, $y2) - cuts a rectangular piece of image
• public function decreaseSide($side, int $size) - deletes a piece of image from specific side. For example, if $side=top and $size=100, 100px from top will be deleted.

Rotation && Mirroring

• public function rotate($angle, $bgColor = 0) - rotates an image. True equals 90°, False equals -90°.
• public function flip($horizontally = true) - flips an image horizontally or vertically.

Collage

• public function appendImageTo($side, Imagery $appendix, int $modifiers) - appends an image ($appendix) to current image at $side (top|bottom|left|right). Modifiers:
  • Imagery::ZOOM_IF_LARGER - appendix' height will be zoomed (not resized) if it's larger than current image's one (when appending to left or right side); appendix' width will be zoomed (not resized) if it's larger than current image's one (when appending to top or bottom side);

• public function placeImageAt($x, $y, Imagery $image) - places an image atop current image at $x X $y., _(*5)

• public function placeImageAtCenter(Imagery $image) - places an image in the center of current image., _(*6)

Effects

• public function filter($filter) - applies grayscale or negate filter. Pass Imagery::FILTER_NEGATE or Imagery::FILTER_GRAYSCALE as $filter., _(*7)

  Grayscale:, _(*8)

  -> , _(*9)

  Negate:, _(*10)

  -> , _(*11)

• public function changeContrast($newValue) - changes contrast of image. New values can be in range from 100 (max contrast) to -100 (min contrast), 0 means no change., _(*12)

  -> , _(*13)

• public function changeBrightness($newValue) - changes brightness of image. New values can be in range from 255 (max brightness) to -255 (min brightness), 0 means no change., _(*14)

  -> , _(*15)

• public function colorize($red, $green, $blue, $alpha = 127) - changes colors of image. Colors ($red, $green, $blue) can be in range from 255 to -255. $alpha from 127 to 0., _(*16)

  -> , _(*17)

• public function blur($method) - blurs an image. Method can be Imagery::GAUSSIAN_BLUR or Imagery::SELECTIVE_BLUR., _(*18)

  -> , _(*19)

• public function smooth($level) - smooths an image. Level of smoothness can be in range from 0 to 8. 8 is un-smooth., _(*20)

  -> , _(*21)

• public function pixelate($blockSize = 5, $useModernEffect = true) - pixelates an image. $blockSize is size of pixel block., _(*22)

  -> , _(*23)

Tools

There's a tools class: Imagery/Tools., _(*24)

• static public function pHash(Imagery $image, $sizes = array(8, 8)), _(*25)

  Calculates Perceptual hash of image., _(*26)