imagepng

(PHP 4, PHP 5, PHP 7)

imagepngAusgabe eines Bildes im Browser oder als Datei im PNG-Format

Beschreibung

imagepng ( resource $image [, mixed $to = NULL [, int $quality = -1 [, int $filters = -1 ]]] ) : bool

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

Parameter-Liste

image

Eine von den verschiedenen Erzeugungsfunktionen wie imagecreatetruecolor() gelieferte Grafikressource.

to

Der Pfad unter dem das Bild gespeichert werden soll. Ist dies 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. 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.

Achtung

Der filters Parameter wird von der System-libgd ignoriert.

Rückgabewerte

Gibt bei Erfolg TRUE zurück. Im Fehlerfall wird FALSE zurückgegeben.

Achtung

However, if libgd fails to output the image, this function returns TRUE.

Changelog

Version Beschreibung
5.4.0 Unterstützung für die Übergabe einer Stream-Ressource (resource) an to wurde hinzugefügt.
5.1.3 Der filters-Parameter wurde hinzugefügt.
5.1.2 Der quality-Parameter wurde hinzugefügt.

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() - Gib die von der aktuell verwendeten PHP-Version unterstützten Grafik-Formate zurück
  • imagesavealpha() - Ob beim Speichern von PNG-Bildern vollständige Alphakanal-Information erhalten wird