(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.
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 Parameterquality
undfilters
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.
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);
?>