グレースケールでイメージの一部をコピー、マージする

説明

imagecopymergegray ( resource $dst_im , resource $src_im , int $dst_x , int $dst_y , int $src_x , int $src_y , int $src_w , int $src_h , int $pct ) : bool

imagecopymergegray() は、 src_im の X,Y座標 src_x, src_y から始まる幅src_w、高さ src_h の領域を dst_imにコピーします。定義された部分は、x、y座標dst_x、 dst_yにコピーされます。

この関数は imagecopymerge() と同じですが、マージをする際に、コピー前にコピー先のピクセルをグレースケールに変換することにより、コピー先のピクセルをコピー元の色相を維持するところが異なります。

パラメータ

dst_im: コピー先の画像リンクリソース。
src_im: コピー元の画像リンクリソース。
dst_x: コピー先の x 座標。
dst_y: コピー先の y 座標。
src_x: コピー元の x 座標。
src_y: コピー元の y 座標。
src_w: コピー元の幅。
src_h: コピー元の高さ。
pct: src_im が pct にしたがってグレースケールに変換されます。 pct が 0 の場合は完全なグレースケール、 100 の場合は何も変わらない状態となります。 pct = 100 の場合、パレット画像に対してはこの関数は imagecopy() と同じ動作となります (アルファコンポーネントを無視する点だけが違います)。一方 true color 画像については、この関数はアルファ透過度を実装しています。

返り値

成功した場合に TRUE を、失敗した場合に FALSE を返します。

例

例1 imagecopymergegray() の使用法


<?php
// 画像のインスタンスを作成します
$dest = imagecreatefromgif('php.gif');
$src = imagecreatefromgif('php.gif');

// コピー・マージ (Gray = 20%) します
imagecopymergegray($dest, $src, 10, 10, 0, 0, 100, 47, 20);

// 出力してメモリから解放します
header('Content-Type: image/gif');
imagegif($dest);

imagedestroy($dest);
imagedestroy($src);
?>