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

PHPのimagecolormatch()関数は、画像のパレット版（インデックスカラー画像）の色を調整し、トゥルーカラー版（TrueColor画像）の色にできるだけ近づけるための関数です。パレット画像とトゥルーカラー画像の色味を一致させたい場合に活用できます。

構文

bool imagecolormatch ( img1, img2 )

パラメータ

• img1：imagecreatetruecolor()関数などで作成したトゥルーカラー画像リソース。

• img2：パレット形式の画像リソース。この画像はimg1と同じサイズである必要があります。imagecreate()関数で生成した画像が該当します。

戻り値

imagecolormatch()関数は、処理が成功した場合はTRUE（1）、失敗した場合はFALSE（0）を返します。

使用例1

以下は、PNG画像を読み込み、パレット画像との色をマッチングさせる基本的な例です。

<?php
    $img1 = imagecreatefrompng('https://www.tutorialspoint.com/images/Swift.png');
    $img2 = imagecreate(imagesx($img1), imagesy($img1));
    $color = Array();
    $color[] = imagecolorallocate($img2, 110, 40, 180);
    $color[] = imagecolorallocate($img2, 90, 10, 90);
    $color[] = imagecolorallocate($img2, 66, 170, 110);
    $color[] = imagecolorallocate($img2, 130,90, 70);
    echo imagecolormatch($img1, $img2);
    imagedestroy($img1);
    imagedestroy($img2);
?>

出力結果

実行すると、マッチング処理が正常に完了したことを示す以下の出力が得られます。

1

使用例2

別の画像を使用した例を見てみましょう。異なる色を割り当てたパレット画像に対しても同様の処理が可能です。

<?php
    $img1 = imagecreatefrompng('https://www.tutorialspoint.com/images/tp-logo-diamond.png');
    $img2 = imagecreate(imagesx($img1), imagesy($img1));
    $color = Array();
    $color[] = imagecolorallocate($img2, 10, 1, 20);
    $color[] = imagecolorallocate($img2, 40, 30, 10);
    $color[] = imagecolorallocate($img2, 15, 100, 50);
    $color[] = imagecolorallocate($img2, 70, 20, 30);
    echo imagecolormatch($img1, $img2);
    imagedestroy($img1);
    imagedestroy($img2);
?>

出力結果

1

まとめ

imagecolormatch()関数は、GDライブラリで画像処理を行う際に、パレット画像とトゥルーカラー画像の見た目の差を最小限に抑えるのに便利な関数です。両方の画像サイズを揃える点と、使用後はimagedestroy()でメモリを解放する点に注意して利用しましょう。