Image Output

Learn how to encode images with Intervention Image, including support for various formats like JPEG, PNG, WebP, and AVIF. Discover versatile methods to encode by file path, media type, or file extension, with customization options.

• Encode Images
  • Encode Images with Encoder Objects
  • Encode Images by Media (MIME) Type
  • Encode Images by File Path
  • Encode Images by File Extension
• Encode with Shortcut Methods
  • Encode JPEG Format
  • Encode WebP Format
  • Encode PNG Format
  • Encode GIF Format
  • Encode Windows Bitmap Format
  • Encode AV1 Image File Format (AVIF)
  • Encode TIFF Format
  • Encode JPEG 2000 Format
  • Encode Heic Format
• Handling of Encoded Image Data
  • Cast Encoded Image Data to String
  • Save Encoded Image Data in Filesystem
  • Create Data URI Scheme
  • Transform Encoded Image to File Pointer
  • Retrieve Media (MIME) Type of an Encoded Image
• Write Images Directly
  • Encode & Save Combined

Encode Images

Encode Images with Encoder Objects

public Image::encode(EncoderInterface $encoder = new AutoEncoder()): EncodedImage

This method encodes the image with the given encoder object. The following encoders are currently available.

• Intervention\Image\Encoders\AutoEncoder::class
• Intervention\Image\Encoders\JpegEncoder::class
• Intervention\Image\Encoders\WebpEncoder::class
• Intervention\Image\Encoders\PngEncoder::class
• Intervention\Image\Encoders\GifEncoder::class
• Intervention\Image\Encoders\AvifEncoder::class
• Intervention\Image\Encoders\BmpEncoder::class
• Intervention\Image\Encoders\TiffEncoder::class
• Intervention\Image\Encoders\Jpeg2000Encoder::class
• Intervention\Image\Encoders\HeicEncoder::class

If no encoder is passed the AutoEncoder is used which will attempt to detect the output format automatically according to the original format of the image.

Parameters

Example

use Intervention\Image\ImageManager;
use Intervention\Image\Drivers\Gd\Driver;
use Intervention\Image\Encoders\AutoEncoder;
use Intervention\Image\Encoders\WebpEncoder;
use Intervention\Image\Encoders\GifEncoder;

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

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

// encode as the originally read image format
$encoded = $image->encode(); // Intervention\Image\EncodedImage

// encode as the originally read image format but with a certain quality
$encoded = $image->encode(new AutoEncoder(quality: 10)); // Intervention\Image\EncodedImage

// encode jpeg as webp format
$encoded = $image->encode(new WebpEncoder(quality: 65)); // Intervention\Image\EncodedImage

// result will be gif format
$encoded = $image->encode(new GifEncoder()); // Intervention\Image\EncodedImage

Encode Images by Media (MIME) Type

public Image::encodeByMediaType(null|string|MediaType $type = null, mixed ...$options): EncodedImage

Encode an image to given media (mime) type.

If no media type is given the image will be encoded to the format of the originally read image's mime type.

Parameters

Example

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

// create new manager instance and read webp image
$image = new ImageManager(Driver::class)
    ->read('images/example.webp');

// encoded result will be the same as original
$encoded = $image->encodeByMediaType();

// encoded result will be the same as original but with low quality
$encoded = $image->encodeByMediaType(quality: 10);

// encoded result will be in progressive jpeg format
$encoded = $image->encodeByMediaType('image/jpeg', progressive: true, quality: 20);

// result will be in gif format
$encoded = $image->encodeByMediaType('image/gif');

// or use member of MediaType enum
$encoded = $image->encodeByMediaType(MediaType::IMAGE_GIF);

Encode Images by File Path

public Image::encodeByPath(null|string $path = null, mixed ...$options): EncodedImage

Encode the image into the format represented by the extension of the given file path. Add an optional parameters to define encoder options. If no path is given the image will be encoded to the format of the originally read image.

Note that this method does not write the given path, but only uses this information to extract the target format.

Parameters

Example

use Intervention\Image\ImageManager;

// image file path
$path = 'images/example.png';

