(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.
Die derzeitige Voreinstellung ist 6.
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_XXX
-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 filters
Parameter 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.
Version | Beschreibung |
---|---|
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);
imagedestroy($im);
?>