Split Primitive

ジオメトリサブセットまたはPrimvar値に基づいてUSDジオメトリPrimsを子Primsに分割します。

On this page	概要パラメータ
Since	18.5

概要 ¶

このノードには、ジオメトリPrimからピースを“抽出”するためのメソッドが2つ用意されています:

特定のサブセットに属したフェースとそうでないフェースでPrimを分割します。
特定のPrimvarが同じ値のフェースでPrimをピースに分割します。

パラメータ ¶

Primitives

分割したいPrimsのUSDパスまたはそれらのパスをスペースで区切ったリスト。

Split Mode

Geometry Subset

特定のサブセット( Subset Attribute Name )内のエレメントとそうでないエレメントでPrim(s)を分割します。

Primvar

特定のPrimvar( Primvar Name )が同じ値のエレメントでPrim(s)をピースに分割します。

Subset Attribute Name

Split Mode が Geometry Subset の時に、Primsを分割するジオメトリサブセットアトリビュートの名前。

Primvar Name

Split Mode が Primvar の時に、Primsを分割するPrimvarの名前。

Import Frame

これは、LOPノードをクックしてステージをサンプリングするフレームです。アニメーションジオメトリを取り込む場合、これを$FFに設定すると良いでしょう。

Sublayer Style

Load As Reference が無効な場合にのみ利用可能です。デフォルトでは、SOPsから取り込まれたジオメトリは、ディスク上のファイルから取り込まれたジオメトリと同様に扱われます。つまり、強いオピニオンのレイヤをそのレイヤの上に適用しないとそのジオメトリを編集することができません。このパラメータを変更することで、このノードは、そのジオメトリを アクティブレイヤ に配置することができるので、このノードの出力に接続されたLOPノードでそのジオメトリを修正することができます。

このノードは、SOPジオメトリから生成された内容を匿名In-Memory USDレイヤにコピーすることで、これを行ないます。この方が遅くなりますが、ディスクに書き込む必要のあるUSDレイヤの数、各レイヤに取り込む内容の選択肢が増えます。これは、Load Layer for Editing LOPのオペレーションと同様です。

Copy SOP Layer Into New Active Layer スタイルは、SOPレイヤの内容のコピー先となる新しいアクティブレイヤを作成します。
Merge SOP Layer Into Existing Active Layer スタイルは、SOPレイヤの内容を入力ノードのアクティブレイヤにコピーするので、ステージ上に新しいレイヤは作成されません。

Note

Edit Layer Block内では、このパラメータは無効になり、 Merge SOP Layer Into Existing Active Layer が使用されます。

Primitive Definition

Enable NURBS Curves

有効にすると、SOPジオメトリをUSDに変換する際に NURBS Curves 設定が使用されます。無効にすると、(例えば、USD Configure SOPからの)usdconfignurbscurvesDetailアトリビュートがSOPジオメトリ上に存在しない限り、パラメータのデフォルト値が使用されます。

NURBS Curves

NURBSカーブプリミティブの扱い方。

Convert to Basis Curves

カーブをBasisCurvesプリミティブとして取り込みます。端点を補間する必要があるカーブの場合、wrapアトリビュートをpinnedに設定するのではなく、カーブの始点と終点に頂点が明示的に挿入されます。このメソッドは、以前のpinned設定されたカーブが一部のレンダーデリゲートでサポートされていなかったので、後方互換のために用意されています。

これは、3次カーブにしか対応していませんが、Hydraを介したレンダリングで役に立ちます。

Convert to Pinned Basis Curves

カーブをBasisCurvesプリミティブとして取り込みます。端点を補間する必要があるカーブの場合、カーブのwrapアトリビュートがpinnedに設定され、レンダリング時にポイントが暗黙的に挿入されます。

これは、3次カーブにしか対応していませんが、Hydraを介したレンダリングで役に立ちます。

Create NURBS Curves

カーブをNurbsCurvesプリミティブとして取り込みます。これは、NURBSカーブを完全に双方で変換できますが、Hydraを介したレンダリングに制限があります。

Enable NURBS Surfaces

