计算机视觉 / 系统课时

保存处理后的视频

保存处理后的视频

把逐帧处理结果保存成新视频,关键不是只调用一次 write(),而是让编码器、帧率和画面尺寸与实际写入帧保持一致。本节用 VideoWriter 建立完整的“读取 → 处理 → 写入 → 验证”流程,并说明最容易导致空文件或无法播放的配置错误。

学习目标

  • 使用 cv2.VideoWriter() 配置编码、帧率和输出尺寸
  • 保证每一帧的尺寸与通道格式满足写入器要求
  • 写完后正确释放资源,并重新打开输出文件验证结果

建立视频写入链路

保存视频时,VideoCapture 提供原始帧,处理逻辑产生新帧,VideoWriter 再把这些帧按指定编码封装进文件。写入器创建时就确定了输出帧率和尺寸,后续每一帧都必须符合这两个约束。

处理后视频的读取、处理与写入链路

常见的 MP4 示例可以尝试 mp4v 编码,但最终可用编码仍取决于本机 OpenCV、FFmpeg/GStreamer 后端以及系统编码器支持。创建后要立即检查 writer.isOpened(),不要等写完整段视频后才发现编码器根本没有成功初始化。

完整写入示例

下面程序读取 input.mp4,把每帧转成灰度后再转换回三通道 BGR,并写入 output.mp4。转换回 BGR 是为了与默认彩色视频写入器保持一致;如果直接写单通道灰度帧,需要按后端要求配置 isColor=False,兼容性通常更依赖具体编码器。

python
import cv2

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

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("无法读取有效的视频帧率或尺寸")

fourcc = cv2.VideoWriter_fourcc(*"mp4v")
writer = cv2.VideoWriter(
    output_path,
    fourcc,
    fps,
    (width, height),
)

if not writer.isOpened():
    cap.release()
    raise RuntimeError("VideoWriter 初始化失败,请检查编码器和输出路径")

frame_count = 0

while True:
    ok, frame = cap.read()
    if not ok:
        break

    # 处理后仍写入与初始化尺寸一致的三通道帧
    gray = cv2.cvtColor(frame, cv2.COLOR_BGR2GRAY)
    processed = cv2.cvtColor(gray, cv2.COLOR_GRAY2BGR)

    writer.write(processed)
    frame_count += 1

cap.release()
writer.release()

check = cv2.VideoCapture(output_path)
if not check.isOpened():
    raise RuntimeError("输出文件已生成,但无法重新打开验证")

saved_width = int(check.get(cv2.CAP_PROP_FRAME_WIDTH))
saved_height = int(check.get(cv2.CAP_PROP_FRAME_HEIGHT))
check.release()

print(f"已保存: {output_path}")
print(f"写入帧数: {frame_count}")
print(f"输出尺寸: {saved_width}x{saved_height}")

预期输出

text
已保存: output.mp4
写入帧数: <VALUE>
输出尺寸: <VALUE>x<VALUE>

这些 <VALUE> 由输入视频决定,实际值可能不同。除了看到输出文件存在,还应确认它能被重新打开,并且尺寸与预期一致。

三个参数必须和写入帧匹配

fourcc 决定编码格式,fps 决定播放器按多快的时间轴解释这些帧,frameSize 决定每帧必须具有的宽高。若输入 30 FPS 的视频却用 15 FPS 写出,而帧数不变,成片时长大约会变成原来的两倍。

尺寸是更常见的故障来源。假设写入器按 (1280, 720) 创建,那么处理后的每一帧也必须是 1280×720。若处理中做了裁剪或缩放,就要么把结果恢复到原尺寸,要么从一开始就用新的输出尺寸初始化 VideoWriter。

写入失败时先检查什么

文件大小为 0、只有文件头、无法播放或没有任何报错时,先检查 writer.isOpened()。如果为 False,优先更换编码、输出扩展名或确认 OpenCV 是否带有可用的视频编码后端。

如果写入器能打开但结果损坏,再检查每帧的尺寸、通道数和数据类型。常规彩色视频通常写入 uint8、三通道 BGR 帧;处理流水线若产生浮点图、单通道图或不同尺寸,应在 write() 前显式转换。

最后一定调用 release()。编码器常在释放阶段写入索引和尾部信息;程序异常退出或忘记释放资源,都可能留下无法正常播放的文件。

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

目录与阅读设置

阅读设置

17

记录一个想法

保存处理后的视频

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

登录哪都通