计算机视觉 / 系统课时

绘制文字标签

绘制文字标签

检测框只有位置,没有类别、置信度等语义信息。OpenCV 的 cv2.putText() 可以直接把文字绘制到图像上;结合 cv2.getTextSize() 预估尺寸,还能避免标签越过图像边界,得到稳定可读的标注结果。

学习目标

  • 使用 cv2.putText() 控制文字内容、位置、字体、字号、颜色和线宽
  • 使用 cv2.getTextSize() 根据文字尺寸调整标签位置
  • 正确处理 OpenCV 文字坐标和 BGR 颜色顺序

掌握文字绘制接口

cv2.putText() 会直接修改传入的图像。常用调用形式如下:

python
cv2.putText(image, text, org, fontFace, fontScale, color, thickness, lineType)

其中 org 不是文字左上角,而是文字基线左端点坐标 (x, y)。fontScale 控制相对字号,color 使用 BGR 顺序,例如绿色是 (0, 255, 0)。为了让斜线和曲线边缘更平滑,通常把 lineType 设置为 cv2.LINE_AA。

OpenCV 内置的是 Hershey 系列字体,例如 cv2.FONT_HERSHEY_SIMPLEX,适合英文、数字和简单符号。它并不是系统字体渲染器,因此直接绘制中文时通常不能得到正确字形。

给检测框添加标签

下面创建一张测试图像,绘制检测框,并把 person 0.93 放到框的上方。如果上方空间不足,就自动把标签移动到框内,避免文字被裁掉。

python
import cv2
import numpy as np

image = np.full((300, 500, 3), 245, dtype=np.uint8)

x1, y1, x2, y2 = 120, 80, 360, 240
label = "person 0.93"
color = (0, 180, 0)
font = cv2.FONT_HERSHEY_SIMPLEX
font_scale = 0.7
thickness = 2

cv2.rectangle(image, (x1, y1), (x2, y2), color, 2)

# 先测量文字尺寸,确保标签不会越过图像顶部。
(text_width, text_height), baseline = cv2.getTextSize(
    label, font, font_scale, thickness
)
text_y = y1 - 8
if text_y - text_height < 0:
    text_y = y1 + text_height + 8

cv2.putText(
    image,
    label,
    (x1, text_y),
    font,
    font_scale,
    color,
    thickness,
    cv2.LINE_AA,
)

saved = cv2.imwrite("label_result.png", image)
print("text size:", text_width, text_height)
print("saved:", saved)

预期输出

text
text size: <VALUE> <VALUE>
saved: True

文字宽高会因 OpenCV 版本和字体参数产生少量差异,因此以 <VALUE> 表示实际值。运行后生成的 label_result.png 中应包含绿色矩形框和 person 0.93 标签。

控制位置和可读性

文字位置最好由检测框位置推导,而不是写死固定坐标。常见策略是优先放在框的左上方,当 y1 - text_height 小于零时再移到框内部。横向也可以用 text_width 检查 x + text_width 是否超出图像宽度。

实际检测结果通常还会在文字下方绘制一块实色背景,再用高对比度文字覆盖,这样即使原图纹理复杂,标签也不会与背景混在一起。背景矩形尺寸可以直接使用 cv2.getTextSize() 返回的宽高计算。

处理中文标签

cv2.putText() 的 Hershey 字体主要面向 ASCII 字符,不能把它当作通用中文字体接口。如果标签包含中文,可先使用 Pillow、FreeType 等支持字体文件和 Unicode 的方案完成文字渲染,再转换回 OpenCV 图像继续处理。

对于英文类别名、置信度、编号等检测标注,cv2.putText() 已经足够轻量。真正需要稳定布局时,关键不是反复调整固定坐标,而是先测量文字尺寸,再根据图像边界动态决定基线位置。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

绘制文字标签

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通