imagepng
(PHP 4, PHP 5, PHP 7, PHP 8)
imagepng — Ausgabe eines Bildes im Browser oder als Datei im PNG-Format
Beschreibung
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. Wenn 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. 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_FILTERoderPNG_ALL_FILTERSkönnen verwendet werden, um entweder alle Filter aus- oder einzuschalten. Der Vorgabewert (-1) deaktiviert die Filterung.AchtungDer
filtersParameter wird von der System-libgd ignoriert.
Rückgabewerte
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.
Changelog
| Version | Beschreibung |
|---|---|
| 8.0.0 |
image erwartet nun eine
GdImage-Instanz; vorher wurde eine
Ressource erwartet.
|
Beispiele
<?php
$im = imagecreatefrompng("test.png");
header('Content-Type: image/png');
imagepng($im);
imagedestroy($im);
?>
Siehe auch
- imagegif() - Gibt das Bild im Browser oder einer Datei aus.
- imagewbmp() - Gibt das Bild im Browser oder einer Datei aus.
- imagejpeg() - Gibt das Bild im Browser oder einer Datei aus.
- imagetypes() - Liefert die von der verwendeten PHP-Version unterstützten Grafikformate
- imagesavealpha() - Ob beim Speichern von PNG-Bildern vollständige Alphakanal-Information erhalten wird
