计算机视觉 / 系统课时

读取图像属性

读取图像属性

图像处理代码经常在尺寸、通道数或数据类型不符合预期时出错。通过 shape、size、dtype 和 nbytes,可以在处理前快速确认图像结构、元素数量以及数组实际占用的内存。

学习目标

  • 读取图像的高度、宽度、通道数和数据类型。
  • 区分像素数量、数组元素数量与内存字节数。
  • 在真实 cv2.imread 流程中加入可靠的属性检查。

用四个属性完成检查

下面示例先生成一张 640×480 的黑色 PNG,再用 OpenCV 读取它。这样不依赖外部素材,运行结果可以直接核对;示例结束后会删除临时文件。

python
import os

import cv2
import numpy as np

path = "opencv-attributes-demo.png"
source = np.zeros((480, 640, 3), dtype=np.uint8)

if not cv2.imwrite(path, source):
    raise RuntimeError("Failed to write demo image")

image = cv2.imread(path, cv2.IMREAD_COLOR)
if image is None:
    raise RuntimeError("Failed to read demo image")

height, width, channels = image.shape
pixel_count = height * width

print("shape:", image.shape)
print("pixels:", pixel_count)
print("elements:", image.size)
print("dtype:", image.dtype)
print("bytes:", image.nbytes)

os.remove(path)

预期输出:

text
shape: (480, 640, 3)
pixels: 307200
elements: 921600
dtype: uint8
bytes: 921600

cv2.IMREAD_COLOR 会得到三通道 BGR 图像;这里每个通道元素是 uint8,每个元素占 1 字节,所以 nbytes 与 size 数值相同。

像素数和元素数不是一回事

对形状 (480, 640, 3) 的彩色图,像素数量是 480 × 640 = 307200,而 image.size 统计所有数组元素,因此是 480 × 640 × 3 = 921600。做分辨率限制时应该比较像素数,而不是直接比较 size。

内存占用可用 image.nbytes 读取,也可以用 image.size * image.itemsize 计算。对于 uint16 图像,单个元素占 2 字节;即使形状不变,内存也会翻倍,因此不能只看宽高判断内存压力。

彩色、灰度和带透明通道的差别

读取模式会直接改变 shape。同一张 640×480 图片,cv2.IMREAD_COLOR 通常得到 (480, 640, 3);cv2.IMREAD_GRAYSCALE 得到 (480, 640);使用 cv2.IMREAD_UNCHANGED 读取带 alpha 的 PNG 时,可能得到 (480, 640, 4)。

数据形式 典型 shape uint8 元素数 典型内存
灰度 (480, 640) 307200 307200 B
BGR (480, 640, 3) 921600 921600 B
BGRA (480, 640, 4) 1228800 1228800 B

因此需要通用代码时,可以先看 image.ndim,再决定是否读取 shape[2]。直接写 height, width, channels = image.shape 遇到灰度图会触发解包错误。

把属性检查放到真实读取流程

项目里拿到文件路径后,第一步应先判断 cv2.imread 是否返回 None,再读取属性。文件不存在、路径写错或格式无法解码时,OpenCV 可能不会给你一个可用数组;此时继续访问 .shape 只会产生后续异常。

一个实用验收标准是:普通相机彩色图通常应满足 image.ndim == 3、image.shape[2] == 3,并根据业务限制检查最大像素数。例如限制在 1200 万像素以内,可以判断 image.shape[0] * image.shape[1] <= 12_000_000。

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

目录与阅读设置

阅读设置

17

记录一个想法

读取图像属性

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

登录哪都通