PHP Image Library

Posted by Paul Whitrow, 27th May, 2009 | Permalink | 14 Comments

Whenever I'm working on a project that requires image manipulation, I always include this useful file. It's something that that's grown over time and includes functions both created by me and or found and modified on my travels through the web.

I've been able to produce pretty much everything I need with these, especially through function stacking.

Some of the functions in this library were used in creating xFlow! : A Javascript and PHP based Coverflow style gallery.

Anyway, I find it a useful thing to have, so thought I would share. I would of course welcome any suggestions for changes / improvements.

Feel free to grab it for yourself (download as a .txt file and rename as .php): Download Image Library

Remember, these are GD image functions, NOT ImageMagick!

---

Image Functions Library

Functions list:

1. _imageGreyScale()


2. _imageSepia()


3. _imageTint()


4. _imageRotate()


5. _imageResize()


6. _imageThumbPart()


7. _imageRoundCorners()


8. _imageWaterMark()


9. _imageMergeXY()


10. _imageShadow()


11. _imageFlip()


12. _imageReflect()


13. _imageTextWrite()


14. _imageFromString()


15. _imageBorder()


16. _imageCrop()


17. _imageSkew()


18. _imagePerspective()


19. _imageBlur()


20. _imageCopyToType()

Functions Descriptions:

1. 
   

   Greyscale

   
   

   _imageGreyScale('original.jpg', 'greyscale.jpg')

   
   

   _imageGreyScale (str $source, str $target)

   
   

   Converts an image ($source) to a grey scaled version.

   
   

   $target is an output file name. If you wish to ovewrite the original image, make $source and $target equal.

   
   
   
   
   
   
   


2. 
   

   Sepia

   
   

   _imageSepia('original.jpg', 'sepia.jpg')

   
   

   _imageSepia (str $source, str $target)

   
   

   Converts an image ($source) to a sepia coloured version.

   
   

   $target is an output file name. If you wish to ovewrite the original image, make $source and $target equal.

   
   
   
   
   
   
   


3. 
   

   Tint

   
   

   _imageTint('original.jpg', 'tint.jpg', 'FFCC00')

   
   

   _imageTint (str $source, str $target, str $tint)

   
   

   Converts an image ($source) to a color tinted ($tint) version.

   
   

   $target is an output file name. If you wish to ovewrite the original image, make $source and $target equal.

   
   
   
   
   
   
   


4. 
   

   Rotate

   
   

   _imageRotate('original.jpg', 'rotate.jpg', 45)

   
   

   _imageRotate (str $source, str $target, int $degrees)

   
   

   Rotates an image ($source) by the given degree ($degrees)

   
   

   $target is an output file name. If you wish to ovewrite the original image, make $source and $target equal.

   
   
   
   
   
   
   


5. 
   

   Resize

   
   

   _imageResize('original.jpg', 'resize.jpg', 100, 100, 'w')

   
   

   _imageResize (str $source, str $target, int $w, int $h, str $aspect)

   
   

   Resizes by values entered ($w, $h) and maintains the aspect of an image ($source). Aspect ($aspect) can be 'h' or 'w', for resizing by 'height' or 'width' respectively.

   
   

   $target is an output file name. If you wish to ovewrite the original image, make $source and $target equal.

   
   
   
   
   
   
   


6. 
   

   Thumbnail (part)

   
   

   _imageThumbPart('original.jpg', 'thumbpart.jpg', 75, 75)

   
   

   _imageThumbPart (str $source, str $target, int $tw, int $th)

   
   

   Creates a thumbnail image of the sizes entered ($tw, $th), from the center of the image ($source)

   
   

   $target is an output file name. If you wish to ovewrite the original image, make $source and $target equal.

   
   

   Use function _imageResize to create a full thumbnail

   
   
   
   
   
   
   


7. 
   

   Round Corners

   
   

   _imageRoundCorners('original.jpg', 'corners.jpg', 20, 'ffffff')

   
   

   _imageRoundCorners (str $source, str $target, int $radius, str $bgcolor)

   
   

   Rounds the corners of an image ($source) by the given radius ($radius), by creating PNG images of colour ($bgcolor) and placing those corner images over the source image in the four corner positions.

   
   

   $target is an output file name. If you wish to ovewrite the original image, make $source and $target equal.

   
   
   
   
   
   
   


8. 
   

   Watermark

   
   

   _imageWaterMark('original.jpg', 'watermark.jpg', 'watermark.gif', 25, 10)

   
   

   _imageWaterMark (str $source, str $target, str $wmFile, int $transparency, str $margin)

   
   

   Places a watermark image ($wmFile) on top of the source image ($source) in the bottom right location of the source image, with a given transparency ($transparency) and a given margin ($margin)

   
   

   $target is an output file name. If you wish to ovewrite the original image, make $source and $target equal.

   
   
   
   
   
   
   


9. 
   

   Image Merge Co-Ordinates

   
   

   _imageMergeXY('original.jpg', 'merge.jpg', 'marker.gif', 210, 180, 100)

   
   

   _imageMergeXY (str $source, str $target, str $merge, str $x, str $y, int $transparency)

   
   

   Places an image ($merge) on top of the source image ($source) in the position specified ($x, $y) , with a given transparency ($transparency).

   
   

   $target is an output file name. If you wish to ovewrite the original image, make $source and $target equal.

   
   
   
   
   
   
   


10. 
    

    Shadow

    
    

    _imageShadow('original.jpg', 'shadow.jpg', 5, 10, 1, 'ffffff')

    
    

    _imageShadow (str $source, str $target, int $offset, int $steps, str $spread, str $bgcolor)

    
    

    Places a (drop) shadow to the bottom right of the source image ($source). The shadow is offset ($offset) from the image, can be spread over a desired distance ($spread), and also scaled by steps ($steps).

    
    

    $target is an output file name. If you wish to ovewrite the original image, make $source and $target equal.

    
    
    
    
    
    
    


