Download the PHP package shekarsiri/simpleimage without Composer
On this page you can find all versions of the php package shekarsiri/simpleimage. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download shekarsiri/simpleimage
More information about shekarsiri/simpleimage
Files in shekarsiri/simpleimage
Package simpleimage
Short Description A PHP class that simplifies working with images
License GPL-2.0 MIT
Informations about the package simpleimage
The SimpleImage PHP class
By Cory LaViska for A Beautiful Site, LLC. (http://www.abeautifulsite.net/)
Dual licensed under the MIT / GPLv2 licenses
Overview
This class makes image manipulation in PHP as simple as possible. The examples are the best way to learn how to use it, but here it is in a nutshell:
The two lines inside the try block load image.jpg, flip it horizontally, rotate it 90 degrees clockwise, shrink it to fit within a 320x200 box, apply a sepia effect, convert it to a GIF, and save it to result.gif.
With this class, you can effortlessly:
- Resize images (free resize, resize to width, resize to height, resize to fit)
- Crop images
- Flip/rotate/adjust orientation
- Adjust brightness & contrast
- Desaturate, colorize, pixelate, blur, etc.
- Overlay one image onto another (watermarking)
- Add text using a font of your choice
- Convert between GIF, JPEG, and PNG formats
- Strip EXIF data
Requirements
This class requires PHP 5.3 and PHP GD library.
Laravel Installation
- Add "shekarsiri/simpleimage": "dev-master" to your /laravel/composer.json
- Run the composer update
- Add 'Shekarsiri\Simpleimage\SimpleimageServiceProvider' to your 'providers' array in the app\config\app.php file
- Add 'SimpleImage' => 'Shekarsiri\Simpleimage\SimpleImage' to your 'aliases' array in the app\config\app.php file
Laravel Usage
Usage
Loading
You can load an image when you instantiate a new SimpleImage object:
Or you can create empty image 200x100 with black background:
Saving
Images must be saved after you manipulate them. To save your changes to the original file, simply call:
Alternatively, you can specify a new filename:
You can specify quality as a second parameter in percents within range 0-100
Converting Between Formats
When saving, the resulting image format is determined by the file extension. For example, you can convert a JPEG to a GIF by doing this:
Stripping EXIF data
There is no built-in method for stripping EXIF data, partly because there is currently no way to prevent EXIF data from being stripped using the GD library. However, you can easily strip EXIF data simply by loading and saving:
Method Chaining
SimpleImage supports method chaining, so you can make multiple changes and save the resulting image with just one line of code:
You can chain all of the methods below as well methods above. (You cannot chain the constructor, however, as this is not supported by PHP.)
Error Handling
SimpleImage throws exceptions when things don't work right. You should always load/manipulate/save images inside of a try/catch block to handle them properly:
Method Examples
Most methods have intelligent defaults so you don't need to pass in every argument. Check out SimpleImage.class.php for required/optional parameters and valid ranges for certain arguments.
- Valid positions are center, top, right, bottom, left, top left, top right, bottom left, bottom right
Utility Methods
The following methods are not chainable, because they return information about the image you're working with or output the image directly to the browser:
Change Log
2013-07-08: Version 2.3 (by Nazar Mokrynskyi)
Differences from Version 2.1
load
andcreate
methods now are public- namespace changed to abeautifulsite
- added composer support
- examples update
2013-07-08: Version 2.2 (by Nazar Mokrynskyi)
Differences from Version 2.1
smart_crop
andcrop_center
methods removed, simplifiedadaptive_resize
added instead, new method is compatible with old, but simpler
2013-07-07: Version 2.1 (by Nazar Mokrynskyi), a lot of refactoring and new features
Differences from Version 2
load
method hidden, use constructor instead- constructor extended with possibility to create empty image without source file (thanks to strip fork)
- added method
fill
for filling image with specified color (thanks to strip fork) - added method
output_base64
for getting image in form of string as data: URL (thanks to Fernando Cunha fork) - added
crop_center
method for cropping image of certain size in the center of image (thanks to Cezar Luiz fork) - quality of output now in percents, which is the same for any image type
- added
$quality
property for specifying default image quality value - private methods replaced by protected for inheritance possibility
- added support of RGB and RGBA colors in addition to HEX
- added interlacing to images in order to obtain progressive jpeg
2013-06-03: square_crop
was replaced with smart_crop
, which supports varying width/height as well as squares. Simply swap out square_crop
with smart_crop
to update.
Differences from Version 1
SimpleImage has been completely overhauled since version 1. Here are the most significant changes:
- Simple_Image is now SimpleImage
- For more efficient processing, the class now has public load and save methods. In version 1, these methods were automatically executed on every manipulation, which led to slower processing times and potential quality loss.
- Because load and save are now public methods, it only made sense to support method chaining. You can now make as many modifications as you want to an image and save it in just one line of code.
- A positioning bug in the text() method was fixed so positioning is 100% accurate now. In version 1, the size of the text box was erroneously calculating points instead of pixels.
- Arguments for many methods have been normalized. Opacity is always 0 through 1 (like in CSS) instead of 0 through 100 and colors are consistently passed in as hex color codes instead of RGB.
- A few methods were consolidated to use the public resize and crop methods instead of replicating the same functionality like in version 1.