计算机视觉 / 系统课时
显示图像窗口
显示图像窗口
读取图像后,可以用 OpenCV 的 HighGUI 模块创建预览窗口。本课完成窗口创建、图像显示、键盘等待和资源释放,并说明桌面环境与无界面服务器之间的运行差异。
学习目标
- 使用
namedWindow和imshow显示图像 - 使用
waitKey接收退出按键 - 无论正常退出还是异常,都能释放窗口资源
窗口显示的执行顺序
显示窗口需要按顺序完成四件事:读取图像、创建窗口、提交图像、处理界面事件。imshow 只负责把图像交给窗口系统,真正刷新窗口需要持续调用 waitKey。
waitKey 的参数单位是毫秒。传入 0 表示无限等待一次按键;传入正数适合循环刷新。本课使用短间隔循环,同时支持按 Q、按 Esc 或点击关闭按钮退出。
完整显示示例
下面的脚本适用于具有桌面图形环境的本地系统。将代码保存为 display_image.py。
import sys
import cv2
def main() -> int:
if len(sys.argv) != 2:
print("用法: python display_image.py <PATH>")
return 2
image_path = sys.argv[1]
image = cv2.imread(image_path)
if image is None:
print(f"读取失败: {image_path}")
return 1
window_name = "OpenCV Preview"
cv2.namedWindow(window_name, cv2.WINDOW_NORMAL)
try:
cv2.imshow(window_name, image)
print("窗口已打开,按 Q、Esc 或关闭按钮退出")
while True:
# waitKey 同时刷新窗口并读取键盘事件。
key = cv2.waitKey(20) & 0xFF
closed = cv2.getWindowProperty(
window_name, cv2.WND_PROP_VISIBLE
) < 1
if key in (ord("q"), ord("Q"), 27) or closed:
break
finally:
# 即使循环中发生异常,也统一销毁 OpenCV 创建的窗口。
cv2.destroyAllWindows()
print("窗口已关闭")
return 0
if __name__ == "__main__":
raise SystemExit(main())运行命令:
python display_image.py <PATH>预期结果:
窗口已打开,按 Q、Esc 或关闭按钮退出
窗口已关闭同时会出现名为 OpenCV Preview 的窗口并显示 <PATH> 指向的图片。实际窗口大小由图片尺寸、桌面系统和用户缩放操作决定。
三个核心 API
cv2.namedWindow 用于显式创建窗口。cv2.WINDOW_NORMAL 允许用户缩放窗口;若省略该调用,imshow 也会按默认方式创建窗口,但可控性较低。
cv2.imshow 接收窗口名称和图像数组。重复使用相同窗口名会更新现有窗口,而不是不断创建新窗口。
cv2.waitKey 负责等待按键并处理界面事件。返回值与平台有关,使用 & 0xFF 可提取常用的低 8 位键值。27 是 Esc 键,ord("q") 和 ord("Q") 分别表示大小写 Q。
常见失败处理
在服务器、容器或 CI 环境中,如果没有桌面显示服务,imshow 可能无法创建窗口。此时应改用 cv2.imwrite 保存结果,或把图像传给支持内联显示的工具,而不是反复调用 waitKey。
安装了 opencv-python-headless 时,HighGUI 通常不可用。需要本地窗口功能时,应在有图形界面的环境中安装带 GUI 支持的 OpenCV 包,并避免同时安装多个互相冲突的 OpenCV Python 发行包。
窗口一闪而过通常是因为程序没有等待事件,或者在 imshow 后立即结束。资源无法释放则多半是遗漏 destroyAllWindows;使用 try...finally 可以让关闭逻辑更可靠。
本课总结
imshow后必须调用waitKey,窗口才能刷新并响应事件- 短间隔事件循环可以同时处理按键和关闭按钮
destroyAllWindows应放入可靠的清理路径,无界面环境不应强行创建窗口
下一课预告
下一课将继续检查图像数据,学习读取单个像素并理解 OpenCV 的 BGR 通道顺序。