Numpy：cv2.setMouseCallback()的参数是什么

在本文中，我们将介绍Numpy中cv2.setMouseCallback()函数的参数及其用法。

cv2.setMouseCallback()函数是一个在OpenCV中非常有用的函数，它可以在窗口显示时检测鼠标事件，并相应地处理它们。一般情况下，这个函数被用作图像处理的交互界面，比如在图像上突出显示感兴趣的点、标记不同的区域、选择感兴趣的目标等。这一功能可以通过设置setMouseCallback()函数的各种参数来实现。

以下是该函数的语法格式：

cv2.setMouseCallback(windowName, onMouse, param)

windowName表示要在其上检测鼠标事件的窗口名称。onMouse回调函数将被每个鼠标事件调用。param是一个可选参数，它是传递给回调函数的附加参数。下面将进一步详细说明它们的具体用法：

阅读更多：Numpy 教程

windowName参数

这个参数是必需的，它指定了要在检测鼠标事件的窗口名称。该名称可以用cv2.namedWindow()函数创建，这个函数需要至少一个参数windowName，来指定要创建的窗口名称。

import cv2
image = cv2.imread('image.jpg')
cv2.namedWindow('imageWindow')
cv2.imshow('imageWindow', image)
cv2.waitKey(0)
cv2.destroyAllWindows()

在上面的代码中，我们首先读取一张图像，然后创建一个名为’imageWindow’的窗口，并将图像显示在该窗口中。参数0表示无限期等待，直到用户按下任何键盘按键为止。cv2.destroyAllWindows()函数用于销毁所有已经创建的窗口。

onMouse参数

该参数是cv2.setMouseCallback()的主要回调函数，在用户执行鼠标事件（比如单击或拖动鼠标）时将被执行。

该函数拥有多个参数，包括event、x、y、flags和param。它们对于鼠标事件处理至关重要。下面将逐一介绍这些参数的具体含义：

event: 给出鼠标事件的类型。常见的事件类型包括cv2.EVENT_LBUTTONDOWN（左键按下），cv2.EVENT_LBUTTONUP（左键释放），cv2.EVENT_MOUSEMOVE（鼠标移动）等。
x, y: 表示鼠标事件发生时的坐标位置。在图像中，原点为左上角。
flags: 给出事件的标志位。这个参数可以是多个标志的组合，例如cv2.EVENT_FLAG_SHIFTKEY（按下SHIFT键时发生的事件）等。
param: 回调函数的额外参数。这个参数在cv2.setMouseCallback()函数中被传递。

下面是该函数的示例代码：

import cv2

def onMouse(action, x, y, flags, params):
    """ A callback function which is triggered when a
        mouse event occurs within the imageWindow. """
    if event==cv2.EVENT_LBUTTONDOWN:
        print("Left button clicked at ({}, {})".format(x, y))
    elif event==cv2.EVENT_RBUTTONDOWN:
        print("Right button clicked at ({}, {})".format(x, y))
    elif event==cv2.EVENT_MOUSEMOVE and flags==cv2.EVENT_FLAG_CTRLKEY:
        print("Ctrl key and mouse move at ({}, {})".format(x, y))

image = cv2.imread('image.jpg')
cv2.namedWindow('imageWindow')
cv2.imshow('imageWindow', image)
cv2.setMouseCallback('imageWindow', onMouse)

while True:
    cv2.waitKey(100)

在上面的示例代码中，我们定义了一个onMouse()回调函数来响应一系列鼠标事件。具体来说，如果单击左键或右键，程序将打印一条消息，指示指针在图像中的位置。如果按下CTRL键并移动鼠标，则打印一条消息提示当前鼠标指针的位置和CTRL键的状态。

最后，将该函数作为cv2.setMouseCallback()函数的onMouse参数传递给’imageWindow’窗口，这样当鼠标事件发生时，函数将被调用。我们在一个无限循环里进行cv2.waitKey()的判定，以在此期间等待用户的鼠标事件。

param参数

这是一个可选参数，它可以是任何类型的附加参数。如果您的回调函数需要访问与鼠标事件无关的其他数据，则可以将其传递给param参数。

以下是使用param参数的示例代码：

import cv2

def onMouse(action, x, y, flags, params):
    """ A callback function which is triggered when a
        mouse event occurs within the imageWindow. """
    if event==cv2.EVENT_LBUTTONDOWN:
        print("Left button clicked at ({}, {})".format(x, y))
        color = img[y, x]
        cv2.circle(img, center=(x, y), radius=5, color=(0, 0, 255), thickness=-1)
    elif event==cv2.EVENT_RBUTTONDOWN:
        print("Right button clicked at ({}, {})".format(x, y))

image = cv2.imread('image.jpg')
cv2.namedWindow('imageWindow')
cv2.imshow('imageWindow', image)
cv2.setMouseCallback('imageWindow', onMouse, image)

while True:
    cv2.imshow('imageWindow', image)
    key = cv2.waitKey(1) & 0xFF
    if key == ord("q"):
        break

cv2.destroyAllWindows()

在上面的示例代码中，我们在回调函数中增加了操作。当左键单击时，函数不仅打印消息，还将在图像中心画一个红色圆圈，并获取鼠标单击位置的像素值作为颜色。param参数将图片传递给回调函数，使在回调函数中可以直接进行操作。