PHP | Imagick writeImages() Function

The Imagick::writeImages() function is an inbuilt function in PHP which is used to write an image or sequence of images to the specified filename. This function saves the image file in the same folder where your PHP script is located. This function supports GIF animations whereas writeImage() doesn’t support.

Syntax:

bool Imagick::writeImages( string $filename, bool $adjoin )

Parameters: This function accepts two parameters as mentioned above and described below:

• $filename: It specifies the name of file.
• $adjoin: It specifies whether to add adjoin or not. If TRUE, it saves the animation as a single gif file whereas in case of FALSE all the frames of animation are saved as separate files.

Return Value: This function returns TRUE on success.

Exceptions: This function throws ImagickException on error.

Below programs illustrate the Imagick::writeImages() function in PHP:

Program 1:

<?php

// Create a new imagick object
$imagickAnimation = new Imagick(
'https://media.geeksforgeeks.org/wp-content/uploads/20191117145951/g4gnaimation1.gif');

// Write that animation with name 'myanimation.gif'
$imagickAnimation->writeImages('myanimation.gif', true);
?>

Output:
This will save a GIF image with name myanimation.gif in the same folder.

Program 2:

<?php

// Create a new imagick object
$imagickAnimation = new Imagick(
'https://media.geeksforgeeks.org/wp-content/uploads/20191117194549/g4ganimatedcolor.gif');

// Write that animation with name 'myanimation2.gif'
$imagickAnimation->writeImages('myanimation2.gif', false);
?>

Output:

This will save 16 images all from different frames of given animation file with filenames as:

• myanimation2-0.gif
• myanimation2-1.gif
• myanimation2-2.gif
• myanimation2-3.gif
• myanimation2-4.gif
• myanimation2-5.gif
• myanimation2-6.gif
• myanimation2-7.gif
• myanimation2-8.gif
• myanimation2-9.gif
• myanimation2-10.gif
• myanimation2-11.gif
• myanimation2-12.gif
• myanimation2-13.gif
• myanimation2-14.gif
• myanimation2-15.gif

Reference: https://www.php.net/manual/en/imagick.writeimages.php