将 GD 图像输出到浏览器或文件

# imagegd

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

imagegd — 将 GD 图像输出到浏览器或文件

### 说明

function imagegd(GdImage `$image`, ?string `$file` = `null`): bool

输出或保存 `image` 参数指定的 GD 图像。

### 参数

`image`
  由图象创建函数(例如imagecreatetruecolor())返回的 GdImage 对象。
`file`

  文件保存的路径或者已打开的流资源（此方法返回后自动关闭该流资源），如果未设置或为 `null`，将会直接输出原始图象流。

### 返回值

成功时返回 `true`， 或者在失败时返回 `false`。

警告

如果 libgd 输出图像失败，函数会返回 `true`。

### 更新日志

版本 | 说明
--- | ---
8.0.3 | `file` 现在可以为 null。
8.0.0 | `image` 现在需要 GdImage 实例；之前需要有效的 `gd` resource。
7.2.0 | imagegd() 现在允许输出真彩色图像。以前，已隐式转换为调色板。

### 示例

示例 #1 输出 GD 图像

    <?php
    // 创建空白图像并添加一些文本
    $im = imagecreatetruecolor(120, 20);
    $text_color = imagecolorallocate($im, 233, 14, 91);
    imagestring($im, 1, 5, 5,  "A Simple Text String", $text_color);

    // 输出图像
    imagegd($im);
    ?>

示例 #2 保存 GD 图像

    <?php
    // 创建空白图像并添加一些文本
    $im = imagecreatetruecolor(120, 20);
    $text_color = imagecolorallocate($im, 233, 14, 91);
    imagestring($im, 1, 5, 5,  "A Simple Text String", $text_color);

    // 保存 gd 图像
    // GD 图像的文件格式为 .gd，参阅 http://www.libgd.org/GdFileFormats
    imagegd($im, 'simple.gd');
    ?>

### 注释

> 注意:

> GD 格式通常用于允许快速加载部分图像。请注意，GD 格式仅可用于与 GD 兼容的应用程序。

警告

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.

### 参见

- imagegd2() - 将 GD2 图像输出到浏览器或文件

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open