imagepng
(PHP 4, PHP 5, PHP 7, PHP 8)
imagepng — Envia uma imagem PNG para o navegador ou arquivo
Descrição
GdImage
$image
,resource|string|null
$file
= null
,int
$quality
= -1,int
$filters
= -1): bool
Envia ou grava uma imagemPNG a partir do parâmetro
image
.
Parâmetros
-
image
Um objeto GdImage, retornado por uma das funções de criação de imagem, como imagecreatetruecolor().
file
-
O caminho ou um recurso de stream 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 stream da imagem bruta será enviado diretamente.Note:
null
é inválido se os argumentosquality
efilters
nã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
ouPNG_ALL_FILTERS
também podem ser utilizados, respectivamente, para desativar ou ativar todos os filtros. O valor padrão (-1
) desativa os filtros.CautionO parâmetro
filters
é ignorado pela libgd de sistema.
Valor Retornado
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
.
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
<?php
$im = imagecreatefrompng("test.png");
header('Content-Type: image/png');
imagepng($im);
imagedestroy($im);
?>
Veja Também
- imagegif() - Envia a imagem para o navegador ou para um arquivo
- imagewbmp() - Envia a imagem para o navegador ou para um arquivo
- imagejpeg() - Envia a imagem para o navegador ou para um arquivo
- imagetypes() - Retorna os tipos de imagens suportados pela instalação do PHP
- imagesavealpha() - Informa se a informação de canal alfa deve ser retida ao gravar imagens