OpencvSharp 算子学习教案之 - Cv2.MinEnclosingCircle 重载1-编程实验室

OpencvSharp 算子学习教案之 - Cv2.MinEnclosingCircle 重载1

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

Cv2.MinEnclosingCircle

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

摘要：本页演示MinEnclosingCircle(InputArray)如何从Mat点集计算最小外接圆的圆心和半径，并说明结果会写回Point2f center和float radius。

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

publicstaticvoidMinEnclosingCircle(InputArraypoints,outPoint2fcenter,outfloatradius)

2. 函数用途

Cv2.MinEnclosingCircle(...)用来计算包住所有输入点的最小圆。

这个重载最适合点集已经在Mat里的场景：

输入可以直接来自轮廓矩阵。
返回结果是圆心和半径，便于后续绘图。
不需要先把点拆成别的容器。

它常用于：

目标大小估计。
圆形区域分析。
几何教学中的“最小包围”概念演示。
作为更复杂测量步骤的前置结果。

3. 函数公式

最小外接圆可以写成一个约束优化问题：

C ∗ = arg ⁡ min ⁡ C ⊇ P A r e a ( C ) C^* = \arg\min_{C \supseteq P} Area(C)C∗=argC⊇PminArea(C)

其中圆C CC可以表示为：

C = { ( x , y ) ∣ ( x − c x ) 2 + ( y − c y ) 2 ≤ r 2 } C = \{(x, y) \mid (x-c_x)^2 + (y-c_y)^2 \le r^2\}C={(x,y)∣(x−cx)2+(y−cy)2≤r2}

这里c x , c y c_x, c_ycx,cy是圆心坐标，r rr是半径。

4. 函数原理说明

这个函数的重点不是“画圆”，而是“找到刚好包住全部点的最小圆”。

对初学者来说，可以先这样理解：

先观察点集的大致分布。
再寻找一个能包住所有点的最小圆。
最后把圆心和半径返回给调用者。

官方文档说明它是一个迭代式算法，所以它输出的是数值结果，而不是圆周上的点集。

5. 参数含义解析

参数名	类型	必填	含义
points	InputArray	是	输入二维点集
center	Point2f	是	输出圆心
radius	float	是	输出半径

补充说明：

points常见来源是Mat、UMat或轮廓缓存。
center是Point2f，所以圆心可以保留小数。
radius是float，适合直接用于Cv2.Circle。

6. 应用场景列表

场景名	场景说明	典型用途
场景A：目标范围	用一个圆概括对象大小	检测与测量
场景B：圆形近似	估计对象的近似半径	粗略分类
场景C：可视化	把圆心和半径画回图像	教学演示
场景D：教学入门	理解“最小外接”几何概念	OpenCvSharp 入门

7. 函数使用示例（与 WPF 场景一一对应）

说明：下面示例对应 WPF 场景 A。它先把点集包装成 Mat，再求最小外接圆。

usingSystem;usingOpenCvSharp;internalstaticclassProgram{privatestaticvoidMain(){// 这组点围成一个略微不规则的圆形，便于观察最小外接圆的效果。Point2f[]points={newPoint2f(82.5f,166.0f),newPoint2f(100.0f,108.5f),newPoint2f(158.0f,76.0f),newPoint2f(226.5f,80.5f),newPoint2f(284.0f,122.0f),newPoint2f(300.0f,186.5f),newPoint2f(268.0f,246.0f),newPoint2f(208.5f,270.0f),newPoint2f(140.0f,262.5f),newPoint2f(90.0f,218.0f),};// InputArray 重载常常用在“点集已经存在于 Mat 里”的场景。usingvarpointMat=Mat.FromArray(points);// 这里会返回圆心和半径，便于直接绘图或继续做几何分析。Cv2.MinEnclosingCircle(pointMat,outPoint2fcenter,outfloatradius);// 额外打印一个外接矩形，帮助初学者理解圆和矩形的包围关系。RectboundingRect=Cv2.BoundingRect(pointMat);Console.WriteLine($"PointCount ={points.Length}");Console.WriteLine($"Center = ({center.X:F1},{center.Y:F1})");Console.WriteLine($"Radius ={radius:F2}");Console.WriteLine($"Diameter ={(radius*2):F2}");Console.WriteLine($"CircleArea ={(Math.PI*radius*radius):F2}");Console.WriteLine($"BoundingRect = ({boundingRect.X},{boundingRect.Y},{boundingRect.Width},{boundingRect.Height})");// 这行说明了本例的核心：MinEnclosingCircle 返回的是圆心和半径，而不是圆周点。Console.WriteLine("MinEnclosingCircle 会直接给出圆心和半径，后续可交给 Cv2.Circle 绘制。\n");}}