Video Filmstrip
FFmpegとPython標準ライブラリ(サードパーティパッケージ不要)を使用して、任意の動画ファイルから抽出フレームアーカイブ、4列の4Kフィルムストリップグリッド、平均色バーコード画像、および平均RGBのCSVを生成します。
前提条件
実行前に ffmpeg、ffprobe、python が PATH 上で利用可能であることを確認してください:
ffmpeg -version; ffprobe -version; python --version
手順
- 入力動画パスを解決し、ユーザーにフィルムストリップグリッドのタイルにフレームバッジ(番号)を付けるかどうかを尋ねます(すでにリクエストで指定されていない場合)。さらに、オプションのオーバーライド(フレームレート、出力ディレクトリ、プレフィックス、開始/再生時間のトリミング、カスタム寸法)も確認します。
- 入力動画パスを指定して generate_filmstrip.py を実行します:
python "<skill_dir>/scripts/generate_filmstrip.py" "<input_video>"
デフォルトを変更する場合のみ、オプションフラグを渡します:
--no-frame-numbers: グリッドシートから左下の16pxフレームバッジを省略(ユーザーが番号なしを選択した場合に指定)--output-dir <dir>: 出力先ディレクトリ(デフォルト: 入力動画の隣に<prefix>_filmstrip)--prefix <name>: 出力ファイル名のプレフィックス(デフォルト: 入力動画のベース名)--fps <rate>: 抽出する1秒あたりのフレーム数(デフォルト: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...(4列のフィルムストリップグリッドシート。左下に16pxのフレームバッジ付き、ただし--no-frame-numbersが指定された場合は除く。FFmpegのJPEG高さ上限65500pxで自動分割)<prefix>_averagesRGB.jpeg(平均色バーコード)<prefix>_averagesRGB.csv(frame,timestamp_sec,r,g,bの行。抽出フレーム数と一致)
- 出力ディレクトリと、生成されたグリッドシート、バーコード、CSV、フレームフォルダへのクリック可能なリンクを報告します。