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 cv2import numpy as np# 创建一个黑色图像img = np.zeros((400, 400, 3), dtype=np.uint8)# 在图像上绘制白色文本text = "Hello, OpenCV"org = (50, 200)fontFace = cv2.FONT_HERSHEY_SIMPLEXfontScale = 1color = (255, 255, 255) # BGR格式，白色thickness = 2cv2.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 cv2import numpy as np# 创建一个黑色图像img = np.zeros((400, 400, 3), dtype=np.uint8)# 绘制红色文本text1 = "Red Text"org1 = (50, 100)fontFace1 = cv2.FONT_HERSHEY_SIMPLEXfontScale1 = 1color1 = (0, 0, 255) # BGR格式，红色thickness1 = 2cv2.putText(img, text1, org1, fontFace1, fontScale1, color1, thickness1)# 绘制绿色文本text2 = "Green Text"org2 = (50, 200)fontFace2 = cv2.FONT_HERSHEY_COMPLEXfontScale2 = 1color2 = (0, 255, 0) # BGR格式，绿色thickness2 = 2cv2.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 函数以避免窗口卡住。