PHP 8.3.4 Released!

Imagick::compositeImage

(PECL imagick 2, PECL imagick 3)

Imagick::compositeImageある画像を別の画像に合成する

説明

public Imagick::compositeImage(
    Imagick $composite_object,
    int $composite,
    int $x,
    int $y,
    int $channel = Imagick::CHANNEL_DEFAULT
): bool

ある画像を、別の画像の指定した位置に合成します。 合成アルゴリズムに指定する引数は、 setImageArtifact の第一パラメータに 'compose:args'、第二パラメータにデータを渡す必要があります。

パラメータ

composite_object

合成する画像を保持する Imagick オブジェクト。

compose

合成演算子。合成演算定数 を参照ください。

x

合成する位置の列オフセット。

y

合成する位置の行オフセット。

channel

そのチャネルモードで使用可能なチャネル定数を指定します。 複数のチャネルを指定するには、チャネル型定数をビット演算子で結合します。 チャネル定数 の一覧を参照ください。

戻り値

成功した場合に true を返します。

例1 Imagick::compositeImage() の利用例

二つの画像を 'mathematics' 方式で合成します。

<?php

// これは、以下のコマンドを実行するのと同等の処理です
// convert src1.png src2.png -compose mathematics -define compose:args="1,0,-0.5,0.5" -composite output.png

$src1 = new \Imagick("./src1.png");
$src2 = new \Imagick("./src2.png");

$src1->setImageVirtualPixelMethod(Imagick::VIRTUALPIXELMETHOD_TRANSPARENT);
$src1->setImageArtifact('compose:args', "1,0,-0.5,0.5");
$src1->compositeImage($src2, Imagick::COMPOSITE_MATHEMATICS, 0, 0);
$src1->writeImage("./output.png");

?>

参考

add a note

User Contributed Notes 4 notes

up
6
m dot roszka at textend dot net
16 years ago
Here is an example on how to compose two images into a single one. The Imagick class utilises the exception handling model introduced in PHP5 and thus we will do that as well. Let's presume, that we have a directory in our filesystem, which contains our program and the two images we want to operate on.

<?php
try
{
// Let's check whether we can perform the magick.
if (TRUE !== extension_loaded('imagick'))
{
throw new
Exception('Imagick extension is not loaded.');
}

// This check is an alternative to the previous one.
// Use the one that suits you better.
if (TRUE !== class_exists('Imagick'))
{
throw new
Exception('Imagick class does not exist.');
}

// Let's find out where we are.
$dir = dirname(__FILE__);

// Let's read the images.
$glasses = new Imagick();
if (
FALSE === $glasses->readImage($dir . '/glasses.png'))
{
throw new
Exception();
}

$face = new Imagick();
if (
FALSE === $face->readImage($dir . '/face.jpg'))
{
throw new
Exception();
}

// Let's put the glasses on (10 pixels from left, 20 pixels from top of face).
$face->compositeImage($glasses, Imagick::COMPOSITE_DEFAULT, 10, 20);

// Let's merge all layers (it is not mandatory).
$face->flattenImages();

// We do not want to overwrite face.jpg.
$face->setImageFileName($dir . '/face_and_glasses.jpg');

// Let's write the image.
if (FALSE == $face->writeImage())
{
throw new
Exception();
}
}

catch (
Exception $e)
{
echo
'Caught exception: ' . $e->getMessage() . "\n";
}

exit(
0);
?>
Also a couple more words on the Imagick::COMPOSITE_DEFAULT argument. The images we are composing together are separate layers. Not only can we put them in specific order, but we can also choose the way we want them to interfere with each other. And here comes the second argument of the compositeImage method. It can be given either as a constant or as the integer value of that constant. You can use the reflection API of PHP5 to get the list of them.

<?php
Reflection
::export(new ReflectionClass('Imagick'));
?>

Just look for COMPOSITE_* constants in the "Constants" section.
up
2
elizapinchley at google dot com
3 years ago
There has been changes to Imagick constants in new version. Please read new list of constants like this.

<?php

$img
= new \Imagick();
$reflection_class = new ReflectionClass($img);

die(
var_dump($reflection_class->getConstants()));

?>
up
0
Iddles
12 years ago
To copy the alpha channel from one image to another, you can do the following:

<?php

$img1
= new Imagick( "image1.png" );
$img2 = new Imagick( "image2.png" );

$img1->compositeImage( $img2, imagick::COMPOSITE_COPYOPACITY, 0, 0 );

header('Content-type: image/png');
echo
$img1;

?>
up
0
giso at connectholland dot nl
14 years ago
You might need to set the colorspace the same when composing two images over each other

<?php
//Creating two Imagick object
$first = new Imagick('first.jpg');
$second = new Imagick('second.jpg');

// Set the colorspace to the same value
$first->setImageColorspace($second->getImageColorspace() );

//Second image is put on top of the first
$first->compositeImage($second, $second->getImageCompose(), 5, 5);

//new image is saved as final.jpg
$first->writeImage('final.jpg');
?>
To Top