On this page |
Tips ¶
-
USDコレクションには、“Include(包含)”と“Exclude(排他)”を組み合わせた内容を指定することができます。コレクションの内容には、Includeに合致し、且つ、Excludeに合致しなかったPrimsが格納されます。時には、これによって、大体的に“Include”を記述してから、“Exclude”を使って不要なPrimsを“除去”するといったことをします。
デフォルトでは、このノードは、ExcludeルールのUIを表示しません。 Add Exclusions を有効にすることで、Excludeする一連のPrimsを指定するためのパラメータが追加で表示されます。
パラメータ ¶
Create Primitive If Required
Primitive Path にPrimが存在しなかった場合、このノードは、そのPrimを作成します(このノードは、未定義のTypeを使ってPrimを作成します)。
Default Primitive Path
コレクションが作成されるデフォルトのPrimパス。 デフォルトでは、このパラメータは、各コレクションの個々の Primitive Path パラメータで参照されます。 このノード作成時にCollection Primitive Pathプリファレンスの値がこのパラメータの値に自動的に設定されます。
Number of Collections
作成または変更するコレクションの数。
Enable
このオプションを無効にすると、コレクションを定義したパラメータ値を消すことなく個々のコレクション編集を無効にすることができます。
Primitive Path
コレクションアトリビュートを作成するPrim。 このパラメータは空っぽのままにすることができます。その場合、USDコレクションは作成されません。
Collection Name
作成/編集するコレクションの名前。 このパラメータは空っぽのままにすることができます。その場合、USDコレクションは作成されません。
Add to Last Modified Primitives
このオプションを有効にすると、このノードの直近で修正した一連のPrimsにこのコレクションのメンバーを追加することができます。 この一連のPrimsは、USDステージ上に記録されませんが、下流のLOPノードでエクスプレッション関数またはHOMを使用してアクセスすることができます。 USDコレクションを作成しなかった場合であっても、直近で修正したPrimsは、これらのパラメータの影響を受けます。
Icon
Scene Graph Treeのcollectionsパネル内のコレクションに関連付けたいアイコンまたは画像ファイルのパス。 このアイコンパスは、コレクションのIncludeリレーションシップのカスタムデータ辞書に格納されます。
Expansion Rule
選択されたPrimsの子Primsをコレクションに包含させるかどうか。
No Expansion
(Exclude内に入っていない)Include内に入っているパスのみがコレクションに属します(explicitOnly
)。
Expand Primitives
(Exluce以下でない)Include以下のすべてのPrimsがコレクションに属します(expandPrims
)。
Expand Primitives and Properties
“Expand Primitives”と同様ですが、合致したすべてのPrims上のすべてのプロパティもIncludeします。
Pixarのドキュメントによると: “私どもは、これに関してどのような用途があるのか確信していませんが、これを使用することで、たくさんのUsdObjectを非常に簡潔に取り込むことができます。”"
Allow Instance Proxies in Collection
インスタンスプロキシは、インスタンス化可能Prims下にあるPrimsです。 インスタンスプロキシはインスタンス内にあるために編集不可なので、 通常では 、インスタンスプロキシをコレクションに追加するのは合理的ではありません。
しかし、マテリアルバインドなどの一部の場合においては、インスタンスプロキシPrimsを参照することができます。 このような制限された場合では、インスタンスプロキシPrimsをコレクションに格納できるのは便利です。 (インスタンス単位のマテリアルバインドは、現在のところ、レンダリングフレームワークで対応していませんが、いつか対応する予定です。)
Primitives
このノードを動作させるPrim(s)。
Scene Graph Tree ペインからPrim(s)をこのテキストボックスにドラッグすることで、それらのパスを追加することができます。
または、このテキストボックスの隣にある 再選択ボタンをクリックすることで、ビューア内でPrim(s)を選択することができます。
他にも、この再選択ボタンを⌃ Ctrlクリックすることで、ポップアップツリーウィンドウからPrim(s)を選択することができます。
コレクション内のすべてのPrimsのマッチング(/path/to/prim.collection:name
)といった高度なマッチングには、プリミティブパターンを使用すると良いでしょう。
Tip
標準プリミティブパターンだけでなく、このパラメータ内に特別なトークンの%self
を使用することで、このコレクションのIncludeリレーションシップの現行メンバー(が既に存在していれば)を指定することができます。
つまり、このパラメータ内に%self
だけを使用しても、たとえコレクションにExcludeが含まれていても、コレクションには何も変化がありません。
Set Exclusions
コレクションのExcludeリレーションシップのPrimsを指定するために、さらに1個のプリミティブパターンパラメータを表示します。 コンポジション時にUSDは、Includeリレーションシップ内のPrimsリストからExcludeリレーションシップのPrimsを除去して、最終的なコレクションの内容を取得します。 このオプションが無効な場合、コレクションのExcludeリレーションシップは、このノードでは変更されません。
Exclude Primitives
Primitives パラメータと同じ書式を使用して、コレクションから明示的に除外したい一連のPrimsを指定します。
Tip
標準プリミティブパターンだけでなく、このパラメータ内に特別なトークンの%self
を使用することで、このコレクションの現行メンバー(が既に存在していれば)を指定することができます。
つまり、このパラメータ内に%self
だけを使用しても、たとえコレクションにExcludeが含まれていても、コレクションには何も変化がありません。
Note
これは、既存のExcludeを考慮するので、 Primitives パラメータに%self
を使用した場合とで若干異なります。
このような若干異なる定義は、*
をIncludeして%self
をExcludeすることでコレクションのメンバーを反転させるのが簡単です。