imagepng

(PHP 4, PHP 5, PHP 7)

imagepngEnvoie une image PNG vers un navigateur ou un fichier

Description

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

imagepng() affiche ou sauvegarde une image au format PNG en utilisant l'image image.

Liste de paramètres

image

Une ressource d'image, retournée par une des fonctions de création d'images, comme imagecreatetruecolor().

to

Le chemin ou un flux de ressource ouvert (qui sera automatiquement fermé après le retour de cette fonction) vers lequel le fichier sera sauvegardé. Si défini à NULL, le flux brute de l'image sera affiché directement.

Note:

La valeur NULL est invalide si le paramètre quality et le paramètre filters ne sont pas utilisés.

quality

Degré de compression : depuis 0 (aucune compression) à 9. La valeur par défaut (-1) utilise la compression par défaut de zlib. Pour plus d'informations voir le » manuel zlib.

filters

Permet la réduction de la taille du fichier PNG. C'est un masque qui peut être défini par une combinaison des constantes PNG_FILTER_XXX. PNG_NO_FILTER ou PNG_ALL_FILTERS peuvent également être utilisé pour, respectivement, désactiver ou activer tous les filtres. La valeur par défaut (-1) désactive le filtrage.

Attention

La paramètre filters est ignoré par system libgd.

Valeurs de retour

Cette fonction retourne TRUE en cas de succès ou FALSE si une erreur survient.

Attention

Toutefois, si libgd ne parvient pas à produire l'image, cette fonction retourne TRUE.

Historique

Version Description
5.4.0 Ajout de la prise en charge des flux resource pour le paramètre to.
5.1.3 Ajout du paramètre filters.
5.1.2 Ajout du paramètre quality.

Exemples

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

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

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

Voir aussi

  • imagegif() - Affichage de l'image vers le navigateur ou dans un fichier
  • imagewbmp() - Affichage de l'image vers le navigateur ou dans un fichier
  • imagejpeg() - Affichage de l'image vers le navigateur ou dans un fichier
  • imagetypes() - Retourne les types d'images supportés par la version courante de PHP
  • imagesavealpha() - Détermine si les informations complètes du canal alpha doivent être conservées lors de la sauvegardes d'images PNG