计算机视觉 / 系统课时
绘制直线与矩形
绘制直线与矩形
在 OpenCV 中,直线和矩形都由像素坐标、BGR 颜色和线宽决定。本课直接在一张空白画布上绘制两个图形并保存结果,同时处理最常见的 x/y 顺序、颜色通道和边界坐标错误。
学习目标
- 正确使用
(x, y)坐标、BGR 颜色和像素线宽 - 使用
cv2.line与cv2.rectangle绘制并保存图像 - 能检查坐标越界、通道顺序和填充参数是否正确
坐标、颜色与线宽
OpenCV 绘图函数使用 (x, y) 表示位置,其中 x 向右、y 向下。例如 260×180 图像的有效坐标范围是 x=0~259、y=0~179。这与 NumPy 访问像素时使用的 image[y, x] 顺序不同,二者不要混用。
颜色默认采用 BGR 顺序,因此 (255, 0, 0) 是蓝色、(0, 255, 0) 是绿色、(0, 0, 255) 是红色。thickness=1 表示约 1 像素宽,矩形使用 thickness=-1 时会填满内部区域。

用 line 与 rectangle 绘制
下面示例适用于 OpenCV 4.x。程序创建白色画布,绘制一条红线和一个绿色矩形边框,然后写入 line_rectangle.png。这里使用 cv2.LINE_AA 获得较平滑的斜线和边缘。
import cv2
import numpy as np
# 创建高 180、宽 260 的白色 BGR 图像
image = np.full((180, 260, 3), 255, dtype=np.uint8)
# 红色直线:坐标参数始终按 (x, y) 传入
cv2.line(
image,
(20, 30),
(220, 130),
(0, 0, 255),
thickness=3,
lineType=cv2.LINE_AA,
)
# 绿色矩形:给出左上角和右下角坐标
cv2.rectangle(
image,
(60, 50),
(180, 140),
(0, 180, 0),
thickness=2,
lineType=cv2.LINE_AA,
)
saved = cv2.imwrite("line_rectangle.png", image)
print(f"saved={saved}, shape={image.shape}")预期输出
saved=True, shape=(180, 260, 3)生成的图片尺寸为 260×180,能看到从左上区域斜向右下的红线,以及顶点位于 (60, 50) 和 (180, 140) 的绿色矩形。若当前目录不可写,cv2.imwrite 可能返回 False,应先改用具有写权限的路径。
检查坐标和边界
绘图前可以先按图像宽高检查坐标。对于 shape=(180,260,3),任何 x 都应满足 0 <= x < 260,任何 y 都应满足 0 <= y < 180。OpenCV 会裁剪落在图像外的部分,但依赖自动裁剪容易掩盖坐标计算错误。
还要注意,NumPy ROI 使用半开区间,例如 image[50:141, 60:181] 才会包含索引 140 和 180;而 cv2.rectangle(image, (60,50), (180,140), ...) 直接把指定坐标作为矩形边界。不要把切片的右边界规则机械套到绘图函数上。
常见错误与修正
把 (255,0,0) 当成红色是最常见的颜色错误;OpenCV 默认 BGR,因此红色应写 (0,0,255)。另一个常见问题是把数组索引 [y,x] 直接复制成绘图坐标,导致图形沿对角方向错位。
如果需要实心矩形,可将 cv2.rectangle 的 thickness 设为 -1;如果只是增加边框粗细,则使用 1、2、3 等正整数。线条的 thickness 应使用正值,不要用矩形填充参数去控制 cv2.line。