Recorta uma imagem no retângulo informado

# imagecrop

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

imagecrop — Recorta uma imagem no retângulo informado

### Descrição

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

Recorta uma imagem na área retangular informada e retorna a imagem resultante. A imagem fornecida em `image` não é modificada.

### Parâmetros

`image`
  Um objeto GdImage, retornado por uma das funções de criação de imagem, como imagecreatetruecolor().
`rectangle`

  O retângulo de recorte com um array com chaves `x`, `y`, `width` e `height`.

### Valor Retornado

Retorna o objeto da imagem recortada em caso de sucesso ou `false` em caso de falha.

### Registro de Alterações

Versão | Descrição
--- | ---
8.0.0 | O parâmetro `image` agora espera uma instância de GdImage; anteriormente, um resource `gd` válido era esperado.
8.0.0 | Em caso de sucesso, esta função agora retorna um objeto GDImage; anteriormente, um resource era retornado.

### Exemplos

Exemplo #1 Exemplo de imagecrop()

Este exemplo mostra como recortar uma imagem em uma área quadrada.

    <?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');
    }
    ?>

### Veja Também

- imagecropauto() - Recorta uma imagem automaticamente usando um dos modos disponíveis

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