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

    imagesavealpha(GdImage$image, bool$enable): bool

    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

    Retorna true em caso de sucesso ou false em caso de falha.

    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.

    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);
    imagedestroy($png);
    ?>

    Veja Também

    To Top