imagecrop

(PHP 5 >= 5.5.0, PHP 7, PHP 8)

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

説明

imagecrop(GdImage $image, array $rectangle): GdImage|false

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

パラメータ

image

imagecreatetruecolor()のような画像作成関数が返す GdImage オブジェクト。

rectangle

クロップする矩形を配列で指定します。配列のキーには x, y, width, height を指定します。

戻り値

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

変更履歴

バージョン 説明
8.0.0 image は、 GdImage クラスのインスタンスを期待するようになりました。 これより前のバージョンでは、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() - 利用可能なモードを指定して、画像を自動的にクロップする
関連キーワード:  画像, 矩形, 指定, imagecrop, GdImage, 関数, バージョン, オブジェクト, インスタンス, 期待