计算机视觉 / 系统课时
保存处理后的视频
保存处理后的视频
把逐帧处理结果保存成新视频,关键不是只调用一次 write(),而是让编码器、帧率和画面尺寸与实际写入帧保持一致。本节用 VideoWriter 建立完整的“读取 → 处理 → 写入 → 验证”流程,并说明最容易导致空文件或无法播放的配置错误。
学习目标
- 使用
cv2.VideoWriter()配置编码、帧率和输出尺寸 - 保证每一帧的尺寸与通道格式满足写入器要求
- 写完后正确释放资源,并重新打开输出文件验证结果
建立视频写入链路
保存视频时,VideoCapture 提供原始帧,处理逻辑产生新帧,VideoWriter 再把这些帧按指定编码封装进文件。写入器创建时就确定了输出帧率和尺寸,后续每一帧都必须符合这两个约束。

常见的 MP4 示例可以尝试 mp4v 编码,但最终可用编码仍取决于本机 OpenCV、FFmpeg/GStreamer 后端以及系统编码器支持。创建后要立即检查 writer.isOpened(),不要等写完整段视频后才发现编码器根本没有成功初始化。
完整写入示例
下面程序读取 input.mp4,把每帧转成灰度后再转换回三通道 BGR,并写入 output.mp4。转换回 BGR 是为了与默认彩色视频写入器保持一致;如果直接写单通道灰度帧,需要按后端要求配置 isColor=False,兼容性通常更依赖具体编码器。
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}")预期输出
已保存: 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()。编码器常在释放阶段写入索引和尾部信息;程序异常退出或忘记释放资源,都可能留下无法正常播放的文件。