本文详细介绍了如何在 Python 中使用 OpenCV 的 `cv2.putText()` 函数为图像添加文字。通过该函数，您可以轻松地在图像上绘制文本，实现图像标注和结果展示等功能。文章深入解析了 `cv2.putText()` 函数的各项参数，包括图像、文本内容、位置、字体、大小、颜色、粗细和线型等，并提供了简单易懂的示例代码，帮助您快速上手。同时，还介绍了 OpenCV 提供的多种常用字体类型，以及使用 `cv2.LINE_AA` 实现抗锯齿效果的技巧。需要注意的是，`cv2.putText()` 函数仅支持 ASCII 字符，若要显示中文，需借助 PIL 库。掌握此方法，能有效提升图像处理项目的实用性。

使用cv2.putText()可在图像上添加文本，参数包括图像、文本内容、位置、字体、大小、颜色、粗细和线型，支持多种字体类型，但仅限ASCII字符，中文需借助PIL实现。

在Python中使用OpenCV为图像添加文本，主要通过 cv2.putText() 函数实现。这个函数可以将指定的字符串绘制到图像上，常用于图像标注、结果显示等场景。

基本语法

cv2.putText(img, text, org, font, fontScale, color, thickness, lineType)

参数说明：

• img：要绘制文本的图像（必须是NumPy数组，通常为BGR格式）
• text：要写入的字符串，如 "Hello OpenCV"
• org：文本左下角的坐标 (x, y)
• font：字体类型，如 cv2.FONT_HERSHEY_SIMPLEX、cv2.FONT_HERSHEY_DUPLEX 等
• fontScale：字体缩放比例，1.0 为默认大小，可增大或缩小
• color：文本颜色，BGR格式，例如 (255, 0, 0) 表示蓝色
• thickness：文本线条的粗细
• lineType：可选，线型，推荐使用 cv2.LINE_AA 实现抗锯齿效果

简单示例代码

import cv2
读取图像
image = cv2.imread('example.jpg')
添加文本
cv2.putText(image, 
text='Hello OpenCV', 
org=(50, 100), 
fontFace=cv2.FONT_HERSHEY_SIMPLEX, 
fontScale=1.2, 
color=(0, 255, 0),     # 绿色
thickness=2, 
lineType=cv2.LINE_AA)
显示结果
cv2.imshow('Image with Text', image)
cv2.waitKey(0)
cv2.destroyAllWindows()

常用字体类型

OpenCV 提供了多种内置字体，可根据需要选择：

• cv2.FONT_HERSHEY_SIMPLEX —— 基础无衬线字体
• cv2.FONT_HERSHEY_PLAIN —— 小号简洁字体
• cv2.FONT_HERSHEY_DUPLEX —— 更清晰的无衬线字体（比SIMPLEX细节更好）
• cv2.FONT_HERSHEY_COMPLEX —— 带衬线字体
• cv2.FONT_HERSHEY_TRIPLEX —— 更粗的衬线字体
• cv2.FONT_HERSHEY_SCRIPT_SIMPLEX 和 SCRIPT_COMPLEX —— 手写风格字体

注意事项

• 图像必须是 NumPy 数组格式，如果是用 PIL 读取的需先转换
• 中文字符不支持直接显示，cv2.putText() 只支持 ASCII 字符。若需显示中文，建议使用 PIL 来绘制文本，再转回 OpenCV 格式
• 坐标 (org) 超出图像范围会导致文本被截断或不可见
• 颜色顺序为 BGR，不是 RGB

基本上就这些。掌握 putText 函数后，可以在图像中标注关键信息，比如人脸检测中的标签、识别结果等，非常实用。

好了，本文到此结束，带大家了解了《OpenCV添加文字教程详解》，希望本文对你有所帮助！关注golang学习网公众号，给大家分享更多文章知识！