在 OpenCvSharp 中进行模板匹配时，若需要添加掩码（mask），可以使用 `Cv2.MatchTemplate` 的重载方法，该方法允许传入掩码图像作为参数。掩码用于指定模板中哪些区域参与匹配计算，通常用于忽略模板中的某些部分。 OpenCV 中的 `matchTemplate` 函数支持掩码的模式为 `TemplateMatchModes.CCoeffNormed`、`TemplateMatchModes.CCoeff` 和 `TemplateMatchModes.CCorr`，但不支持 `CCorrNormed` 模式下的掩码[^1]。 ### 示例代码 以下是一个使用掩码进行模板匹配的完整示例： ```csharp using OpenCvSharp; class Program { static void Main() { // 读取目标图像和模板图像 Mat sourceImage = Cv2.ImRead("source.jpg", ImreadModes.Grayscale); Mat templateImage = Cv2.ImRead("template.jpg", ImreadModes.Grayscale); // 创建掩码图像（与模板图像大小一致，白色表示参与匹配） Mat mask = new Mat(); Cv2.Threshold(templateImage, mask, 0, 255, ThresholdTypes.BinaryInv); // 假设背景为黑色，前景为白色 // 创建结果矩阵 int resultRows = sourceImage.Rows - templateImage.Rows + 1; int resultCols = sourceImage.Cols - templateImage.Cols + 1; Mat result = new Mat(resultRows, resultCols, MatType.CV_32FC1); // 执行带掩码的模板匹配（仅支持部分匹配模式） Cv2.MatchTemplate(sourceImage, templateImage, result, TemplateMatchModes.CCoeffNormed, mask); // 归一化结果 Cv2.Normalize(result, result, 0, 1, NormTypes.MinMax, -1); // 获取最佳匹配位置 double minVal, maxVal; Point minLoc, maxLoc; Cv2.MinMaxLoc(result, out minVal, out maxVal, out minLoc, out maxLoc); // 绘制矩形标记匹配区域 Rect matchRect = new Rect(maxLoc, new Size(templateImage.Cols, templateImage.Rows)); Mat outputImage = Cv2.ImRead("source.jpg"); Cv2.Rectangle(outputImage, matchRect, new Scalar(0, 255, 0), 2); // 显示结果 Cv2.ImShow("Match Result", outputImage); Cv2.WaitKey(0); } } ``` ### 注意事项 - 掩码图像必须与模板图像具有相同的尺寸和通道数。 - 在掩码中，非零像素表示对应的模板区域参与匹配计算，零值像素则被忽略。 - 使用掩码时应选择支持掩码输入的匹配模式，如 `CCoeffNormed` 或 `CCoeff`。 ---