imagecrop
(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);
?>
参考
- imagecropauto() - 利用可能なモードを指定して、画像を自動的にクロップする
+add a note
User Contributed Notes
There are no user contributed notes for this page.