PHP Conference Nagoya 2025

Imagick::appendImages

(PECL imagick 2, PECL imagick 3)

Imagick::appendImagesAppend a set of images

Description

public Imagick::appendImages(bool $stack): Imagick

Append a set of images into one larger image.

Parameters

stack

Whether to stack the images vertically. By default (or if false is specified) images are stacked left-to-right. If stack is true, images are stacked top-to-bottom.

Return Values

Returns Imagick instance on success.

Errors/Exceptions

Throws ImagickException on error.

Examples

Example #1 Imagick::appendImages() example

<?php

/* Create new imagick object */
$im = new Imagick();

/* create red, green and blue images */
$im->newImage(100, 50, "red");
$im->newImage(100, 50, "green");
$im->newImage(100, 50, "blue");

/* Append the images into one */
$im->resetIterator();
$combined = $im->appendImages(true);

/* Output the image */
$combined->setImageFormat("png");
header("Content-Type: image/png");
echo
$combined;
?>

The above example will output something similar to:

Output of example : Imagick::appendImages()

add a note

User Contributed Notes 3 notes

up
13
Brandon
15 years ago
# How to combine a multi-page pdf file into a single long image:

<?php
$im1
= new Imagick();
$im1->readImage('multi-page-pdf.pdf');
$im1->resetIterator();
# Combine multiple images into one, stacked vertically.
$ima = $im1->appendImages(true);
$ima->setImageFormat("png");
header("Content-Type: image/png");
echo
$ima;
?>
up
0
adao at adao dot eti dot br
10 years ago
# change $ima to $ima->getimagesblob()

<?php
$im1
= new Imagick();
$im1->readImage('multi-page-pdf.pdf');
$im1->resetIterator();
# Combine multiple images into one, stacked vertically.
$ima = $im1->appendImages(true);
$ima->setImageFormat("png");
header("Content-Type: image/png");
echo
$ima->getimagesblob();
?>
up
-2
Anonymous
10 years ago
Sometimes when running this code on a long running apache24 instance on a server with minimal memory the final "echo $ima;" returns an empty string.

Doing an "apache graceful" seems to clear this up. There appears to be no other way to correct OR DETECT this problem. Suckky.
To Top