array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'pt_BR', ), 'this' => array ( 0 => 'function.imagepng.php', 1 => 'imagepng', ), 'up' => array ( 0 => 'ref.image.php', 1 => 'Funções de GD e Image', ), 'prev' => array ( 0 => 'function.imagepalettetotruecolor.php', 1 => 'imagepalettetotruecolor', ), 'next' => array ( 0 => 'function.imagepolygon.php', 1 => 'imagepolygon', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'pt_BR', 'path' => 'reference/image/functions/imagepng.xml', ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); ?>
(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
.
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.
Nota:
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_XXX
.
PNG_NO_FILTER
ou
PNG_ALL_FILTERS
também podem ser utilizados, 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
.
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.
|
<?php
$im = imagecreatefrompng("test.png");
header('Content-Type: image/png');
imagepng($im);
imagedestroy($im);
?>