(PHP 5 >= 5.5.0, PHP 7, PHP 8)
imagecrop — 指定した矩形に画像をクロップする
画像を指定した矩形範囲にクロップして、クロップ後の画像を返します。
パラメータ 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);
?>