imagecopy

(PHP 4, PHP 5, PHP 7, PHP 8)

imagecopy画像の一部をコピーする

説明

imagecopy(
    GdImage $dst_image,
    GdImage $src_image,
    int $dst_x,
    int $dst_y,
    int $src_x,
    int $src_y,
    int $src_width,
    int $src_height
): bool

src_image の一部、つまり、x,y座標 src_x, src_y を基準として幅 src_width、高さ src_height の領域を 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

コピー元の高さ。

戻り値

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

変更履歴

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

例1 PHP.net のロゴの切り取り

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

// コピーします
imagecopy($dest$src0020138040);

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

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

上の例の出力は、 たとえば以下のようになります。

出力例 : PHP.net のロゴの切り取り

参考

  • imagecrop() - 指定した矩形に画像をクロップする
関連キーワード:  コピー, 画像, dst, 座標, int, imagecopy, GdImage, width, height, 期待