opencv的rectangle函数

opencv的rectangle函数

当然,以下是关于OpenCV中rectangle函数的详细文档。这个函数用于在图像上绘制矩形框。

cv2.rectangle 函数

功能描述

cv2.rectangle 是 OpenCV 库中的一个函数,它允许你在图像上绘制一个矩形。你可以指定矩形的顶点坐标、颜色以及线条的粗细等参数。

语法格式

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

参数说明

  • img: 要在其上绘制矩形的图像(可以是灰度图或彩色图)。
  • pt1: 矩形的一个顶点坐标,通常是左上角 (x1, y1)。类型为元组 (int, int)。
  • pt2: 与 pt1 对角线上的另一个顶点坐标,通常是右下角 (x2, y2)。类型为元组 (int, int)。
  • color: 矩形边框的颜色。对于灰度图像,它是一个亮度值;对于彩色图像,它是一个 BGR 元组 (blue, green, red)。
  • thickness (可选): 线条的厚度。如果为负值(例如 -1),则填充整个矩形区域。默认值为 1。
  • lineType (可选): 线条的类型。可以是 cv2.LINE_8, cv2.LINE_4, 或 cv2.LINE_AA 等。默认为 cv2.LINE_8。
  • shift (可选): 点坐标的小数位数。默认值为 0。这个参数通常用于提高绘图精度。

返回值

该函数不返回任何值,而是直接在输入图像 img 上进行绘制。

使用示例

下面是一个简单的例子,展示如何在图像上绘制一个矩形:

import cv2 import numpy as np # 创建一个黑色的空白图像 image = np.zeros((512, 512, 3), dtype="uint8") # 定义矩形的两个对角点 pt1 = (100, 100) pt2 = (400, 400) # 定义矩形的颜色 (BGR) 和线条厚度 color = (0, 255, 0) # 绿色 thickness = 3 # 在图像上绘制矩形 cv2.rectangle(image, pt1, pt2, color, thickness) # 显示结果图像 cv2.imshow("Rectangle", image) cv2.waitKey(0) cv2.destroyAllWindows()

在这个例子中,我们创建了一个 512x512 的黑色图像,并在其上绘制了一个绿色的矩形。矩形的左上角坐标为 (100, 100),右下角坐标为 (400, 400),线条厚度为 3 个像素。

希望这份文档能帮助你更好地理解和使用 OpenCV 中的 rectangle 函数!