PHP マニュアル: 指定した矩形に画像をクロップする

説明

GdImagefalse imagecrop(GdImage $image, array $rectangle)

画像を指定した矩形範囲にクロップして、クロップ後の画像を返します。パラメータ image で渡した画像には何も手を加えません。

パラメータ

image: imagecreatetruecolorのような画像作成関数が返す GdImage オブジェクト。
rectangle: クロップする矩形を配列で指定します。配列のキーには x, y, width, height を指定します。

戻り値

成功した場合にクロップ後の画像オブジェクトを返します。失敗した場合に false を返します。

変更履歴

バージョン	説明
8.0.0	`image` は、 GdImage クラスのインスタンスを期待するようになりました。これより前のバージョンでは、有効な `gd` resource が期待されていました。
8.0.0	成功時には、この関数は GDImage クラスのインスタンスを返すようになりました。これより前のバージョンでは、 resource を返していました。

例

例1 imagecrop の例

この例は、画像を正方形にクロップする方法を示すものです。


<?php
$im = imagecreatefrompng('example.png');
$size = min(imagesx($im), imagesy($im));
$im2 = imagecrop($im, ['x' => 0, 'y' => 0, 'width' => $size, 'height' => $size]);
if ($im2 !== FALSE) {
    imagepng($im2, 'example-cropped.png');
    imagedestroy($im2);
}
imagedestroy($im);
?>

参考

imagecropauto