PHP マニュアル
前のページ |  | 次のページ

# imagecreatetruecolor

(PHP 4 >= 4.0.6, PHP 5)

imagecreatetruecolor -- TrueColor イメージを新規に作成する

## 説明

resource imagecreatetruecolor ( int width, int height )

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

この関数が定義されているかどうかは、PHP および GD のバージョンによって 変わります。PHP 4.0.6 から 4.1.x の場合、GD モジュールが読み込まれていれば この関数は常に存在しますが、GD2 がインストールされていない環境では PHP が致命的なエラーを発生して終了してしまいます。PHP 4.2.x では、 このような場合にエラーではなく警告を発生させます。他のバージョンの PHP では、 適切なバージョンの GD がインストールされている場合にのみ この関数が定義されます。

## パラメータ

`width`

  画像の幅。

`height`

  画像の高さ。

## 返り値

成功した場合に画像リソース ID、エラー時に `FALSE` を返します。

## 例

例 1. 新規 GD イメージストリームの作成およびイメージの出力

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

上の例の出力は、たとえば 以下のようになります。

## 注意

> 注意: この関数は、GD 2.0.1 以降を必要とします (2.0.28 以降を推奨します)。

> 注意: この関数では GIF ファイルフォーマットは使用できません。

## 参考

imagedestroy()
imagecreate()

前のページ | ホーム | 次のページ
imagecreatefromxpm | 上に戻る | imagedashedline