计算机视觉 / 系统课时

保存图像文件

保存图像文件

本课解决如何把 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() 的布尔返回值,并重新读取文件验证尺寸。

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

预期输出:

text
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() 把图像编码到内存,便于接口返回、数据库存储和网络传输。

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

目录与阅读设置

阅读设置

17

记录一个想法

保存图像文件

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

登录哪都通