使用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')
LANUX蓝脑商务网站系统下载LANUX V1.0 蓝脑商务网站系统 适用于网店、公司宣传自己的品牌和产品。 系统在代码、页面方面设计简约,浏览和后台管理操作效率高。 此版本带可见即可得的html编辑器, 方便直观添加和编辑要发布的内容。 安装: 1.解压后,更换logo、分类名称、幻灯片的图片及名称和链接、联系我们等等页面。 2.将dbconfig.php里面的数据库配置更改为你的mysql数据库配置 3.将整个文件夹上传至
立即学习“Python免费学习笔记(深入)”;
添加文本
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 函数后,可以在图像中标注关键信息,比如人脸检测中的标签、识别结果等,非常实用。











