パレットを使用する新規画像を作成する

# imagecreate

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

imagecreate — パレットを使用する新規画像を作成する

### 説明

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

imagecreate() は、 指定した大きさの空の画像を表す画像 ID を返します。

一般に、imagecreate() よりは imagecreatetruecolor() を使うことを推奨します。 より高品質な画像処理ができるからです。パレット形式の画像を出力したい場合は、 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() - TrueColor イメージを新規に作成する

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