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()方法。