Gmagick::modulateimage()函式—用法及示例

函式名：Gmagick::modulateimage()

函式描述：該函式用於調整影象的亮度、飽和度和色調。

適用版本：Gmagick擴充套件模組需要安裝並啟用，適用於PHP版本5.4.0及以上。

語法：public Gmagick::modulateimage(float $brightness, float $saturation, float $hue)

引數：

• $brightness（浮點型）：設定亮度的倍數，取值範圍為0到2。1表示不改變亮度，小於1表示降低亮度，大於1表示增加亮度。
• $saturation（浮點型）：設定飽和度的倍數，取值範圍為0到2。1表示不改變飽和度，小於1表示降低飽和度，大於1表示增加飽和度。
• $hue（浮點型）：設定色調的倍數，取值範圍為0到360。0表示不改變色調，小於0表示逆時針旋轉色調，大於0表示順時針旋轉色調。

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

示例：

// 建立一個Gmagick物件
$image = new Gmagick('path/to/image.jpg');

// 調整影象的亮度、飽和度和色調
$image->modulateimage(1.2, 1.5, 45);

// 儲存修改後的影象
$image->write('path/to/new_image.jpg');

上述示例中，我們首先建立了一個Gmagick物件，將路徑為'path/to/image.jpg'的影象載入進來。然後使用modulateimage()函式將影象的亮度增加20%（1.2倍），飽和度增加50%（1.5倍），色調順時針旋轉45度。最後，使用write()函式將修改後的影象儲存到'path/to/new_image.jpg'路徑下。

請注意，使用該函式需要安裝Gmagick擴充套件，並且啟用了對應的PHP模組。