OpencvSharp 算子学习教案之 - Cv2.PointPolygonTest 重载2

OpencvSharp 算子学习教案之 - Cv2.PointPolygonTest 重载2

大家好，Opencv在很多工程项目中都会用到，而OpencvSharp则是以C#开发与实现的Opencv操作库，对.NET开发人员友好，但很多API的中文资料、应用场景及常见坑点等缺乏系统性归纳，因此这系列博客将给大家带来Cv2及Mat对象全系列算子学习教案，供大家参考学习。

Cv2.PointPolygonTest

• 教案版本：V1.0
• 面向对象：OpenCvSharp 初学者
• 所属模块：imgproc
• 源码位置：OpenCvSharp/Cv2/Cv2_imgproc.cs:4230

摘要：本页演示PointPolygonTest(IEnumerable<Point>, Point2f, bool)如何直接使用整数点轮廓做点位判断，并说明measureDist=false时只返回+1 / -1 / 0。

1. 函数名称（带参数签名）

publicstaticdoublePointPolygonTest(IEnumerable<Point>contour,Point2fpt,boolmeasureDist)

2. 函数用途

这个重载直接处理IEnumerable<Point>形式的整数轮廓。

它适合：

1. 轮廓已经是像素坐标。
2. 你希望代码写起来最自然，不想先包装成Mat。
3. 你只需要做基础的 inside / outside / on edge 判定。

对初学者来说，这个重载最直观，因为Point[]就是最常见的像素点数组。

3. 函数公式

当measureDist=false时：

f ( p ) = { + 1 , p ∈ i n t ( C ) 0 , p ∈ ∂ C − 1 , p ∉ C f(p)= \begin{cases} +1, & p \in \mathrm{int}(C) \\ 0, & p \in \partial C \\ -1, & p \notin C \end{cases}f(p)=⎩⎨⎧​+1,0,−1,​p∈int(C)p∈∂Cp∈/C​

当measureDist=true时，返回值变成带符号的边界距离：

f ( p ) = s ⋅ d ( p , C ) f(p)=s\cdot d(p, C)f(p)=s⋅d(p,C)

4. 函数原理说明

这个重载和InputArray版本的数学意义完全相同，区别只在于输入写法更直接：

1. 轮廓直接用IEnumerable<Point>提供。
2. OpenCvSharp 内部会把它交给底层的点集处理逻辑。
3. 返回值仍然遵循“内部为正、外部为负、边界为 0”的规则。

对于整数点轮廓，最重要的是把“像素级坐标”这个前提讲清楚。

5. 参数含义解析

补充说明：

1. 如果点坐标本来就是像素坐标，这个重载通常最顺手。
2. Point比Point2f更容易和图像像素对应。
3. 如果你需要亚像素精度，可以直接换成Point2f重载。

6. 应用场景列表

7. 函数使用示例

说明：下面示例对应 WPF 场景 B。它直接使用Point[]轮廓，并把查询点放在轮廓外部。

usingSystem;usingOpenCvSharp;internalstaticclassProgram{privatestaticvoidMain(){// 直接准备整数点轮廓，这种写法最符合日常图像坐标思维。Point[]contourPoints={newPoint(77,96),newPoint(164,59),newPoint(262,74),newPoint(304,136),newPoint(286,214),newPoint(196,262),newPoint(93,234),newPoint(58,150),};// 选择一个明显在外部的点，方便观察 -1 的返回语义。varqueryPoint=newPoint2f(320.0f,112.0f);// 这里故意把 measureDist 设成 false，让输出只保留三值判定结果。varresult=Cv2.PointPolygonTest(contourPoints,queryPoint,false);Console.WriteLine($"Result ={result:F0}");Console.WriteLine(result>0?"点在轮廓内部":result<0?"点在轮廓外部":"点在轮廓边界上");}}

8. 注意事项

1. 不要把Point[]和Point2f[]混为一谈，精度差别会影响调试结果。
2. measureDist=false时，不要期待它返回真实距离。
3. 轮廓点顺序仍然要保持沿边界排列。
4. 点位测试只回答“在哪里”，不负责修复错误轮廓。

9. 调优建议

1. 如果轮廓是从二值图提出来的，先把点顺序和闭合性确认好。
2. 做交互式点击检测时，Point[]是最容易读懂的输入形式。
3. 如果结果经常抖动，优先检查坐标是否被过早取整。
4. 需要更细的测量时，再切换到Point2f。

10. 进阶扩展

1. 可以把这个函数接到鼠标点击事件里，做轮廓内点击判定。
2. 可以批量遍历图像像素，做区域热力图。
3. 可以和FindContours、DrawContours一起讲“轮廓提取 + 轮廓测试”。
4. 可以把整数轮廓和浮点轮廓做成同一组对比教学。

11. 常见错误排查

1. 把外部点误判成内部点，往往是轮廓顺序有问题。
2. 以为measureDist=false会给出距离，实际上只给三值结果。
3. 把点坐标四舍五入得太早，导致边界判断不稳定。
4. 轮廓不闭合或点集顺序乱掉时，结果很难解释。

相关链接：

• WPF 教学控件：Cv2PointPolygonTestControl.xaml.cs
• 样例实现：PointPolygonTestPointEnumerableSample.cs
• 官方文档源码位置：OpenCvSharp/Cv2/Cv2_imgproc.cs