imagecreatetruecolor

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 を返します。

例

例 928. 新規 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()