(PHP 4, PHP 5, PHP 7, PHP 8)
imagepng — Ausgabe eines Bildes im Browser oder als Datei im PNG-Format
$image,$file = null,$quality = -1,$filters = -1
Erzeugt eine PNG-Datei aus dem übergebenen
image oder gibt diese direkt aus.
imageEin GdImage-Objekt, das von einer der Funktionen zur Bilderzeugung, z. B. imagecreatetruecolor(), zurückgegeben wurde.
fileDer 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:
nullist ungültig, wenn die Parameterqualityundfiltersnicht ü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.
Der Parameter filters wird von der System-libgd
ignoriert.
Gibt bei Erfolg true zurück. Bei einem Fehler wird false zurückgegeben.
Wenn libgd das Bild nicht ausgeben kann, gibt diese Funktion true zurück.
Wenn quality ungültig ist, wird ein
ValueError geworfen.
| 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.
|
<?php
$im = imagecreatefrompng("test.png");
header('Content-Type: image/png');
imagepng($im);
?>