PHP | Gmagick getimagehistogram()函数

简介

在Gmagick扩展中，getimagehistogram()函数用于获取图像的直方图。直方图是一种用来表示图像中像素分布的统计图表。

语法

Gmagick::getimagehistogram([bool $normalize = false])

参数

• $normalize（可选）：一个布尔值，表示是否对返回的直方图进行归一化。默认值为 false。

返回值

该函数返回一个包含图像直方图的数组，数组的索引是像素的亮度值（0-65535），而对应的值则是该亮度值在图像中的像素数量。

示例

以下示例演示如何使用getimagehistogram()函数来获取图像的直方图：

$gmagick = new Gmagick('image.jpg');
$histogram = $gmagick->getimagehistogram();

// 打印直方图
foreach ($histogram as $brightness => $count) {
    echo "亮度：" . $brightness . "，像素数量：" . $count . "\n";
}

输出结果：

亮度：0，像素数量：500
亮度：1，像素数量：600
亮度：2，像素数量：750
...

注意事项

• 如果指定了 $normalize 参数为 true，则返回的直方图会进行归一化处理，在归一化后，每个亮度值对应的像素数量将会以0-1的范围内表示。
• getimagehistogram()函数仅适用于已经加载到内存中的图像。
• 该函数返回的直方图是基于整个图像的像素数统计，而非仅仅基于某个特定区域的像素数统计。

更多关于Gmagick的使用方法和详细文档，请参考PHP官方文档。