有効にすると、SOPジオメトリをUSDに変換する際に NURBS Surfaces 設定が使用されます。無効にすると、(例えば、USD Configure SOPからの)usdconfignurbssurfsDetailアトリビュートがSOPジオメトリ上に存在しない限り、パラメータのデフォルト値が使用されます。

NURBS Surfaces

NURBSサーフェスプリミティブの扱い方。

Convert to Meshes

NURBSサーフェスをMesh Primとして取り込みます。これは、Hydraを介したレンダリングに役立ちます。

Create NURBS Patches

NURBSサーフェスをNurbsPatch Primとして取り込みます。これは、NURBSサーフェスの双方向変換に役立ちますが、Hydraを介したレンダリングで機能が制限されます。

Enable Kind Authoring

有効にすると、SOPジオメトリをUSDに変換する際に Kind Authoring 設定が使用されます。無効にすると、(例えば、USD Configure SOPからの)usdconfigkindschemaDetailアトリビュートがSOPジオメトリ上に存在しない限り、パラメータのデフォルト値が使用されます。

Kind Authoring

取り込んだプリミティブにKindを割り当てる方法。

All Geometry is One Component

取り込んだツリー内のルートプリミティブをComponentに設定します。子プリミティブにはKindを設定しません。

Nested Groups and Components

取り込んだツリー内のLeaf(末端)プリミティブをComponentに設定します。ブランチ(分岐)プリミティブをGroupに設定します。

Nested Assembly, Groups, and Components

取り込んだツリー内のルートプリミティブをAssemblyに設定します。中間のブランチプリミティブをGroupに設定します。LeafプリミティブをComponentに設定します。

None

取り込んだプリミティブにKindを設定しません。

Geometry Handling

以下のパラメータには、SOPジオメトリデータの解釈を変更するためのオプションが用意されています。

Enable Treat Polygons as Subdivision Surfaces

有効にすると、SOPジオメトリをUSDに変換する際に Treat Polygons as Subdivision Surfaces 設定が使用されます。無効にすると、(例えば、USD Configure SOPからの)usdconfigpolygonsassubdDetailアトリビュートがSOPジオメトリ上に存在しない限り、パラメータのデフォルト値が使用されます。

Treat Polygons as Subdivision Surfaces

サブディビジョンスキームのタグがまだ付けられていないポリゴンメッシュに対して、catmullClarkが設定されたsubdivisionSchemeアトリビュートを追加します。これによって、それらのポリゴンメッシュはサブディビジョンサーフェスに変換されるようになります。

Enable Subdivision Group

有効にすると、SOPジオメトリをUSDに変換する際に Subdivision Group 設定が使用されます。無効にすると、(例えば、USD Configure SOPからの)usdconfigsubdgroupDetailアトリビュートがSOPジオメトリ上に存在しない限り、パラメータのデフォルト値が使用されます。

Subdivision Group

Treat Polygons as Subdivision Surfaces が有効な場合、このプリミティブグループ内のポリゴンのみがサブディビジョンサーフェスに変換されます。

Enable Reverse Polygon Vertex Ordering

有効にすると、SOPジオメトリをUSDに変換する際に Reverse Polygon Vertex Ordering 設定が使用されます。無効にすると、(例えば、USD Configure SOPからの)usdconfigreversepolygonsDetailアトリビュートがSOPジオメトリ上に存在しない限り、パラメータのデフォルト値が使用されます。

Reverse Polygon Vertex Ordering

USDはポリゴンの頂点順が左手系なのか右手系なのかを示したメッシュプリミティブ上のorientationアトリビュートに対応しているのに対して、 SOPジオメトリは頂点順が常に左手系です。このオプションを有効にすると、インポーターは常に頂点順が右手系になるように頂点(と関連するPrimvar)を並べ替えます。

これは、右手系の向きのポリゴンをUSDからSOP、SOPからUSDに双方向に変換する時に役立ちます。データは、SOPに取り込む時には常に左手系の頂点順に変換されます。このオプションを使わないでポリゴンをUSDに戻した場合、そのUSDはオリジナルの右手系とは異なり左手系の頂点順のままになります。

