PHPのimagecolorat()関数とは？使い方とサンプルコードを解説

PHPのGDライブラリに含まれるimagecolorat()関数は、画像内の指定した座標にあるピクセルの色インデックスを取得するための関数です。画像処理を行う際に、特定の位置の色情報を調べたい場合に非常に便利です。

構文

imagecolorat( $img, $x, $y )

パラメータ

• img：対象となる画像リソース。imagecreatetruecolor() 関数や imagecreatefrompng() 関数などで作成します。

• x：色を取得したい点のx座標（横方向の位置）。

• y：色を取得したい点のy座標（縦方向の位置）。

戻り値

imagecolorat()関数は、成功した場合にそのピクセルの色インデックスを返し、失敗した場合は FALSE を返します。

なお、取得した色インデックスからRGB値を取り出すには、ビット演算を利用するか、imagecolorsforindex() 関数と組み合わせて使うのが一般的です。

使用例

以下は、PNG画像を読み込み、座標 (15, 25) のピクセルの色情報を取得する例です。

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

出力結果

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

このように、imagecolorsforindex() 関数を使うことで、色インデックスを「赤（red）」「緑（green）」「青（blue）」「アルファ（alpha）」の各要素に分解して確認できます。上記の出力では、赤・緑・青がそれぞれ255（最大値）、アルファ値が127となっており、半透明の白色ピクセルであることがわかります。