OpenCV库学习之cv2.rectangle函数

OpenCV库学习之cv2.rectangle函数

一、简介

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)的区域被填充成蓝色矩形

四、注意事项

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