Enable Set Missing Widths

有効にすると、SOPジオメトリをUSDに変換する際に Set Missing Widths 設定が使用されます。無効にすると、(例えば、USD Configure SOPからの)usdconfigsetmissingwidthsDetailアトリビュートがSOPジオメトリ上に存在しない限り、パラメータのデフォルト値が使用されます。

Set Missing Widths

USDは、CurvesとPointsの幅のフォールバック値として1.0の値を持ちます。たいていの場合、この値は必要な値よりも非常に太いです。 SOPジオメトリにwidth/pscaleデータが明示的に設定されていない場合、明示的にUSD値を設定する代わりに、このコントロールを使用することができます。

Import Data

以下のパラメータは、SOPジオメトリアトリビュートからUSDのアトリビュートとPrimvarへの変換に影響し、デフォルト値とタイムサンプル値のどちらで編集するのか選択することができます。

Author Time Samples

SOPから取り込まれた値を、それに呼応するUSDアトリビュートのデフォルト値として編集するのか、(タイムライン内の時間で)タイムサンプルとして編集するのか。

(USDシステムにアトリビュート値を照会すると、そのアトリビュート上にタイムサンプルが存在しなければデフォルト値を返します。タイムサンプルが存在すれば、そのタイムサンプルデータから補間された値を返します。)

If SOP is Time Dependent

ジオメトリ派生元のSOPノードが時間依存(アニメーションしたり、アニメーション値が含まれている)の場合、タイムサンプルを書き込みます。時間依存でない場合、デフォルト値を書き込みます。

If Not Specifically Excluded

Single Value Attributes パラメータでリストしたアトリビュート以外のアトリビュートに対してすべての値をタイムサンプルとして編集します。

Never

すべての値をデフォルト値として編集します。

(これは、USD Configure SOPを使用してジオメトリ上で事前に設定できないこのノード上の唯一のパラメータです。この理由は、ジオメトリに埋め込まれたアトリビュート値だけでなく“ライブ”のSOPを必要とするからです。)

Enable Set Default Primitive

有効にすると、SOPジオメトリをUSDに変換する際に Set Default Primitive 設定が使用されます。無効にすると、(例えば、USD Configure SOPからの)usdconfigsetdefaultprimDetailアトリビュートがSOPジオメトリ上に存在しない限り、パラメータのデフォルト値が使用されます。

Set Default Primitive

Import Path Prefix が存在する場合、インポートしたジオメトリを含んだレイヤに対してデフォルトプリミティブメタデータを作成します。デフォルトプリミティブは、その接頭辞パスのルート(例えば、接頭辞パスが/a/b/cの場合は/a)に設定されます。

Enable Topology Attributes

有効にすると、 SOPジオメトリをUSDに変換する際に Topology Attributes 設定が使用されます。無効にすると、(例えば、USD Configure SOPからの)usdconfigtopologyDetailアトリビュートがSOPジオメトリ上に存在しない限り、パラメータのデフォルト値が使用されます。

Topology Attributes

USDトポロジアトリビュートをタイムサンプル値またはデフォルト値のどちらで作成するのかを制御します。

以下のアトリビュートがトポロジアトリビュートとして扱われます:

プリミティブのタイプ	アトリビュート
`PointBased`	`orientation`
`Mesh`	`faceVertexCounts`、`faceVertexIndices`、サブディビジョン関連のアトリビュート
`TetMesh`	`tetVertexIndices`、`surfaceFaceVertexIndices`
`NurbsPatch`	`uKnots`、`vKnots`、`trimCurve`
`Curves`	`curveVertexCounts`
`BasisCurves`	`type`、`basis`、`wrap`
`NurbsCurves`	`orders`、`ranges`、`knots`
`PointInstancer`	`protoIndices`
`GeomSubset`	`indices`

Animated

ソースジオメトリのトポロジが時間軸で変化するのか分かっているのであれば、USDシーングラフ内でトポロジアトリビュートをタイムサンプルとして記録するこのオプションを選択してください。アニメーションするトポロジが含まれていると、再生するのに非常に負荷がかかってしまうので、このオプションは必要な時にだけ使用してください。

