OpenCV学习笔记（五）——图像上添加几何图形和文字（绘制圆、线段、椭圆、矩形、多边形及生成文字）

1 绘制圆

OpenCV4中分别提供了绘制圆的函数cv.circle().

#cv.circle()函数原型
img = cv.circle(img,
				center,
				radius,
				color
				[, thickness
				[, lineType
				[, shift]]])

其中各返回值和参数的含义分别为：
img：需要绘制圆的图像
center：圆心坐标
radius：圆的半径，单位为像素
color：线条的颜色，用三通道表示
thickness：轮廓的宽度(默认值为1)
lineType：线条的类型(可选参数如下表所示)
shift：设置center和radius的小数位数(默认值为0)

lineType可选标志	效果
cv.FILLED	全连接线
cv.LINE_4	四连接线
cv.LINE_8	八连接线(默认值)
cv.LINE_AA	抗锯齿线

2 绘制线段

OpenCV4中分别提供了绘制线段的函数cv.line().

#cv.line()函数原型
img = cv.line(img,
			  pt1,
			  pt2,
			  color
			  [, thickness
			  [, lineType
			  [, shift]]])

其中各返回值和参数的含义分别为：
img：需要绘制线段的图像
pt1：线段起点在图像中的坐标
pt2：线段终点在图像中的坐标
color：线条的颜色，用三通道表示
thickness：轮廓的宽度(默认值为1)
lineType：线条的类型(默认值为cv.LINE_8,可选值见上表)
shift：设置center和radius的小数位数(默认值为0)

3 绘制椭圆

OpenCV4中分别提供了绘制椭圆的函数cv.ellipse().

#cv.ellipse()函数原型
img = cv.ellipse(img,
			  	 center,
			  	 axes,
			  	 angle,
			  	 startAngle,
			  	 endAngle,
			     color
			     [, thickness
			     [, lineType
			     [, shift]]])

其中各返回值和参数的含义分别为：
img：需要绘制椭圆的图像
center：椭圆的中心
axes：椭圆长半轴的长度
angle：椭圆旋转的角度，单位为度
startAngle：椭圆弧起始的角度，单位为度
endAngle：椭圆弧终止的角度，单位为度
color：线条的颜色，用三通道表示
thickness：轮廓的宽度(默认值为1)
lineType：线条的类型(默认值为cv.LINE_8,可选值见上表)
shift：设置center和radius的小数位数(默认值为0)

4 绘制矩形

OpenCV4中分别提供了绘制矩形的函数cv.rectangle().cv.rectangle()函数有两种原型，分别可用一对对角的顶点坐标或左上角顶点的坐标及长宽绘制。

#cv.rectangle()函数原型一
img = cv.rectangle(img,
			  	   pt1,
			       pt2,
			       color
			  	   [, thickness
			       [, lineType
			       [, shift]]])

其中各返回值和参数的含义分别为：
img：需要绘制矩形的图像
pt1：矩形的一个顶点坐标
pt2：与pt1相对的顶点的坐标
color：线条的颜色，用三通道表示
thickness：轮廓的宽度(默认值为1)
lineType：线条的类型(默认值为cv.LINE_8,可选值见上表)
shift：设置center和radius的小数位数(默认值为0)

#cv.rectangle()函数原型二
img = cv.rectangle(img,
			  	   rec,
			       color
			  	   [, thickness
			       [, lineType
			       [, shift]]])

其中各返回值和参数的含义分别为：
img：需要绘制矩形的图像
rec：左上角的顶点坐标及矩形的长宽，以元组形式输入，四个元素依次为（顶点的x坐标、顶点的y坐标、矩阵的宽和矩阵的高）
color：线条的颜色，用三通道表示
thickness：轮廓的宽度(默认值为1)
lineType：线条的类型(默认值为cv.LINE_8,可选值见上表)
shift：设置center和radius的小数位数(默认值为0)

5 绘制多边形

OpenCV4中分别提供了绘制多边形的函数cv.fillPoly().

#cv.fillPoly()函数原型
img = cv.fillPoly()(img,
			  		pts,
			  		color
			  		[, lineType
			  		[, shift
			  		[, offset]]])

