Python中waitKey函数用法详解
作者:小确幸
时间:2026-01-12
浏览:1
waitKey()用于控制图像显示时的键盘输入等待,参数为毫秒数:0表示无限等待,正数如1表示等待指定时间;常与cv2.imshow()配合使用,在图像或视频处理中通过返回值检测按键操作,如按'q'退出,需结合&0xFF确保跨平台兼容性。
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()
说明:
- 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() 的配合使用。不复杂但容易忽略细节。
作者最新文章
Photoshop抠图教程详细步骤图解:新手入门常用方法与技巧
2026-09-22 14:38
Windows 10
2026-09-16 17:44
Python安装后怎么打开:使用IDLE或命令行启动解释器
2026-09-16 13:54
Windows系统Python安装教程:下载、勾选PATH及环境变量配置
2026-09-16 13:53
“等灯不计时”落地解析:算法善意如何转化为技术能力与生态协同
2026-09-08 18:03
上一篇:
Win11家庭版开启组策略教程
热门文章
更多
精品专题
更多
Mac软件
更多
WINDOWS
更多


































