| On this page | |
| Since | 17.0 |
このSOPでは、エージェントプリミティブの定義をディスクに簡単に書き出せるように
Agent ROPとAgent SOPを組み合わせました。
これは、SOPチェーン(例えば、
Agent Clip SOPと
Agent Layer SOP)の最後でエージェントを初期化するのに便利です。
エージェント定義を別々のファイルに保存するメリットについては、キャッシュ化のヘルプページを参照してください。
パラメータ ¶
Load from Disk
有効にすると、ディスク上のエージェント定義ファイルからエージェントが読み込まれます。 無効にすると、入力エージェントが通過します。
Keep External References
有効にすると、エージェントをジオメトリファイルに保存する際に.bgeoファイルにエージェント定義コンポーネントのファイルパス(例えば、各アニメーションクリップの.bclipファイルのパス)が格納されます。
無効にすると、エージェント定義は.bgeoファイルに埋め込まれ、そのジオメトリファイルを自己完結型にすることができますが、ファイルサイズが肥大になります。
このパラメータは、 Load from Disk が有効な場合に利用可能です。
Reload
エージェント定義を再読み込みします。
このパラメータは、 Load from Disk が有効な場合に利用可能です。
Rest Frame
ディスクに保存する時に入力エージェントが評価されるフレーム。 入力エージェントが時間依存の場合、これは、どのフレームのエージェント定義とアトリビュート値をキャッシュ化するのかを決めます。
Agent Name
エージェントの名前。
他のパラメータ値で$AGENTローカル変数を使ってエージェントの名前を参照できるように、このパラメータが便宜的に用意されています。
Cache Directory
エージェント定義ファイルの親ディレクトリ。
このパラメータは、利便性のために提供されていて、その値は、他のファイル名パラメータに$CACHEDIRローカル変数を使用することで参照することができます。
Save to Disk
エージェント定義ファイルをディスクに書き出します。
Skip Existing Frames
既存フレームのレンダリングをスキップします。このパラメータには3つの値があります。
Overwrite existing frames
このオプションは、ディスク上のファイルの有無に関わらず、すべてのフレームをレンダリングします。
Skip frames that exist
vm_pictureパラメータに該当するディスクファイルが存在すれば、そのレンダリングを実行しません。
Skip frames that are valid images
ディスクファイルが存在すれば、レンダリングを実行する前に、その画像の整合性をチェックします。 このオプションは、画像の読み込みに負荷がかかりますが、完全にレンダリングされなかった画像を再レンダリングします。
Rig
エージェントリグのファイル名。 このリグファイルは、エージェントのトランスフォーム階層を記述したJSONファイルです。
Agent Layers
エージェントレイヤファイルのファイル名パターン。
${LAYER}ローカル変数を使用することで、そのファイル名にレイヤの名前を含ませることができます。
Shape Library
エージェントシェイプライブラリのファイル名。
Clips
エージェントクリップファイルのファイル名パターン。
${CLIP}ローカル変数を使用することで、そのファイル名にクリップの名前を含ませることができます。
Transform Groups
エージェントトランスフォームグループファイルのファイル名パターン。
${TRANSFORM_GROUP}ローカル変数を使用することで、そのファイル名にトランスフォームグループの名前を含ませることができます。
Metadata
エージェント定義のメタデータのファイル名パターン。 このファイルは追加カスタムデータを含んだJSONファイルです。
Attributes
エージェントプリミティブのアトリビュートとプロパティ(エージェントの現行レイヤ、コリジョンレイヤ、現行クリップなど)を含んだジオメトリファイルを保存します。 これはエージェント定義の一部ではありませんが、キャッシュを読み込む時にその入力エージェントのアトリビュートを保持するのに役立ちます。
これらのパラメータは、 Load from Disk が有効な場合に利用可能です。 エージェント定義がディスクから読み込まれた時のエージェントプロパティの初期値(例えば、表示するレイヤなど)を指定します。
Current Layers
The layer (or list of layers) to assign to the agent.
If Current Layers is empty, and Attributes is turned on, the layers that were assigned when the agent definition was saved are used.
If Current Layers is empty, and Attributes is turned off, the layer named default is used, if it exists. Otherwise, the first available layer in the agent definition is used.
Collision Layers
The collision layer (or list of collision layers) to assign to the agent.
If Collision Layers is empty, and Attributes is turned on, the layers that were assigned when the agent definition was saved are used.
If Collision Layers is empty, and Attributes is turned off, the layer named collision is used, if it exists. Otherwise, the first available layer in the agent definition is used.
Current Clip
The name of the animation clip the agents run.
If Current Clip is empty, and Attributes is turned on, the clip that was assigned when the agent definition was saved is used.
If Current Clip is empty, and Attributes is turned off, the first available clip in the agent definition is used.
Clip Offset
When turned on, this is the time into the current clip to begin playing (in seconds).
Apply Clip Locomotion
有効にすると、ロコモーションクリップを簡単に事前確認できるように、エージェントリグから__locomotion__トランスフォームを適用します。
入力 ¶
Agent
(Optional) The agent primitive used when caching the agent definition to disk. If there are multiple agents, only the first agent is used. This input is optional, so you can use this SOP in a new scene to load in an agent definition cache from disk.
出力 ¶
Output
The original geometry that is passed through if Load from Disk is turned off. If Load from Disk is turned on, this output is a new agent primitive that is created by loading the agent definition cache from disk.
| See also |
