Output GD image to browser or file

Beschreibung

imagegd ( resource $image [, mixed $to = NULL ] ) : bool

Outputs a GD image to the given to.

Parameter-Liste

image: Eine von den verschiedenen Erzeugungsfunktionen wie imagecreatetruecolor() gelieferte Grafikressource.
to: Der Pfad unter dem das Bild gespeichert werden soll. Ist dies nicht gesetzt oder NULL wird der rohe Bilddatenstrom direkt ausgegeben.

Rückgabewerte

Gibt bei Erfolg TRUE zurück. Im Fehlerfall wird FALSE zurückgegeben.

Achtung

However, if libgd fails to output the image, this function returns TRUE.

Changelog

Version	Beschreibung
7.2.0	imagegd() now allows to output truecolor images. Formerly, these have been implicitly converted to palette.
5.4.0	Added support for passing a stream resource to `to`.

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.

Siehe auch

imagegd2() - Output GD2 image to browser or file