Static

トポロジアトリビュートをデフォルト値として書き込みます。これによって再生を非常に速くすることができますが、トポロジが時間軸で変化できなくなる制限がかかります。

None

トポロジアトリビュートを作成しません。

これは、USDデータをSOPsに送信して処理を加えて、それをLOPsに戻すのに役立ちます。このオプションを使用すると、このプロセスではジオメトリトポロジが変化しなかったとインポーターに伝わるので、変化のあったポイントポジションまたは他のPrimvarのみが取り込まれるようになります。

Enable Attributes

有効にすると、SOPジオメトリをUSDに変換する際に Attributes 設定が使用されます。無効にすると、(例えば、USD Configure SOPからの)usdconfigattribsDetailアトリビュートがSOPジオメトリ上に存在しない限り、パラメータのデフォルト値が使用されます。

Attributes

USDにPrimvarとして取り込みたいSOPアトリビュートを指定したスペース区切りのアトリビュート名/パターンのリスト。

アトリビュート名を直接マッチさせるだけでなく、特別な意味を持った値がいくつか用意されています:

bounds

関連するSOPジオメトリから計算された境界ボックスを使用して、USD extentアトリビュートを作成します。

visibility

usdvisibilityジオメトリアトリビュートの値に基づいて、USD visibilityアトリビュートを作成します。

インポーターが特定の共通Houdiniアトリビュートをそれに呼応するUSDアトリビュートにどのように変換するのかに関する情報は、アトリビュートのインポートを参照してください。

Enable Indexed Attributes

有効にすると、 SOPジオメトリをUSDに変換する際に Indexed Attributes 設定が使用されます。無効にすると、(例えば、USD Configure SOPからの)usdconfigindexattribsDetailアトリビュートがSOPジオメトリ上に存在しない限り、パラメータのデフォルト値が使用されます。

Indexed Attributes

USDにIndex Primvarとして取り込みたいSOPアトリビュートを指定したスペース区切りのアトリビュート名/パターンのリスト。アトリビュート名を直接マッチングさせるだけでなく、type:string値を使用して、任意のSOP文字列アトリビュートに対してマッチングを行なうこともできます。

SOPアトリビュートがこのパターンにマッチすると、インポーターは、Primvarをインデックス配列の値として作成します(つまり、primvars:‹name›に値の配列、primvars:‹name›:indicesにそれらの値のインデックスの配列が入ります)。

整数でも文字列でもないアトリビュートに対してIndex Primvarを用意するのは、処理に負荷がかかってしまいます。少数の固有な値を多数のコンポーネントにわたって使用することでストレージサイズを大幅に節約できそうな場合にのみIndex Primvarを使用してください。

Enable Import as Single Element Array

有効にすると、SOPジオメトリをUSDに変換する際に Import as Single Element Array 設定が使用されます。無効にすると、(例えば、USD Configure SOPからの)usdconfigconstantattribsDetailアトリビュートがSOPジオメトリ上に存在しない限り、パラメータのデフォルト値が使用されます。

Import as Single Element Array

SOPジオメトリアトリビュートがPoint/Primitive/Vertexアトリビュートのどれかに関係なく、USDにConstant補間(プリミティブ全体で1個の値を持つ配列)のPrimvarとして取り込みたいSOPアトリビュートを指定したスペース区切りのアトリビュート名/パターンのリスト。特定のUSDプリミティブに対して複数の値を選択できる場合、インポーターは、見つかった最初の値を選択します。

( Import as Single Value の代わりに)アトリビュートを単一要素配列として取り込むと、Primvarの型を変えずにそのPrimvarの補間を上書きすることができるので便利です。

Enable Import as Single Value

有効にすると、SOPジオメトリをUSDに変換する際に Import as Single Value 設定が使用されます。無効にすると、(例えば、USD Configure SOPからの)usdconfigscalarconstantattribsDetailアトリビュートがSOPジオメトリ上に存在しない限り、パラメータのデフォルト値が使用されます。

