当前位置：首页 > news >正文

RV1126 NO.40:OPENCV图形计算面积、弧长API讲解

news 2025/11/8 11:01:54

一.OPENCV图形面积、弧长计算的API介绍

在之前的章节中，我们已经讲解了图形轮廓检测和画框功能。本章节我们将重点介绍如何利用轮廓检测API来计算图形面积，包括矩形、圆形等多种形状的面积计算。这些面积和弧长计算方法在车辆识别、桥梁识别等实际应用中起着重要作用。课程将涉及contourArea、arcLength、minAreaRect、boundingRect、rectangle、line等常用API的使用。

1.1.contourArea的API讲解

contourArea 函数主要用于计算轮廓曲线包围的区域面积，即图像中目标物体的实际面积。如上图所示，该函数会计算白色区域的面积，其内部实现通常采用微积分等数学方法进行面积计算。

函数原型：

CV_EXPORTS_W double contourArea(InputArray contour, bool oriented = false);

参数说明：

contour：输入轮廓的点集数据
oriented：可选参数，用于指定是否返回带方向的面积值（当设为true时，返回值可能为负数）

返回值：返回计算得到的轮廓面积值（单位：像素）

1.2. arcLength的API讲解

arcLength 函数主要用于计算轮廓的周长，即图形边缘的曲线总长度。如下图所示，该函数通过计算轮廓点之间的连线长度来获取轮廓周长。

函数定义：

CV_EXPORTS_W double arcLength(InputArray curve, bool closed);

参数说明：

curve：输入轮廓的2D像素点集
closed：布尔值，表示轮廓是否闭合（true表示闭合）

返回值：计算得到的轮廓周长数值

1.3. minAreaRect的API讲解

minAreaRect的核心功能是计算最小外接矩形，即能够完全包含所有给定点的最小面积矩形。如图所示，数字"8"的形状被minAreaRect生成的矩形完美包围。这个矩形不仅能完整覆盖整个形状的所有点，还具有旋转特性 - 即使"8"存在倾斜角度，最小矩形也能准确贴合包裹。

CV_EXPORTS_W RotatedRect minAreaRect( InputArray points );

第一个参数：points输入的二维点数，可以Mat类型也可以是std::vector的向量类型

返回值：RotatedRect的矩形对象，它表示的是一个轮廓的最小外接矩形，我们来看看RotatedRect结构体成员变量

template<typename _Tp> class Point_
{
public:typedef _Tp value_type;//! default constructorPoint_();Point_(_Tp _x, _Tp _y);Point_(const Point_& pt);Point_(const Size_<_Tp>& sz);Point_(const Vec<_Tp, 2>& v);Point_& operator = (const Point_& pt);//! conversion to another data typetemplate<typename _Tp2> operator Point_<_Tp2>() const;//! conversion to the old-style C structuresoperator Vec<_Tp, 2>() const;//! dot product_Tp dot(const Point_& pt) const;//! dot product computed in double-precision arithmeticsdouble ddot(const Point_& pt) const;//! cross-productdouble cross(const Point_& pt) const;//! checks whether the point is inside the specified rectanglebool inside(const Rect_<_Tp>& r) const;_Tp x; //!< x coordinate of the point_Tp y; //!< y coordinate of the point
};

center：旋转矩形的质心

size：旋转矩形的宽度和高度

angle：顺时针的旋转角度。

RotatedRect矩形四个点的确定

在RotatedRect中，矩形的四个顶点通常用Point2f表示，其中p[0]点的确定尤为重要。p[0]的位置主要分为两种情况：

当最小外接矩形不与坐标轴平行时，Y坐标最大的点即为p[0]，如图2、3、4所示
当最小外接矩形与坐标轴平行时，会有两个Y坐标最大的点，如图1所示

1.4. boundingRect的API讲解

boundingRect的核心功能是计算图形轮廓的最小垂直边界矩形，该矩形必须与图像的上下边界平行。如上图所示：我们仍以数字8的形状为例，它保持在原先的位置。boundingRect生成的矩形能够完整包围数字8的垂直边界。

CV_EXPORTS_W Rect boundingRect( InputArray array );

第一个参数：array输入的灰度图像或者2D点集，数据类型为vector或者Mat矩阵数据
返回值：Rect的矩形对象，它表示的是物体轮廓的最大外接矩形。我们来看看Rect主要的成员变量

template<typename _Tp> class Point_
{
public:typedef _Tp value_type;//! default constructorPoint_();Point_(_Tp _x, _Tp _y);Point_(const Point_& pt);Point_(const Size_<_Tp>& sz);Point_(const Vec<_Tp, 2>& v);Point_& operator = (const Point_& pt);//! conversion to another data typetemplate<typename _Tp2> operator Point_<_Tp2>() const;//! conversion to the old-style C structuresoperator Vec<_Tp, 2>() const;//! dot product_Tp dot(const Point_& pt) const;//! dot product computed in double-precision arithmeticsdouble ddot(const Point_& pt) const;//! cross-productdouble cross(const Point_& pt) const;//! checks whether the point is inside the specified rectanglebool inside(const Rect_<_Tp>& r) const;_Tp x; //!< x coordinate of the point_Tp y; //!< y coordinate of the point
};

