Home/ Manual/ image / functions/ imagegd2

imagegd2

PHP function Edit on GitHub ✎

(PHP 4 >= 4.0.7, PHP 5, PHP 7, PHP 8)

Output GD2 image to browser or file

Description

imagegd2(GdImage $image, string|null $file = null, int $chunk_size = 128, int $mode = IMG_GD2_RAW): bool

Outputs or saves the given image in GD2 format.

Parameters

file: Path
chunk_size: Chunk size.
mode: Either IMG_GD2_RAW or IMG_GD2_COMPRESSED. Default is IMG_GD2_RAW.

Return Values

Success

Trueonerror

Changelog

Version	Description
8.0.3	`file` is now nullable.

Examples

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

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

Notes

Note

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-formats