Contao Imagine SVG library
This project implements the interfaces of Imagine and allows you to make simple modifications to SVG images. It is used in Contao to handle on-the-fly resizing of SVG images.
Installation
php composer.phar require contao/imagine-svg
Usage
use Contao\ImagineSvg\Imagine;
use Imagine\Image\Box;
use Imagine\Image\Point;
$imagine = new Imagine();
$imagine
->open('/path/to/image.svg')
->crop(new Point(50, 50), new Box(100, 100))
->resize(new Box(40, 40))
->save('/path/to/thumbnail.svg')
;
$image = $imagine->open('/path/to/image.svg');
$image->effects()
->gamma(1.5)
->negative()
->grayscale()
->colorize($color)
->sharpen()
->blur(2)
;
$image->save('/path/to/image.svg');
Because of the nature of SVG images, the getSize()
method differs a little bit
from other implementations. You can check the return value like in this example:
use Contao\ImagineSvg\Imagine;
use Contao\ImagineSvg\RelativeBoxInterface;
use Contao\ImagineSvg\UndefinedBoxInterface;
$imagine = new Imagine();
$size = $imagine->open('/path/to/image.svg')->getSize();
if ($size instanceof UndefinedBoxInterface) {
// The image has no defined size
} elseif ($size instanceof RelativeBoxInterface) {
// The image has a relative size, $size->getWidth() and $size->getHeight()
// should be treated as an aspect ratio
} else {
// The image has a defined size like a regular image
}