(PHP 5 >= 5.5.0, PHP 7, PHP 8)
imagecropauto — Recorta uma imagem automaticamente usando um dos modos disponíveis
$image,$mode = IMG_CROP_DEFAULT,$threshold = 0.5,$color = -1
Automaticamente recorta uma imagem de acordo com o modo informado no parâmetro
mode.
imageUm objeto GdImage, retornado por uma das funções de criação de imagem, como imagecreatetruecolor().
modeUma das constantes a seguir:
IMG_CROP_DEFAULTIMG_CROP_TRANSPARENT.
Antes do PHP 7.4.0, a libgd fornecida retrocedia para IMG_CROP_SIDES,
se a imagem não tivesse cor transparente.
IMG_CROP_TRANSPARENTIMG_CROP_BLACKIMG_CROP_WHITEIMG_CROP_SIDESIMG_CROP_THRESHOLDthreshold e
color fornecidos.
thresholdEspecifica a tolerância em percentagem que será usada ao comparar a cor da imagem com a cor a ser cortada. O método usado para calcular a diferença de cor é baseado na distância de cores no cubo RGB(a).
Usado somente no modo IMG_CROP_THRESHOLD.
Nota: Antes do PHP 7.4.0, a libgd fornecida usava um algotitmo ligeiramente diferente, por isso o mesmo
thresholdgerava resultados diferentes para a libgd de sistema e a fornecida.
colorUm valor de cor RGB ou um índice de paleta.
Usado somente no modo IMG_CROP_THRESHOLD.
Retorna um objeto de imagem cortada em caso de sucesso ou false em caso de falha.
false também é retornado se a imagem for inteiramente cortada.
| 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. |
| 7.4.0 |
O comportamento de imagecropauto() na libgd fornecida foi sincronizado com
o da libgd de sistema: IMG_CROP_DEFAULT não mais retrocede
para IMG_CROP_SIDES e o recorte de limites agora usa
o mesmo algoritmo da libgd de sistema.
|
| 7.4.0 |
O valor padrão de mode mudou para
IMG_CROP_AUTO. Anteriormente, o valor padrão era
-1 que corresponde a IMG_CROP_DEFAULT,
mas passar -1 agora foi descontinuado.
|
Exemplo #1 Gerenciamento adequado de auto-recorte
Como percebido na seção de valores de retorno, imagecropauto()
retorna false se a imagem inteira
foi recortada. Neste exemplo será trabalho o objeto de imagem
$im que deve ser automaticamente recortado somente se
houver algo a ser recortado; caso contrário será mantida a imagem original.
<?php
$cropped = imagecropauto($im, IMG_CROP_DEFAULT);
if ($cropped !== false) { // caso om novo objeto de imagem tenha sido retornado
$im = $cropped; // a imagem recortada é atribuída a $im
}
?>