PHP | Gmagick getimagewhitepoint()函数

介绍

getimagewhitepoint()函数是Gmagick扩展提供的一个函数，用于获取图像的白点。白点是指在XYZ颜色空间中，哪个颜色值最接近纯白色。通过该函数，可以获取图像的白平衡点，进而对图像进行白平衡处理。

语法

public Gmagick::getimagewhitepoint ( void ): array

返回值

该函数返回一个数组，包含三个值：X、Y和Z。分别表示在XYZ颜色空间中的三个坐标轴上，图像最接近纯白色的颜色值。

示例

以下示例演示了如何使用getimagewhitepoint()函数获取图像的白点。

<?php
try {
  $image = new Gmagick();
  $image->readImage('input.jpg');

  // 获取白点
  $whitepoint = $image->getimagewhitepoint();
  echo "White point: X=" . $whitepoint['x'] . ", Y=" . $whitepoint['y'] . ", Z=" . $whitepoint['z'];

} catch (Exception $e) {
  echo $e->getMessage();
}
?>

输出如下：

White point: X=0.9505, Y=1, Z=1.089

注意

在使用该函数前，需要事先加载Gmagick扩展，并安装正确的Gmagick库文件。该函数仅能用于处理Gmagick对象，不能用于处理其他类型的图片对象。

参考链接

• Gmagick官方文档：http://www.php.net/manual/en/gmagick.getimagewhitepoint.php