11. 
    

    Flip

    
    

    _imageFlip('original.jpg', 'flip.jpg', 'h')

    
    

    _imageFlip (str $source, str $target, str $mode)

    
    

    Flips an image ($source) by vertical axis ($mode = 'v'), horizontal axis ($mode = 'h') or both axis ($mode = 'both')

    
    

    $target is an output file name. If you wish to ovewrite the original image, make $source and $target equal.

    
    
    
    
    
    
    


12. 
    

    Reflect

    
    

    _imageReflect('original.jpg', 'reflect.jpg', 'ffffff', 1, 80, 10)

    
    

    _imageReflect (str $source, str $target, str $colorfade, int $fadeheight, int $fadestart)

    
    

    Creates a reflection (also know as 'wet floor') effect for the source image ($source). The background colour of the fade ($colorfade) can be set to match the document background colour. The height of the reflection ($fadeheight) can be set as desired, as can the starting transparency ($fadestart) of the reflection.

    
    

    $target is an output file name. If you wish to ovewrite the original image, make $source and $target equal.

    
    
    
    
    
    
    


13. 
    

    Text

    
    

    _imageTextWrite('original.jpg', 'text.jpg', "Leaf", 'AUGUSTUS.TTF', 40, 'FFCC00', '484848')

    
    

    _imageTextWrite (str $source, str $target, str $text, str $font, int $fontsize, str $color, str $bgcolor)

    
    

    Place centralised (vertical and horizontal) text onto an image ($source). Set the text string ($text), the font (this is done by calling in any True Type font file ($font)), the font size ($fontsize), and the text color ($color). A shadow can be applied to the text by setting a dark color ($bgcolor) for the shadow text. This text will be the same as the input text, but will be placed 2 (two) pixels to the right and down, and then behind the original text.

    
    

    $target is an output file name. If you wish to ovewrite the original image, make $source and $target equal.

    
    
    
    
    
    
    


14. 
    

    Strings

    
    

    _imageFromString('string.jpg', "Strings!", 'AUGUSTUS.TTF', 40, 'FF6600', 'FFFFCC')

    
    

    _imageFromString (str $target, str $text, str $font, int $fontsize, str $color, str $bgcolor)

    
    

    Create an image ($target) centralised (vertical and horizontal) of the input text ($text). Set the font (this is done by calling in any True Type font file ($font)), the font size ($fontsize), the text color ($color) and the background color ($bgcolor).

    
    
    
    
    
    
    


15. 
    

    Border

    
    

    _imageBorder('original.jpg', 'border.jpg', 8, '339900')

    
    

    _imageBorder (str $source, str $target, int $borderwidth, str $bordercolor)

    
    

    Places a border of desired size ($borderwidth) and color ($bordercolor) around an image ($source)

    
    

    $target is an output file name. If you wish to ovewrite the original image, make $source and $target equal.

    
    
    
    
    
    
    


16. 
    

    Crop

    
    

    _imageCrop('original.jpg', 'crop.jpg', 0, 0, 100, 100)

    
    

    _imageCrop (str $source, str $target, int $x, int $y, int $w, int $h)

    
    

    Crops an image ($source) starting at co-ordinates ($x & $y) to new size ($w & $h)

    
    

    $target is an output file name. If you wish to ovewrite the original image, make $source and $target equal.

    
    
    
    
    
    
    


17. 
    

    Perspective

    
    

    _imagePerspective('original.jpg', 'perspective.jpg', 15, 0, 'ffffff')

    
    

    _imagePerspective (str $source, str $target, int $angle, int $dir, str $bgcolor)

    
    

    Add perspective to an image ($source) by desired degrees ($angle) and desired direction ($dir) (left = 0, right = 1), with a defined background colour ($bgcolor).

    
    

    $target is an output file name. If you wish to ovewrite the original image, make $source and $target equal.

    
    
    
    
    
    
    


18. 
    

    Skew

    
    

    _imageSkew('original.jpg', 'skew.jpg', 0.25, 'right', 'ffffff')

    
    

    _imageSkew (str $source, str $target, int $angle, int $dir, str $bgcolor)

    
    

    Skews an image ($source) by desired degrees ($angle) and desired direction ($dir) (left, right), with a defined background colour ($bgcolor).

    
    

    $target is an output file name. If you wish to ovewrite the original image, make $source and $target equal.

    
    
    
    
    
    
    


19. 
    

    Blur

    
    

    _imageBlur('original.jpg', 'blur.jpg')

    
    

    _imageBlur (str $source, str $target)

    
    

    Blur an image ($source).

    
    

    $target is an output file name. If you wish to ovewrite the original image, make $source and $target equal.

    
    
    
    
    
    
    


20. 
    

    Change File Type

    
    

    _imageCopyToType('original.jpg', 'original.gif')

    
    

    _imageCopyToType (str $source, str $target)

    
    

    Changes an image ($source) to a new image type (target). Supports JPG, GIF and PNG

    
    

    $target is an output file name. If you wish to ovewrite the original image, make $source and $target equal.

    
    
    
    
    
    
    

Function Stacking

Functions can also be stacked (run one after the other on the same image) to create a combination of effects:

• 
  

  
  		$file = 'multi.jpg';
  		_imageBorder('original.jpg', $file, 6, '000000');
  		_imageTextWrite($file, $file, "Multi Effects", 'AUGUSTUS.TTF', 20, 'FFCC00', '484848');
  		_imageReflect($file, $file, 'ffffff');
  		

  
  


•