array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'de', ), 'this' => array ( 0 => 'function.imagepng.php', 1 => 'imagepng', 2 => 'Ausgabe eines Bildes im Browser oder als Datei im PNG-Format', ), 'up' => array ( 0 => 'ref.image.php', 1 => 'GD- und Image-Funktionen', ), 'prev' => array ( 0 => 'function.imagepalettetotruecolor.php', 1 => 'imagepalettetotruecolor', ), 'next' => array ( 0 => 'function.imagepolygon.php', 1 => 'imagepolygon', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'de', '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 — Ausgabe eines Bildes im Browser oder als Datei im PNG-Format

Beschreibung

imagepng(
    GdImage $image,
    resource|string|null $file = null,
    int $quality = -1,
    int $filters = -1
): bool

Erzeugt eine PNG-Datei aus dem übergebenen image oder gibt diese direkt aus.

Parameter-Liste

image

Ein GdImage-Objekt, das von einer der Funktionen zur Bilderzeugung, z. B. imagecreatetruecolor(), zurückgegeben wurde.

file

Der Pfad oder eine offene Stream-Ressource (die nach der Beendigung dieser Funktion automatisch geschlossen wird), in dem bzw. der die Datei gespeichert werden soll. Falls nicht gesetzt oder null, wird der rohe Bilddatenstrom direkt ausgegeben.

Hinweis:

null ist ungültig, wenn die Parameter quality und filters nicht übergeben werden.

quality

Kompressionsstufe: Von 0 (keine Kompression) bis 9. Die Voreinstellung (-1) verwendet die voreingestellte zlib-Komprimierung. Weitere Informationen sind dem » zlib Handbuch zu entnehmen.

filters

Erlaubt einer Verkleinerung der PNG-Dateigröße. Dies ist ein Bitfeld, welches beliebig aus den PNG_FILTER_*-Konstanten zusammengesetzt werden kann. PNG_NO_FILTER oder PNG_ALL_FILTERS können verwendet werden, um entweder alle Filter aus- oder einzuschalten. Der Vorgabewert (-1) deaktiviert die Filterung.

Achtung

Der Parameter filters wird von der System-libgd ignoriert.

Rückgabewerte

Gibt bei Erfolg true zurück. Bei einem Fehler wird false zurückgegeben.

Achtung

Wenn libgd das Bild nicht ausgeben kann, gibt diese Funktion true zurück.

Fehler/Exceptions

Wenn quality ungültig ist, wird ein ValueError geworfen.

Changelog

Version Beschreibung
8.4.0 Wirft nun einen ValueError, wenn quality ungültig ist.
8.0.0 image erwartet nun eine GdImage-Instanz; vorher wurde eine gültige gd-Ressource erwartet.

Beispiele

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

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

imagepng($im);
?>

Siehe auch