(PHP 5 >= 5.5.0, PHP 7, PHP 8)
imagecrop — Recorta uma imagem no retângulo informado
Recorta uma imagem na área retangular informada e retorna a imagem resultante.
A imagem fornecida em image
não é modificada.
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
.
Retorna o objeto da imagem recortada em caso de sucesso ou false
em caso de falha.
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. |
Exemplo #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);
?>