画像パレットの色数を検出する

# imagecolorstotal

(PHP 4, PHP 5, PHP 7, PHP 8)

imagecolorstotal — 画像パレットの色数を検出する

### 説明

function imagecolorstotal(GdImage `$image`): int

指定した画像パレットの色数を返します。

### パラメータ

`image`
  imagecreatetruecolor()のような画像作成関数が返す GdImage オブジェクト。

### 戻り値

指定した画像パレットの色数を返します。 truecolor 画像の場合は 0 を返します。

### 変更履歴

バージョン | 説明
--- | ---
8.0.0 | `image` は、 GdImage クラスのインスタンスを期待するようになりました。 これより前のバージョンでは、有効な `gd` resource が期待されていました。

### 例

例1 imagecolorstotal() による画像の色の総数の取得

    <?php
    // 画像のインスタンスを作成します
    $im = imagecreatefromgif('php.gif');

    echo '色の総数: ' . imagecolorstotal($im);
    ?>

上の例の出力は、 たとえば以下のようになります。

    色の総数: 128

### 参考

- imagecolorat() - ピクセルの色のインデックスを取得する
- imagecolorsforindex() - カラーインデックスからカラーを取得する
- imageistruecolor() - 画像が truecolor かどうか調べる

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open