Informa se a informação de canal alfa deve ser retida ao gravar imagens

# imagesavealpha

(PHP 4 >= 4.3.2, PHP 5, PHP 7, PHP 8)

imagesavealpha — Informa se a informação de canal alfa deve ser retida ao gravar imagens

### Descrição

function imagesavealpha(GdImage `$image`, bool `$enable`): true

imagesavealpha() define a opção que determina se a informação completa do canal alfa deve ser retida (ao contrário de manter transparência de uma cor) ao gravar imagens. Isto somente é suportado para formatos de imagem que suportam informação de canal alfa completo, isto é, `PNG`, `WebP` e `AVIF`.

> Nota: imagesavealpha() só faz sentido para imagens `PNG`, já que o canal alfa completo é sempre gravado para `WebP` e `AVIF`. Não pe recomendado confiar neste comportamento, pois ele pode mudar no futuro. Por isso, imagesavealpha() deve ser chamada deliberadamente também para imagens `WebP` e `AVIF`.

Mesclagem de alfa tem que ser desabilitada (`imagealphablending($im, false)`) para reter o canal alfa em primeiro lugar.

### Parâmetros

`image`
  Um objeto GdImage, retornado por uma das funções de criação de imagem, como imagecreatetruecolor().
`enable`

  Informa se o canal alfa deve ou não ser retido. O padrão é `false`.

### Valor Retornado

Sempre retorna `true`.

### 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.

### Exemplos

Exemplo #1 Uso básico de imagesavealpha()

    <?php
    // Carrega uma imagem PNG com canal alfa
    $png = imagecreatefrompng('./alphachannel_example.png');

    // Desabilita mesclagem alfa
    imagealphablending($png, false);

    // Faz as operações desejadas

    // Define a opção de gravação alfa
    imagesavealpha($png, true);

    // Mostra imagem no navegador
    header('Content-Type: image/png');

    imagepng($png);
    ?>

### Veja Também

- imagealphablending() - Define o modo de combinação para uma imagem

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