# imagegd2

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

imagegd2 — 将 GD2 图像输出到浏览器或文件

### 说明

imagegd2 ( resource `$image` [, string `$filename` [, int `$chunk_size` [, int `$type` = IMG_GD2_RAW ]]] ) : bool

imagegd2() 将一个 GD 图像输出到 `filename`。`image`

### 参数

`image`

  由图象创建函数(例如imagecreatetruecolor())返回的图象资源。

`filename`

  文件保存的路径，如果未设置或为 `NULL`，将会直接输出原始图象流。

`chunk_size`

  Chunk size.

`type`

  可以是 `IMG_GD2_RAW` 或 `IMG_GD2_COMPRESSED`。默认为 `IMG_GD2_RAW`。

### 返回值

成功时返回 `TRUE`， 或者在失败时返回 `FALSE`。

### 范例

Example #1 输出一个 GD2 图像

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

Example #2 保存 GD2 图像

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

### 注释

> Note: 此函数需要 GD 2.0.1 或更高版本(推荐 2.0.28 及更高版本)。

> Note:

> GD2 格式一般是用来加载图像中的一部分时更快。注意 GD2 格式只能用于兼容于 GD2 的应用程序。

### 更新日志

版本 | 说明
--- | ---
4.3.2 | 添加了参数 `chunk_size` 和 `type`。

### 参见

- imagegd() - 将 GD 图像输出到浏览器或文件