x：矩形的x坐标轴

y：矩形的y坐标轴

width：矩形的宽度

height：矩形的高度

1.5. rectangle的API讲解

rectangle函数的作用是绘制矩形，它有两种表示形式

1.5.1. 以两个顶点的方式画矩形

void cv::rectangle(InputOutputArray img, Point pt1, Point pt2, const Scalar & color, int  thickness = 1,int  lineType = LINE_8, int  shift = 0)

第一个参数：输入的矩阵图像数据

第二个参数：pt1是矩形的一个顶点，左上角的顶点

第三个参数：pt2矩形中与pt1相对的顶点，也就是两个点在对角线上，也就是右下角的顶点

第四个参数：Scalar颜色的标量

第五个参数：thickness线宽

第六个参数：lineType线的类型，默认是LINE_8就行，具体的类型如下代码：

//! type of line
enum LineTypes {FILLED  = -1,LINE_4  = 4, //!< 4-connected lineLINE_8  = 8, //!< 8-connected lineLINE_AA = 16 //!< antialiased line
};

第七个参数：shift坐标的小数点位，默认为0就可以

1.5.2.以Rect的方式画矩形

void cv::rectangle(InputOutputArray img, Rect rec, const Scalar & color, int thickness = 1,int  lineType = LINE_8, int  shift = 0)

第一个参数：输入的矩阵图像数据

第二个参数：Rect的结构体，我们来看看这个Rect的重要成员变量

template<typename _Tp> class Rect_
{
public:typedef _Tp value_type;//! default constructorRect_();Rect_(_Tp _x, _Tp _y, _Tp _width, _Tp _height);Rect_(const Rect_& r);Rect_(const Point_<_Tp>& org, const Size_<_Tp>& sz);Rect_(const Point_<_Tp>& pt1, const Point_<_Tp>& pt2);Rect_& operator = ( const Rect_& r );//! the top-left cornerPoint_<_Tp> tl() const;//! the bottom-right cornerPoint_<_Tp> br() const;//! size (width, height) of the rectangleSize_<_Tp> size() const;//! area (width*height) of the rectangle_Tp area() const;//! true if emptybool empty() const;//! conversion to another data typetemplate<typename _Tp2> operator Rect_<_Tp2>() const;//! checks whether the rectangle contains the pointbool contains(const Point_<_Tp>& pt) const;_Tp x; //!< x coordinate of the top-left corner_Tp y; //!< y coordinate of the top-left corner_Tp width; //!< width of the rectangle_Tp height; //!< height of the rectangle
};

x：矩形的x坐标轴

y：矩形的y坐标轴

width：矩形的宽度

height：矩形的高度

第三个参数：Scalar颜色的标量

第四个参数：thickness线宽，默认是1

第五个参数：lineType线的类型，默认是LINE_8就行，line的类型如下:

//! type of line
enum LineTypes {FILLED  = -1,LINE_4  = 4, //!< 4-connected lineLINE_8  = 8, //!< 8-connected lineLINE_AA = 16 //!< antialiased line
};

第六个参数：shift坐标点的小数点位数

1.6. line的API讲解

line函数的主要作用是通过两个点绘制直线

CV_EXPORTS_W void line(InputOutputArray img, Point pt1, Point pt2, const Scalar& color,int thickness = 1, int lineType = LINE_8, int shift = 0);

第一个参数：输入的矩阵图像数据

第二个参数：pt1是线的起始坐标，也就是图上x1坐标和y1坐标
第三个参数：pt2是线的终点坐标，也就是图上x2坐标和y2坐标

第四个参数：Scalar是颜色标量，绘制直线的颜色
第五个参数：thickness它是线的粗细程度，默认为1

第六个参数：lineType线的类型，默认是LINE_8就行，具体的类型

第七个参数：shift坐标点的小数点位数

1.7. threshold的API讲解

threshold主要用途是把图像进行二值化处理，二值化操作可以使图像中的数据量大大降低图像的复杂度，并且能够凸显出图像中的轮廓。

CV_EXPORTS_W double threshold( InputArray src, OutputArray dst, double thresh, double maxval, int type );

第一个参数：src源图像，可以是8位灰度图，也可以是32位的三通道图像
第二个参数：dst目标图像

第三个参数：thresh阈值
第四个参数：maxval二值图像中灰度最大值，maxval只能在THRESH_BINARY和THRESH_BINARY_INV有用，但是其他选项也需要填这个值，不能空着。
第五个参数：type阈值操作类型，具体的阈值操作如下图：

THRESH_BINARY：二值化阈值处理将图像转换为仅包含两个灰度值的二值图像。具体规则为：当像素灰度值超过设定阈值时，将其设为最大值(maxval)；若像素灰度值不高于阈值，则将其置为0。