(PHP 4 >= 4.0.7, PHP 5, PHP 7, PHP 8)
imagegd2 — Output GD2 image to browser or file
$image,$file = null,$chunk_size = 128,$mode = IMG_GD2_RAW
Outputs a GD2 image to the given file.
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.
chunk_sizeChunk size.
mode
Either IMG_GD2_RAW or
IMG_GD2_COMPRESSED. Default is
IMG_GD2_RAW.
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.3 |
file is now nullable.
|
| 8.0.0 |
image erwartet nun eine
GdImage-Instanz; vorher wurde eine gültige
gd-Ressource erwartet.
|
Beispiel #1 Outputting a GD2 image
<?php
// Create a blank image and add some text
$im = imagecreatetruecolor(120, 20);
$text_color = imagecolorallocate($im, 233, 14, 91);
imagestring($im, 1, 5, 5, "A Simple Text String", $text_color);
// Output the image
imagegd2($im);
// Free up memory
imagedestroy($im);
?>
Beispiel #2 Saving a GD2 image
<?php
// Create a blank image and add some text
$im = imagecreatetruecolor(120, 20);
$text_color = imagecolorallocate($im, 233, 14, 91);
imagestring($im, 1, 5, 5, "A Simple Text String", $text_color);
// Save the gd2 image
// The file format for GD2 images is .gd2, see http://www.libgd.org/GdFileFormats
imagegd2($im, 'simple.gd2');
// Free up memory
imagedestroy($im);
?>Hinweis:
The GD2 format is commonly used to allow fast loading of parts of images. Note that the GD2 format is only usable in GD2-compatible applications.
Die Bildformate GD und GD2 sind proprietäre Bildformate von libgd. Sie sind als veraltet anzusehen, und sollten nur zu Entwicklungs- und Testzwecken verwendet werden.