首页 > 文章 > python教程

Python中waitKey函数使用教程

时间：2025-11-26 22:26:38 253浏览收藏

IT行业相对于一般传统行业，发展更新速度更快，一旦停止了学习，很快就会被行业所淘汰。所以我们需要踏踏实实的不断学习，精进自己的技术，尤其是初学者。今天golang学习网给大家整理了《Python中waitKey函数详解》，聊聊，我们一起来看看吧！

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()

说明：

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函数使用教程》的介绍应该让你收获多多了吧！欢迎大家收藏或分享给更多需要学习的朋友吧~golang学习网公众号也会发布文章相关知识，快来关注吧！