PHPのimagecreatetruecolor()関数の使い方を徹底解説！構文・パラメータ・サンプルコード付き

PHPのimagecreatetruecolor()関数は、新しいトゥルーカラー（True Color）画像を作成するための関数です。GDライブラリを使用した画像処理において、黒地の画像リソースを生成する際によく使われます。この記事では、imagecreatetruecolor()関数の基本的な使い方から、実際のコード例まで詳しく解説します。

imagecreatetruecolor()関数とは

imagecreatetruecolor()関数は、指定されたサイズの新しいトゥルーカラー画像を作成します。トゥルーカラー画像とは、各ピクセルに約1677万色（24ビット）を表現できる画像形式で、従来のパレット形式（imagecreate()で作成）よりも豊かな色表現が可能です。

構文

imagecreatetruecolor(width, height)

パラメータ

• width: 作成する画像の幅（ピクセル単位）。

• height: 作成する画像の高さ（ピクセル単位）。

戻り値

処理が成功した場合は画像リソース識別子（GdImageオブジェクト）を返し、失敗した場合はFALSEを返します。

使用例1：画像の幅と高さを確認する

まずは、imagecreatetruecolor()関数で作成した画像の高さと幅を取得する基本例を見てみましょう。

<?php
   $img = imagecreatetruecolor(600, 500);
   echo imagesy($img);
   echo "<br>";
   echo imagesx($img);
?>

このコードでは、imagesy()関数で画像の高さを、imagesx()関数で画像の幅をそれぞれ取得して表示しています。

出力結果

500
600

上記の出力では、新しく作成された画像の高さ「500」と幅「600」が表示されています。

使用例2：異なるサイズで作成する

次に、別の高さと幅を指定した例を見てみましょう。

<?php
   $img = imagecreatetruecolor(300, 450);
   echo imagesy($img);
   echo "<br>";
   echo imagesx($img);
?>

出力結果

450
300

このように、引数として渡したwidth（幅）とheight（高さ）の値が正しく反映され、作成された画像のサイズを取得できることが確認できます。

まとめ

imagecreatetruecolor()関数は、PHPで動的に画像を生成する際の起点となる重要な関数です。作成した画像リソースは、その後imagefill()での塗りつぶしやimagettftext()での文字描画、imagepng()やimagejpeg()でのファイル出力など、さまざまな画像処理に活用できます。画像操作を行う際には、ぜひこの関数の使い方をマスターしておきましょう。