Instantiation

Learn how to manage and process images with the Intervention Image Manager. Read and decode images from multiple sources like file paths, Base64, and Data Uri, or create custom images and animations using PHP.

• Reading Images
  • Reading Image Sources
• Creating Images
  • Creating New Images
  • Creating Animations

Reading Images

Reading Image Sources

public ImageManager::read(mixed $input, string|array|DecoderInterface $decoders = []): ImageInterface

With a configured Image Manager it is possible to read images from different sources. The method not only accepts paths from file systems, but also binary image data, Base64-encoded image data or images in Data Uri format. It is also possible to pass a range of objects and PHP resources as input. A complete list can be found below.

Parameters

Supported Image Sources

The following input argument formats are accepted.

• Path in filesystem
• Raw binary image data
• Base64 encoded image data
• Data Uri
• File Pointer resource
• SplFileInfo from which Illuminate\Http\UploadedFile and Symfony\Component\HttpFoundation\File\UploadedFile are derived
• Intervention Image Instance (instance of Intervention\Image\Image)
• Encoded Intervention Image (instance of Intervention\Image\EncodedImage)
• Driver-specific image (instance of GDImage or Imagick)

To decode the input data, you can optionally specify a decoding strategy with the second parameter. This can be an array of class names or objects of decoders to be processed in sequence. In this case, the input must be decodedable with one of the decoders passed. It is also possible to pass a single object or class name of a decoder.

All decoders that implement the DecoderInterface::class can be passed. Usually a selection of classes of the namespace Intervention\Image\Decoders.

If the second parameter is not set, an attempt to decode the input is made with all available decoders of the driver.

If the given argument can not be decoded by the library an exception of type Intervention\Image\Exceptions\DecoderException is thrown.

Examples

use Intervention\Image\ImageManager;
use Intervention\Image\Drivers\Imagick\Driver;

// create new manager instance with desired driver
$manager = new ImageManager(new Driver());

// read image from filesystem
$image = $manager->read('images/example.jpg');

// read image from binary data
$image = $manager->read(file_get_contents('images/example.jpg'));

use Intervention\Image\ImageManager;
use Intervention\Image\Drivers\Imagick\Driver;
use Intervention\Image\Decoders\DataUriImageDecoder;
use Intervention\Image\Decoders\Base64ImageDecoder;
use Intervention\Image\Decoders\FilePathImageDecoder;

// create new manager instance with desired driver
$manager = new ImageManager(new Driver());

// read image only from data uri or base64 encoded data
$image = $manager->read($input, [
    DataUriImageDecoder::class,
    Base64ImageDecoder::class,
]);

// read image only from file path
$image = $manager->read($input, FilePathImageDecoder::class);

// same with object instead of class name
$image = $manager->read($input, new FilePathImageDecoder());

Creating Images

Creating New Images

public ImageManager::create(int $width, int $height): ImageInterface

Reading existing image sources is one thing, but what if you want to create your own images? Intervention Images can help you with that. You start with an instance of the Intervention\Image\ImageManager class and call the create() method with the desired image size as arguments. See the following example:

By default the image is created with a transparent background. If you want to define a background color instead use the fill() method after creation.

Parameters

Examples

use Intervention\Image\ImageManager;
use Intervention\Image\Drivers\Imagick\Driver;

// create new manager instance with desired driver
$manager = new ImageManager(Driver::class);

// create new image 640x480
$image = $manager->create(640, 480);

// create new image 512x512 with grey background
$image = $manager->create(512, 512)->fill('ccc');

Creating Animations

public ImageManager::animate(callable $callback): ImageInterface

It is also possible to create animated graphics. To do this, use the "animate" function. A callback function is passed to this function, which determines the source and the delay time of the individual animation images. It should be noted that the animation created in this way is output in a format that supports animations at all.

Animations are possible in all supplied drivers. Read more on how to modify animated images.

Parameters

Examples

use Intervention\Image\ImageManager;
use Intervention\Image\Drivers\Gd\Driver;

// create new manager instance with desired driver
$manager = new ImageManager(new Driver());

// create animated image with three frames and a delay of 250 ms for each frame
$image = $manager->animate(function ($animation) {
    $animation->add('images/frame01.png', .25);
    $animation->add('images/frame02.png', .25);
    $animation->add('images/frame03.png', .25);
})->setLoops(4);

use Intervention\Image\ImageManager;
use Intervention\Image\Drivers\Imagick\Driver;

// create new manager instance with desired driver
$manager = new ImageManager(Driver::Class);

// create a looping  5 frame circle animation by making 
// own animation frames via the drawCircle method
$animation = $manager->animate(function ($animation) use ($manager) {
    for ($i = 1; $i <= 5; $i++) {
        $animation->add(
            $manager->create(300, 300) // frame size
                ->fill('b53717') // frame background color
                ->drawCircle(150, 150, function ($circle) use ($i) {
                    $circle->radius(40 * $i); // radius of circle in pixels
                    $circle->border('fff', 5); // border color & size
                }),
            .15 // frame delay
        );
    }
})->setLoops(10);