array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'pt_BR', ), 'this' => array ( 0 => 'function.imagepng.php', 1 => 'imagepng', 2 => 'Envia uma imagem PNG para o navegador ou arquivo', ), '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', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

imagepng

(PHP 4, PHP 5, PHP 7, PHP 8)

imagepng — Envia uma imagem PNG para o navegador ou arquivo

Descrição

imagepng(
    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 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 argumentos quality e filters 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 constantes 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.

Cuidado

O parâmetro filters é ignorado pela libgd de sistema.

Valor Retornado

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

Cuidado

Entretanto, se a biblioteca libgd falhar ao gerar a imagem, esta função retornará true.

Erros/Exceções

Lança uma exceção ValueError se quality for inválido.

Registro de Alterações

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.

Exemplos

<?php
$im = imagecreatefrompng("test.png");

header('Content-Type: image/png');

imagepng($im);
?>

Veja Também