python中waitKey如何使用-Python教程-PHP中文网

python中waitKey如何使用

舞夢輝影

发布： 2025-11-13 22:52:02

原创

546人浏览过

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

python中waitkey如何使用

在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免费学习笔记（深入）”；

如知AI笔记

如知笔记——支持markdown的在线笔记，支持ai智能写作、AI搜索，支持DeepseekR1满血大模型

查看详情

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() 的配合使用。不复杂但容易忽略细节。

以上就是python中waitKey如何使用的详细内容，更多请关注php中文网其它相关文章！