Define uma cor como transparente

# imagecolortransparent

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

imagecolortransparent — Define uma cor como transparente

### Descrição

function 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

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');
    ?>

O exemplo acima produzirá algo semelhante a:

### Notas

> Nota: Transparência é copiada apenas com imagecopymerge() e imagens com 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 vez definida uma cor transparente, as regiões da imagem com essa cor que foram desenhadas anteriormente serão transparentes.

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open