imagecrop

指定した矩形に画像をクロップする

説明

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