FFmpeg Extract Images TOP node

動画ファイルから静止画像シーケンスを抽出します。

On this page

概要
- インストール
Top_attributes
パラメータ
- Node
- Processor
Examples

概要

この反対の処理(フレーム画像を動画に変換)がFFmpeg Encode Videoノードです。

このノードは2通りの方法で使用します:

入力を接続しない場合は、画像を抽出したい動画ファイルを指定します。
このノードに動画ファイルを表現したoutputを持った入力ワークアイテムが存在すれば、このノードは入力のワークアイテム毎に静止画像シーケンスを抽出します。 Video パラメータに&96;@pdg_input&96;を設定することで、各入力のワークアイテムの出力結果ファイルをフレーム抽出の入力として使用することができます。

このノードは、入力の動画毎にすべての画像を抽出する 1個のワークアイテム を生成します(フレーム毎に別々のワークアイテムを生成しません)。ワークアイテムのoutputは、出力ファイル名の配列です。ファイル毎に別々のワークアイテムが生成されるように出力をノードに接続したいのであれば、Work Item Expandノードを使用することで、ワークアイテム(s)内の出力ファイルを分割することができます。

インストール

このノードは、ffmpegコマンドラインツールのラッパーです。 このノードを動作させるには、各マシン上にFFmpegがインストールされている必要があります。

このノードの FFmpeg Path パラメータを使用することで、実行ファイルのパスを明示的に指定することができます。
FFmpeg Path パラメータが空っぽの場合、このノードは、実行ファイルのパスを定義したPDG_FFMPEG環境変数を検索します。
PDG_FFMPEG変数が定義されていなかった場合、このノードは、実行ファイルがシステムパスにあると想定します。

TOP Attributes

`operation`	string	FFmpegオペレーション(`extract`)を意味します。
`inputvideo`	string	抽出元の動画のファイルパス。
`overridebin`	integer	ユーザが独自の`ffmpeg`実行ファイルのパスを指定したかどうか。これが`1`なら、ワークスクリプトは`ffmpegbin`アトリビュートの実行ファイルパスを使用します。
`ffmpegbin`	string	`overridebin`が`1`の場合の`ffmpeg`実行ファイルのパス。
`fps`	integer	動画の1秒あたりに抽出するフレーム数。
`specifyimagesize`	integer	これが`1`なら、`imgwidth`と`imgheight`で指定されたカスタムサイズで画像が出力されます。
`imgwidth`	integer	`specifyimagesize`が`1`の場合に出力される画像の幅。
`imgheight`	integer	`specifyimagesize`が`1`の場合に出力される画像の高さ。
`outputfilepath`	string	出力ファイル名の生成方法を指定した(FFmpeg特有の`%`フォーマット構文を使った)パターン文字列。注: 実際の出力ファイル名は、ファイルパスの配列として`@pdg_output`アトリビュートに格納されます。
`customcommand`	integer	これを`1`に設定すると、ワークスクリプトは`expr`のカスタムコマンドラインを実行するようになります。
`expr`	string	`customcommand`が`1`の時に実行するカスタムコマンドライン。
`outputtag`	outputtag	結果ファイルパスに追加するファイルタグ。

パラメータ

Node

Video

フレームを抽出する動画ファイルのファイルパス。

Frames Per Second

動画の1秒あたりに抽出するフレーム画像の枚数を指定します。この数が大きいほどフレーム画像が増えます。

Width

Width/Heightパラメータの隣りにあるチェックボックスを有効にすると、出力画像の独自の幅を指定することができます。無効にすると、このノードは動画のオリジナルのサイズを使用します。

Height

Width/Heightパラメータの隣りにあるチェックボックスを有効にすると、出力画像の独自の高さを指定することができます。無効にすると、このノードは動画のオリジナルのサイズを使用します。

Image Output Pattern

出力される画像ファイルのパスを生成する際に使用する文字列。ここには、@expressions(文字列パラメータなのでバッククォートで閉じます)を含めることができ、フレーム番号の位置としてFFmpeg特有の%dマーカーを1個だけ含めてください。このマーカーを使ってフレーム番号をゼロ詰めすることができます。例えば、フレーム番号を4桁でゼロ詰めしたいのであれば、%04dと記述します。テキストボックスの最後にあるドロップメニューを使用すれば、他にも別のプリセットパターンを選択することができます。

Output Tag

FFmpeg Command

これを有効にすることで、ffmpegに渡すコマンドラインをカスタマイズすることができます。

FFmpeg Path

これを有効にすることで、ffmpeg実行ファイルのパスを明示的に設定することができます。これを無効にすると、このノードはPDG_FFMPEG環境変数を検索するようになります。その変数が設定されていなかった場合、このノードは単に実行ファイルがシステムパスにあると想定します。

Processor

Work Item Generation

このノードが静的または動的なワークアイテムのどちらを生成するかどうか。このノードのワークアイテムが静的に計算可能かどうか、もしくは、動的に生成させる必要があるかどうか分からないのであれば、通常では、これを"Automatic"のままに設定してください。

Dynamic

このノードが常に動的なワークアイテムを生成します。つまり、上流のワークアイテムが判明するまで待機し、その上流のワークアイテムから新しいワークアイテムを生成します。

Static

このノードが常に静的なワークアイテムを生成します。つまり、ネットワークを実行する前にパラメータ(と上流の静的なワークアイテム)に基づいて必要だと思われるだけの数のワークアイテムを生成します。

Automatic

入力が静的(静的なプロセッサ、静的な入力のみを使ったパーティショナー、マッパー)な場合、このノードは静的なワークアイテムを生成し、そうでない場合、動的なワークアイテムを生成します。

Examples

example_top_ffmpegextractimages Example for FFmpeg Extract Images TOP node

このサンプルでは、FFmpeg Extract Imagesノードを使って、動画ファイルから画像を抽出する方法について説明しています。

The following examples include this node.