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類的基本使用方法和相關概念，以便更好地理解和應用該函式。