PHPのimagecropauto()関数で画像を自動的に切り抜く方法を徹底解説

imagecropauto()は、PHPに標準で組み込まれている関数の一つで、用意された複数のモードの中から選択して、画像を自動的に切り抜き（クロップ）することができます。

構文

resource imagecropauto(resource $image, int $mode, float $threshold, int $color)

パラメータ

imagecropauto()は、$image、$mode、$threshold、$color の4つのパラメータを受け取ります。

• $image − 切り抜き対象となる画像リソースを指定します。

• $mode − 省略可能なパラメータで、切り抜きモードに対応する整数値を指定します。指定できるモードは以下の通りです。

  • IMG_CROP_DEFAULT − IMG_CROP_TRANSPARENTモードと同じ動作を行います。

  • IMG_CROP_TRANSPARENT − 透明な背景を切り抜くためのモードです。

  • IMG_CROP_BLACK − 黒い背景を切り抜くためのモードです。

  • IMG_CROP_WHITE − 白い背景を切り抜くためのモードです。

  • IMG_CROP_SIDES − 画像の四隅の色をもとに背景色を検出し、その背景を切り抜くモードです。

  • IMG_CROP_THRESHOLD − 指定したしきい値（threshold）と色（color）に基づいて画像を切り抜くモードです。

• $threshold − 省略可能なパラメータで、画像の色と切り抜き対象の色を比較する際の許容誤差をパーセントで指定します。

• $color − 省略可能なパラメータで、RGB（赤・緑・青）によるカラー値、またはパレットインデックスを指定します。

戻り値

imagecropauto()は、処理が成功した場合は切り抜かれた画像リソースを返し、失敗した場合はfalseを返します。また、画像全体が切り抜き対象となった場合にもfalseが返される点に注意してください。

使用例1

<?php
   // ローカルドライブのフォルダからJPEG画像を読み込む
   $img = imagecreatefromjpeg('C:\xampp\htdocs\Images\img33.jpg');

   // 画像の余分な白い領域を切り抜く
   $cropped = imagecropauto($img, IMG_CROP_WHITE);

   // GIFファイルとして出力する
   header('Content-type: image/gif');
   imagepng($cropped);
?>

実行結果

IMG_CROP_WHITEモードを適用する前：周囲に白い余白がある状態の画像

IMG_CROP_WHITEモードを適用した後：白い余白が切り抜かれた画像

補足

このように、imagecropauto()ではモードの指定を変えるだけで、さまざまな条件で画像を切り抜くことができます。たとえばIMG_CROP_BLACKを指定すれば、画像の黒い背景部分を自動的に切り抜くことが可能です。用途に応じて最適なモードを選択しましょう。