Import as Single Value

SOPジオメトリアトリビュートがPoint/Primitive/Vertexアトリビュートのどれかに関係なく、USDにConstant補間且つプリミティブ全体で単一値のPrimvarとして取り込みたいSOPアトリビュートを指定したスペース区切りのアトリビュート名/パターンのリスト。特定のUSDプリミティブに対して複数の値を選択できる場合、インポーターは、見つかった最初の値を選択します。

これは、Detailアトリビュートが取り込まれるデフォルトの挙動です。

これは、 Import as Single Element Array に似ていますが、Primvarの型が単一要素の配列ではなくスカラー値となります(例えば、vector3f[]ではなくvector3fとなります)。

Enable Boolean Attributes

有効にすると、SOPジオメトリをUSDに変換する際に Boolean Attributes 設定が使用されます。無効にすると、(例えば、USD Configure SOPからの)usdconfigboolattribsDetailアトリビュートがSOPジオメトリ上に存在しない限り、パラメータのデフォルト値が使用されます。

Boolean Attributes

bool型のPrimvarに変換したい整数SOPアトリビュートを指定したスペース区切りのアトリビュート名/パターンのリスト。

Enable Unsigned 32-bit Attributes

有効にすると、SOPジオメトリをUSDに変換する際に Unsigned 32-bit Attributes 設定が使用されます。無効にすると、(例えば、USD Configure SOPからの)usdconfiguintattribsDetailアトリビュートがSOPジオメトリ上に存在しない限り、パラメータのデフォルト値が使用されます。

Unsigned 32-bit Attributes

uint型のPrimvarに変換したい整数SOPアトリビュートを指定したスペース区切りのアトリビュート名/パターンのリスト。

Enable Unsigned 64-bit Attributes

有効にすると、SOPジオメトリをUSDに変換する際に Unsigned 64-bit Attributes 設定が使用されます。無効にすると、(例えば、USD Configure SOPからの)usdconfiguint64attribsDetailアトリビュートがSOPジオメトリ上に存在しない限り、パラメータのデフォルト値が使用されます。

Unsigned 64-bit Attributes

uint64型のPrimvarに変換したい整数SOPアトリビュートを指定したスペース区切りのアトリビュート名/パターンのリスト。

Enable Asset Path Attributes

有効にすると、SOPジオメトリをUSDに変換する際に Asset Path Attributes 設定が使用されます。無効にすると、(例えば、USD Configure SOPからの)usdconfigassetpathattribsDetailアトリビュートがSOPジオメトリ上に存在しない限り、パラメータのデフォルト値が使用されます。

Asset Path Attributes

asset型のPrimvarに変換したい文字列SOPアトリビュートを指定したスペース区切りのアトリビュート名/パターンのリスト。

Enable Set Default Values

有効にすると、SOPジオメトリをUSDに変換する際に Set Default Values 設定が使用されます。無効にすると、(例えば、USD Configure SOPからの)usdconfigstaticattribsDetailアトリビュートがSOPジオメトリ上に存在しない限り、パラメータのデフォルト値が使用されます。

Set Default Values

常にデフォルト値(タイムサンプルなし)としてUSD Primvarを作成したいSOPアトリビュートを指定したスペース区切りのアトリビュート名/パターンのリスト。ここには、 Author Time Samples を If Not Specifically Excluded に設定した場合のその除外アトリビュートのリストを指定します。

Enable Subset Attributes

有効にすると、SOPジオメトリをUSDに変換する際に Subset Attributes 設定が使用されます。無効にすると、(例えば、USD Configure SOPからの)usdconfigpartitionattribsDetailアトリビュートがSOPジオメトリ上に存在しない限り、パラメータのデフォルト値が使用されます。

Subset Attributes

ジオメトリのサブセットを表現したSOP文字列/整数アトリビュートを指定したスペース区切りのアトリビュート名/パターンのリスト。インポーターは、このアトリビュートが同じ値のエレメントを自身のジオメトリサブセットに格納します。

各アトリビュートのサブセットは、(元のアトリビュート名に由来した)サブセットファミリーに追加されます。これは、それらのサブセット同士が関連していることを意味します。

