(PHP 4, PHP 5, PHP 7, PHP 8)
imagepng — Envia uma imagem PNG para o navegador ou arquivo
$image,$file = null,$quality = -1,$filters = -1
Envia ou grava uma imagemPNG a partir do parâmetro
image.
imageUm objeto GdImage, retornado por uma das funções de criação de imagem, como imagecreatetruecolor().
fileO caminho ou um recurso de fluxo aberto (que será fechado automaticamente após o retorno desta função) para salvar o arquivo. Se não for definido ou for null, o fluxo da imagem bruta será enviado diretamente.
Nota:
nullé inválido se os argumentosqualityefiltersnão forem informados.
quality
Nível de compressão: de 0 (sem compressão) a 9.
O padrão (-1) utiliza a compressão padrão da zlib.
Para mais informações, consulte o » manual zlib.
filters
Permite reduzir o tamanho do arquivo PNG. Uma máscara de bits pode ser
informada por qualquer combinação das contantes PNG_FILTER_*.
PNG_NO_FILTER ou
PNG_ALL_FILTERS também podem ser utilizadas, respectivamente,
para desativar ou ativar todos os filtros.
O valor padrão (-1) desativa os filtros.
O parâmetro filters é ignorado pela libgd de sistema.
Retorna true em caso de sucesso ou false em caso de falha.
Entretanto, se a biblioteca libgd falhar ao gerar a imagem, esta função retornará true.
Lança uma exceção ValueError se quality for inválido.
| Versão | Descrição |
|---|---|
| 8.4.0 |
Agora lança uma exceção ValueError se quality for inválido.
|
| 8.0.0 |
O parâmetro image agora espera uma instância de GdImage;
anteriormente, um resource gd válido era esperado.
|
<?php
$im = imagecreatefrompng("test.png");
header('Content-Type: image/png');
imagepng($im);
?>