其中各返回值和参数的含义分别为：
img：需要绘制多边形的图像
pts：多边形顶点数组，存放多边形顶点坐标的数组
color：线条的颜色，用三通道表示
lineType：线条的类型(默认值为cv.LINE_8,可选值见上表)
shift：设置center和radius的小数位数(默认值为0)
offset：所有顶点的可选偏移量

6 生成文字

OpenCV4中分别提供了生成文字的函数cv.putText().

#cv.ellipse()函数原型
img = cv.putText(img,
			  	 text,
			  	 org,
			  	 fontFace,
			  	 fontScale,
			     color
			     [, thickness
			     [, lineType
			     [, bottomLeftOrigin]]])

其中各返回值和参数的含义分别为：
img：需要生成文字的图像
text：输出到图像中的文字，目前OpenCV4只支持英文
org：图像中文字字符串的的左下角像素坐标
fontFace：字体类型的选择标志，具体参数见下标
fontScale：字体的大小
color：线条的颜色，用三通道表示
thickness：轮廓的宽度(默认值为1)
lineType：线条的类型(默认值为cv.LINE_8,可选值见上表)
bottomLeftOrigin：图像数据圆点的位置，默认位于左上角。若参数选择True,则原点位于左下角

标志	简记	作用
cv.FONT_HERSHEY_SIMPLEX	0	正常大小的无衬线字体
cv.FONT_HERSHEY_PLAIN	1	小尺寸的无衬线字体
cv.FONT_HERSHEY_DUPLEX	2	正常大小较复杂的衬线字体
cv.FONT_HERSHEY_COMPLEX	3	正常大小的衬线字体
cv.FONT_HERSHEY_TRIPLEX	4	正常大小较复杂的衬线字体
cv.FONT_HERSHEY_COMPLEX_SMALL	5	小尺寸的衬线字体
cv.FONT_HERSHEY_SCRIPT_SIMPLEX	6	手写风格的字体
cv.FONT_HERSHEY_SCRIPT_COMPLEX	7	复杂的手写风格字体
cv.FONT_ITALIC	16	斜体字体

示例代码

# -*- coding:utf-8 -*-
import cv2 as cv
import numpy as np
import sys


if __name__ == '__main__':
    # 生成一个灰色图像用于绘制图形
    img = np.zeros((512, 512, 3), dtype='uint8')
    img.fill(200)
    # 绘制圆形
    # 绘制实心圆
    img = cv.circle(img, (50, 450), 25, (255, 255, 255), -1)
    # 绘制空心圆
    img = cv.circle(img, (100, 450), 20, (255, 255, 255), 4)

    # 绘制直线
    img = cv.line(img, (100, 100), (200, 300), (255, 0, 255), 2, cv.LINE_4, 0)

    # 绘制椭圆
    img = cv.ellipse(img, (300, 255), (100, 70), 0, 0, 270, (255, 255, 0), -1)

    # 用一些点近似一个椭圆
    points = cv.ellipse2Poly((200, 400), (100, 70), 0, 0, 360, 2)
    # 使用直线将上述点显示出来
    for i in range(len(points) - 1):
        img = cv.line(img, (points[i][0], points[i][1]), (points[i + 1][0], points[i + 1][1]),
                      (255, 0, 0), 2, cv.LINE_4, 0)
    img = cv.line(img, (points[-1][0], points[-1][1]), (points[0][0], points[0][1]),
                  (255, 0, 0), 2, cv.LINE_4, 0)

    # 绘制矩形
    img = cv.rectangle(img, (300, 400), (400, 500), (0, 255, 0), -1)
    img = cv.rectangle(img, (50, 250, 60, 50), (0, 0, 255), 2)

    # 绘制多边形
    pts = np.array([[350, 83], [463, 90], [500, 171], [421, 194], [338, 141]], dtype='int32')
    img = cv.fillPoly(img, [pts], (255, 0, 0), 8)

    # 添加文字
    img = cv.putText(img, 'Xyzz1223', (150, 70), 2, 1, (0, 255, 0))
    # 展示结果
    cv.imshow('Image', img)
    cv.waitKey(0)
    cv.destroyAllWindows()

代码运行结果如下图所示。

下一篇将会介绍OpenCV中的ROI（感兴趣区域）以及深拷贝和浅拷贝。