计算机视觉 / 系统课时
获取视频属性
获取视频属性
处理视频文件前,先读取宽度、高度、帧率、总帧数和当前播放位置,可以帮助你计算时长、检查编码信息,并确认后续逐帧读取是否按预期推进。本课使用 VideoCapture.get() 完成查询,并解释常见属性值的边界。
学习目标
- 使用 OpenCV 查询视频的宽高、帧率和总帧数
- 计算视频时长并读取当前帧位置与时间位置
- 正确处理属性不可用、帧率为零和浮点返回值
打开视频并检查状态
cv2.VideoCapture() 既可以读取视频文件,也可以连接摄像头。查询文件属性前应先调用 isOpened(),避免路径错误或解码器不可用时继续使用无效对象。
python
from pathlib import Path
import cv2
def main() -> None:
video_path = Path("sample.mp4")
capture = cv2.VideoCapture(str(video_path))
if not capture.isOpened():
raise RuntimeError(f"无法打开视频:{video_path.resolve()}")
try:
width = int(capture.get(cv2.CAP_PROP_FRAME_WIDTH))
height = int(capture.get(cv2.CAP_PROP_FRAME_HEIGHT))
fps = capture.get(cv2.CAP_PROP_FPS)
frame_count = int(capture.get(cv2.CAP_PROP_FRAME_COUNT))
duration_seconds = frame_count / fps if fps > 0 else None
print(f"分辨率:{width} x {height}")
print(f"帧率:{fps:.3f} FPS")
print(f"总帧数:{frame_count}")
if duration_seconds is None:
print("视频时长:无法计算,帧率不可用")
else:
print(f"视频时长:{duration_seconds:.3f} 秒")
# 读取一帧后再次查询,观察播放位置如何前进。
ok, _ = capture.read()
if not ok:
raise RuntimeError("视频已打开,但第一帧读取失败")
frame_position = capture.get(cv2.CAP_PROP_POS_FRAMES)
time_position_ms = capture.get(cv2.CAP_PROP_POS_MSEC)
print(f"下一帧索引位置:{frame_position:.0f}")
print(f"当前时间位置:{time_position_ms:.3f} 毫秒")
finally:
capture.release()
if __name__ == "__main__":
main()预期输出
text
分辨率:1920 x 1080
帧率:25.000 FPS
总帧数:1500
视频时长:60.000 秒
下一帧索引位置:1
当前时间位置:40.000 毫秒实际宽高、帧率、总帧数和时间位置取决于视频文件及解码后端。某些编码格式的 CAP_PROP_POS_MSEC 可能存在舍入误差,第一帧读取后的数值也不一定严格等于 1000 / FPS。
常用属性及返回值
VideoCapture.get() 接收属性常量并返回 float。宽度、高度和总帧数通常可转换为整数,帧率和时间位置应保留浮点数。
CAP_PROP_FRAME_WIDTH:解码后单帧宽度,单位为像素。CAP_PROP_FRAME_HEIGHT:解码后单帧高度,单位为像素。CAP_PROP_FPS:标称帧率。可变帧率视频中,它不一定能准确代表每一帧的时间间隔。CAP_PROP_FRAME_COUNT:后端报告的总帧数,部分容器或流媒体可能返回0或近似值。CAP_PROP_POS_FRAMES:下一次读取对应的帧位置。调用一次read()后通常变为1。CAP_PROP_POS_MSEC:当前播放时间位置,单位为毫秒。
计算时长与定位边界
固定帧率视频通常可用“总帧数除以帧率”估算时长,但必须先检查帧率是否大于零。对于可变帧率视频、损坏文件或不支持完整索引的容器,该结果只能作为近似值。
读取位置属于解码后端状态,而不是文件中绝对可靠的元数据。调用 set(cv2.CAP_PROP_POS_FRAMES, n) 可以尝试跳转到指定帧,但压缩视频通常只能先跳到附近关键帧,再向前解码,因此实际定位可能有偏差。
Tips:查询结果异常时,先确认
isOpened(),再检查视频是否可被系统中的 FFmpeg、GStreamer 或平台媒体后端正常解码。不要把属性值为0直接解释为视频本身确实为零。
本课总结
- 视频属性通过
VideoCapture.get()查询,返回值统一为浮点数 - 视频时长可由总帧数和帧率估算,但必须处理帧率为零和可变帧率情况
- 当前帧位置与时间位置受解码后端影响,可能存在近似值和跳转误差
下一课预告
下一课将设置摄像头分辨率、帧率和曝光参数,并通过重新读取属性判断设备是否真正接受了设置。
按自己的节奏,确认真正理解。