PHP 4 >= 4.0.7, PHP 5, PHP 7, PHP 8
imagegd - Output GD image to browser or file
Code Examples

imagegd( GdImage$image, [string|null$file = null] ): bool

Outputs a GD image to the given file.



A GdImage object, returned by one of the image creation functions, such as imagecreatetruecolor.


The path or an open stream resource (which is automatically closed after this function returns) to save the file to. If not set or null, the raw image stream will be output directly.

Return Values

Returns true on success or false on failure.


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



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.


Version Description
8.0.3 file is now nullable.
8.0.0 image expects a GdImage instance now; previously, a resource was expected.
7.2.0 imagegd now allows to output truecolor images. Formerly, these have been implicitly converted to palette.

Related Functions

Example of imagegd

Show all examples for imagegd

PHP Version:

Function imagegd:

Image Processing and GD Functions

Most used PHP functions