计算机视觉 / 系统课时
读取与显示图像
读取与显示图像
本课用一个可直接运行的 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 顺序。

dtype 通常是 uint8,每个通道取值为 0~255。数值越大,代表该颜色分量越强;例如 BGR 值 [0, 0, 255] 表示纯红色。cv2.imshow() 按 BGR 显示数组,而 Matplotlib 等库通常按 RGB 解释数据,混用时需要转换通道顺序。
完整读取与显示示例
下面的程序先生成一张确定尺寸和颜色的 PNG 测试图,再使用 OpenCV 重新读取。这样不依赖外部素材,输出尺寸和指定像素值也可以准确验证。
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()预期输出
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() 输出文件,再下载或通过支持图像渲染的工具查看;图像读取和数组分析本身不受影响。