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.

Note: 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ã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

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