PHPのimagecolorallocate()関数の使い方を解説

PHPのimagecolorallocate()関数は、作成した画像に対して新しい色を割り当てるためのGDライブラリ関数です。画像に図形や文字を描画する際には必須となる基本的な関数の一つです。

構文

int imagecolorallocate($img, $red, $green, $blue)

パラメータ

• img: imagecreatetruecolor()などで生成された画像リソース（画像ID）を指定します。

• red: 赤色の成分（0〜255の整数値）を指定します。

• green: 緑色の成分（0〜255の整数値）を指定します。

• blue: 青色の成分（0〜255の整数値）を指定します。

戻り値

imagecolorallocate()関数は、指定されたRGB成分から生成された色識別子（カラーID）を返します。この色IDは、imagefill()やimageline()など、他の描画関数で使用できます。なお、色の割り当てに失敗した場合はfalseが返されます。

補足ポイント

パレット形式の画像では、最初に割り当てられた色が自動的に背景色として設定されます。また、RGBの各成分は0（最小）〜255（最大）の範囲で指定し、例えば「(0, 0, 0)」は黒、「(255, 255, 255)」は白を表します。

使用例

以下は、imagecolorallocate()関数を使って背景色を設定するサンプルコードです。

<?php
    // 600×220ピクセルの画像を作成
    $img = imagecreatetruecolor(600, 220);
    // 色を割り当てる（R=20, G=50, B=120）
    $bgcolor = imagecolorallocate($img, 20, 50, 120);
    // 画像全体を指定した色で塗りつぶす
    imagefill($img, 0, 0, $bgcolor);
    // PNG画像として出力
    header("Content-type: image/png");
    imagepng($img);
    // メモリを解放
    imagedestroy($img);
?>

実行結果

上記のコードを実行すると、RGB(20, 50, 120)で指定した青系統の単色画像がブラウザに出力されます。