Gmagick::getimagewhitepoint()函数—用法及示例

函数名：Gmagick::getimagewhitepoint()

适用版本：Gmagick扩展版本2.0.0及以上

用法：该函数用于获取当前Gmagick对象的图像白点（white point）。

语法：array Gmagick::getimagewhitepoint ( void )

返回值：该函数返回一个包含白点坐标的数组，格式为array('x' => x坐标, 'y' => y坐标)。如果获取白点失败，则返回false。

示例：

// 创建Gmagick对象并读取图像文件
$gmagick = new Gmagick();
$gmagick->readImage('image.jpg');

// 获取图像白点坐标
$whitepoint = $gmagick->getimagewhitepoint();

if ($whitepoint) {
    echo "图像白点坐标：x = " . $whitepoint['x'] . ", y = " . $whitepoint['y'];
} else {
    echo "获取图像白点失败";
}

注意事项：

1. 在调用该函数之前，需要先安装并启用Gmagick扩展。
2. 该函数只能在Gmagick对象上调用，不能在Gmagick类上调用。
3. 该函数只能用于处理图像文件，不能处理其他类型的数据。
4. 如果图像中没有白点信息，或者获取白点失败，将返回false。
5. 图像白点坐标是指在CIE XYZ颜色空间中，表示白色的坐标值。
6. 对于多帧图像，该函数只会返回第一帧的白点坐标。如需获取其他帧的白点坐标，需要先使用Gmagick::setIteratorIndex()方法切换到相应帧。
7. 在使用Gmagick扩展之前，建议先了解Gmagick类的基本使用方法和相关概念，以便更好地理解和应用该函数。