5.1 引言
为了提高图像处理过程中额可读性和交互性,opencv提供了绘制几何形状、文本、线的功能。广泛地应用于目标检测、图像分割、实时显示等场景中。
5.2 预先认识
5.2.1 CV::Point
Point表示在二维平面上的一个点(x, y);可用以下方式进行构造定义:
Point p;
p.x=1;
p.y=2;
或
Point p=Point(1,2);
5.2.1 CV::Scalar
Scalar是一个包含四个元素vector的模板类;最多可以表征4个元素。Scalar类型在OPenCV中被广泛用于传递像素值。
如 Scalar(a,b,c);//a=blue,b-green,c=red表示RGB三个通道;
5.3 绘制线、矩形、圆、椭圆等基本几何形状
5.3.1 画线 CV::line
void cv::line(InputOutputArray img,Point pt1,Point pt2,const Scalar & color,int thickness = 1,int lineType = LINE_8,int shift = 0)
参数 | 含义 | |
作用 | 在图上绘制线 | |
输入 | img | 底图 |
pt1 | 线的起点 | |
pt2 | 线的终点 | |
color | 线的颜色Scalar(B,G,R) | |
thickness | 线的宽度 | |
lineType | 线的类型: LINE_4:4邻近连接线 LINE_8:8邻近连接线(默认) LINE_AA:反锯齿连接线 | |
shift | 坐标点小数点的位数 | |
返回值 | void | 无 |
代码示例
void MyLine(Mat srcImg)
{
Point ps=Point(10,20);
Point pe;
pe.x=120;
pe.y=160;
Scalar color=Scalar(0,0,255);
Line(srcImg,ps,pe,color,1,LINE_8);
}
5.3.2 画矩形CV::rectangle
绘制矩形有两种方式
void cv::rectangle(InputOutputArray img,Point pt1,Point pt2,const Scalar & color,int thickness = 1,int lineType = LINE_8,int shift = 0)
参数 | 含义 | |
作用 | 在图上绘制矩形 | |
输入 | img | 底图 |
pt1 | 矩形左上点 | |
pt2 | 矩形右下点 | |
color | 线条的颜色Scalar(B,G,R) | |
thickness | 线条的宽度(-1表示被填充) | |
lineType | 线条的类型: LINE_4:4邻近连接线 LINE_8:8邻近连接线(默认) LINE_AA:反锯齿连接线 | |
shift | 坐标点小数点的位数 | |
返回值 | void | 无 |
void cv::rectangle(Mat &img,Rect rect,const Scalar & color,int thickness = 1,int lineType = LINE_8,int shift = 0)
参数 | 含义 | |
作用 | 在图上绘制矩形 | |
输入 | img | 底图 |
rect | 矩形边框,由CV::Rect(int x, int y, int width, int height);定义:左上坐标和宽高。 | |
color | 线条的颜色Scalar(B,G,R) | |
thickness | 线条的宽度(-1表示被填充) | |
lineType | 线条的类型: LINE_4:4邻近连接线 LINE_8:8邻近连接线(默认) LINE_AA:反锯齿连接线 | |
shift | 坐标点小数点的位数 | |
返回值 | void | 无 |
代码示例
void MyRectangle(Mat srcImg)
{
Point p1=Point(10,20);
Point p2=Point(110,120);
Scalar color = Scalar(0, 255,0);
rectangle(srcImg,p1,p2, color,2,LINE_8);
}
void MyRectangle2(Mat srcImg)
{
Rect rect=Rect(10,20,100,100);
Scalar color = Scalar(0, 255,0);
rectangle(srcImg,rect, color,2,LINE_8);
}
5.3.3 画圆CV::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 | 线条的颜色Scalar(B,G,R) | |
thickness | 线条的宽度(-1表示被填充) | |
lineType | 线条的类型: LINE_4:4邻近连接线 LINE_8:8邻近连接线(默认) LINE_AA:反锯齿连接线 | |
shift | 坐标点小数点的位数 | |
返回值 | void | 无 |
代码示例
void MyCircle(Mat srcImg)
{
Point center=Point(10,20);
int nRadius=10;
Scalar color = Scalar(0, 255,0);
circle(srcImg,center,p2, nRadius,color,2,LINE_8);
}
5.3.4 画椭圆CV::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)
参数 | 含义 | |
作用 | 在图上绘制椭圆 | |
输入 | img | 底图 |
center | 椭圆的中心点 | |
axes | 椭圆的长短轴Size(int width, int height) | |
angle | 椭圆旋转的角度,单位为度。顺时针旋转 | |
startAngle | 椭圆弧起始的角度,单位为度。顺时针旋转为正 | |
endAngle | 椭圆弧结束的角度,单位为度。顺时针旋转为正 | |
color | 椭圆线的颜色Scalar(B,G,R) | |
thickness | 线条的宽度(-1表示被填充) | |
lineType | 线条的类型: LINE_4:4邻近连接线 LINE_8:8邻近连接线(默认) LINE_AA:反锯齿连接线 | |
shift | 坐标点小数点的位数 | |
返回值 | void | 无 |
void cv::ellipse(InputOutputArray img, const RotatedRrct& box,const Scalar& color,int thickness=1, int lineType = LINE_8)
参数 | 含义 | |
作用 | 在图上绘制椭圆 | |
输入 | img | 底图 |
box | 平面上的旋转矩形 RotatedRect(const Point2f& center, const Size2f& size, float angle); (矩阵的质心,宽高,旋转角度) | |
color | 线条的颜色Scalar(B,G,R) | |
thickness | 线条的宽度(-1表示被填充) | |
lineType | 线条的类型: LINE_4:4邻近连接线 LINE_8:8邻近连接线(默认) LINE_AA:反锯齿连接线 | |
返回值 | void | 无 |
代码示例
void MyEllipse(Mat srcImg)
{
ellipse(srcImg, Point(srcImg.cols / 2, srcImg.rows / 2), Size(srcImg.cols / 4, srcImg.rows / 8), 60,0,360, Scalar(255, 0, 0), 1,LINE_8);
}
//只适用于画全椭圆,矩阵的宽高为长短轴的2倍
void MyEllipse2(Mat srcImg)
{
RotatedRect box=RotatedRect(Point(srcImg.cols / 2, srcImg.rows / 2), Size(srcImg.cols/4, srcImg.rows / 8), 60);
ellipse(srcImg, box, Scalar(255, 0, 0), 2, LINE_8);
}
5.3.5 绘制多边形
void cv::polylines(InputOutputArray img,InoutArrayOfArrays pts,bool isClosed,const Scalar & color, int thickness = 1, int lineType=LINE_8, int shift=0)
参数 | 含义 | |
作用 | 在图上绘制多边形性(只绘制不填充) | |
输入 | img | 底图 |
pts | 多边形点集 | |
isClosed | 是否闭合,默认闭合 | |
color | 线条的颜色Scalar(B,G,R) | |
thickness | 线条的宽度(必须大于0) | |
lineType | 线条的类型: LINE_4:4邻近连接线 LINE_8:8邻近连接线(默认) LINE_AA:反锯齿连接线 | |
shift | 坐标点小数点的位数 | |
返回值 | void | 无 |
void cv::fillPoly(InputOutputArray img,InoutArrayOfArrays pts,const Scalar & color, int lineType=LINE_8, int shift=0,Point offset =Point())
参数 | 含义 | |
作用 | 在图上绘制多边形(填充) | |
输入 | img | 底图 |
pts | 平面上的旋转矩形 RotatedRect(const Point2f& center, const Size2f& size, float angle); (矩阵的质心,宽高,旋转角度) | |
color | 线条的颜色Scalar(B,G,R) | |
lineType | 线条的类型: LINE_4:4邻近连接线 LINE_8:8邻近连接线(默认) LINE_AA:反锯齿连接线 | |
shift | 坐标点小数点的位数 | |
offset | 所有顶点的可选偏移 | |
返回值 | void | 无 |
void cv::drawContours(InputOutputArray img,InoutArrayOfArrays contours,int contourIdx,const Scalar & color,int thickness=1, int lineType=LINE_8,InputArray hierarchy=noArray(),int maxLevel=INT_MAX,Point offset =Point())
参数 | 含义 | |
作用 | 在图上绘制多边形 | |
输入 | img | 底图 |
contours | 输入的轮廓组,每一组轮廓由点vector构成 | |
contourIdx | 指明画第几个轮廓,如果该参数为负值,则画全部轮廓 | |
color | 线条的颜色Scalar(B,G,R) | |
thickness | 线条的宽度(-1表示被填充) | |
lineType | 线条的类型: LINE_4:4邻近连接线 LINE_8:8邻近连接线(默认) LINE_AA:反锯齿连接线 | |
hierarchy | 轮廓结构信息 | |
maxLevel | 绘制轮廓的最大级别。 | |
offset | 所有顶点的可选偏移 | |
返回值 | void | 无 |
代码示例
void MyPolygan(Mat srcImg)
{
Point p1(10, 10);
Point p2(150, 50);
Point p3(200, 180);
Point p4(160, 200);
Point p5(80, 180);
std::vector<Point> pts;
pts.push_back(p1);
pts.push_back(p2);
pts.push_back(p3);
pts.push_back(p4);
pts.push_back(p5);
//polylines:只画轮廓
polylines(srcImg, pts, true, Scalar(255, 255, 0),2,LINE_8,0);
//fillpoly:多边形填充
fillPoly(srcImg,pts, Scalar(255, 255, 0),LINE_8,0);
//drawContours:绘制多边形(填充可选)
vector<vector<Point>> contours;
contours.push_back(pts);
drawContours(srcImg,contours,-1, Scalar(255, 255, 0), 1,LINE_8);
}
以下为上述代码测试的三个绘制多边形方式结果:
5.4 绘制文字
图像处理中经常需要对图像增加一些说明性的文字,OpenCV提供了文字绘制的函数putText,函数的定义如下:
void cv::putText(Mat& img,cosnst String &text, Point orgin,int fontFace,double fontScale,Scalar color,int thickness=1, int lineType=8)
参数 | 含义 | |
作用 | 在图上绘制文字 | |
输入 | img | 底图 |
text | 绘制的文字 | |
orgin | 第一个字符的左下角坐标 | |
fontFace | 字体类型: FONT_HERSHEY_SIMPLEX ,FONT_HERSHEY_PLAIN ,FONT_HERSHEY_DUPLEX ,FONT_HERSHEY_COMPLEX等 | |
fontScale | 字体缩放系数 | |
color | 字体颜色 | |
thickness | 字体粗细 | |
lineType | 线条的类型: LINE_4:4邻近连接线 LINE_8:8邻近连接线(默认) LINE_AA:反锯齿连接线 | |
返回值 | void | 无 |
为了能够更好地放置文本框,会先计算出文本字符的大小,可通过cv::getTextSize()接口获取。
Size cv::getTextSize(cosnst String &text, int fontFace,double fontScale,Scalar color,int thickness=1, CV_OUT int *baseLine=8)
参数 | 含义 | |
作用 | 获取待绘制文本框的大小 | |
输入 | text | 输入的文本文字 |
fontFace | 字体类型: FONT_HERSHEY_SIMPLEX ,FONT_HERSHEY_PLAIN ,FONT_HERSHEY_DUPLEX ,FONT_HERSHEY_COMPLEX等 | |
fontScale | 字体缩放系数 | |
thickness | 字体粗细 | |
baseLine | 文字最底部y坐标 | |
返回值 | Size | 返回文本框的大小size |
代码示例
void MyPutText(Mat srcImg)
{
//设置文本参数
string sText = "put text";
int nFontFace = FONT_HERSHEY_COMPLEX;
double dFontScale = 1;
int nThickness = 2;
int baseline;
//求取所输入的文本框大小
Size textSize = cv::getTextSize(sText, nFontFace, dFontScale, nThickness, &baseline);
//将文本框居中绘制
Point origin;
origin.x = srcImg.cols / 2 - textSize.width / 2;
origin.y = srcImg.rows / 2 + textSize.height / 2;
putText(srcImg, sText, origin, nFontFace, dFontScale, Scalar(0,255,255), nThickness,LINE_8);
}