imagegd2
(PHP 4 >= 4.0.7, PHP 5, PHP 7, PHP 8)
imagegd2 — Output GD2 image to browser or file
Beschreibung
GdImage
$image,?string
$file = null,int
$chunk_size = 128,int
$mode = IMG_GD2_RAW): bool
Outputs a GD2 image to the given file.
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. -
chunk_size -
Chunk size.
-
mode -
Either
IMG_GD2_RAWorIMG_GD2_COMPRESSED. Default isIMG_GD2_RAW.
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.3 |
file is now nullable.
|
| 8.0.0 |
image erwartet nun eine
GdImage-Instanz; vorher wurde eine
Ressource erwartet.
|
Beispiele
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);
?>
Anmerkungen
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 GD und GD2 Bildformate sind proprietäre Bildformate von libgd. Sie sind als veraltet anzusehen, und sollten nur zu Entwicklungs- und Testzwecken verwendet werden.
Siehe auch
- imagegd() - Output GD image to browser or file
