计算机视觉 / 系统课时

显示图像窗口

显示图像窗口

读取图像后,可以用 OpenCV 的 HighGUI 模块创建预览窗口。本课完成窗口创建、图像显示、键盘等待和资源释放,并说明桌面环境与无界面服务器之间的运行差异。

学习目标

  • 使用 namedWindow 和 imshow 显示图像
  • 使用 waitKey 接收退出按键
  • 无论正常退出还是异常,都能释放窗口资源

窗口显示的执行顺序

显示窗口需要按顺序完成四件事:读取图像、创建窗口、提交图像、处理界面事件。imshow 只负责把图像交给窗口系统,真正刷新窗口需要持续调用 waitKey。

waitKey 的参数单位是毫秒。传入 0 表示无限等待一次按键;传入正数适合循环刷新。本课使用短间隔循环,同时支持按 Q、按 Esc 或点击关闭按钮退出。

完整显示示例

下面的脚本适用于具有桌面图形环境的本地系统。将代码保存为 display_image.py。

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

运行命令:

bash
python display_image.py <PATH>

预期结果:

text
窗口已打开,按 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 通道顺序。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

显示图像窗口

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通