Image_moo

Image_Moo is currently at version 1.0.0 – 7th Dec 2010

Download image_moo (v1.0.1)

The CI library for image manipulation is great, but I found it awkward to use when doing multiple processes. So I wrote my own library which I’m happy for you to play with and send feedback. It is limited to PHP 5 and GD2 only, sorry, but that suits my needs.

Install

Copy the unzipped file to /system/application/libraries for CI > 1.7.2 and /application/libraries for CI 2.

Functions

load($x) - Loads a base image as specified by $x - JPG, PNG, GIF supported. This is then used for all processing and is kept in memory till complete

save($x,$overwrite=FALSE) - Saved the manipulated image (if applicable) to file $x - JPG, PNG, GIF supported. If overwrite is not set file write may fail. The file saved will be dependant on processing done to the image, or a simple copy if nothing has been done.

save_dynamic($filename="") - Saves as a stream output, use filename to return png/jpg/gif etc., default is jpeg

save_pa($prepend="", $append="", $overwrite=FALSE) - Saves the file using the original location and filename, however it adds $prepend to the start of the filename and adds $append to the end of the filename. e.g. if your original file was /this/that/file.jpg you can use save_pe("pre_", "_app", TRUE) to save it as /this/that/pre_file_app.jpg

resize($x,$y,$pad=FALSE) - Proportioanlly resize original image using the bounds $x and $y, if padding is set return image is as defined centralised using current background colour (set_background_colour)

resize_crop($x,$y) - Proportioanlly resize original image using the bounds $x and $y but cropped to fill dimensions

stretch($x,$y) - Take the original image and stretch it to fill new dimensions $x $y, unless you have done the calculations this will distort the image

crop($x1,$y1,$x2,$y2) - Crop the original image using Top left, $x1,$y1 to bottom right $x2,y2. New image size =$x2-x1 x $y2-y1

rotate($angle) - Rotates the work image by X degrees, normally 90,180,270 can be any angle.Excess filled with background colour

load_watermark($filename, $transparent_x=0, $transparent_y=0) - Loads the specified file as the watermark file, if using PNG32/24 use x,y to specify direct positions of colour to use as index

make_watermark_text($text, $fontfile, $size=16, $colour="#ffffff", $angle=0) - Creates a watermark image using your text and specified ttf font file. 

watermark($position, $offset=8, $abs=FALSE) - Use the loaded watermark, or created text to place a watermark. $position works like NUM PAD key layout, e.g. 7=Top left, 3=Bottom right $offset is the padding/indentation, if $abs is true then use $positiona and $offset as direct values to watermark placement 

shadow($size=4, $direction=3, $colour="#444") - Add a basic shadow to the image. Size in pixels, note that the image will increase by this size, so resize(400,400)->shadow(4) will give an image 404 pixels in size, Direction works on the keypad basis like the watermark, so 3 is bottom right, 7 top left, $color if the colour of the shadow.

border($width,$colour="#000") - Draw a border around the output image X pixels wide in colour specified. This can be used multiple times, e.g. $this->image_moo->border(6,"#fff")->border(1,"#000") creates a photo type of border

border_3d($width,$rot=0,$opacity=30) - Creates a 3d border (opaque) around the current image $width wise in 0-3 rot positions, $opacity allows you to change how much it effects the picture

filter($function, $arg1=NULL, $arg2=NULL, $arg3=NULL, $arg4=NULL) - Runs the standard imagefilter GD2 command, see http://www.php.net/manual/en/function.imagefilter.php for details

round($radius,$invert=FALSE,$corners(array[top left, top right, bottom right, bottom left of true or False)="") default is all on and normal rounding. This functions masks the corners to created a rounded edge effect.

Image helper functions

display_errors($open = '<p>', $close = '</p>') - Display errors as Ci standard style. Example if ($this->image_moo->error) print $this->image_moo->display_errors();

set_jpeg_quality($x) - quality to wrte jpeg files in for save, default 75 (1-100)

set_watermark_transparency($x) - the opacity of the watermark 1-100, 1-just about see, 100=solid

check_gd() - Run to see if you server can use this library

clear_temp() - Call to clear the temp changes using the master image again

clear() - Use to clear all loaded images form memory

Examples

All the examples here will use the image as shown on the right hand side (click to expand) and we will use the save_dynamic output instead of saving as a file. Of course all the examples are missing 2 bits of common code, to reduce space used. Before image_moo works, you need to load it with $this->load->library(“image_moo”);, and after running a function you should check for errors and report as needed. if($this->image_moo->error) print $this->image_moo->display_errors();.

Cropping

The following section shows the various ways Image_moo can crop and resize an image

Simple crop
Image is cropped to a max in either axis of 100 pixels, output image will be the same ratio as the input image
$this->image_moo
	->load("DSC01707.JPG")
	->resize(100,100)
	->save_dynamic()

Crop keep proportions but outputting a fixed size
Image is cropped as above, but the output is padded to fit the specified size. Please note I set a funny background colour for visual reasons only
$this->image_moo
	->load('DSC01707.JPG')
	->set_background_colour("#49F")
	->resize(100,100,TRUE)
	->save_dynamic();

Resize with crop
Image is resized to an exact size based on cropping a ratio match from the original image
$this->image_moo
	->load('DSC01707.JPG')
	->resize_crop(100,100)
	->save_dynamic();

Borders

In these examples we will add various borders to the output image

Simple photo style border
$this->image_moo
	->load('DSC01707.JPG')
	->resize_crop(100,100)
	->border(5, "#ffffff")
	->border(1, "#000000")
	->save_dynamic();

Rounded corners
Note that the background colour used can be set with the set_background_colour command, we have left it white for this example.
$this->image_moo
	->load('DSC01707.JPG')
	->resize_crop(100,100)
	->round(5)
	->save_dynamic();

3d effect
$this->image_moo
	->load('DSC01707.JPG')
	->resize_crop(100,100)
	->border_3d(5)
	->save_dynamic();

Watermarking

You can also apply watermarks to your images!

Using an image
$this->image_moo
	->load('DSC01707.JPG')
	->load_watermark("matmoo.gif")
	->resize(400,400)
	->watermark(5)
	->save_dynamic();



Using your own text
$this->image_moo
	->load('DSC01707.JPG')
	->make_watermark_text("MatMoo.com", "DANUBE__.TTF", 25, "#000")
	->resize(400,400)
	->watermark(2)
	->save_dynamic();

Conclusion

As you can see this library is much easier to use than that default Image_lib that comes with CI, especially when it comes to mulitple picture outputs. For example; once an image is loaded you can run multiple commands and saves on it $this->image_moo->load(“image.jpg”)->resize(600,600)->save(“large.jpg”)->resize(400,400)->save(“medium.jpg”)->resize(100,100)->save(“small.jpg”) and of course you can add watermarks after each resize (or borders) as well.

Todo

Rotated text fix box size

Changelog

1.0.1: 13th Dec 2010, Fixed watermark text after changes to images, it got broken (oops)
1.0.0: 7th Dec 2010, Change the way the watermarks are applied using a suggested fix from the PHP help docs on imagecopy,merge page
0.9.9b: 10th Nov 2010, Modify resize routine calculation, thanks Cole
0.9.9a : 17th Oct 2010, Another pa save bug!
0.9.9 : 1st Oct 2010, added shadow system
0.9.3 : 10th Sep 2010, bug fix in save_pa thanks to Matjaz
0.9.2 : 26th Aug 2010, fixed an error with set background colour (stupid cut and paste error!)
0.9.2 : 26th Aug 2010, added a couple of additional defaults for round and border