首页 > 文章 > python教程

Python中waitKey函数使用教程

时间：2025-11-08 14:18:28 452浏览收藏

各位小伙伴们，大家好呀！看看今天我又给各位带来了什么文章？本文标题是《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学习网公众号！