一、简介

<code>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 函数以避免窗口卡住。