视频胶片条生成器 是做什么的?
使用 FFmpeg 和 Python 标准库(无需第三方包),从任意视频文件生成提取帧归档、四列 4K 胶片条网格、平均色条形码图像和平均 RGB CSV 文件。
前置条件
运行前确保 ffmpeg、ffprobe 和 python 在 PATH 中可用:
ffmpeg -version; ffprobe -version; python --version
步骤
- 解析输入视频路径,并询问用户是否希望胶片条网格瓦片上带有帧编号徽标(Frame Badges)或不带编号(除非用户已在请求中明确指定),此外还可提供可选覆盖参数(帧率、输出目录、前缀、起止时间裁剪或自定义尺寸)。
- 运行 generate_filmstrip.py 脚本,传入输入视频路径:
python "<skill_dir>/scripts/generate_filmstrip.py" "<input_video>"
仅在需要覆盖默认值时传递可选标志:
--no-frame-numbers:在网格图上省略左下角 16px 帧编号徽标(当用户选择不带编号瓦片时使用)--output-dir <dir>:目标目录(默认:在输入视频旁创建<前缀>_filmstrip文件夹)--prefix <name>:输出文件名前缀(默认:输入视频的文件名主干)--fps <rate>:每秒提取的帧数(默认:1.0)--cols <count>:网格列数(默认:4)--grid-width <px>:网格总宽度(像素,默认:3840)--barcode-height <px>:平均色条形码高度(像素,默认:715)--barcode-stripe-width <px>:每帧的条形码宽度(像素,默认:1)--quality <2-31>:FFmpeg MJPEG 质量,数值越低质量越高(默认:2)--start <sec>:起始偏移秒数(-ss)--duration <sec>:剪辑持续时间秒数(-t)
- 检查输出文件夹内生成的内容:
frames/<prefix>-001.jpeg... (保持原始视频分辨率、无徽标的提取帧)<prefix>_grid.jpeg或编号的<prefix>_grid-001.jpeg...(四列胶片条网格图,左下角带有 16px 帧编号徽标,除非传递了--no-frame-numbers,当高度超过 FFmpeg65500pxJPEG 上限时自动拆分)<prefix>_averagesRGB.jpeg(平均色条形码)<prefix>_averagesRGB.csv(frame,timestamp_sec,r,g,b行,行数与提取帧数一致)
- 报告输出目录,并提供生成的网格图、条形码、CSV 和帧文件夹的可点击链接。