[函数]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对象和图像处理的基础知识。