[函数]Imagick::getImageChannelRange()函数—用法及示例

函数名称：Imagick::getImageChannelRange()

函数描述：获取图像指定通道的像素值范围。

适用版本：该函数在PHP Imagick扩展版本3.3.0及以上可用。

语法：public Imagick::getImageChannelRange(int $channel) : array

参数：

• $channel：指定的通道，可以是以下常量之一：
  • Imagick::CHANNEL_UNDEFINED (未定义通道)
  • Imagick::CHANNEL_RED (红色通道)
  • Imagick::CHANNEL_GRAY (灰度通道)
  • Imagick::CHANNEL_CYAN (青色通道)
  • Imagick::CHANNEL_MAGENTA (洋红色通道)
  • Imagick::CHANNEL_YELLOW (黄色通道)
  • Imagick::CHANNEL_BLACK (黑色通道)

返回值：

• 成功时返回包含最小值和最大值的关联数组，数组结构为：['min' => 最小值, 'max' => 最大值]。
• 失败时返回false。

示例：

// 创建Imagick对象并读取图像
$image = new Imagick('path/to/image.jpg');

// 获取红色通道的像素值范围
$channelRange = $image->getImageChannelRange(Imagick::CHANNEL_RED);

if ($channelRange !== false) {
    echo "红色通道的像素值范围：最小值 = " . $channelRange['min'] . ", 最大值 = " . $channelRange['max'];
} else {
    echo "获取像素值范围失败";
}

输出示例：

红色通道的像素值范围：最小值 = 0, 最大值 = 255

注意事项：

• 该函数只能用于已经加载到Imagick对象中的图像。
• 如果指定的通道不存在或图像未加载成功，函数将返回false。
• 此函数可用于获取图像的特定通道的像素值范围，以便进行图像处理和分析。