imagegd2

Output GD2 image to browser or file

&reftitle.description; `bool` `imagegd2` `GdImage` `image` ``string``null```file`&null; `int` `chunk_size` 128 `int` `mode` `IMG_GD2_RAW`

Outputs a GD2 image to the given `file`.

&reftitle.parameters;

&gd.image.description;

`file`

- &gd.image.path;

`chunk_size`

- Chunk size.

`mode`

- Either `IMG_GD2_RAW` or `IMG_GD2_COMPRESSED`. Default is `IMG_GD2_RAW`.

&reftitle.returnvalues;

&return.success;

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

&Version; | &Description;
8.0.3 | `file` is now nullable.
&gd.changelog.image-param;

&reftitle.examples;

### Outputting a GD2 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
    imagegd2($im);

    // Free up memory
    imagedestroy($im);
    ?>

### Saving a GD2 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 gd2 image
    // The file format for GD2 images is .gd2, see http://www.libgd.org/GdFileFormats
    imagegd2($im, 'simple.gd2');

    // Free up memory
    imagedestroy($im);
    ?>

&reftitle.notes;

The GD2 format is commonly used to allow fast loading of parts of images. Note that the GD2 format is only usable in GD2-compatible applications.

&gd.deprecated.gd-formats;
&reftitle.seealso;

- `imagegd`