Current Location: Home> Latest Articles>

gitbox 2025-06-20

imagecolorclosesthwb 函数

适用PHP版本

PHP 4 >= 4.3.0, PHP 5, PHP 7, PHP 8

函数说明

imagecolorclosesthwb() 函数用于计算与指定颜色最接近的颜色,并返回其在图像资源中的颜色索引。这个函数以 HWB(色调、白度、黑度)色彩模型为基础来选择最接近的颜色。

函数语法

imagecolorclosesthwb(resource $image, float $hue, float $whiteness, float $blackness): int

参数

  • image: 图像资源。该参数必须是通过像 imagecreate() 或类似函数创建的图像资源。
  • hue: 色相值,范围从 0 到 360。
  • whiteness: 白度值,范围从 0 到 100。
  • blackness: 黑度值,范围从 0 到 100。

返回值

成功时返回最接近的颜色索引值(整数),如果出错则返回 -1。

示例

    $image = imagecreatetruecolor(200, 200);
    $colorIndex = imagecolorclosesthwb($image, 120, 60, 40);
    echo "最接近的颜色索引是: " . $colorIndex;
  

这段代码创建了一个 200x200 的图像资源,然后计算与色相为 120、白度为 60、黑度为 40 的颜色最接近的颜色索引,并输出结果。