Recorta uma imagem no retângulo informado

Descrição

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

Example #1 imagecrop() example

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');
    imagedestroy($im2);
}
imagedestroy($im);
?>

Veja Também

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