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

# imagecrop

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

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

### 説明

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

画像を指定した矩形範囲にクロップして、クロップ後の画像を返します。 パラメータ `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');
    }
    ?>

### 参考

- imagecropauto() - 利用可能なモードを指定して、画像を自動的にクロップする

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open