ScotlandPHP

Imagick::coalesceImages

(PECL imagick 2.0.0)

Imagick::coalesceImages複数の画像を合成する

説明

Imagick Imagick::coalesceImages ( void )

ページオフセットや処理方法を指定して、複数の画像を合成します。 典型的な使用例としては、たとえば GIF や MIFF、MNG といった画像シーケンスを最初に背景として指定し、 それ以降にさまざまなサイズやオフセットの画像を合成するというものがあります。 返り値は、新規 Imagick オブジェクトとなります。 シーケンスの各画像のサイズは、最初の画像のサイズと同じになります。

返り値

成功した場合に新規 Imagick オブジェクトを返します。

エラー / 例外

エラー時に ImagickException をスローします。

add a note add a note

User Contributed Notes 4 notes

up
9
ktr
5 years ago
resize and/or crop an animated GIF

<?php
$image
= new Imagick($file_src);

$image = $image->coalesceImages();

foreach (
$image as $frame) {
 
$frame->cropImage($crop_w, $crop_h, $crop_x, $crop_y);
 
$frame->thumbnailImage($size_w, $size_h);
 
$frame->setImagePage($size_w, $size_h, 0, 0);
}

$image = $image->deconstructImages();
$image->writeImages($file_dst, true);
?>
up
1
vikomic at gmail dot com
6 years ago
Here goes an exaple how to resize GIF-s.

<?php
$imagick
= new Imagick("original.gif");

$format = $imagick->getImageFormat();
if (
$format == 'GIF') {
 
$imagick = $imagick->coalesceImages();
  do {
    
$imagick->resizeImage(120, 120, Imagick::FILTER_BOX, 1);
  } while (
$imagick->nextImage());
 
$imagick = $imagick->deconstructImages();
 
$imagick->writeImages('new_120x120.gif', true);

 
// can be added some more gifs
 
$imagick = $imagick->coalesceImages();
  do {
    
$imagick->resizeImage(100, 100, Imagick::FILTER_BOX, 1);
  } while (
$imagick->nextImage());
 
$imagick = $imagick->deconstructImages();
 
$imagick->writeImages('new_100x100.gif', true);
}

$imagick->clear();
$imagick->destroy();
?>

You can use any resize method (resizeImage) with this example.

This example works fine with *imagick module version 2.2.1-dev*, but doesn't work correctly with *imagick module version 3.0.1*.
up
1
Anony
1 year ago
If you wish to open an animated gif, don't ping the image with $imagick->pingImage(), you will get the same amount of frames you have in the gif, added to the start - but they're all black with stripes. So you have then double the amounts of frames the gif actually has.
up
-3
dikirill
4 years ago
I tried examples below, and couldn't make them work. And found that version of my php-imagick extension is 3.1.0RC1, and looks like it's buggy in function "writeImages", downgrade to 3.0.1 helped me.
To Top