【PHP】imagecolorclosestalpha()関数の使い方とサンプルコード

PHPのimagecolorclosestalpha()関数とは

imagecolorclosestalpha()関数は、指定したRGB値とアルファ値（透明度）に最も近い色を画像のパレットから検索し、そのインデックス（カラーパレット上の番号）を取得するための関数です。半透明の色を扱う際に、既存のパレットカラーの中から最適な色を見つけたい場合に役立ちます。

構文

imagecolorclosestalpha ( img, red, green, blue, alpha )

パラメータ

• img：imagecreatetruecolor() などの関数で作成された画像リソース（GdImage オブジェクト）。

• red：赤（Red）成分。0〜255 の範囲で指定します。

• green：緑（Green）成分。0〜255 の範囲で指定します。

• blue：青（Blue）成分。0〜255 の範囲で指定します。

• alpha：透明度（アルファ値）。0 が完全な不透明、127 が完全な透明を表します。

戻り値

パレット内で最も近い色のインデックスを返します。検索に失敗した場合は false を返します。

使用例

以下は、PNG画像を読み込んでパレット形式に変換し、指定した色とアルファ値に最も近い色を取得するサンプルコードです。

<?php
    $img = imagecreatefrompng('https://www.tutorialspoint.com/images/tp-logo-diamond.png');
    imagetruecolortopalette($img, false, 255);
    $match = imagecolorclosestalpha($img, 180, 100, 150, 110);
    $match = imagecolorsforindex($img, $match);
    $match = "({$match['red']}, {$match['green']},
    {$match['blue']}, {$match['alpha']})";
    echo $match;
    imagedestroy($img);
?>

出力結果

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

(140, 130, 140, 0)

補足

この関数を使用するには、GDライブラリが有効になっている必要があります。また、TrueColor画像に対して使用する場合は、imagetruecolortopalette() を使ってあらかじめパレット形式へ変換しておく点に注意してください。取得したインデックスから具体的なRGBA値を確認したい場合は、imagecolorsforindex() を組み合わせると便利です。