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

函式名： Imagick::tintImage()

適用版本： Imagick 3.3.0以上

用法： Imagick::tintImage ( mixed $tint , mixed $opacity ) : bool

說明：該函式將Imagick物件中的影象著色為指定的顏色，並可選地設定透明度。此函式可以用於建立影象的不透明或半透明的色彩效果。

引數：

• $tint：指定的顏色，可以是字串、陣列或ImagickPixel物件。字串可以是顏色名稱（如"red"）或十六進位制顏色碼（如"#FF0000"）。
• $opacity：可選引數，指定著色的透明度。取值範圍為0（完全透明）到1（完全不透明）之間的浮點數。

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

示例：

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

// 設定著色為紅色，並設定透明度為0.5
$tint = 'red';
$opacity = 0.5;

// 著色影象
$result = $image->tintImage($tint, $opacity);

if ($result) {
    // 儲存著色後的影象
    $image->writeImage('path/to/tinted_image.jpg');
    echo "影象著色成功！";
} else {
    echo "影象著色失敗！";
}

// 銷燬Imagick物件
$image->destroy();

注意事項：

• 請確保安裝了Imagick擴充套件，並且版本在3.3.0以上。
• $tint引數可以是字串（顏色名稱或十六進位制顏色碼），陣列（包含RGBA或CMYK值）或ImagickPixel物件。
• $opacity引數可選，如果不設定，則預設為1（完全不透明）。
• 著色後的影象將直接應用於原始Imagick物件，如果需要保留原始影象，請在呼叫tintImage()函式前建立副本。
• 在使用該函式前，建議先了解Imagick物件和影象處理的基礎知識。