そのサブセットファミリーのタイプは、partitionに設定されます。これは、それらのサブセットが互いに交差せず、プリミティブのすべてのエレメントがサブセット内に含まれていることを意味します。

空っぽの文字列値を持つエレメント(サブセットに追加されていないエレメント)が存在した場合、そのファミリータイプは代わりにnonOverlappingに設定されます。これは、それらのサブセットが互いに交差しないものの、一部のエレメントがサブセット内に含まれていないことを意味します。ファミリーのタイプは、親プリミティブ上のアトリビュート(例えば、subsetFamily:shop_materialpath:familyType)として作成されます。

サブセットは、SOPメッシュ、カーブ、四面体、ポイント上のパーティション用Point/Primitiveアトリビュートから作成することができます。

インポーターは、サブセット名をアトリビュート値に設定することを試みますが、その名前を有効なUSDプリミティブ名に変更する必要性が出てきます。インポーターは、ジオメトリサブセットPrim上のそのままのアトリビュート値をpartitionValueキーを持つCustom Dataとして格納します。

Enable Prefix Subsets with Attribute Name

有効にすると、 SOPジオメトリをUSDに変換する際に Prefix Subsets with Attribute Name 設定が使用されます。無効にすると、(例えば、USD Configure SOPからの)usdconfigprefixpartitionsubsetsDetailアトリビュートがSOPジオメトリ上に存在しない限り、パラメータのデフォルト値が使用されます。

Prefix Subsets with Attribute Name

Subset Attributes からサブセットを作成する時、それらのサブセットの名前は、アトリビュート名とパーティションアトリビュート値(文字列または整数)を組み合わせた名前になります。これによって、複数のパーティションアトリビュートに同じ値が含まれている時に名前の干渉が回避されますが、サブセット名を正確に制御したい場合には望ましい名前が得られない場合があります。文字列アトリビュートの場合、このオプションを無効にすると、アトリビュート値が直接サブセット名として使用されます。

Enable Subset Groups

有効にすると、SOPジオメトリをUSDに変換する際に Subset Groups 設定が使用されます。無効にすると、(例えば、USD Configure SOPからの)usdconfigsubsetgroupsDetailアトリビュートがSOPジオメトリ上に存在しない限り、パラメータのデフォルト値が使用されます。

Subset Groups

SOPグループを指定したスペース区切りのグループ名/パターンのリスト。各グループ内のSOPエレメントは、そのグループの名前でジオメトリサブセットとして取り込まれます。

サブセットは、SOPメッシュ、カーブ、四面体、ポイント上のポイント/プリミティブグループから作成することができます。

Enable USD Custom Attributes

有効にすると、SOPジオメトリをUSDに変換する際に USD Custom Attributes 設定が使用されます。無効にすると、(例えば、USD Configure SOPからの)usdconfigcustomattribsDetailアトリビュートがSOPジオメトリ上に存在しない限り、パラメータのデフォルト値が使用されます。

USD Custom Attributes

USDに(Primvarではなく)アトリビュートとして取り込みたいSOPアトリビュートを指定したスペース区切りのアトリビュート名/パターンのリスト。

Enable Translate UV Attribute to ST

有効にすると、SOPジオメトリをUSDに変換する際に Translate UV Attribute to ST 設定が使用されます。無効にすると、(例えば、USD Configure SOPからの)usdconfigtranslateuvtostDetailアトリビュートがSOPジオメトリ上に存在しない限り、パラメータのデフォルト値が使用されます。

Translate UV Attribute to ST

有効にすると、uvSOP頂点アトリビュートをprimvars:stUSD Primvarに変換します。これを有効にする必要があるかどうかは、あなたが使用しているレンダラーとシェーダの作り方で決まります。 Karmaでレンダリングする場合は、これを無効のままにしてください。

(これを書いた時点では、USDでのテクスチャ座標の命名に厳格な基準はありませんが、stを使用するのが一般的な慣例であるのに対して、SOPジオメトリではuvを使用するのが一般的な慣例です。)