pip install opencv-python

#!/usr/bin/env python3
"""
MP4視頻分解為JPG圖片腳本
將視頻文件的每一幀保存為獨(dú)立的JPG圖片
"""
import cv2
import os
import argparse
from pathlib import Path
def video_to_frames(video_path, output_dir, fps=None, prefix="frame", quality=95):
    """
    將視頻文件分解為JPG圖片
    Args:
        video_path: 視頻文件路徑
        output_dir: 輸出目錄
        fps: 保存幀率(None表示保存所有幀，指定數(shù)字表示每秒保存多少幀)
        prefix: 輸出文件名前綴
        quality: JPG圖片質(zhì)量(1-100)
    Returns:
        保存的圖片總數(shù)
    """
    # 檢查視頻文件是否存在
    if not os.path.exists(video_path):
        raise FileNotFoundError(f"視頻文件不存在: {video_path}")
    # 創(chuàng)建輸出目錄
    os.makedirs(output_dir, exist_ok=True)
    # 打開視頻文件
    cap = cv2.VideoCapture(video_path)
    if not cap.isOpened():
        raise RuntimeError(f"無法打開視頻文件: {video_path}")
    # 獲取視頻信息
    video_fps = cap.get(cv2.CAP_PROP_FPS)
    total_frames = int(cap.get(cv2.CAP_PROP_FRAME_COUNT))
    width = int(cap.get(cv2.CAP_PROP_FRAME_WIDTH))
    height = int(cap.get(cv2.CAP_PROP_FRAME_HEIGHT))
    print(f"視頻信息:")
    print(f"  - 幀率: {video_fps:.2f} FPS")
    print(f"  - 總幀數(shù): {total_frames}")
    print(f"  - 分辨率: {width}x{height}")
    print(f"  - 輸出目錄: {output_dir}")
    print()
    # 計(jì)算幀間隔
    if fps is not None and fps < video_fps:
        frame_interval = int(video_fps / fps)
        print(f"每隔 {frame_interval} 幀保存一次(約 {fps} FPS)")
    else:
        frame_interval = 1
        print("保存所有幀")
    # JPEG編碼參數(shù)
    encode_param = [int(cv2.IMWRITE_JPEG_QUALITY), quality]
    frame_count = 0
    saved_count = 0
    try:
        while True:
            ret, frame = cap.read()
            if not ret:
                break
            # 根據(jù)幀間隔判斷是否保存
            if frame_count % frame_interval == 0:
                # 生成輸出文件名，使用6位數(shù)字編號
                output_path = os.path.join(output_dir, f"{prefix}_{saved_count:06d}.jpg")
                # 保存圖片
                cv2.imwrite(output_path, frame, encode_param)
                saved_count += 1
                # 顯示進(jìn)度
                if saved_count % 100 == 0:
                    print(f"已保存 {saved_count} 張圖片...")
            frame_count += 1
    finally:
        cap.release()
    print(f"\n完成! 共保存 {saved_count} 張圖片到 {output_dir}")
    return saved_count
def main():
    parser = argparse.ArgumentParser(
        description="將MP4視頻文件分解為JPG圖片",
        formatter_class=argparse.RawDescriptionHelpFormatter,
        epilog="""
示例:
  # 保存所有幀
  python video_to_frames.py input.mp4 -o frames/
  # 每秒保存10幀
  python video_to_frames.py input.mp4 -o frames/ --fps 10
  # 自定義文件名前綴和圖片質(zhì)量
  python video_to_frames.py input.mp4 -o frames/ --prefix img --quality 90
"""
    )
    parser.add_argument("video", help="輸入的MP4視頻文件路徑")
    parser.add_argument("-o", "--output", default="frames", help="輸出目錄(默認(rèn): frames)")
    parser.add_argument("--fps", type=float, help="保存幀率(不指定則保存所有幀)")
    parser.add_argument("--prefix", default="frame", help="輸出文件名前綴(默認(rèn): frame)")
    parser.add_argument("--quality", type=int, default=95, 
                        help="JPG圖片質(zhì)量1-100(默認(rèn): 95)")
    args = parser.parse_args()
    # 驗(yàn)證質(zhì)量參數(shù)
    if args.quality < 1 or args.quality > 100:
        parser.error("圖片質(zhì)量必須在1-100之間")
    # 執(zhí)行轉(zhuǎn)換
    video_to_frames(
        video_path=args.video,
        output_dir=args.output,
        fps=args.fps,
        prefix=args.prefix,
        quality=args.quality
    )
if __name__ == "__main__":
    main()

# 計(jì)算幀間隔
if fps is not None and fps < video_fps:
    frame_interval = int(video_fps / fps)
    print(f"每隔 {frame_interval} 幀保存一次(約 {fps} FPS)")

encode_param = [int(cv2.IMWRITE_JPEG_QUALITY), quality]
cv2.imwrite(output_path, frame, encode_param)

output_path = os.path.join(output_dir, f"{prefix}_{saved_count:06d}.jpg")
# 結(jié)果：frame_000001.jpg, frame_000002.jpg ...

if saved_count % 100 == 0:
    print(f"已保存 {saved_count} 張圖片...")

python video_to_frames.py my_video.mp4 -o frames/

python video_to_frames.py 4k_video.mp4 -o preview/ --fps 2 --quality 85

視頻信息:
  - 幀率: 30.00 FPS
  - 總幀數(shù): 900
  - 分辨率: 1920x1080
  - 輸出目錄: frames/

每隔 3 幀保存一次(約 10.0 FPS)
已保存 100 張圖片...
已保存 200 張圖片...
已保存 300 張圖片...

完成! 共保存 300 張圖片到 frames/