OpenCV库学习之cv2.putText函数
一、简介
cv2.putText
是 OpenCV 库中的一个函数,用于在图像上绘制文本。通过指定文本内容、位置、字体、大小和颜色等参数,可以在图像上添加注释或标签。
二、语法和参数
语法
cv2.putText(img, text, org, fontFace, fontScale, color, thickness=None, lineType=None, bottomLeftOrigin=None)
参数
img
: 要绘制文本的图像对象。text
: 要绘制的文本内容。org
: 文本左下角的坐标,以 (x, y) 形式表示。fontFace
: 字体类型,例如cv2.FONT_HERSHEY_SIMPLEX
。fontScale
: 字体大小比例因子。color
: 文本颜色,以 (B, G, R) 格式表示。thickness
(可选):文本笔画的厚度。默认为 1。lineType
(可选):线条类型。默认值为cv2.LINE_8
。bottomLeftOrigin
(可选):当为 True 时,文本的原点是左下角。默认值为 False。
返回值
此函数没有返回值,它直接在输入图像上进行绘制。
三、实例
3.1 在图像上绘制白色文本
import cv2
import numpy as np
# 创建一个黑色图像
img = np.zeros((400, 400, 3), dtype=np.uint8)
# 在图像上绘制白色文本
text = "Hello, OpenCV"
org = (50, 200)
fontFace = cv2.FONT_HERSHEY_SIMPLEX
fontScale = 1
color = (255, 255, 255) # BGR格式,白色
thickness = 2
cv2.putText(img, text, org, fontFace, fontScale, color, thickness)
# 显示图像
cv2.imshow('Text', img)
cv2.waitKey(0)
cv2.destroyAllWindows()
输出:
# 一个400x400的黑色图像,其中在(50, 200)位置绘制了"Hello, OpenCV"的白色文本
3.2 绘制带有不同字体和颜色的文本
import cv2
import numpy as np
# 创建一个黑色图像
img = np.zeros((400, 400, 3), dtype=np.uint8)
# 绘制红色文本
text1 = "Red Text"
org1 = (50, 100)
fontFace1 = cv2.FONT_HERSHEY_SIMPLEX
fontScale1 = 1
color1 = (0, 0, 255) # BGR格式,红色
thickness1 = 2
cv2.putText(img, text1, org1, fontFace1, fontScale1, color1, thickness1)
# 绘制绿色文本
text2 = "Green Text"
org2 = (50, 200)
fontFace2 = cv2.FONT_HERSHEY_COMPLEX
fontScale2 = 1
color2 = (0, 255, 0) # BGR格式,绿色
thickness2 = 2
cv2.putText(img, text2, org2, fontFace2, fontScale2, color2, thickness2)
# 显示图像
cv2.imshow('Multiple Text', img)
cv2.waitKey(0)
cv2.destroyAllWindows()
输出:
# 一个400x400的黑色图像,其中在(50, 100)位置绘制了"Red Text"的红色文本,在(50, 200)位置绘制了"Green Text"的绿色文本
四、注意事项
- 文本的颜色是以 BGR(蓝色、绿色、红色)格式表示的,而不是常见的 RGB 格式。
- 确保字体大小和位置参数正确,以避免文本绘制在图像外部或不可见。
cv2.putText
的fontFace
参数有多种选择,如cv2.FONT_HERSHEY_SIMPLEX
、cv2.FONT_HERSHEY_COMPLEX
等,可根据需求选择合适的字体。- 在显示图像时,需要确保正确使用
cv2.imshow
、cv2.waitKey
和cv2.destroyAllWindows
函数以避免窗口卡住。