// create new manager instance and read from path
$image = new ImageManager::imagick() ->read($path);

// encoded format will be the same as original
$encoded = $image->encodeByPath();

// resulting format will be the same as original but with low quality
$encoded = $image->encodeByPath(quality: 10);

// resulting format will jpeg because "jpg" represents jpeg format
$encoded = $image->encodeByPath('images/example.jpg', progressive: true, quality: 10);

// result will be gif format
$encoded = $image->encodeByPath('images/example.gif');

Encode Images by File Extension

public Image::encodeByExtension(null|string|FileExtension $extension = null, mixed ...$options): EncodedImage

Encode the image into the format represented by the given file extension. Define the image quality with the optional second parameter. If no extension is given the image will be encoded to the format of the originally read image.

Parameters

Example

use Intervention\Image\ImageManager;

// create new manager instance and read image
$image = new ImageManager::gd() ->read('example.jpg');

// resulting format will be the same as original
$encoded = $image->encodeByExtension();

// resulting format will be the same as original but with low quality
$encoded = $image->encodeByExtension(quality: 10);

// result will be jpeg format
$encoded = $image->encodeByExtension('jpg', progressive: true, quality: 10);

// result will be PNG format
$encoded = $image->encodeByExtension('png');

// alternatively use member of FileExtension enum
$encoded = $image->encodeByExtension(FileExtension::PNG);

Encode with Shortcut Methods

There is a corresponding shortcut method for each image format, which can be called up directly from the image object.

Encode JPEG Format

public Image::toJpeg(int $quality = 75, bool $progressive = false, null|bool $strip = null): EncodedImage

Encode the current image instance in JPEG format in the given quality ranging between 0 for low quality to 100 for best quality.

Parameters

Example

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

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

// read gif image
$image = $manager->read('images/example.gif');

// encod jpeg data
$encoded = $image->toJpeg(90); // Intervention\Image\EncodedImage

Encode WebP Format

public Image::toWebp(int $quality = 75, null|bool $strip = null): EncodedImage

Encode the current image instance in the WebP graphic format in the given quality ranging between 0 for low quality to 100 for best quality.

Parameters

Example

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

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

// read gif image
$image = $manager->read('images/example.gif');

// encod jpeg data
$encoded = $image->toWebp(60); // Intervention\Image\EncodedImage

Encode PNG Format

public Image::toPng(bool $interlaced = false, bool $indexed = false): EncodedImage

This method encodes the current image instance in PNG format. Further details of the format can be defined via the parameters. It is possible to set the encoding method for the PNG image to interlaced, which means the image can be progressively rendered; non-interlaced sequential saving is used here by default.

The second option indexed determines whether the image is saved with an indexed (limited) color palette. With this option, the colors are automatically reduced, which results in smaller file sizes, but can also lead to a loss of quality in the coloring. By default, the encoder always outputs truecolor format.

Please note that the GD driver for PNG output with indexed color palette only supports binary transparency. This means that colors can either be completely transparent or completely opaque. Semi-transparency is not possible with GD.

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

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

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

// encode as truecolor png image
$encoded = $image->toPng(); // Intervention\Image\EncodedImage

// encode png format with and indexed color palette
$encoded = $image->toPng(indexed: true); // Intervention\Image\EncodedImage

Encode GIF Format

public Image::toGif(bool $interlaced = false): EncodedImage

Encode the current image instance in GIF format.

Caution: The signature has changed in version 3.1 by removing the parameter color_limit

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

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

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

// encode gif data
$encoded = $image->toGif(); // Intervention\Image\EncodedImage

Encode Windows Bitmap Format

public Image::toBitmap(): EncodedImage

Encode the current image instance in Windows Bitmap format.

Caution: The signature has changed in version 3.1 by removing the parameter color_limit

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

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

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

// encode bitmap data
$encoded = $image->toBmp(); // Intervention\Image\EncodedImage

Encode AV1 Image File Format (AVIF)

public Image::toAvif(int $quality = 75): EncodedImage

Encode the current image instance in AVIF format in the given quality ranging between 0 for low quality to 100 for best quality.

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

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

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

