[函数]Imagick::subImageMatch()函数—用法及示例

函数名：Imagick::subImageMatch()

适用版本：Imagick类是通过Imagick扩展提供的，该扩展从版本2.0.0开始可用。

用法： Imagick::subImageMatch()方法用于在当前图像中查找子图像，并返回匹配的区域的位置。

语法：

public Imagick::subImageMatch(Imagick $Imagick, &$bestMatch = null)

参数：

• $Imagick：要匹配的子图像的Imagick对象。
• $bestMatch（可选）：将包含匹配区域的Imagick对象。如果未提供，则将在原始图像中绘制一个矩形来标记匹配区域。

返回值： 如果找到匹配的区域，则返回true，否则返回false。

示例：

// 创建主图像和子图像的Imagick对象
$mainImage = new Imagick('main_image.jpg');
$subImage = new Imagick('sub_image.jpg');

// 调用subImageMatch()方法查找子图像在主图像中的匹配区域
$bestMatch = new Imagick();
if ($mainImage->subImageMatch($subImage, $bestMatch)) {
    echo "找到了匹配的区域！";
    
    // 显示匹配区域
    header('Content-type: image/jpeg');
    echo $bestMatch;
} else {
    echo "未找到匹配的区域。";
}

注意事项：

• Imagick::subImageMatch()方法会修改原始图像，将匹配区域标记出来。如果不想修改原始图像，可以在调用该方法前创建一个副本。
• 如果找到多个匹配区域，只会返回最佳匹配的区域。要获取所有匹配区域，可以使用Imagick::subImageSearch()方法。