OpencvSharp 算子学习教案之 - Cv2.ApproxPolyDP 重载3

fengxing666

175人浏览 · 2026-06-02 12:23:48

fengxing666 · 2026-06-02 12:23:48 发布

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

Cv2.ApproxPolyDP

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

摘要：本页演示 ApproxPolyDP(IEnumerable<Point2f>, double, bool) 如何保留亚像素坐标，并说明浮点点集在闭合轮廓简化中的优势。

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

public static Point2f[] ApproxPolyDP(
    IEnumerable<Point2f> curve,
    double epsilon,
    bool closed)

2. 函数用途

Cv2.ApproxPolyDP(...) 用来把一条轮廓或折线简化成更少的点。

这个重载的特点是：

输入直接是 IEnumerable<Point2f>。
返回值是 Point2f[]，可以保留亚像素精度。
非常适合更细致的几何轮廓分析。

它最常见的用途有：

精细轮廓压缩。
亚像素路径简化。
轮廓几何分析前处理。
需要保留小数坐标的矢量处理。

3. 函数公式

这个重载和其他 ApproxPolyDP 版本遵循同样的误差约束：

$\max_{p_i \in C} d(p_i, \hat{C}) \le \epsilon$

其中：

$C$ 是原始浮点曲线。
$\hat{C}$ 是简化后的浮点曲线。
Point2f 允许保留小数坐标。
epsilon 仍然表示允许的最大偏离距离。

4. 函数原理说明

Point2f 版本的算法逻辑和 Point 版本一样，只是输入输出都保留了浮点精度：

先找出最远离端点连线的点。
再判断这个点是否超过 epsilon。
如果超过，就继续拆分区段。
如果没有超过，就保留端点。

对初学者来说，最重要的是记住：

浮点点集更适合亚像素级的几何形状。
结果同样会变短，但精度会更细。
closed=true 会把首尾看成一条边。
如果把浮点坐标直接四舍五入，结果会略有变化。

5. 参数含义解析

参数名	类型	必填	含义
curve	IEnumerable<Point2f>	是	原始浮点轮廓
epsilon	double	是	允许的最大近似误差
closed	bool	是	是否把首尾当成连接边

补充说明：

Point2f[] 更适合亚像素轮廓或更细的形状分析。
closed=true 常用于圆环、叶片、标志轮廓等闭合形状。
closed=false 更适合轨迹或路径。
返回值仍然是浮点数组，所以可以继续做精细几何运算。

6. 应用场景列表

场景名	场景说明	典型用途
场景A：亚像素轮廓压缩	保留小数坐标的同时减少点数	高精度测量
场景B：闭合曲线分析	研究闭合形状的简化结果	工业视觉
场景C：细轮廓前处理	为后续几何分析减少冗余点	形状识别
场景D：教学对比	对比浮点和整数版本的差异	算法学习

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

说明：下面示例对应 WPF 场景 C。它会对一条闭合浮点曲线做简化，并打印简化前后的长度和点数。

using System;
using System.Collections.Generic;
using System.Globalization;
using OpenCvSharp;

internal static class Program
{
    private static void Main()
    {
        // 这条曲线保留了浮点坐标，方便观察亚像素精度的效果。
        Point2f[] sourcePoints = CreateClosedCurvePoints();

        // closed=true 表示首尾连成闭合曲线。
        Point2f[] approxPoints = Cv2.ApproxPolyDP(sourcePoints, 10.0, true);

        Console.WriteLine($"OriginalCount = {sourcePoints.Length}");
        Console.WriteLine($"ApproxCount = {approxPoints.Length}");
        Console.WriteLine($"OriginalLength = {Cv2.ArcLength(sourcePoints, true).ToString("F2", CultureInfo.InvariantCulture)}");
        Console.WriteLine($"ApproxLength = {Cv2.ArcLength(approxPoints, true).ToString("F2", CultureInfo.InvariantCulture)}");

        // 输出前几个点，帮助初学者确认浮点坐标是有小数部分的。
        PrintFirstPoints("Original", sourcePoints);
        PrintFirstPoints("Approx", approxPoints);
    }

    private static Point2f[] CreateClosedCurvePoints()
    {
        // 这里使用一个带波纹的极坐标圆形，便于观察简化后剩下的关键点。
        var points = new List<Point2f>();
        const int sampleCount = 16;
        const double centerX = 260.0;
        const double centerY = 180.0;

        for (var index = 0; index < sampleCount; index++)
        {
            var angle = Math.PI * 2.0 * index / sampleCount;
            var radius = 112.0 + 18.0 * Math.Sin(angle * 3.0) + 9.0 * Math.Cos(angle * 5.0);
            var x = centerX + radius * Math.Cos(angle);
            var y = centerY + radius * Math.Sin(angle);
            points.Add(new Point2f((float)x, (float)y));
        }

        return points.ToArray();
    }

    private static void PrintFirstPoints(string name, IReadOnlyList<Point2f> points)
    {
        // 只打印前几个点，避免控制台输出过长。
        Console.WriteLine($"{name} points:");

        for (var index = 0; index < Math.Min(points.Count, 5); index++)
        {
            Console.WriteLine($"  P{index + 1} = ({points[index].X:F1}, {points[index].Y:F1})");
        }
    }
}