在 Python 中使用 OpenCV (cv2) 在图片上绘制矩形框，可以使用 cv2.rectangle() 函数。以下是详细用法和示例：

函数原型

cv2.rectangle(img, pt1, pt2, color, thickness=None, lineType=None, shift=None)

参数说明

示例代码

1. 绘制空心矩形框

import cv2
import numpy as np

# 创建黑色背景图像
img = np.zeros((400, 400, 3), dtype=np.uint8)

# 定义矩形左上角和右下角坐标
pt1 = (100, 100)  # 左上角 (x1, y1)
pt2 = (300, 300)  # 右下角 (x2, y2)

# 绘制蓝色矩形框（边框粗细为2）
cv2.rectangle(img, pt1, pt2, (255, 0, 0), thickness=2)

cv2.imshow("Rectangle", img)
cv2.waitKey(0)
cv2.destroyAllWindows()

2. 绘制实心矩形框

# thickness=-1 表示填充矩形
cv2.rectangle(img, pt1, pt2, (0, 255, 0), thickness=-1)

3. 使用抗锯齿（更平滑的边缘）

cv2.rectangle(img, pt1, pt2, (0, 0, 255), thickness=3, lineType=cv2.LINE_AA)

注意事项

1. 坐标顺序：pt1 是左上角，pt2 是右下角，确保 x2 > x1 且 y2 > y1。
2. 颜色通道：BGR 格式（非 RGB），例如红色是 (0, 0, 255)。
3. 图像修改：函数会直接修改输入图像，若需保留原图，请先复制（img.copy()）。

常见问题

• 如何绘制多个矩形？
  多次调用 cv2.rectangle() 或使用循环。
• 如何调整矩形位置？
  修改 pt1 和 pt2 的坐标值即可。

如果需要结合其他图形（如圆形、文本等），可以组合使用 cv2.circle() 或 cv2.putText()。