Python OpenCV - waitKey()函数介绍

1. 简介

在 Python 的 OpenCV 库中，waitKey() 函数主要用于等待用户按下键盘上的某个键。该函数是一个 GUI 元素的主要控制函数，是编写交互应用程序必不可少的一部分。

2. 函数语法

cv2.waitKey([delay])

参数

• delay: 等待时间，单位为毫秒，若 delay < 0 表示一直等待，直到用户按下一个按键。

返回值

• 整数值：表示按键的 ASCII 码值或者是特殊值。若没有按键事件，则返回 -1。

3. 函数用法

waitKey() 函数的主要作用是等待用户按下某个键。如果没有等待用户按键的需要，可以将 delay 参数设置为 0 或者负数。

waitKey() 函数返回的是一个整数值，该值得根据用户按下的按键不同而不同。如果用户按下的是 ESC 键，返回值就是 27。

在计算机视觉领域中，通常使用 waitKey() 函数来等待按键事件，具体使用方法如下：

import cv2

# 读取图像
img = cv2.imread('lena.jpg')

# 显示图像
cv2.imshow('image', img)

# 等待键盘响应
key = cv2.waitKey(0)

# 判断是否按下 ESC
if key == 27:
    cv2.destroyAllWindows()

4. 注意事项

waitKey() 函数只有在 cv2.imshow() 函数被调用之后才能发挥作用，因为 cv2.imshow() 函数会创建窗口并显示图像。在实际使用过程中，可能会遇到按键事件不响应的情况，原因往往是程序进入了阻塞状态，此时可以考虑将 delay 参数调整为较小值。

5. 小结

waitKey() 函数是 OpenCV 库中一个十分重要的函数，主要用于等待用户按下键盘上的某个键。该函数的返回值可以用来判断用户按下的是哪个键，为编写交互应用程序提供了很好的支持。