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

Opencv-绘制几何图形

news 2026/5/27 13:16:13

1. 绘制圆形

1.1 circle()函数原型

void cv::circle(InputOutputArray img, Point center, int radius, const Scalar & color, 
int thickness = 1, int lineType = LINE_8, int shift = 0 )

img：需要绘制圆形的图像。
center：圆形的圆心位置坐标。
radius：圆形的半径，单位为像素。
color：圆形的颜色。
thickness：轮廓的宽度，如果数值为负，则绘制一个实心圆。
lineType：边界的类型，可取值为 FILLED、LINE_4、LINE_8 和 LINE_AA。
shift：中心坐标和半径数值中的小数位数。

该函数用于在一幅图像中绘制圆形图案，输入的参数分别是圆形的圆心位置、半径，以及边界线的宽度和线型。

2. 绘制直线

2.1 line()函数原型

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

pt1：直线起点在图像中的坐标。
pt2：直线终点在图像中的坐标。
color：直线的颜色，用三通道表示。

该函数利用两点确定一条直线的方式在图像中画出一条直线，函数中很多参数的含义与circle() 函数一致，这里不再赘述。

3. 绘制椭圆

3.1 ellipse()函数原型

void cv::ellipse(InputOutputArray img, Point center, Size axes, double angle, double startAngle, 
double endAngle, const Scalar & color, int thickness = 1, int lineType = LINE_8, int shift = 0 )

center ：椭圆的中心坐标。

axes：椭圆的长半轴和短半轴的长度。

angle ：椭圆旋转的角度，单位为度。

startAngle ：椭圆弧起始的角度，单位为度。

endAngle ：椭圆弧终止的角度，单位为度

该函数通过选定椭圆中心位置和主轴大小唯一地确定一个椭圆，并且可以控制旋转角度改变椭圆在坐标系中的位置。通过椭圆弧起始和终止角度，可以绘制完整的椭圆或者一部分椭圆弧。与circle()函数一致，当边界线的厚度值为负数的时候，将绘制一个实心的椭圆。

在 OpenCV 4 中，还提供了另一个名为 ellipse2Poly() 的函数用于输出椭圆边界的像素坐标，但是不会在图像中绘制椭圆。

3.2 ellipse2Poly()函数原型

void cv::ellipse2Poly(Point center, 
Size axes, 
int angle, 
int arcStart, 
int arcEnd, 
int delta, 
std::vector< Point > & pts 
)

arcStart：椭圆孤起始的角度，单位为度。
arcEnd：椭圆弧终止的角度，单位为度。
delta：点与点之间的角度分辨率，其实就是对椭圆曲线的近似度。
pts：椭圆边缘像素坐标向量集合。

该函数与绘制椭圆需要输入的参数类似，只是不将椭圆输出到图像中，而是通过 vector （向量）将椭圆边缘的坐标点存储起来，便于后续的再处理。

4. 绘制多边形

在几何图形中，多边形也是一个重要的成员。在多边形中，矩形是一个比较特殊的类型，因此，在 OpenCV 4 中，除提供绘制多边形的函数 fillPoly() 之外，也提供了绘制矩形的函数 rectangle() 。我们先介绍矩形的绘制，之后再介绍多边形的绘制。

4.1 rectangle()函数原型

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

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

pt1：矩形的一个顶点。
pt2：矩形中与 pt1 相对的顶点，即两个点在对角线上。
rec：矩形左上角顶点和长宽。

在 OpenCV 4 中定义了两种函数原型，分别利用矩形对角线上两个顶点的坐标或者利用左上角顶点坐标与矩形的长和宽唯一地确定一个矩形。在绘制矩形时，同样可以控制边缘线的宽度绘制一个实心的矩形。

这里我们详细介绍 Rect 变量，该变量在 OpenCV 4中表示矩形的含义，与 Point、Vec3b 等类型相同，都是在图像处理中常用的类型。Rect 表示的是矩形的左上角像素坐标，以及矩形的长和宽，该类型定义的格式为 Rect(像素的 x 坐标，像素的 y 坐标，矩形的宽，矩形的高)，其中可以存放的数据类型也分别为 int 型（Rect2i 或者 Rect）、double 类型（Rect2d）和 float 类型（Rect2f）。

4.3 fillPoly()函数原型

void cv::fillPoly(InputOutputArray img, 
const Point ** pts, 
const int * npts, 
int ncontours, 
const Scalar & color, 
int lineType = LINE_8, 
int shift = 0, 
Point offset = Point() 
)

