计算机视觉 / 系统课时

读取与显示图像

读取与显示图像

本课用一个可直接运行的 OpenCV 示例完成图像读取、窗口显示与属性检查,并把“宽高、通道、像素值、BGR 颜色空间”对应到实际数组,避免后续处理目标框时混淆坐标和通道顺序。

学习目标

  • 使用 cv2.imread() 读取图像,并判断读取是否成功
  • 正确解释 shape、dtype、像素值与三通道顺序
  • 在 BGR 与 RGB 之间转换,并验证显示结果

图像数组与颜色空间

OpenCV 读取彩色图像后,会得到一个三维 NumPy 数组,形状通常是 (height, width, channels)。例如 (240, 320, 3) 表示图像高 240 像素、宽 320 像素,每个像素包含 3 个颜色分量。

数组索引使用 image[y, x],先写纵向位置,再写横向位置。单个彩色像素通常是长度为 3 的数组,OpenCV 默认按 BGR 顺序保存,而不是常见的 RGB 顺序。

图像数组的宽高、坐标与 BGR 通道关系

dtype 通常是 uint8,每个通道取值为 0~255。数值越大,代表该颜色分量越强;例如 BGR 值 [0, 0, 255] 表示纯红色。cv2.imshow() 按 BGR 显示数组,而 Matplotlib 等库通常按 RGB 解释数据,混用时需要转换通道顺序。

完整读取与显示示例

下面的程序先生成一张确定尺寸和颜色的 PNG 测试图,再使用 OpenCV 重新读取。这样不依赖外部素材,输出尺寸和指定像素值也可以准确验证。

python
from pathlib import Path

import cv2
import numpy as np

def main() -> None:
    image_path = Path("sample.png")

    # 创建固定内容的测试图,保证示例可独立运行
    canvas = np.zeros((240, 320, 3), dtype=np.uint8)
    cv2.rectangle(canvas, (40, 50), (280, 190), (0, 255, 0), -1)
    cv2.circle(canvas, (160, 120), 35, (0, 0, 255), -1)
    cv2.imwrite(str(image_path), canvas)

    # 读取失败时 OpenCV 返回 None,必须在访问 shape 前拦截
    image = cv2.imread(str(image_path), cv2.IMREAD_COLOR)
    if image is None:
        raise FileNotFoundError(f"无法读取图像:{image_path.resolve()}")

    # 用圆心像素验证 BGR 与 RGB 的通道顺序
    height, width, channels = image.shape
    center_bgr = image[120, 160]
    center_rgb = cv2.cvtColor(image, cv2.COLOR_BGR2RGB)[120, 160]

    print(f"shape={image.shape}")
    print(f"width={width}, height={height}, channels={channels}")
    print(f"dtype={image.dtype}, min={image.min()}, max={image.max()}")
    print(f"center BGR={center_bgr.tolist()}")
    print(f"center RGB={center_rgb.tolist()}")

    # 本地桌面环境中按任意键关闭预览窗口
    cv2.imshow("OpenCV Image", image)
    cv2.waitKey(0)
    cv2.destroyAllWindows()

if __name__ == "__main__":
    main()

预期输出

text
shape=(240, 320, 3)
width=320, height=240, channels=3
dtype=uint8, min=0, max=255
center BGR=[0, 0, 255]
center RGB=[255, 0, 0]

程序还会打开标题为 OpenCV Image 的窗口,显示绿色矩形和红色圆形;按任意键后窗口关闭。cv2.cvtColor(image, cv2.COLOR_BGR2RGB) 只调整通道顺序,不改变图像宽高,也不会把像素值归一化到 0~1。

Tips:灰度图使用 cv2.IMREAD_GRAYSCALE 读取后,shape 只有 (height, width) 两个维度,不能再直接解包出 channels。

读取失败与无界面环境

当 cv2.imread() 返回 None 时,优先检查文件路径、文件是否存在、后缀是否与真实格式一致,以及程序是否有读取权限。不要立即访问 image.shape,否则会得到 NoneType 异常,掩盖真正原因。

在服务器或容器等无桌面环境中,cv2.imshow() 可能无法创建窗口。此时可以保留 cv2.imwrite() 输出文件,再下载或通过支持图像渲染的工具查看;图像读取和数组分析本身不受影响。

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

目录与阅读设置

记录一个想法

读取与显示图像

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

登录哪都通