// encode avif image 
$encoded = $image->toAvif(60); // Intervention\Image\EncodedImage

Encode TIFF Format

public Image::toTiff(int $quality = 75): EncodedImage

Encode the current image instance in TIFF format in the given quality ranging between 0 for low quality to 100 for best quality.

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

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

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

// encode tiff format
$encoded = $image->toTiff(60); // Intervention\Image\EncodedImage

Encode JPEG 2000 Format

public Image::toJpeg2000(int $quality = 75): EncodedImage

Encode the current image instance in JPEG 2000 format in the given quality ranging between 0 for low quality to 100 for best quality.

use Intervention\Image\ImageManager;

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

// read png format
$image = $manager->read('images/example.png');

// encode jpeg 2000 format
$encoded = $image->toJpeg2000(90); // Intervention\Image\EncodedImage

Encode Heic Format

public Image::toHeic(int $quality = 75): EncodedImage

Encode the current image instance in HEIC format in the given quality ranging between 0 for low quality to 100 for best quality.

use Intervention\Image\ImageManager;

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

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

// encode heic image
$encoded = $image->toHeic(60); // Intervention\Image\EncodedImage

Handling of Encoded Image Data

The mentioned encoding methods return an Intervention\Image\EncodedImage object. With this instance you can decide how to proceed with the encoded data.

Cast Encoded Image Data to String

public EncodedImage::__toString(): string

This method can be used to obtain the raw image data as type string. This is particularly useful if it is to be further processed with other libraries or transferred to remote data storage (such as S3).

Example

use Intervention\Image\ImageManager;
use Just\An\Example\CloudStorage;

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

// resize gif image
$image = $manager
    ->read('images/example.gif')
    ->scale(height: 200);

// encode in jpeg format and cast result as string
$imagedata = (string) $image->toJpeg();

// save to imaginary data service
CloudStorage::put('example.jpg', $imagedata);

Save Encoded Image Data in Filesystem

public EncodedImage::save(string $filepath, mixed ...$options): void

This method writes the object's data to the given path in the local file system. The respective folder structure must already exist and be writable.

Parameters

Example

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

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

// reading gif image
$image = $manager->read('images/example.gif');

// save progressive jpeg file in low quality
$encoded = $image->toJpeg()->save('images/test.jpg', progressive: true, quality: 10);

Create Data URI Scheme

public EncodedImage::toDataUri(): string

This method takes the already encoded image data and wraps it in an base64 encoded data uri scheme.

Example

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

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

// read gif image
$image = $manager->read('images/example.gif');

// encode to gif data uri
$data_uri = $image->toGif()->toDataUri();

Transform Encoded Image to File Pointer

public EncodedImage::toFilePointer(): resource

Create a file pointer resource to handle the encoded image data.

Example

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

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

// read gif image
$image = $manager->read('images/example.gif');

// create file pointer
$pointer = $image->toJpeg()->toFilePointer();

Retrieve Media (MIME) Type of an Encoded Image

public EncodedImage::mediaType(): string

This method returns the media (MIME) type of the encoded image.

Example

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

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

// read gif image
$image = $manager->read('images/example.gif');

// "image/jpeg"
$mimetype = $image->toJpeg()->mediaType();

Write Images Directly

Encode & Save Combined

public Image::save(null|string $path = null, mixed ...$options): ImageInterface

This method helps to initiate the saving process directly from the image object without having to go via an EncodedImage object and encodes & writes the image data in one call.

The resulting image format is defined by the file extension of the given path. If no path is given the format of the originally read image will be used. Define the image quality by using the second parameter.

The encoded image is saved at the given path in the local file system. The respective folder structure must already exist and be writable.

In contrast to the other encoding methods, save() returns an Image object instead of an EncodedImage object.

Parameters

Example

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

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

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

// overwrite file at "images/example.jpg" with low quality
$image->save(quality: 10);

// encode jpeg as png and save in a new file
$image->save('images/example.png');

// encode & save progressive jpeg in low quality
$image->save('images/example.jpg', quality: 10, progressive: true);