Define uma cor como transparente

Descrição

imagecolortransparent(GdImage $image, ?int $color = null): int

Obtém ou define a cor transparente na imagem fornecida em image.

Parâmetros

image: Um objeto GdImage, retornado por uma das funções de criação de imagem, como imagecreatetruecolor().
color: Um identificador de cor criado com imagecolorallocate().

Valor Retornado

O identificador da nova (ou atual se nenhuma for especificada) cor transparente é retornado. Se color for null, e a imagem não tiver cor transparente, o identificador retornado será -1.

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	`color` agora pode ser nulo.

Exemplos

Example #1 Exemplo de imagecolortransparent()

<?php
// Cria uma image 55 x 30
$im = imagecreatetruecolor(55, 30);
$red = imagecolorallocate($im, 255, 0, 0);
$black = imagecolorallocate($im, 0, 0, 0);

// Define o fundo para transparente
imagecolortransparent($im, $black);

// Desenha um retângulo vermelho
imagefilledrectangle($im, 4, 4, 50, 25, $red);

// Grava a imagem
imagepng($im, './imagecolortransparent.png');
imagedestroy($im);
?>

O exemplo acima produzirá algo semelhante a:

Notas

Note:
Transparênia é copiada apenas com imagecopymerge() e imagens em cores verdadeiras, e não com imagecopy() ou imagens com paleta.

Note:
A cor transparente é uma propriedade da imagem, a transparência não é uma propriedade da cor. Uma ver definida uma cor transparente, as regiões da imagem com essa cor que foram desenhadas anteriormente serão transparentes.