新しい画像を作成する

# Imagick::newImage

(PECL imagick 2, PECL imagick 3)

Imagick::newImage — 新しい画像を作成する

### 説明

public function Imagick::newImage(
int `$cols`,
int `$rows`,
mixed `$background`,
string `$format` = ?
): bool

新しい画像を作成し、ImagickPixel の値を背景色として関連付けます。

### パラメータ

`cols`

  新しい画像のカラム数。

`rows`

  新しい画像の行数。

`background`

  この画像で使用する背景色。

`format`

  画像フォーマット。このパラメータは Imagick バージョン 2.0.1 で追加されました。

### 戻り値

成功した場合に `true` を返します。

### エラー / 例外

エラー時に ImagickException をスローします。

### 変更履歴

バージョン | 説明
--- | ---
PECL imagick 2.1.0 | 色を表す文字列を 3 番目のパラメータとして指定できるようになりました。 これまでのバージョンでは ImagickPixel オブジェクトしか指定できませんでした。

### 例

例1 Imagick::newImage() の使用法

新しい画像を作成し、それを表示します。

    <?php

    $image = new Imagick();
    $image->newImage(100, 100, new ImagickPixel('red'));
    $image->setImageFormat('png');

    header('Content-type: image/png');
    echo $image;

    ?>

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