array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'fr', ), 'this' => array ( 0 => 'function.imagepng.php', 1 => 'imagepng', 2 => 'Envoie une image PNG vers un navigateur ou un fichier', ), 'up' => array ( 0 => 'ref.image.php', 1 => 'Fonctions GD et images', ), 'prev' => array ( 0 => 'function.imagepalettetotruecolor.php', 1 => 'imagepalettetotruecolor', ), 'next' => array ( 0 => 'function.imagepolygon.php', 1 => 'imagepolygon', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'fr', '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 — Envoie une image PNG vers un navigateur ou un fichier

Description

imagepng(
    GdImage $image,
    resource|string|null $file = 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

Un objet GdImage, retournée par une des fonctions de création d'images, comme imagecreatetruecolor().

file

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 non-défini ou 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 : de 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_*. PNG_NO_FILTER ou PNG_ALL_FILTERS peuvent également être utilisés pour, respectivement, désactiver ou activer tous les filtres. La valeur par défaut (-1) désactive le filtrage.

Attention

Le paramètre filters est ignoré par la version système de 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.

Erreurs / Exceptions

Lève une ValueError si quality est invalide.

Historique

Version Description
8.4.0 Lève désormais une ValueError si quality est invalide.
8.0.0 image attend une instance de GdImage désormais; auparavant, une resource gd était attendue.

Exemples

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

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

imagepng($im);
?>

Voir aussi