计算机视觉 / 系统课时

保存处理后视频

保存处理后视频

把逐帧处理结果真正保存成可播放文件,关键不是只调用 write(),而是让编码器、帧率、画面尺寸与实际写入帧保持一致。本课用 Python + OpenCV 完成一条可运行的读取、处理、写入和回读验证流程,并说明常见的编码失败原因。

学习目标

  • 能正确配置 VideoWriter 的编码器、帧率和输出尺寸。
  • 能把处理后的每一帧写入 MP4,并在结束时安全释放文件。
  • 能通过回读输出文件检查帧率、分辨率和帧数是否合理。

写入视频前先确定四个参数

cv2.VideoWriter 最重要的四项参数是输出路径、FourCC、FPS 和 (width, height)。尺寸必须与每次传给 writer.write(frame) 的图像完全一致;例如源视频是 1280×720,就不要把 640×360 的处理结果直接写给 1280×720 的 writer。

目标文件 FourCC 常见用途 备注
output.mp4 mp4v 通用 MP4 示例 大多数带 FFmpeg 的 OpenCV 构建可用
output.avi MJPG 调试、兼容性优先 文件通常更大,但编码支持较常见
output.avi XVID AVI 压缩 是否可用取决于本机后端与编解码器

从视频帧到编码文件的写入数据流

完成读取、处理与写入

下面示例假设当前目录存在 input.mp4。它读取源视频的 FPS 与尺寸,对每帧做 9×9 高斯模糊,再按原尺寸写入 output.mp4;写完后重新打开输出文件进行一次元数据验证。

python
import cv2

input_path = "input.mp4"
output_path = "output.mp4"

# 打开输入并读取创建 writer 所需的元数据。
cap = cv2.VideoCapture(input_path)
if not cap.isOpened():
    raise RuntimeError(f"无法打开输入视频: {input_path}")

fps = cap.get(cv2.CAP_PROP_FPS)
width = int(cap.get(cv2.CAP_PROP_FRAME_WIDTH))
height = int(cap.get(cv2.CAP_PROP_FRAME_HEIGHT))

if fps <= 0 or width <= 0 or height <= 0:
    cap.release()
    raise RuntimeError("读取到的 FPS 或画面尺寸无效")

# 编码器、FPS 和尺寸在 writer 创建后不应中途改变。
fourcc = cv2.VideoWriter_fourcc(*"mp4v")
writer = cv2.VideoWriter(output_path, fourcc, fps, (width, height))
if not writer.isOpened():
    cap.release()
    raise RuntimeError("VideoWriter 打开失败,请检查编码器或改用 AVI + MJPG")

# 逐帧处理并写入;每次写入的 frameSize 必须一致。
written = 0
while True:
    ok, frame = cap.read()
    if not ok:
        break

    # 处理结果仍保持原来的宽、高和 BGR 三通道。
    processed = cv2.GaussianBlur(frame, (9, 9), 0)
    writer.write(processed)
    written += 1

# 释放 writer 会完成容器收尾,因此必须正常执行。
cap.release()
writer.release()

# 回读输出文件,确认它能被 OpenCV 正常解码。
check = cv2.VideoCapture(output_path)
if not check.isOpened():
    raise RuntimeError("输出文件无法重新打开")

out_fps = check.get(cv2.CAP_PROP_FPS)
out_width = int(check.get(cv2.CAP_PROP_FRAME_WIDTH))
out_height = int(check.get(cv2.CAP_PROP_FRAME_HEIGHT))
out_frames = int(check.get(cv2.CAP_PROP_FRAME_COUNT))
check.release()

print(
    f"saved={output_path} written={written} "
    f"frames={out_frames} size={out_width}x{out_height} fps={out_fps:.3f}"
)

预期输出中帧数、尺寸和 FPS 取决于输入视频,实际值会不同:

text
saved=output.mp4 written=<FRAME_COUNT> frames=<FRAME_COUNT> size=<WIDTH>x<HEIGHT> fps=<FPS>

如果 written 与回读得到的 frames 接近、尺寸与输入一致,而且输出文件可以正常播放,就说明基本写入链路成立。不同封装或后端可能让回读帧数存在轻微差异,因此不要只依赖 CAP_PROP_FRAME_COUNT 判断每一帧都绝对一致。

处理结果改变尺寸时同步修改 writer

如果处理步骤包含缩放或裁剪,必须先确定最终帧尺寸,再用同一尺寸创建 writer。例如把 1920×1080 缩放到 960×540 时,VideoWriter 的 frameSize 也要设为 (960, 540),并确保每一帧都执行同样的尺寸变换。

错误做法是 writer 仍按 (1920, 1080) 创建,却写入 960×540 的帧;正确做法是先统一输出尺寸,再创建 writer。若处理中途需要切换分辨率,应结束当前 writer 并创建新文件,而不是在同一个视频流中混写不同尺寸。

写完后这样验收

至少检查三项:用播放器完整拖动一次时间轴;回读确认 CAP_PROP_FRAME_WIDTH、CAP_PROP_FRAME_HEIGHT 和 CAP_PROP_FPS 与预期一致;观察文件大小是否持续增长且最终不是 0 字节。若 writer.isOpened() 为 False,优先换成 output.avi + MJPG;若能写 AVI 但不能写 MP4,问题通常在 MP4 编码器或后端支持,而不是逐帧处理逻辑。

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

目录与阅读设置

阅读设置

17

记录一个想法

保存处理后视频

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

登录哪都通