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

PHPのimagecolorexact()関数は、画像パレット内から指定した色に完全一致する色のインデックス（添字）を取得するための関数です。GDライブラリで画像を扱う際に、特定のRGB値がパレット内に存在するかどうかを確認したい場合に役立ちます。

構文

imagecolorexact ( $img, $red, $green, $blue )

パラメータ

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

• red：赤成分の値（0〜255）を指定します。

• green：緑成分の値（0〜255）を指定します。

• blue：青成分の値（0〜255）を指定します。

戻り値

imagecolorexact()関数は、パレット内に指定した色が存在する場合はその色のインデックスを返します。該当する色が存在しない場合は -1 を返します。

使用例

以下は、imagecolorexact()関数を使って複数の色のインデックスを取得するサンプルコードです。

<?php
    $img = imagecreatefrompng('https://www.tutorialspoint.com/assets/videos/courses/67/images/course_67_image.png');
    $colors = Array();
    $colors[] = imagecolorexact($img, 30, 90, 50);
    $colors[] = imagecolorexact($img, 80, 120, 100);
    $colors[] = imagecolorexact($img, 25, 80, 50);
    print_r($colors);
    imagedestroy($img);
?>

実行結果

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

Array ( [0] => 1989170 [1] => 5273700 [2] => 1658930 )

補足ポイント

imagecolorexact()は、画像のパレットに登録されている色との完全一致のみを判定します。そのため、近似色でも一致しない場合は-1が返されます。近似色でもインデックスを取得したい場合は、最も近い色を検索するimagecolorclosest()関数を使用するとよいでしょう。また、画像の使用後はimagedestroy()でメモリを解放することを忘れないようにしましょう。