PHPのimagecolorsforindex()関数とは？構文・パラメータ・使用例をわかりやすく解説

はじめに

imagecolorsforindex()関数は、PHPのGDライブラリで提供される関数の一つで、指定したカラーパレットインデックスに対応する色情報（赤・緑・青・アルファ値）を取得するために使用されます。画像処理を行う際に、特定のピクセルがどのような色で構成されているかを調べたい場合に便利です。

構文

imagecolorsforindex(img, index)

パラメータ

• img：imagecreatetruecolor() や imagecreatefrompng() などで作成した画像リソースを指定します。

• index：取得したい色のインデックスを指定します。通常は imagecolorat() 関数を使って特定の座標から取得した値を使用します。

戻り値

imagecolorsforindex()関数は、指定した色インデックスに対応する値を格納した連想配列を返します。この配列には「red（赤）」「green（緑）」「blue（青）」「alpha（透明度）」という4つのキーが含まれており、それぞれ該当する色の値が入っています。

使用例

以下は、PNG画像を読み込み、特定の座標（x=25, y=45）にあるピクセルの色情報を取得して表示するサンプルコードです。

<?php
    $img = imagecreatefrompng('https://www.tutorialspoint.com/images/tp-logo-diamond.png');
    $x = 25;
    $y = 45;
    $rgb = imagecolorat($img, 25, 45);
    $colors = imagecolorsforindex($img, $rgb);
    var_dump($colors);
?>

出力結果

上記のコードを実行すると、次のような出力が得られます。

array(4) { ["red"]=> int(255) ["green"]=> int(255) ["blue"]=> int(255) ["alpha"]=> int(127) }

出力結果の読み方

この結果から、座標（25, 45）のピクセルは「赤：255、緑：255、青：255」、つまり白色であり、アルファ値が127であるため完全に透明な状態であることがわかります。なお、alpha値は0（完全不透明）～127（完全に透明）の範囲で表現されます。

このように、imagecolorsforindex()関数をimagecolorat()関数と組み合わせることで、画像内の任意の位置にある色の詳細情報を簡単に取得できます。画像の解析や色判定などの処理にぜひ活用してください。