计算机视觉 / 系统课时
保存图像文件
保存图像文件
本课解决如何把 OpenCV 处理后的 numpy.ndarray 写入磁盘,并分别控制 JPEG 质量与 PNG 压缩等级。完成后,你将能保存结果、检查返回值,并通过重新读取确认文件真实可用。
学习目标
- 使用
cv2.imwrite()保存 JPEG 和 PNG 图像 - 正确设置 JPEG 质量与 PNG 压缩参数
- 通过返回值和重新读取验证保存结果
保存规则与参数含义
cv2.imwrite(filename, image, params) 会根据文件扩展名选择编码器,例如 .jpg 使用 JPEG,.png 使用 PNG。待保存图像通常应为 uint8 数组,彩色图像沿用 OpenCV 的 BGR 通道顺序。
JPEG 是有损格式,cv2.IMWRITE_JPEG_QUALITY 的常用范围为 0~100,数值越高通常画质越好、文件越大。PNG 是无损格式,cv2.IMWRITE_PNG_COMPRESSION 的范围为 0~9,数值越高通常压缩更充分,但编码耗时也更长。
完整保存示例
下面生成一张渐变测试图,创建输出目录后分别保存为 JPEG 和 PNG。示例同时检查 imwrite() 的布尔返回值,并重新读取文件验证尺寸。
from pathlib import Path
import cv2
import numpy as np
def build_image(width: int = 320, height: int = 240) -> np.ndarray:
x = np.linspace(0, 255, width, dtype=np.uint8)
left_to_right = np.tile(x, (height, 1))
# 组合三个通道,生成可直接保存的 BGR 图像
return cv2.merge([
left_to_right,
np.flip(left_to_right, axis=1),
np.full_like(left_to_right, 128),
])
def main() -> None:
output_dir = Path("output")
output_dir.mkdir(parents=True, exist_ok=True)
image = build_image()
jpg_path = output_dir / "result.jpg"
png_path = output_dir / "result.png"
jpg_ok = cv2.imwrite(
str(jpg_path),
image,
[cv2.IMWRITE_JPEG_QUALITY, 90],
)
png_ok = cv2.imwrite(
str(png_path),
image,
[cv2.IMWRITE_PNG_COMPRESSION, 6],
)
if not jpg_ok or not png_ok:
raise RuntimeError("图像编码或文件写入失败")
# 重新读取,避免只检查到“函数已返回”却未验证文件内容
jpg_image = cv2.imread(str(jpg_path), cv2.IMREAD_COLOR)
png_image = cv2.imread(str(png_path), cv2.IMREAD_COLOR)
if jpg_image is None or png_image is None:
raise RuntimeError("文件已生成,但无法被 OpenCV 重新读取")
print("JPEG 保存:", jpg_ok, jpg_image.shape)
print("PNG 保存:", png_ok, png_image.shape)
if __name__ == "__main__":
main()预期输出:
JPEG 保存: True (240, 320, 3)
PNG 保存: True (240, 320, 3)程序会在当前工作目录下创建 output/result.jpg 和 output/result.png。文件大小会受 OpenCV 版本和编码器实现影响,因此不应把固定字节数作为验收条件。
参数选择与结果验证
照片、扫描件等连续色调图像通常适合 JPEG。质量 85~95 往往能兼顾清晰度和体积;若图像还要继续分析,不要反复以 JPEG 保存和读取,因为多次有损编码会逐渐引入压缩误差。
截图、图标、掩膜和需要保持像素精确的结果更适合 PNG。压缩等级只影响编码时间和文件大小,不改变解码后的像素内容。验证时至少检查 imwrite() 返回值、目标文件是否存在,以及 cv2.imread() 是否返回非 None。
常见失败处理
保存失败时先检查父目录是否存在、进程是否有写权限、文件扩展名是否受当前 OpenCV 构建支持。路径正确但返回 False 时,应停止后续流程并记录目标路径;不要假设调用完成就代表文件一定可用。
若输入数组是浮点型或数值范围异常,应先明确缩放规则再转换为 uint8。直接强制转换可能造成截断或溢出,使保存后的图像过暗、过亮或颜色异常。
本课总结
cv2.imwrite()根据扩展名选择编码器,并用布尔值表示写入是否成功- JPEG 质量控制画质与体积,PNG 压缩等级控制体积与编码耗时
- 可靠保存应同时检查返回值,并重新读取验证文件内容
下一课预告
下一课将不写入磁盘,而是使用 cv2.imencode() 把图像编码到内存,便于接口返回、数据库存储和网络传输。