OpenCV库学习之cv2.putText函数

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"的绿色文本

四、注意事项

1. 文本的颜色是以 BGR（蓝色、绿色、红色）格式表示的，而不是常见的 RGB 格式。
2. 确保字体大小和位置参数正确，以避免文本绘制在图像外部或不可见。
3. cv2.putText 的 fontFace 参数有多种选择，如 cv2.FONT_HERSHEY_SIMPLEX、cv2.FONT_HERSHEY_COMPLEX 等，可根据需求选择合适的字体。
4. 在显示图像时，需要确保正确使用 cv2.imshow、cv2.waitKey 和 cv2.destroyAllWindows 函数以避免窗口卡住。