elgervb/imagemanipulation

Library for image manipulation in PHP with GD

IMAGEMANIPULATION

br/ Fork me on GitHub: https://github.com/elgervb/imagemanipulation , _(*1)

Library to manipulate images using PHP's GD library. Most of the functionality is available through the ImageBuilder facade. This way chaining of image filters and thumbnailing is possible, like:, _(*2)

ImageBuilder::create( new \SplFileInfo('image.jpg') )
  ->contrast( 20 ) // increase contrast
  ->colorize( '#DB3636' ) // apply a bit of red the the image
  ->flip( ImageFilterFlip::FLIP_VERTICALLY ) // flip image vertically
  ->save( new \SplFileInfo( 'image.new.png' ) ) // save the jpg image as png with filters applied
  ->render( 80 ); // render to browser with quality 80

Installation

With composer.json:

    "require" : {
        "elgervb/imagemanipulation": "^1.0"
    }

Requirements

PHP version >= 5.3 with GD library, _(*3)

FUNCTIONALITY

Filters

Lots of image filters. All of them listed below:, _(*4)

• brightness
• colorize
• comic
• contrast
• convolution 3x3 filters
• darken
• dodge
• duotone
• edge detect
• emboss
• find edges
• flip (horizonal, vertical, both)
• gamma correction
• gaussian blur
• grayscale
• hue rotate
• mean remove
• motion blur
• negative
• noise
• old cardboard
• opacity
• pixelate
• random blocks with custom size and color
• replace color
• reverse
• rounded corners
• scatter
• selective blur
• semi grayscale
• sepia
• sepia fast
• sharpen
• smooth
• sobel edge detect
• sobel edge enhance (based on convolution matrix)
• true color
• vignette

Overlay

Use an image as overlay on another image. Can be configured with overlay opacity, start and end position and fill options., _(*5)

Reflection

Use the current image to make a reflection below the original image, _(*6)

Image repeater

Repeat images on a canvas, until it fits. This way we can create Warhol like images., _(*7)

Rotate

Rotate images in degrees. When rotating an image not equal to 90, 180, 270 or 360 degrees, then optionally you can specify a background color for those oncovered edges., _(*8)

Thumbnails

Create thumbnails on the fly. There are several strategies to use:, _(*9)

• Centered strategy: create a thumb from the center of an image. Ideal for creating square thumbs from not so square images
• Max strategy: resize the image to a max width or height keeping proportions. For example: when resizing an image (300x750) on max 500 pixels, the resulting image will be 200x500 pixels
• Percentage strategy: reduce the size of an image with a certain percentage.

Watermarking

Add a watermark to your image. Possible positions are: top, bottom, left, right, center, top right, top left, bottom right, bottom left., _(*10)

Examples

Thumbnails

You can create thumbnails in several ways, _(*11)

centered

create a thumbnail which is centered in the middle of the image, _(*12)

Examples
, _(*13)

max

resize the image to a max width or height keeping proportions, thus restraining the image to a certain size, _(*14)

Examples
, _(*15)

percentage

reduce a image with a certain percentage, _(*16)

Examples
, _(*17)

square

Examples
, _(*18)

Available Filters

blocks

Add random blocks to an image with custom size and color, _(*19)

Examples
, _(*20)

brightness

Adjust the brightness of the image, either lighter or darker, _(*21)

Examples
, _(*22)

colorize

Blends a fill color with the image, _(*23)

Examples
, _(*24)

comic

Apply a sketchy comic filter to an image, _(*25)

Examples
, _(*26)

contrast

Changes the contrast of the image, _(*27)

Examples
, _(*28)

darken

Adjust the brightness of the image, either darker or lighter, _(*29)

Examples
, _(*30)

dodge

Dodge an image, resulting in a darker image, _(*31)

Examples
, _(*32)

duotone

Duotone filter. Enhances Red, Green or Blue or a combination, _(*33)

Examples
, _(*34)

edgedetect

Uses edge detection to highlight the edges in the image, _(*35)

Examples
, _(*36)

emboss

Embosses the image, _(*37)

Examples
, _(*38)

findedges

Find the edges in an image without color loss, _(*39)

Examples
, _(*40)

flip

Flips an image, _(*41)

Examples
, _(*42)

gammacorrection

Applies gamma correction, _(*43)

Examples
, _(*44)

gaussianblur

Blurs the image using the Gaussian method., _(*45)

Examples
, _(*46)

grayscale

Converts the colors to grayscale, _(*47)

Examples
, _(*48)

huerotate

Rotete the hue of the image, _(*49)

Examples
, _(*50)

meanremove

Uses mean removal to achieve a "sketchy" effect, _(*51)

Examples
, _(*52)

motionblur

Motion blurs the image, _(*53)

Examples
, _(*54)

negative

Create a negative of an image, _(*55)

Examples
, _(*56)

noise

add noise to the image, _(*57)

Examples
, _(*58)

oldcardboard

Image filter to give the image an old cardboard look, _(*59)

Examples
, _(*60)

opacity

Sets the opacity of an image, _(*61)

Examples
, _(*62)

pixelate

Pixelate an image, _(*63)

Examples
, _(*64)

rotate

Rotate an image over an angle, _(*65)

Examples
, _(*66)

scatter

Scatter pixels around in a random way, _(*67)

Examples
, _(*68)

selectiveblur

Image filter Selective Blur, _(*69)

Examples
, _(*70)

sepia

Apply sepia to the image, _(*71)

Examples
, _(*72)

semigrayscale

Applies grayscale to an image, optionally add a grayscale percentage, _(*73)

Examples
, _(*74)

sepiafast

Apply sepia to the image (fast), _(*75)

Examples
, _(*76)

sharpen

Sharpens the image, _(*77)

Examples
, _(*78)

smooth

Makes the image smoother., _(*79)

Examples
, _(*80)

sobel

Sobel edge detect (extremely slow...), _(*81)

Examples
, _(*82)

sobeledge

Sobel edge enhance, _(*83)

Examples
, _(*84)

truecolor

Makes the image smoother., _(*85)

Examples
, _(*86)

vignette

Applies a darker mask around the edges of the image, _(*87)

Examples
, _(*88)