imagecreate

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

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

説明

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(11020)
    or die(
"Cannot Initialize new GD image stream");
$background_color imagecolorallocate($im000);
$text_color imagecolorallocate($im2331491);
imagestring($im155,  "A Simple Text String"$text_color);
imagepng($im);
imagedestroy($im);
?>

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

出力例 : 新しい GD 画像ストリームの作成および画像の出力

参考

関連キーワード:  画像, 作成, パレット, 新規, 使用, create, 出力, height, バージョン, imagecreatetruecolor