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

PHPのimagecolorclosesthwb()関数とは

imagecolorclosesthwb()は、GDライブラリに含まれる画像処理用の関数の一つです。指定したRGBカラーに対して、色相（Hue）・白（White）・黒（Blackness）で表されるHWB色空間において最も近い色のインデックスを取得します。

画像内のパレットから、目的の色に視覚的に最も近い色を探したい場合に便利な関数です。

構文

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

パラメータ

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

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

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

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

戻り値

imagecolorclosesthwb()関数は、指定した色に対して色相・白・黒が最も近い色のインデックスを整数（int）として返します。

使用例

以下は、GIF画像を読み込み、特定のRGB値に最も近いHWB色のインデックスを取得するサンプルコードです。

<?php
    $img = imagecreatefromgif('https://www.tutorialspoint.com/images/html.gif');
    echo 'HWB = ' . imagecolorclosesthwb($img, 50, 110, 90);
    imagedestroy($img);
?>

出力結果

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

HWB = 87

補足ポイント

• この関数は、画像内のカラーパレットに存在する色の中から最も近い色を検索するため、対象画像がパレット形式（GIFやPNG-8など）である場合に特に有効です。

• 使用後は imagedestroy() を呼び出してメモリを解放することを推奨します。

• HWB色空間はHSVに似たモデルですが、白と黒の要素を直接扱えるため、直感的な色の調整に向いています。