本文详细介绍了如何使用Python OpenCV中的cv2.line()函数在图像上精准绘制直线，涵盖函数基本语法、各参数含义（图像、起点、终点、BGR颜色值、线宽）、实际代码示例（包括在空白画布和真实图像上画线），并重点提醒了OpenCV坐标系原点在左上角、颜色通道为BGR顺序、坐标不能越界等关键细节，帮助读者快速掌握图像标注、目标检测等场景中不可或缺的直线绘制技能。

在Python中使用OpenCV画线，主要依赖于 cv2.line() 函数。这个函数可以让你在图像上绘制一条直线，常用于目标检测、图像标注等场景。

基本语法

cv2.line(img, pt1, pt2, color, thickness) 的参数说明：

• img：要绘制的图像（通常是NumPy数组，如通过 cv2.imread() 读取的）
• pt1：直线起点坐标，格式为 (x1, y1)
• pt2：直线终点坐标，格式为 (x2, y2)
• color：线条颜色，BGR格式，例如 (0, 255, 0) 表示绿色
• thickness：线条粗细，单位为像素，必须是正整数

绘制一条简单直线

下面是一个完整示例，在一张空白图像上画一条红色直线：

import cv2
import numpy as np
创建一个黑色图像（300x300 像素，3通道）
img = np.zeros((300, 300, 3), dtype=np.uint8)
绘制一条从 (50, 50) 到 (250, 250) 的红色直线，宽度为 3
cv2.line(img, (50, 50), (250, 250), (0, 0, 255), 3)
显示图像
cv2.imshow('Line', img)
cv2.waitKey(0)
cv2.destroyAllWindows()

在已有图像上画线

你也可以在读取的图片上叠加线条：

import cv2
读取图像
img = cv2.imread('example.jpg')
在图像上画一条蓝色横线（穿过中间）
height, width = img.shape[:2]
cv2.line(img, (0, height//2), (width, height//2), (255, 0, 0), 2)
保存或显示
cv2.imshow('Image with line', img)
cv2.waitKey(0)
cv2.destroyAllWindows()

注意事项

• 坐标系原点在左上角，x 向右增加，y 向下增加
• 颜色顺序是 BGR 而不是 RGB
• 确保点的坐标没有超出图像范围，否则可能出错或看不到效果
• 如果需要绘制虚线或箭头线，OpenCV 没有直接支持，需自行实现或使用其他库辅助

基本上就这些。只要掌握 cv2.line() 的用法，就能灵活地在图像中添加直线标注。

今天关于《OpenCV画线教程：Python实战教学》的内容就介绍到这里了，是不是学起来一目了然！想要了解更多关于的内容请关注golang学习网公众号！