Imagick::transformImageColorspace()函式—用法及示例

函式名稱：Imagick::transformImageColorspace()

函式描述：該函式用於將影象轉換到指定的顏色空間。

使用版本：PHP Imagick擴充套件 3.0.0 版本及以上

語法：bool Imagick::transformImageColorspace ( int $colorspace )

引數：

• colorspace：指定要轉換到的顏色空間的整數值。可選值包括：
  • Imagick::COLORSPACE_UNDEFINED (0)：未定義的顏色空間
  • Imagick::COLORSPACE_RGB (1)：RGB顏色空間
  • Imagick::COLORSPACE_GRAY (2)：灰度顏色空間
  • Imagick::COLORSPACE_TRANSPARENT (3)：透明顏色空間
  • Imagick::COLORSPACE_OHTA (4)：OHTA顏色空間
  • Imagick::COLORSPACE_LAB (5)：LAB顏色空間
  • Imagick::COLORSPACE_XYZ (6)：XYZ顏色空間
  • Imagick::COLORSPACE_YCBCR (7)：YCbCr顏色空間
  • Imagick::COLORSPACE_YCC (8)：YCC顏色空間
  • Imagick::COLORSPACE_YIQ (9)：YIQ顏色空間
  • Imagick::COLORSPACE_YPBPR (10)：YPbPr顏色空間
  • Imagick::COLORSPACE_YUV (11)：YUV顏色空間
  • Imagick::COLORSPACE_CMYK (12)：CMYK顏色空間
  • Imagick::COLORSPACE_SRGB (13)：sRGB顏色空間
  • Imagick::COLORSPACE_HSL (14)：HSL顏色空間
  • Imagick::COLORSPACE_HWB (15)：HWB顏色空間
  • Imagick::COLORSPACE_REC601LUMA (16)：Rec.601亮度顏色空間
  • Imagick::COLORSPACE_REC601YCBCR (17)：Rec.601 YCbCr顏色空間
  • Imagick::COLORSPACE_REC709LUMA (18)：Rec.709亮度顏色空間
  • Imagick::COLORSPACE_REC709YCBCR (19)：Rec.709 YCbCr顏色空間

返回值：成功時返回 true，失敗時返回 false。

示例：

// 建立 Imagick 物件
$image = new Imagick('input.jpg');

// 將影象轉換為灰度顏色空間
if ($image->transformImageColorspace(Imagick::COLORSPACE_GRAY)) {
    // 儲存轉換後的影象
    $image->writeImage('output.jpg');
    echo '影象顏色空間轉換成功！';
} else {
    echo '影象顏色空間轉換失敗！';
}

上述示例中，我們首先建立一個 Imagick 物件，並載入名為 "input.jpg" 的影象。然後，我們呼叫 transformImageColorspace() 函式將影象轉換為灰度顏色空間。如果轉換成功，我們將儲存轉換後的影象，並輸出成功訊息；否則，輸出失敗訊息。

注意：在使用該函式前，需要確保已經安裝了 Imagick 擴充套件，並且版本號大於等於 3.0.0。