计算机视觉 / 系统课时
读取视频属性
读取视频属性
视频文件打开后,真正决定后续处理方式的是它的尺寸、帧率、总帧数和当前读取位置。本节直接用 VideoCapture.get() 读取这些属性,并处理“属性不可用”这一常见情况,最终得到可验证的视频元数据与时长估算。
学习目标
- 使用
CAP_PROP_FRAME_WIDTH、CAP_PROP_FRAME_HEIGHT、CAP_PROP_FPS和CAP_PROP_FRAME_COUNT读取基础属性。 - 用
CAP_PROP_POS_FRAMES与CAP_PROP_POS_MSEC判断当前读取位置。 - 识别摄像头、网络流和变帧率视频中可能出现的不可靠属性值。
常用属性和值的含义
VideoCapture.get(propId) 返回浮点数,即使“宽度”和“总帧数”本质上是整数,也通常需要显式转成 int。对普通文件,最常用的属性如下:
| 属性 | 常见含义 | 典型值 |
|---|---|---|
CAP_PROP_FRAME_WIDTH |
解码后帧宽,单位像素 | 1920 |
CAP_PROP_FRAME_HEIGHT |
解码后帧高,单位像素 | 1080 |
CAP_PROP_FPS |
视频标称帧率 | 29.97、30、60 |
CAP_PROP_FRAME_COUNT |
可报告的总帧数 | 900 |
CAP_PROP_POS_FRAMES |
下一帧的 0 起始索引 | 0、1、120 |
CAP_PROP_POS_MSEC |
当前视频位置,单位毫秒 | 0、4000 |
例如 1920×1080、30 FPS、900 帧的视频,按“总帧数 ÷ 帧率”估算时长为 30 秒。这个算法适合固定帧率文件;变帧率素材只能把它当近似值。
读取并校验元数据
下面示例适用于 Python 3 和 OpenCV 4.x。运行时把视频路径作为命令行参数传入,先检查 isOpened(),再读取属性;这样不会把“文件没打开”误判成“视频属性全部为 0”。
import sys
import cv2
def main() -> int:
if len(sys.argv) != 2:
print("用法: python video_props.py <video_path>")
return 2
cap = cv2.VideoCapture(sys.argv[1])
if not cap.isOpened():
print("无法打开视频")
return 1
# get() 返回 float;像素尺寸和帧数在展示时转成整数。
width = int(cap.get(cv2.CAP_PROP_FRAME_WIDTH))
height = int(cap.get(cv2.CAP_PROP_FRAME_HEIGHT))
fps = cap.get(cv2.CAP_PROP_FPS)
frame_count = int(cap.get(cv2.CAP_PROP_FRAME_COUNT))
pos_before = int(cap.get(cv2.CAP_PROP_POS_FRAMES))
ok, _ = cap.read()
pos_after = int(cap.get(cv2.CAP_PROP_POS_FRAMES))
print(f"width={width}")
print(f"height={height}")
print(f"fps={fps:.3f}")
print(f"frame_count={frame_count}")
if fps > 0 and frame_count > 0:
print(f"duration_seconds={frame_count / fps:.3f}")
else:
print("duration_seconds=unknown")
print(f"pos_frames_before_read={pos_before}")
print(f"first_read_ok={ok}")
print(f"pos_frames_after_read={pos_after}")
cap.release()
return 0
if __name__ == "__main__":
raise SystemExit(main())预期输出:若输入文件确实是 1920×1080、30 FPS、900 帧,并且第一帧可正常读取,可得到类似结果。
width=1920
height=1080
fps=30.000
frame_count=900
duration_seconds=30.000
pos_frames_before_read=0
first_read_ok=True
pos_frames_after_read=1实际尺寸、帧率和帧数会随文件变化;如果 first_read_ok=False,说明容器虽然可能被打开,但没有成功解码出第一帧,应继续检查编码器支持或文件完整性。
当前位置怎样变化
CAP_PROP_POS_FRAMES 适合按帧观察进度。刚打开文件时通常为 0;成功执行一次 read() 后通常变为 1,表示下一次将读取第 1 号帧。若读取到第 120 帧附近,值会随解码进度继续增加。
CAP_PROP_POS_MSEC 用毫秒表示时间位置。例如 30 FPS 的固定帧率视频,读到约第 120 帧时,时间位置大约是 4000 ms。压缩视频执行随机跳转时,后端可能先落到邻近关键帧再继续解码,因此不要把它当作所有格式下都绝对精确的时间戳。
属性值不可靠的情况
摄像头和实时网络流通常没有“总帧数”,因此 CAP_PROP_FRAME_COUNT 可能返回 0 或其他不可用值;某些设备的 CAP_PROP_FPS 也可能是 0。此时应把“值大于 0”作为计算时长或帧间隔前的最小检查条件。
变帧率文件还有另一个边界:FRAME_COUNT / FPS 只给出近似时长。如果业务需要精确时间轴,应以每帧时间戳或专门的媒体探测工具为准,而不是仅依赖 VideoCapture 的两个汇总属性。