(PHP 4 >= 4.0.7, PHP 5, PHP 7, PHP 8)
imagegd — Output GD image to browser or file
Outputs or saves the given image
in GD format.
image
Una risorsa immagine, restituita da una delle funzioni di creazione immagine, come imagecreatetruecolor().
file
Il 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);
?>
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');
?>
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.