OpenCV-04 鼠标绘图

在计算机视觉和图像处理中，OpenCV 是一个功能强大的工具库，它不仅可以处理图像和视频数据，还能够进行交互式应用程序的开发，例如通过鼠标在图像上绘制形状和线条。本文将介绍如何使用 OpenCV 创建一个简单的画板应用，让鼠标作为画笔，实现绘图功能。

准备工作

首先，确保你已经安装了 OpenCV 并配置好了 Python 环境。如果尚未安装，可以通过以下命令安装：

pip install opencv-python

编写代码

我们将通过一个简单的示例代码来说明如何实现鼠标绘图功能。

import numpy as np
import cv2 as cv

# 创建一个黑色背景图像
img = np.zeros((512, 512, 3), np.uint8)

# 鼠标回调函数，用于画圆
def draw_circle(event, x, y, flags, param):
    # 如果是双击事件
    if event == cv.EVENT_LBUTTONDBLCLK:
        # 绘制圆形，参数依次是：画布对象、圆心、半径、颜色、线条粗细（-1表示填充）
        cv.circle(img, (x, y), 10, (0, 255, 0), -1)

def mouse_draw():
    # 创建一个窗口，并将鼠标回调函数绑定到窗口上
    cv.namedWindow('image')
    cv.setMouseCallback('image', draw_circle)

    while True:
        # 显示图像
        cv.imshow('image', img)

        # 等待按键操作，按下ESC键退出循环
        if cv.waitKey(20) & 0xFF == 27:
            break

    cv.destroyAllWindows()

if __name__ == '__main__':
    mouse_draw()

setMouseCallback()

cv.setMouseCallback 是 OpenCV 中用于设置鼠标事件回调函数的函数。它允许用户在图像窗口上捕获和处理鼠标事件，比如鼠标点击、移动等操作。底层原理涉及以下几个方面：

1. 事件监听：OpenCV 使用底层图形用户界面库（比如 GTK+、Qt）来创建图像窗口。cv.setMouseCallback 函数实际上是调用这些库提供的事件处理机制来注册一个鼠标事件的回调函数。

2. 回调函数注册：当调用 cv.setMouseCallback 时，用户可以指定一个自定义的回调函数，该函数将在发生鼠标事件时被调用。例如，你可以指定一个函数来处理鼠标点击事件或者鼠标移动事件。

3. 事件类型：OpenCV 支持多种鼠标事件，包括：

   • cv.EVENT_MOUSEMOVE：鼠标移动事件
   • cv.EVENT_LBUTTONDOWN：左键按下事件
   • cv.EVENT_RBUTTONDOWN：右键按下事件
   • 等等...

4. 事件处理：当用户与图像窗口进行交互（比如点击、拖动鼠标）时，底层图形库会检测到这些事件并调用预先注册的回调函数。这样用户就可以在回调函数中获取鼠标事件的具体信息，比如鼠标位置、按键状态等，并进行相应的处理。

5. 图像窗口管理：除了事件处理，cv.setMouseCallback 还可以用于管理图像窗口的创建和销毁，尽管主要功能是与鼠标事件相关的。

总结来说，cv.setMouseCallback 的底层原理是利用底层图形库提供的事件监听机制，通过注册用户定义的回调函数来捕获和处理图像窗口中的鼠标事件。

OpenCV 支持多种鼠标事件

OpenCV（Open Source Computer Vision Library）支持多种鼠标事件，这些事件可以通过编程来捕获和处理。以下是主要的鼠标事件列表及其对应的常量值：

1. CV_EVENT_MOUSEMOVE：鼠标移动事件。
2. CV_EVENT_LBUTTONDOWN：鼠标左键按下事件。
3. CV_EVENT_RBUTTONDOWN：鼠标右键按下事件。
4. CV_EVENT_MBUTTONDOWN：鼠标中键按下事件。
5. CV_EVENT_LBUTTONUP：鼠标左键释放事件。
6. CV_EVENT_RBUTTONUP：鼠标右键释放事件。
7. CV_EVENT_MBUTTONUP：鼠标中键释放事件。
8. CV_EVENT_LBUTTONDBLCLK：鼠标左键双击事件。
9. CV_EVENT_RBUTTONDBLCLK：鼠标右键双击事件。
10. CV_EVENT_MBUTTONDBLCLK：鼠标中键双击事件。

这些事件常常用于交互式的图像处理应用程序中，例如在图像上选择区域、标注物体或进行测量等操作。通过设置鼠标回调函数，可以实现对这些事件的响应和处理，从而使得图像处理更加灵活和直观。

在OpenCV中，通常通过以下方式来处理鼠标事件：

1. 使用cv::setMouseCallback函数来设置鼠标事件的回调函数。
2. 在回调函数中根据事件类型和坐标信息来执行相应的操作。

这些功能使得OpenCV不仅仅是一种图像处理库，还可以方便地与用户进行交互，处理鼠标事件是其中的一个重要方面。

鼠标回调函数

在 OpenCV 中设置鼠标事件回调函数时，回调函数确实有固定的参数格式，这是为了确保能够正确地接收和处理鼠标事件的信息。通常情况下，回调函数的参数格式如下：

def on_mouse_event(event, x, y, flags, param):
    # 处理鼠标事件的代码
    pass

这里是参数的解释：

• event：这是一个整数，表示发生的鼠标事件类型。可以根据该参数来判断是何种事件，比如移动、点击等。OpenCV 提供了一些预定义的事件类型，例如 cv.EVENT_MOUSEMOVE、cv.EVENT_LBUTTONDOWN 等。

• x 和 y：这两个参数表示鼠标事件发生时的坐标位置，即鼠标指针相对于窗口左上角的位置。

• flags：这是一个整数，包含了与事件相关的附加信息。例如，如果是鼠标按下事件，可能会包含有关按下哪个键的信息。

• param：这个参数通常不直接用到，是一个可选的用户参数，可以在设置鼠标回调函数时传递进去。在一般情况下，不会用到这个参数，因为大多数情况下回调函数可以直接访问外部定义的变量或对象。

因此，回调函数在 OpenCV 中是按照这个固定的参数格式来定义的，以确保能够准确地获取和处理鼠标事件的相关信息。

  关注公众号：资小库，问题快速答疑解惑