PHPのimageistruecolor()関数で画像がトゥルーカラー画像かどうかを判定する方法

imageistruecolor() は、PHPに標準で組み込まれている関数の一つで、指定された画像がトゥルーカラー画像であるかどうかを判定するために使用されます。トゥルーカラー画像とは、各ピクセルがRGB（赤・緑・青）のカラー値によって表現される画像のことです。

構文

bool imageistruecolor(resource $image)

パラメータ

imageistruecolor() 関数は、1つのパラメータ $image を受け取ります。このパラメータには、判定対象となる画像リソースを渡します。

戻り値

imageistruecolor() は、指定された画像がトゥルーカラー画像であれば true を返し、そうでなければ false を返します。

補足：トゥルーカラー画像とは

PHPのGDライブラリでは、imagecreatetruecolor() 関数などで作成される画像がトゥルーカラー画像に該当します。一方、imagecreate() で作成される画像はパレット（インデックスカラー）形式となるため、トゥルーカラーとはみなされません。画像処理を行う前にこの関数で判別しておくと、意図しない色の劣化を防ぐことができます。

例1：トゥルーカラー画像を判定する

<?php
    // imagecreatefrompng()関数を使ってPNG画像から画像インスタンスを作成
    $img = imagecreatefrompng('C:\xampp\htdocs\Images\img44.png');

    // 画像がトゥルーカラーかどうかを判定
    $istruecolor = imageistruecolor($img);

    // 結果を出力
    if($istruecolor) {
      echo "指定された入力画像はトゥルーカラーです";
    }
?>

出力結果

// 入力：RGB画像

// 実行結果

指定された入力画像はトゥルーカラーです。

例2：グレー画像（非トゥルーカラー）を判定する

<?php
    // imagecreatefrompng()関数を使ってグレー画像から画像インスタンスを作成
    $img = imagecreatefrompng('C:\xampp\htdocs\Gray.png');
   
    // 画像がトゥルーカラーかどうかを判定
    $istruecolor = imageistruecolor($img);
 
    // 結果を出力
    if(!$istruecolor) {
      echo "指定された入力画像はトゥルーカラーではありません";
    }
?>

出力結果

// 入力：グレースケール画像

// 実行結果

指定された入力画像はトゥルーカラーではありません。

まとめ

imageistruecolor() 関数を使えば、画像がトゥルーカラー形式かどうかを簡単に判別できます。パレット画像を扱う場合は必要に応じて imagetruecolortopalette() や imagepalettetotruecolor() などの関数で変換することも可能なので、画像加工の前処理として活用すると良いでしょう。