如何在OpenCV Python中设置起止帧及解决!_src.empty()错误

错误根源 #

cv2.error: (-215:Assertion failed)!_src.empty() 直接说明你传给cv2.cvtColor的帧是空的。绝大多数情况是你设置的起始/终止帧超出了视频实际的总帧数范围，或者跳转到目标帧时失败导致读取到空帧。

分步解决方案 #

1. 先获取视频总帧数，做范围校验
   先拿到视频的实际总帧数，避免设置的帧范围越界：

   import cv2
   
   cap = cv2.VideoCapture("your_mouse_video.mp4")
   total_frames = int(cap.get(cv2.CAP_PROP_FRAME_COUNT))
   

   手动设置起始、终止帧后，必须做合法性检查：

   start_frame = 100  # 自定义起始帧
   end_frame = 500    # 自定义终止帧
   
   # 校验范围合法性
   if start_frame < 0 or end_frame > total_frames or start_frame >= end_frame:
       print(f"无效帧范围！视频总帧数为{total_frames}，请重新设置")
       cap.release()
       exit()
   

2. 正确跳转到起始帧
   不要用循环逐帧跳过，直接用cv2.CAP_PROP_POS_FRAMES定位，同时检查跳转是否成功（部分视频格式不支持精确帧跳转）：

   # 跳转到目标起始帧
   success = cap.set(cv2.CAP_PROP_POS_FRAMES, start_frame)
   if not success:
       print(f"无法跳转到起始帧{start_frame}，将从第0帧开始处理")
       start_frame = 0
       cap.set(cv2.CAP_PROP_POS_FRAMES, 0)
   

3. 循环处理帧时，实时检查帧有效性
   在处理每帧前必须判断读取的帧是否为空，同时跟踪当前帧序号，到终止帧就停止：

   # 初始化背景减除器（适配原运动检测逻辑）
   fgbg = cv2.createBackgroundSubtractorMOG2()
   current_frame = start_frame
   
   while current_frame <= end_frame:
       ret, frame = cap.read()
       # 关键：检查帧是否读取成功
       if not ret or frame is None:
           print(f"读取帧{current_frame}失败，提前退出")
           break
   
       # 原有运动检测逻辑（灰度转换、背景减除等）
       gray = cv2.cvtColor(frame, cv2.COLOR_BGR2GRAY)
       fgmask = fgbg.apply(gray)
       # ... 其他处理代码（比如轮廓检测、绘制运动区域）
   
       # 显示结果（可选）
       cv2.imshow('Mouse Motion Detection', fgmask)
       if cv2.waitKey(1) & 0xFF == ord('q'):
           break
   
       current_frame += 1
   
   # 释放资源
   cap.release()
   cv2.destroyAllWindows()
   

额外注意点 #

• 如果是从摄像头实时读取视频，CAP_PROP_FRAME_COUNT会返回0，这种情况无法设置终止帧，只能用时间或计数来控制处理时长。
• 部分编码的视频（比如某些流媒体格式）不支持精确帧跳转，此时可以退而求其次：先循环读取到起始帧，再开始处理直到达到终止帧。

内容的提问来源于stack exchange，提问作者titan digitalsoft