imagepng

(PHP 4, PHP 5, PHP 7)

imagepngEmite uma imagem PNG para o navegador ou arquivo

Descrição

imagepng ( resource $image [, mixed $to [, int $quality [, int $filters ]]] ) : bool

Emite ou grava uma imagemPNG a partir do parâmetro image.

Parâmetros

image

Um resource de imagem, retornado por funções de criação de imagens, como imagecreatetruecolor().

to

O caminho ou um resource stream aberto (o qual será automaticamente fechado quando a função retorna) para gravar o arquivo. Se não informado ou null, os bytes da imagem serão impressos diretamente.

Nota:

null é inválido se argumentos quality e filters não forem informados.

quality

Nível de compressão: de 0 (sem compressão) a 9.

filters

Permite reduzir o tamanho do arquivo PNG. Um campo bitmask pode ser informado 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.

Valor Retornado

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

Changelog

Versão Descrição
5.4.0 Adicionado suporte a passagem de um resource stream no parâmetro to.
5.1.3 Adicionado o parâmetro filters.
5.1.2 Adicionado o parâmetro quality.

Exemplos

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

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

imagepng($im);
imagedestroy($im);
?>

Veja Também

  • imagegif() - Envia uma imagem para o browser ou arquivo
  • imagewbmp() - Envia uma imagem para o browser ou arquivo
  • imagejpeg() - Envia a imagem para o borwser ou arquivo
  • imagetypes() - Retorna os tipos de imagens suportados por esta instalação do PHP
  • imagesavealpha() - Define a opção para salvar a informação completa do alpha channel (ao invés de a transparencia de uma cor só) quando estiver salvando imagens PNG.