On this page | |
Since | 17.5 |
Note
動画からフレーム画像を抽出する反対の処理に関する情報は、FFmpeg Extract Imagesノードのドキュメントを参照してください。
インストール
このノードは、ffmpeg
コマンドラインツールのラッパーです。
このノードを動作させるには、各マシン上にFFmpegがインストールされている 必要があります 。
FFmpegコマンドラインツールを検索するノードに関しては、そのツールの実行可能バイナリのパスが以下の方法のどれかで利用できる必要があります:
-
システムパス。
-
PDG_FFMPEG
という名前の環境変数でパスを指定。 -
ノードの FFmpeg Binary Path パラメータで直接パスを指定。
Tip
$HH/help/files/pdg_examples/top_multishot
と$HH/help/files/pdg_examples/top_rop
のサンプルでは、このノードを使用して、レンダリング画像から動画を生成する方法を説明しています。
TOP Attributes
|
integer |
出力される動画の1秒あたりのフレーム数。 |
パラメータ
Node
Generate When
このノードがワークアイテムを生成するタイミングを決めます。 このノードがどの生成モードを必須にしているのか、もしくは、ワークアイテムを動的に生成させる必要があるのかどうか分からないのであれば、通常では、これを“Automatic”のままに設定してください。
All Upstream Items are Generated
このノードは、すべての入力ノードが自身のワークアイテムを生成した時にワークアイテムを生成します。
All Upstream Items are Cooked
このノードは、すべての入力ノードが自身のワークアイテムをクックした時にワークアイテムを生成します。
Each Upstream Item is Cooked
このノードは、入力ノード内のワークアイテムがクックされる度にワークアイテムを生成します。
Automatic
入力ノードの生成モードに基づいて生成モードが選択されます。 入力ノードのどれかがその入力のクック時にワークアイテムが生成されている場合、このノードには Each Upstream Item is Cooked が設定されます。 そうでない場合、 All Upstream Items are Generated が設定されます。
Cache Mode
ワークアイテムから目的のファイル結果がレポートされるように、プロセッサノードがそのワークアイテムを制御する方法を決めます。
Automatic
目的の結果ファイルがディスク上に存在すれば、そのワークアイテムはスケジュールに組まれずにクック済みとマークされます。 そのファイルが 存在しなければ 、そのワークアイテムは通常どおりにスケジュールに組まれます。 上流のワークアイテムの依存関係がクック中に新しいファイルを書き出す場合、このノード内のワークアイテムのキャッシュファイルもout-of-date(古い)としてマークされます。
Automatic (Ignore Upstream)
Automatic と同様ですが、上流のファイルの書き込みは、このノード内のワークアイテムのキャッシュファイルを 無効にしません 。 そして、このノードは自身のワークアイテムの出力ファイルのみをチェックします。
Read Files
目的の結果ファイルがディスク上に存在すれば、そのワークアイテムはスケジュールに組まれずにクック済みとマークされます。 そのファイルが存在しなければ、そのワークアイテムは失敗とマークされます。
Write Files
目的の結果ファイルがディスク上に存在していても、ワークアイテムが常にスケジュールに組まれ、その目的の結果ファイルを無視します。
Tool Presets
このメニューには、事前に定義されたFFmpegオペレーションセットが用意されています。 これらのプリセットのどれかを選択すると、自動的にパラメータとFFmpegコマンドが設定されます。
Create Video From Images
一連の入力画像から動画を生成することができます。
Convert File Format
単純な変換オペレーションを実行することができます。 例えば、音声ファイルまたは動画ファイルを変換します。
Convert Audio or Video File
もっと高度な変換オペレーション(例えば、動画ファイルのフォーマットを変更し、さらにその解像度を変更したい場合)を実行することができます。
Input Source
入力ソースを選択します。
Upstream Output Images
File Tag パラメータで指定されたタグを持った上流のワークアイテムから出力されたファイルを入力として設定します。
Upstream Output File
File Tag パラメータで指定されたタグを持った上流のワークアイテムから最初に出力されたファイルを入力として設定します。
Custom File Path
File Path パラメータで指定されたファイルパスを入力として設定します。
File Tag
入力ソースのファイルタグを指定します。
このパラメータは、 Input Source が Custom File Path に設定されて いない 時にのみ利用可能です。
File Path
入力ソースのファイルパスを指定します。
このパラメータは、 Input Source が Custom File Path に設定されている時にのみ利用可能です。
Frame List File
フレームリストファイルのファイルパス。 フレームリストファイルは、動画に変換する際に使用するすべての入力画像の順番が決められたリストを含んだテキストファイルです。
FFmpegでは、このファイル内の画像のパスが相対パスとして指定されている必要があります。 そのため、Windowsで実行する時、このフレームリストファイルは必ず入力画像と同じドライブ上に 配置しなければなりません 。
このパラメータは、 Input Source が Upstream Output Images に設定されている時にのみ利用可能です。
Output File Path
出力される動画のファイルパスを指定します。
File Tag
出力される動画のファイルタグを指定します。
Frames Per Second
有効な時、エンコードされる動画ファイルの1秒あたりのフレーム数を指定します。
Format
有効な時、FFmpegの-f
引数の値を指定します。
Size
有効な時、FFmpegの-s
引数の値を指定します。
-apply_trc
有効な時、FFmpegの-apply_trc
引数の値を指定します。
Video Codec
有効な時、FFmpegの-c:v
引数の値を指定します。
-movflags
有効な時、FFmpegの-movflags
引数の値を指定します。
Pixel Format
有効な時、ピクセルフォーマットを指定します。
FFmpeg Binary
FFmpegをコールする方法を指定します。
System Path
システムパスから(利用可能であれば)FFmpegをコールします。
$PDG_FFMPEG
PDG_FFMPEG
環境変数に格納されているパスを使ってFFmpegをコールします。
この環境変数は、ユーザー側で作成してください。
Custom Path
FFmpeg Binary Path パラメータで指定されたパスを使ってFFmpegバイナリをコールします。
FFmpeg Binary Path
FFmpegバイナリのパスを指定します。
このパラメータは、 FFmpeg Binary が Custom Path に設定されている時にのみ利用可能です。
FFmpeg Command
有効な時、ワークアイテムがクックされた時にコールされるFFmpegコマンドを指定します。 このコマンドを修正することができますが、他のパラメータを変更しても自動的に 更新されなくなります 。
Schedulers
TOP Scheduler Override
このパラメータは、このノードのTOPスケジューラを上書きします。
Add Job Parms
Opens the Edit Parameter Interface window for the purpose of adding scheduler parameters to the node’s interface.
In-Process Scheduler
The Edit Parameter Interface window opens with the In-Process Scheduler’s parameter folder selected in the Create Parameters column.
Local Scheduler
The Edit Parameter Interface window opens with the Local Scheduler’s parameter folder selected in the Create Parameters column.
HQueue Scheduler
The Edit Parameter Interface window opens with the HQueue Scheduler’s parameter folder selected in the Create Parameters column.
Work Item Label
Determines how the node should label its work items. This parameter allows you to assign non-unique label strings to your work items which are then used to identify the work items in the attribute panel, task bar, and scheduler job names.
No Label
The work items on this node do not have a label.
Inherit From Upstream Item
The work items inherit their labels from their parent work items.
Custom Expression
The work item label is set to the Label Expression custom expression which is evaluated for each item.
Node Defines Label
The work item label is defined in the node’s internal logic.
Label Expression
When on, this parameter specifies a custom label for work items created by this node. The parameter can be an expression that includes references to work item attributes or built-in properties. For example, $OS: @pdg_frame
will set the label of each work item based on its frame value.
Work Item Priority
このパラメータは、現行スケジューラがこのノード内のワークアイテムの優先度を設定する方法を決めます。
Inherit From Upstream Item
ワークアイテムは、親ワークアイテムの優先度を継承します。ワークアイテムに親ワークアイテムがなければ、その優先度は0に設定されます。
Custom Expression
ワークアイテムの優先度は、 Priority Expression の値に設定されます。
Node Defines Priority
ワークアイテムの優先度は、このノード自身の内部優先度計算に基づいて設定されます。
このオプションは、
Python Processor TOP,
ROP Fetch TOP, ROP Output TOPのノードでのみ利用可能です。
これらのノードは、各自のノードロジックで実装された優先度設定スキームを定義しています。
Examples
example_top_ffmpegencodevideo Example for FFmpeg Encode Video TOP node
このサンプルでは、FFmpeg Encode Videoノードを使って、画像シーケンスを動画ファイルに変換する方法を説明しています。