imagegd
(PHP 4 >= 4.0.7, PHP 5, PHP 7, PHP 8)
imagegd — Output GD image to browser or file
Beschreibung
Outputs a GD image to the given file.
Parameter-Liste
-
image -
Eine von den verschiedenen Erzeugungsfunktionen wie imagecreatetruecolor() gelieferte Grafikressource.
-
file -
Der Pfad unter dem das Bild gespeichert werden soll. Ist dies nicht gesetzt oder
nullwird der rohe Bilddatenstrom direkt ausgegeben.
Rückgabewerte
Gibt bei Erfolg true zurück. Im Fehlerfall 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 expects a GdImage
instance now; previously, a resource was expected.
|
| 7.2.0 | imagegd() now allows to output truecolor images. Formerly, these have been implicitly converted to palette. |
Beispiele
Beispiel #1 Outputting a GD 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
imagegd($im);
// Free up memory
imagedestroy($im);
?>
Beispiel #2 Saving a GD 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 gd image
// The file format for GD images is .gd, see http://www.libgd.org/GdFileFormats
imagegd($im, 'simple.gd');
// Free up memory
imagedestroy($im);
?>
Anmerkungen
Hinweis:
The GD format is commonly used to allow fast loading of parts of images. Note that the GD format is only usable in GD-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
- imagegd2() - Output GD2 image to browser or file
add a note
