取得指定颜色的索引值

# imagecolorexact

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

imagecolorexact — 取得指定颜色的索引值

### 说明

function imagecolorexact(
GdImage `$image`,
int `$red`,
int `$green`,
int `$blue`
): int

返回图像调色板中指定颜色的索引值。

如果图象由文件创建，只有该图象使用到的颜色会被解析。仅存在于调色板中的颜色不会被解析。

### 参数

`image`
  由图象创建函数(例如imagecreatetruecolor())返回的 GdImage 对象。
`red`

  红色成分的值。

`green`

  绿色成分的值。

`blue`

  蓝色成分的值。

### 返回值

返回调色板中指定颜色的索引值，如果该颜色不存在则返回 -1。

### 更新日志

版本 | 说明
--- | ---
8.0.0 | `image` 现在需要 GdImage 实例；之前需要有效的 `gd` resource。

### 示例

示例 #1 从 GD logo 中获取颜色

    <?php
    // 设置图像
    $im = imagecreatefrompng('./gdlogo.png');

    $colors   = Array();
    $colors[] = imagecolorexact($im, 255, 0, 0);
    $colors[] = imagecolorexact($im, 0, 0, 0);
    $colors[] = imagecolorexact($im, 255, 255, 255);
    $colors[] = imagecolorexact($im, 100, 255, 52);

    print_r($colors);
    ?>

以上示例的输出类似于：

    Array
    (
        [0] => 16711680
        [1] => 0
        [2] => 16777215
        [3] => 6618932
    )

### 参见

- imagecolorclosest() - 取得与指定的颜色最接近的颜色索引值

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