基于OpenCvSharp的C#图像模板匹配问题求助

我关注计算机视觉与自动化领域，现在需要在一张大图中查找指定小图。我知道Python里有很多能正常运行的相关代码，但用C#的OpenCvSharp实现时却没能成功。

源文件 #

• 待查找的大图：
  
• 模板小图：
  

实现代码 #

var sourceImage = Cv2.ImRead("path");
var template = Cv2.ImRead("path");

var resultImage = new Mat();

Cv2.MatchTemplate(sourceImage, template, resultImage, TemplateMatchModes.CCoeffNormed);
Cv2.MinMaxLoc(resultImage, out _, out double maxVal, out _, out OpenCvSharp.Point maxLoc);

Rect rect = new Rect(maxLoc, new Size(template.Width, template.Height));
Cv2.Rectangle(sourceImage, rect, new Scalar(0, 255, 0), 2);

Cv2.ImShow("Result", sourceImage);
Cv2.WaitKey(0);

运行结果 #

1. 修正图片读取逻辑 #

• 确保ImRead的路径为绝对路径，或程序能正确识别的相对路径，避免路径含中文、空格导致读取失败。
• 处理模板图的透明通道：你的模板图是PNG格式，默认读取会带Alpha通道，需强制转为3通道与大图保持一致，修改读取代码：

  var sourceImage = Cv2.ImRead("大图路径", ImreadModes.Color);
  var template = Cv2.ImRead("模板图路径", ImreadModes.Color);
  

2. 添加匹配阈值过滤 #

CCoeffNormed模式下匹配值maxVal范围是[-1,1]，越接近1匹配度越高。直接取最大值可能匹配到低相似度区域，建议设置阈值（如0.8），仅当匹配度达标时绘制矩形：

double threshold = 0.8;
if (maxVal > threshold)
{
    Rect rect = new Rect(maxLoc, new Size(template.Width, template.Height));
    Cv2.Rectangle(sourceImage, rect, new Scalar(0, 255, 0), 2);
}

3. 尝试其他匹配模式 #

不同模式适配不同场景，若CCoeffNormed效果差，可切换为TmSqDiffNormed（该模式下minVal越小匹配度越高）：

Cv2.MatchTemplate(sourceImage, template, resultImage, TemplateMatchModes.TmSqDiffNormed);
Cv2.MinMaxLoc(resultImage, out double minVal, out _, out OpenCvSharp.Point minLoc, out _);
double threshold = 0.2;
if (minVal < threshold)
{
    Rect rect = new Rect(minLoc, new Size(template.Width, template.Height));
    Cv2.Rectangle(sourceImage, rect, new Scalar(0, 255, 0), 2);
}

4. 校验图像尺寸 #

确保模板图尺寸小于等于大图尺寸，否则MatchTemplate会直接无结果输出。

内容的提问来源于stack exchange，提问作者user20986100