waitKey()用于控制图像显示时的键盘输入等待,参数为毫秒数:0表示无限等待,正数如1表示等待指定时间;常与cv2.imshow()配合使用,在图像或视频处理中通过返回值检测按键操作,如按'q'退出,需结合& 0xFF确保跨平台兼容性。

在Python中使用OpenCV时,waitKey() 是一个常用的函数,主要用于捕获键盘输入和控制程序的等待时间。它通常配合图像显示函数 cv2.imshow() 一起使用。
基本语法
cv2.waitKey(delay) 接受一个整数参数,表示等待键盘事件的毫秒数:
- 如果设置为正数(如 1000),程序会暂停指定毫秒(例如1秒)或直到有按键被按下。
- 如果设置为 0,程序将无限期等待,直到用户按下任意键。
常见用法示例
以下是一个典型的图像显示并等待按键退出的例子:
import cv2# 读取并显示图像
img = cv2.imread('example.jpg')
cv2.imshow('Image', img)
# 等待用户按键
key = cv2.waitKey(0) & 0xFF # 推荐写法,确保跨平台兼容性
# 按 'q' 键退出
if key == ord('q'):
print("退出程序")
cv2.destroyAllWindows()
说明:
立即学习“Python免费学习笔记(深入)”;
- waitKey(0) 表示一直等待按键。
- & 0xFF 是为了获取低8位字符值,因为在某些系统中返回值可能超过8位。
- ord('q') 将字符 'q' 转换为对应的ASCII码进行比较。
在视频处理中的应用
在读取摄像头或视频流时,通常使用较小的延迟值(如1ms),以便实现连续播放:
cap = cv2.VideoCapture(0)while True:
ret, frame = cap.read()
if not ret:
break
cv2.imshow('Video', frame)
if cv2.waitKey(1) & 0xFF == ord('q'):
break
cap.release()
cv2.destroyAllWindows()
这里 waitKey(1) 让程序每帧等待1毫秒,既能保持视频流畅,又能响应按键退出。
基本上就这些。关键是理解 delay 参数的作用和与 imshow() 的配合使用。不复杂但容易忽略细节。











