(PHP 4 >= 4.0.7, PHP 5, PHP 7, PHP 8)
imagegd — Output GD image to browser or file
Outputs a GD image to the given file.
imageUna risorsa immagine, restituita da una delle funzioni di creazione immagine, come imagecreatetruecolor().
fileIl percorso in cui salvare il file. Se non è impostato o è null, viene restituito il flusso raw dell'immagine.
Restituisce true in caso di successo, false in caso di fallimento.
However, if libgd fails to output the image, this function returns true.
| Versione | Descrizione |
|---|---|
| 8.0.3 |
file is now nullable.
|
| 8.0.0 |
image expects a GdImage
instance now; previously, a valid gd resource was expected.
|
| 7.2.0 | imagegd() now allows to output truecolor images. Formerly, these have been implicitly converted to palette. |
Example #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);
?>
Example #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);
?>Nota:
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.
The GD and GD2 image formats are proprietary image formats of libgd. They have to be regarded obsolete, and should only be used for development and testing purposes.