imagecolortransparent

    (PHP 4, PHP 5, PHP 7, PHP 8)

    imagecolortransparent — 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ãoDescrição
    8.0.0 O parâmetro image agora espera uma instância de GdImage; anteriormente, um resourcegd válido era esperado.
    8.0.0color agora pode ser nulo.

    Exemplos

    Exemplo #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:

    Saída do exemplo: imagecolortransparent()

    Notas

    Nota:

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

    Nota:

    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.

    To Top