pts：多边形顶点数组，可以存放多个多边形的顶点坐标的数组。
npts：每个多边形顶点数组中顶点的个数。
ncontours：绘制多边形的个数。
offset：所有顶点的可选偏移。

该函数中与前文含义相同的参数不再重复介绍。该函数通过依次连接多边形的顶点来实现多边形的绘制，多边形的顶点需要按照顺时针或者逆时针的顺序依次给出，通过控制边界线宽度可以实现是否绘制实心多边形。需要说明的是，pts 参数是一个数组，数组中存放的是每个多边形顶点坐标数组，npts 参数也是一个数组，用于存放 pts 数组中每个元素中顶点的个数。

5. 文字生成

5.1 putText()函数原型

void cv::putText(InputOutputArray img, 
const String & text, 
Point org, 
int fontFace, 
double fontScale, 
Scalar color, 
int thickness = 1, 
int lineType = LINE_8, 
bool bottomLeftOrigin = false 
)

text：输出到图像中的文字，目前 OpenCV 4 只支持英文。
org：图像中文字字符串的左下角像素坐标。
fontFace：字体类型的选择标志、参数取值范围及含义在表 3-8 中给出。
fontScale：字体的大小。
bottomLeftOrigin：图像数据原点的位置。默认为左上角；如果参数改为 true，则原点为左下角。

该函数中与前文含义相同的参数不再重复介绍。目前，该函数只支持英文的输出，如果要在图像中输出中文，那么需要添加额外的依赖项，这里不进行扩展，有需求的读者可以寻找相关资料进一步地进行学习。

6.代码示例

#include <opencv2/opencv.hpp> 
#include <iostream> using namespace cv; 
using namespace std; int main() 
{ Mat img = Mat::zeros(Size(512, 512), CV_8UC3); //生成一个黑色图像用于绘制几何图形//绘制圆形circle(img, Point(50, 50), 25, Scalar(255, 255, 255), -1); //绘制一个实心圆circle(img, Point(100, 50), 20, Scalar(255, 255, 255), 4); //绘制一个空心圆//绘制直线line(img, Point(100, 100), Point(200, 100), Scalar(255, 255, 255), 2, LINE_4,0); //绘制椭圆ellipse(img, Point(300,255), Size(100, 70), 0, 0, 100, Scalar(255,255,255), -1); ellipse(img, RotatedRect(Point2f(150,100), Size2f(30,20), 0), Scalar(0,0,255),2); vector<Point> points; //用一些点来近似一个椭圆ellipse2Poly(Point(200, 400), Size(100, 70),0,0,360,2,points); for (int i = 0; i < points.size()-1; i++) //用直线把这个椭圆画出来{ if (i==points.size()-1) { //椭圆最后一个点与第一个点连线line(img, points[0], points[i], Scalar(255, 255, 255), 2); break; } //当前点与后一个点连线line(img, points[i], points[i+1], Scalar(255, 255, 255), 2); } //绘制矩形rectangle(img, Point(50, 400), Point(100, 450), Scalar(125, 125, 125), -1); rectangle(img, Rect(400,450,60,50), Scalar(0, 125, 125), 2);//绘制多边形Point pp[2][6]; pp[0][0] = Point(72, 200); pp[0][1] = Point(142, 204); pp[0][2] = Point(226, 263); pp[0][3] = Point(172, 310); pp[0][4] = Point(117, 319); pp[0][5] = Point(15, 260); pp[1][0] = Point(359, 339); pp[1][1] = Point(447, 351); pp[1][2] = Point(504, 349); pp[1][3] = Point(484, 433); pp[1][4] = Point(418, 449); pp[1][5] = Point(354, 402); Point pp2[5]; pp2[0] = Point(350, 83); pp2[1] = Point(463, 90); pp2[2] = Point(500, 171); pp2[3] = Point(421, 194); pp2[4] = Point(338, 141); const Point* pts[3] = { pp[0],pp[1],pp2 }; //pts 变量的生成int npts[] = { 6,6,5 }; //顶点个数数组的生成fillPoly(img, pts, npts, 3, Scalar(125, 125, 125),8); //绘制 3 个多边形//生成文字putText(img, "Learn OpenCV 4",Point(100, 400), 2, 1, Scalar(255, 255, 255)); imshow("img", img); waitKey(0); return 0; 
}