PHP マニュアル: イメージの一部をコピー、マージする

説明

bool imagecopymerge(
    GdImage $dst_image,
    GdImage $src_image,
    int $dst_x,
    int $dst_y,
    int $src_x,
    int $src_y,
    int $src_width,
    int $src_height,
    int $pct
)

src_image のsrc_x, src_y で始まる幅 src_width 、高さ src_heightの領域を x,y座標で指定した dst_image にコピーします。定義された部分は、x,y座標、dst_x、 dst_yにコピーされます。

パラメータ

dst_image: コピー先の画像リソース。
src_image: コピー元の画像リソース。
dst_x: コピー先の x 座標。
dst_y: コピー先の y 座標。
src_x: コピー元の x 座標。
src_y: コピー元の y 座標。
src_width: コピー元の幅。
src_height: コピー元の高さ。
pct: 二つの画像は、 0から100の範囲で指定した pctに基づきマージされます。 pct = 0 の時は、何も行われません。 100の場合、この関数の動作は、パレットイメージに対する imagecopy と同じとなります (アルファコンポーネントを無視する点だけが違います)。一方 true color 画像については、この関数はアルファ透過度を実装しています。

戻り値

成功した場合に true を、失敗した場合に false を返します。

変更履歴

バージョン	説明
8.0.0	`dst_image` と `src_image` は、 GdImage クラスのインスタンスを期待するようになりました。これより前のバージョンでは、 resource が期待されていました。

例

例1 2 つの PHP.net ロゴを 75% の透過度でマージ

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

// コピー・マージします
imagecopymerge($dest, $src, 10, 10, 0, 0, 100, 47, 75);

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

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