一、简介

<code>cv2.rectangle 是 OpenCV 库中的一个函数，用于在图像上绘制矩形。通过指定矩形的顶点坐标和颜色，可以在图像上标注感兴趣的区域。

二、语法和参数

语法

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

参数

img: 要绘制矩形的图像对象。pt1: 矩形的一个顶点（左上角），以 (x, y) 形式表示。pt2: 矩形的对角顶点（右下角），以 (x, y) 形式表示。color: 矩形边框的颜色，以 (B, G, R) 格式表示。thickness（可选）：矩形边框的厚度。默认为 1。如果设置为负值（如 -1），则表示填充矩形。lineType（可选）：线条类型。默认值为 cv2.LINE_8。shift（可选）：顶点坐标中的小数位数。默认值为 0。

返回值

此函数没有返回值，它直接在输入图像上进行绘制。

三、实例

3.1 在图像上绘制一个红色矩形

import cv2

import numpy as np

# 创建一个黑色图像

img = np.zeros((400, 400, 3), dtype=np.uint8)

# 在图像上绘制一个红色矩形

start_point = (50, 50)

end_point = (300, 300)

color = (0, 0, 255) # BGR格式，红色

thickness = 2

cv2.rectangle(img, start_point, end_point, color, thickness)

# 显示图像

cv2.imshow('Rectangle', img)

cv2.waitKey(0)

cv2.destroyAllWindows()

输出：

# 一个400x400的黑色图像，其中从(50, 50)到(300, 300)的区域被一个红色矩形框住

3.2 绘制一个填充的蓝色矩形

import cv2

import numpy as np

# 创建一个黑色图像

img = np.zeros((400, 400, 3), dtype=np.uint8)

# 在图像上绘制一个填充的蓝色矩形

start_point = (100, 100)

end_point = (250, 250)

color = (255, 0, 0) # BGR格式，蓝色

thickness = -1 # 填充矩形

cv2.rectangle(img, start_point, end_point, color, thickness)

# 显示图像

cv2.imshow('Filled Rectangle', img)

cv2.waitKey(0)

cv2.destroyAllWindows()

输出：

# 一个400x400的黑色图像，其中从(100, 100)到(250, 250)的区域被填充成蓝色矩形

四、注意事项

矩形的颜色是以 BGR（蓝色、绿色、红色）格式表示的，而不是常见的 RGB 格式。矩形的坐标可以超出图像的边界，但只有在图像内的部分会被绘制。在绘制多个矩形时，应确保颜色和厚度参数正确设置以区分不同的矩形。在显示图像时，需要确保正确使用 cv2.imshow、cv2.waitKey 和 cv2.destroyAllWindows 函数以避免窗口卡住。