PHPのimagecolorresolve()関数の使い方を徹底解説

PHPのimagecolorresolve()関数は、指定した色のカラーパレットインデックスを取得するための関数です。パレットに完全に一致する色が存在しない場合でも、最も近い色のインデックスが返される点が特徴です。

構文

imagecolorresolve(img, red, green, blue)

パラメータ

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

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

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

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

戻り値

imagecolorresolve() 関数は、指定したRGB値に対応するカラーインデックスを返します。正確な色がパレットに存在しない場合は、最も近い色のインデックスが返されます。なお、画像の生成や色の割り当てに失敗した場合は -1 が返されます。

使用例

以下は、GIF画像を読み込み、複数のRGB値に対するカラーインデックスを取得するサンプルコードです。

<?php
   $img = imagecreatefromgif('https://www.tutorialspoint.com/images/html.gif');
   $colors = array();
   $colors[] = imagecolorresolve($img, 120, 0, 190);
   $colors[] = imagecolorresolve($img, 110, 0, 140);
   $colors[] = imagecolorresolve($img, 120, 190, 0);
   print_r($colors);
   imagedestroy($img);
?>

実行結果

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

Array ( [0] => 128 [1] => 129 [2] => 130 )

まとめ

imagecolorresolve() 関数は、GDライブラリを使用した画像処理において、特定のRGB値に対応するカラーパレットのインデックスを簡単に取得できる便利な関数です。似たような関数として、常に新しい色を作成する imagecolorallocate() や、一致しない場合は新規に色を追加して失敗時に-1を返す imagecolorexact() との違いも理解しておくと、より柔軟な画像処理が可能になります。