Python OpenCV 实现鼠标绘制矩形与圆形交互程序

陈默

发布时间：2026-10-15| 4人浏览过

原创

本文介绍如何使用 Python 和 OpenCV 实现一个交互式鼠标绘图小程序。通过定义鼠标回调函数捕获左键按下、移动和释放事件，结合模式切换逻辑，支持实时绘制矩形和圆形。按 M 键可在两种绘图模式间切换，按 ESC 键退出程序，代码完整且可直接运行。

需求

目标是在画布上实现鼠标绘图功能，支持绘制圆形或矩形。用户可以通过按下键盘上的 m 键在两种绘图模式之间进行切换。交互逻辑为：当鼠标左键按下时开始绘图，鼠标移动过程中实时绘制图形，当鼠标左键释放时结束当前图形的绘制。

实现思想

实现鼠标绘图功能需要定义鼠标的回调函数 mouse_event 来处理交互事件。为了区分绘制圆形或矩形，需要定义一个画图的模式变量 mode。系统需要捕获左键单击、鼠标移动和左键释放这三个不同的事件。此外，还需要定义一个画图标记位 drawing 来标识是否正在绘制图形，以控制绘图的开始和结束。

实现代码


import cv2 as cv
import numpy as np

drawing = False # 是否开始画图
mode = True # True：画矩形，False：画圆
start = (-1, -1)

# 鼠标的回调函数的参数格式是固定的，不要随意更改。
def mouse_event(event, x, y, flags, param):
  global start, drawing, mode

  # 左键按下：开始画图
  if event == cv.EVENT_LBUTTONDOWN:
    drawing = True
    start = (x, y)
  # 鼠标移动，画图
  elif event == cv.EVENT_MOUSEMOVE:
    if drawing:
      if mode:
        cv.rectangle(img, start, (x, y), (0, 255, 0), -1)
      else:
        cv.circle(img, (x, y), 5, (0, 0, 255), -1)
  # 左键释放：结束画图
  elif event == cv.EVENT_LBUTTONUP:
    drawing = False
    if mode:
      cv.rectangle(img, start, (x, y), (0, 255, 0), -1)
    else:
      cv.circle(img, (x, y), 5, (0, 0, 255), -1)


img = np.zeros((512, 512, 3), np.uint8)
cv.namedWindow('image')
cv.setMouseCallback('image', mouse_event)

while(True):
  cv.imshow('image', img)
  # 按下m切换模式
  if cv.waitKey(1) == ord('m'):
    mode = not mode
  # 按ESC键退出程序
  elif cv.waitKey(1) == 27:
    break