新しい画像を作成する

# Imagick::newImage

(PECL imagick 2.0.0)

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

### 説明

Imagick::newImage ( int `$cols` , int `$rows` , mixed `$background` [, string `$format` ] ) : bool

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

### パラメータ

`cols`

  新しい画像のカラム数。

`rows`

  新しい画像の行数。

`background`

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

`format`

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

### 返り値

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

### エラー / 例外

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

### 変更履歴

バージョン | 説明
--- | ---
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;
?>`