Imagick::getImageClipMask()函数—用法及示例

函数名：Imagick::getImageClipMask()

函数描述：该函数用于获取图像的剪切蒙版图像。

适用版本：该函数在Imagick扩展版本3.4.0以上可用。

语法：public Imagick::getImageClipMask ( void ) : Imagick|null

参数：此函数不接受任何参数。

返回值：返回一个Imagick对象，表示图像的剪切蒙版图像。如果图像没有设置剪切蒙版，则返回null。

示例：

// 创建一个Imagick对象
$image = new Imagick('input.jpg');

// 设置剪切蒙版图像
$clipMask = new Imagick('clip_mask.png');
$image->setImageClipMask($clipMask);

// 获取图像的剪切蒙版图像
$clipMaskImage = $image->getImageClipMask();

// 检查是否成功获取剪切蒙版图像
if ($clipMaskImage) {
    // 打印剪切蒙版图像的宽度和高度
    echo '剪切蒙版图像的宽度：' . $clipMaskImage->getImageWidth() . PHP_EOL;
    echo '剪切蒙版图像的高度：' . $clipMaskImage->getImageHeight() . PHP_EOL;
} else {
    echo '图像没有设置剪切蒙版。' . PHP_EOL;
}

// 销毁对象
$image->destroy();
$clipMaskImage->destroy();

注意事项：

• 在使用该函数之前，需要先创建一个Imagick对象，并且加载了需要获取剪切蒙版图像的源图像。
• 在示例中，我们通过setImageClipMask()方法设置了一个剪切蒙版图像，然后使用getImageClipMask()方法获取该剪切蒙版图像。
• 如果图像没有设置剪切蒙版，则getImageClipMask()方法返回null。
• 在使用完Imagick对象和剪切蒙版图像后，记得使用destroy()方法销毁对象，释放内存。