wapmorgan / image-editor
This package is abandoned and no longer maintained.
The author suggests using the wapmorgan/imagery package instead.
Simple image editor for resizing, cropping and doing other elementary actions with images.
v0.0.7
2017-01-11 17:19 UTC
Requires
- ext-gd: *
README
!! Moved to another repository: https://github.com/wapmorgan/Imagery This one is not updatable at all!
ImageEditor is a wrapper of gd functions. Earlier it was working only in yii-application context, now you can use this package in any application.
Installation
- Composer package:
wapmorgan/image-editor
[1] - Archive:
https://github.com/wapmorgan/ImageEditor/archive/master.zip
How to start: Create from existing file or make an empty area
$image = ImageEditor::createFromFile($filename); // or $image = ImageEditor::createWithSize($width, $height); // or $image = ImageEditor::createFromResource(imagecreatetruecolor(90, 90));
Properties:
- width - width of image
- height - height of image
- resource - original gd-resource of image (you can pass it directly to image-gd functions)
Operations
Resize && Zoom (don't cut image)
can minimize and maximize image:
- zoomWidthTo(int $size) - changes proportionally image width to
$size
- zoomHeightTo(int $size) - changes proportionally image height to
$size
can only minimize image:
- decreaseWidthTo(int $size) - decreases proportionally image width to
$size
, if needed - decreaseHeightTo(int $size) - decreases proportionally image height to
$size
, if needed - decreaseTo(int $size) - decreases proportionally larger side to
$size
, if needed
can do everything you ask it for:
- resize(int $width, int $height) - resizes an image to
$width
X$height
Crop (can cut image)
- crop($x, $y, $x2, $y2) - cuts a rectangular piece of image
- 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
- rotate($angle, $bgColor = 0) - rotates an image.
True
equals 90°,False
equals -90°. - horizontalFlip() - flips an image horizontally.
- verticalFlip() - flips an image vertically.
Manipulation:
- appendImageTo($side, ImageEditor $appendix, int $modifiers) - appends an image (
$appendix
) to current image at$side
(top|bottom|left|right
). - placeImageAt($x, $y, ImageEditor $image) - places an image atop current image at
$x
X$y
. - placeImageAtCenter(ImageEditor $image) - places an image in the center of current image.
Save
- save($filename, $format, $quality) - saves image to disk.
Possible
$format
values: jpeg, png, gif, wbmp. Quality is an integer value between 0 (worst) and 100 (best).
Links
- ImageEditor repo: https://github.com/wapmorgan/ImageEditor
- ImageEditor testing script: https://github.com/wapmorgan/ImageEditor-test
- ImageEditor docs: https://github.com/wapmorgan/ImageEditor-doc
- ImageEditor class reference (API): http://wapmorgan.github.io/ImageEditor-doc/classes/ImageEditor.html
Changelog
+------------------------------------------------+--------------+------------------------------------------------------------------------------------------------------------------------+
| version | date | description |
+------------------------------------------------+--------------+------------------------------------------------------------------------------------------------------------------------+
| v0.0.6: composer fixes and ImageEditor updates | May 19, 2014 | Changed: |
| | | * Method **saveToFile()** marked as depricated. Now use **save()** method instead. |
| | | * Added method **tryCreateFromFile()** which returns either an ImageEditor instance (on success) or null (on failure). |
| | | * Fixed composer configuration (autoloading and requirements). |
+------------------------------------------------+--------------+------------------------------------------------------------------------------------------------------------------------+
| v0.0.5: instantiation from bmp files | May 6, 2014 | Changed: |
| | | * Added function **imagecreatefrombmp**. |
| | | * Some updates in `saveToFile()`: now you can use predefined constants like IMAGETYPE_XXX to specify output format. |
+------------------------------------------------+--------------+------------------------------------------------------------------------------------------------------------------------+
| v0.0.4: new class ImageEditorTools | Apr 22, 2014 | Changed: |
| | | * Added **ImageEditorTools.php** with `pHash()` method. |
+------------------------------------------------+--------------+------------------------------------------------------------------------------------------------------------------------+
| v0.0.3: standalone using and composer.json | Apr 22, 2014 | Changed: |
| | | * Added **CComponent.php**. **ImageEditor** loads in automatically if need. (so you can use ImageEditor without yii). |
| | | * Added **composer.json**. Packagist name: `wapmorgan/image-editor` |
+------------------------------------------------+--------------+------------------------------------------------------------------------------------------------------------------------+
| v0.0.2: a lot of changes | Apr 12, 2014 | Changed: |
| | | * allowing clone object. |
| | | * returning $this in all methods. |
| | | * **cropSide** renamed to **decreaseSide**. |
| | | * added **decreaseWidthTo**(), **decreaseHeightTo**() and **decreaseTo**(). |
| | | * **appendImageTo**() finished. |
| | | * **rotate()** fixed. |
| | | * **added gif and wbmp** formats in saveToFile(). |
| | | * **added mirroring functions**: horizontalFlip() and verticalFlip(). |
| | | * **added createFromResource** static public method. |
| | | * **created testing script**, **added docs**. |
+------------------------------------------------+--------------+------------------------------------------------------------------------------------------------------------------------+
| first commit | Oct 4, 2013 | |
+------------------------------------------------+--------------+------------------------------------------------------------------------------------------------------------------------+