joacub / webino-image-thumb
Image Thumbnailer for Zend Framework 2
Requires
- php: >=5.3.3
- masterexploder/phpthumb: 2.*
Requires (Dev)
- apigen/apigen: 2.*
- mayflower/php-codebrowser: *
- pdepend/pdepend: 1.*
- phploc/phploc: *
- phpmd/phpmd: 1.*
- phpunit/phpunit: 3.7.*
- sebastian/phpcpd: *
- squizlabs/php_codesniffer: 1.*
- zendframework/zendframework: 2.*
Suggests
- zendframework/zend-modulemanager: To use it as Zend Framework module
This package is not auto-updated.
Last update: 2024-11-01 19:37:39 UTC
README
Service that provides API to manipulate images.
- Powered by PHPThumb
- Demo webino-image-thumb.demo.webino.org
Features
- Resize, crop, pad, rotate, show and save images
- Create image reflection
- Crop whitespace
- Sharpen images
- Watermark
Setup
Following steps are necessary to get this module working, considering a zf2-skeleton or very similar application:
- Run:
php composer.phar require webino/webino-image-thumb:dev-develop
- Add
WebinoImageThumb
to the enabled modules list
Requirements
- GD 2.0+
QuickStart
-
For example add following code into the controller action, assume example image:
// We encourage to use Dependency Injection instead of Service Locator $thumbnailer = $this->getServiceLocator()->get('WebinoImageThumb'); $imagePath = 'public/images/example.jpg'; $thumb = $thumbnailer->create($imagePath, $options = [], $plugins = []); $thumb->resize(100, 100); $thumb->show(); // or/and $thumb->save('public/images/resized.jpg');
NOTE: If you don't know how to inject the WebinoImageThumb into action controller, check out
test/resources
-
Use reflection plugin:
$reflection = $thumbnailer->createReflection(40, 40, 80, true, '#a4a4a4'); $thumb = $thumbnailer->create($imagePath, [], [$reflection]);
-
Use whitespace cropper plugin:
$cropper = $thumbnailer->createWhitespaceCropper(); $thumb = $thumbnailer->create($imagePath, [], [$cropper]);
-
Use sharpen plugin:
$sharpen = $thumbnailer->createSharpen(); $thumb = $thumbnailer->create($imagePath, [], [$sharpen]);
-
Use watermark plugin:
$watermarkPath = 'public/images/my_watermark.png'; $watermarkThumb = $thumbnailer->create($watermarkPath); $watermark = $thumbnailer->createWatermark($watermarkThumb); $thumb = $thumbnailer->create($imagePath, [], [$watermark]);
Options
The options array allows you to customize the behavior of the library a bit. Some of these options are implementation-specific, and are noted as such. So, let's first go over what options are available to us:
Functions
adaptiveResize($width, $height)
adaptiveResizePercent($width, $height, $percent = 50)
adaptiveResizeQuadrant($width, $height, $quadrant = 'T|B|C|L|R')
crop($startX, $startY, $cropWidth, $cropHeight)
cropFromCenter($cropWidth, $cropHeight = null)
pad($width, $height, $color = [255, 255, 255])
resize($maxWidth, $maxHeight)
resizePercent($percent)
rotateImage($direction = 'CW|CCW')
rotateImageNDegrees($degrees)
save($fileName, $format = 'GIF|JPG|PNG')
show($rawData = false)
Getters / Setters
getCurrentDimensions()
getFileName()
getFormat()
getIsRemoteImage()
getMaxHeight()
getMaxWidth()
getNewDimensions()
getOldImage()
getOptions()
getPercent()
getWorkingImage()
setCurrentDimensions($currentDimensions)
setFileName($fileName)
setFormat($format)
setMaxHeight($maxHeight)
setMaxWidth($maxWidth)
setNewDimensions($newDimensions)
setOldImage($oldImage)
setOptions($options)
setPercent($percent)
setWorkingImage($workingImage)
Reflection plugin
-
createReflection($percent, $reflection, $white, $border, $borderColor)
$percent
- What percentage of the image to create the reflection from.$reflection
- What percentage of the image height should the reflection height be.$white
- How transparent (using white as the background) the reflection should be, as a percent.$border
- Whether a border should be drawn around the original image.$borderColor
- The hex value of the color you would like your border to be.
Whitespace Cropper plugin
-
createWhitespaceCropper($border, $color)
$margin
- What pixels of a margin should be around the original image.$color
- The hex value of the color you would like to crop.
Watermark plugin
-
createWatermark(PHPThumb $watermarkThumb, $position = [0, 0], $scale = .5)
$watermarkThumb
- Watermark image from watermark file.$position
- Position of watermark, center by default:[0, 0]
- center[-1, -1]
- left bottom[-1, 1]
- left top[1, 1]
- right top[1, -1]
- right bottom
$scale
- Scale of the watermark relative to the image.
Changelog
2.0.0 [UNRELEASED]
- Requires PHPThumb 2.0 via composer
- Added Whitespace Cropper plugin
- Added Sharpen plugin
- Removed ZF autoloader support
- Added Watermark plugin
- Added ImageThumbAwareInterface & Trait
1.0.0
- Initial release
Development
We will appreciate any contributions on development of this module.
Learn How to develop Webino modules
Addendum
Most of the documentation is taken from the PHPThumb wiki.
Please, if you are interested in this Zend Framework module report any issues and don't hesitate to contribute.