imagegd

Output GD image to browser or file

&reftitle.description; `bool` `imagegd` `GdImage` `image` ``string``null```file`&null;

Outputs a GD image to the given `file`.

&reftitle.parameters;

&gd.image.description;

`file`

- &gd.image.path;

&reftitle.returnvalues;

&return.success;

&gd.return.trueonerror;
&reftitle.changelog;

&Version; | &Description;
8.0.3 | `file` is now nullable.
&gd.changelog.image-param;
7.2.0 | `imagegd` now allows to output truecolor images. Formerly, these have been implicitly converted to palette.

&reftitle.examples;

### 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);
    ?>

### 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);
    ?>

&reftitle.notes;

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.deprecated.gd-formats;
&reftitle.seealso;

- `imagegd2`