imagegd
PHP function
Edit on GitHub ✎
(PHP 4 >= 4.0.7, PHP 5, PHP 7, PHP 8)
Output GD image to browser or file
Description
imagegd(GdImage $image, string|null $file = null): bool
Outputs or saves the given image in GD format.
Parameters
filePath
Return Values
Success
Trueonerror
Changelog
| Version | Description |
|---|---|
| 8.0.3 | file is now nullable. |
| 7.2.0 | imagegd() now allows to output truecolor images. Formerly, these have been implicitly converted to palette. |
Examples
Outputting a GD image
php
<?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);
?>Saving a GD image
php
<?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');
?>Notes
Note
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.
Gd-formats