(PHP 5 >= 5.5.0, PHP 7, PHP 8)
imagecrop — 指定した矩形に画像をクロップする
画像を指定した矩形範囲にクロップして、クロップ後の画像を返します。
パラメータ image で渡した画像には何も手を加えません。
imageimagecreatetruecolor()のような画像作成関数が返す 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');
}
?>