创建新的基于调色板的图像

# imagecreate

(PHP 4, PHP 5, PHP 7, PHP 8)

imagecreate — 创建新的基于调色板的图像

### 说明

function imagecreate(int `$width`, int `$height`): GdImage|false

imagecreate() 返回代表指定大小的空白图像的图像标识符。

通常，建议使用 imagecreatetruecolor() 而不是 imagecreate()，以便在尽可能的最高质量图像上进行图像处理。如果要输出调色板图像，则应在使用 imagepng() 或 imagegif() 保存图像之前立即调用 imagetruecolortopalette()。

### 参数

`width`

  图像宽度。

`height`

  图像高度。

### 返回值

成功后返回图象对象,失败后返回 `false`。

### 更新日志

版本 | 说明
--- | ---
8.0.0 | 成功时，此函数现在返回 GDImage 实例，之前返回 resource。

### 示例

示例 #1 创建新的 GD 图像流并输出图像。

    <?php
    header("Content-Type: image/png");
    $im = @imagecreate(110, 20)
        or die("Cannot Initialize new GD image stream");
    $background_color = imagecolorallocate($im, 0, 0, 0);
    $text_color = imagecolorallocate($im, 233, 14, 91);
    imagestring($im, 1, 5, 5,  "A Simple Text String", $text_color);
    imagepng($im);
    ?>

以上示例的输出类似于：

### 参见

- imagecreatetruecolor() - 新建真彩色图像

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