Home/ Manual/ image / functions/ imagegd

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

file: Path

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