影片底片條生成器 是做什麼的?
從任何影片檔案產生已提取畫格的壓縮包、4 欄 4K 底片條網格、平均色條碼影像,以及平均 RGB CSV,全程使用 FFmpeg 與 Python 標準函式庫(不需任何第三方套件)。
前置需求
執行前請確認 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/<前綴>-001.jpeg...(保留的原始解析度未標記畫格)<前綴>_grid.jpeg或編號<前綴>_grid-001.jpeg...(4 欄底片條網格,除非使用了--no-frame-numbers,否則每格左下角會有 16px 幀編號標記;當超過 FFmpeg 的65500pxJPEG 高度上限時會自動分割成多張)<前綴>_averagesRGB.jpeg(平均色條碼)<前綴>_averagesRGB.csv(欄位:frame,timestamp_sec,r,g,b,列數與提取的畫格數一致)
- 回報輸出目錄,並提供產生的網格、條碼、CSV 與畫格資料夾的可點擊連結。