Geometry Import TOP node

SOPまたはジオメトリファイルのポイントまたはプリミティブをワークアイテムアトリビュートまたは一時ファイルに読み込みます。

On this page	Top_attributes パラメータ Examples
Since	17.5

このノードは以下のことができます:

SOPまたはジオメトリファイルからポイント、頂点、プリミティブを抽出して、それらをワークアイテムに変換し、それらのSOPアトリビュートをワークアイテムアトリビュートに変換することができます。

例えば、このノードでファイルからポイントまたはカーブを抽出して、それらを使って並列シミュレーションを生成することができます。
SOPまたはジオメトリファイルからポイント、プリミティブ、境界ボックスを抽出して、それらをディスク上の別々のファイルに保存することができます。
SOPまたはジオメトリファイルからジオメトリ全体を読み込んで、それをHoudiniのネイティブフォーマットでワークアイテムに格納することができます。

現在のところ、このように格納されたジオメトリに対して操作可能な唯一のノードはInvoke TOPです。しかし、他のノード内のワークアイテムもジオメトリデータを渡すことができます。
SOPネットワークをクックして、その出力ジオメトリをディスクに保存することができます。

Note

このノードでできる事は、パラメータ設定次第で大きく変わります。

このノードの重要なパラメータは、 Geometry Source (ジオメトリの読み込み元)、 Store Geometry As (ジオメトリをディスクに書き出す場所)、 Class (作用させる内容)です。

デフォルトでは、このノードは、ワークアイテムを生成する度にそのジオメトリを読み込みます(ネットワークに静的なワークアイテムを生成するように指定した時も含む)。ネットワーク内で生成されたファイルをすぐに読み込みたい場合は、 Load Geometry During Cook を有効にしてください。

Tip

Geometry Import TOPノードの使用方法に関するTipsは、PDG GeoImport Surface Operatorのチュートリアルを見てください。

Tip

$HH/help/files/pdg_examples/top_invokeと$HH/help/files/pdg_examples/top_sopのサンプルでは、このノードを使用して、SOPネットワークからデータを読み込む方法について説明しています。

TOP Attributes ¶

Geometry Import TOP は、 Copy Attributes パラメータで指定したアトリビュートに基づいてワークアイテム上にアトリビュートを作成します。さらに、インポートしたジオメトリの Copy From Class に基づいて他のアトリビュートもいくつか作成します。

`sopname`	string	SOPノードからジオメトリを読み込むと、このアトリビュートにはそのノードの名前が設定されます。
`soppath`	string	SOPノードからジオメトリを読み込むと、このアトリビュートにはそのSOPのフルパスが設定されます。
`*attribs`	string array	エレメントタイプ毎にアトリビュート名の文字列配列が作成されます: `pointattribs`, `vertexattribs`, `primitiveattribs`, `detailattribs`。ジオメトリがDetailとして読み込まれると、すべての4つのアトリビュートが作成され、そうでない場合は、指定した Copy From Class のアトリビュートのみが作成されます。 All Groups または Specified Group を使ってワークアイテムを作成すると、グループのエレメントのアトリビュートのリストが含まれた`<groupname>attribs`アトリビュートが作成されます。
`groupname`	string	特定のグループからジオメトリエレメントを読み込むと、このアトリビュートにはそのグループの名前が設定されます。
`groupsize`	integer	All Groups または Specified Group からワークアイテムを作成した時、このアトリビュートにはそのグループのサイズが設定されます。
`*offset`	integer	ポイント、頂点、プリミティブを読み込んだ時、このノードは、ソースジオメトリ内のエレメントを識別した`pointoffset`、`vertexoffset`、`primitiveoffset`のアトリビュートを作成します。
`*number`	integer	ピース、ポイント、頂点、プリミティブを読み込んだ時、このノードは、ソースジオメトリ内のエレメントを識別した`piecenumber`、`pointnumber`、`vertexnumber`、`primitivenumber`のアトリビュートを作成します。
`point*`	float array	Include Points from Primitives パラメータを有効にしてプリミティブを読み込むと、そのプリミティブ内のポイント毎にfloat配列アトリビュートが作成されます。
`primitive`	string	Include Points from Primitives パラメータを有効にしてプリミティブを読み込むと、プリミティブ座標のフルリストが入った文字列パラメータが作成されます。
`pointcount`	integer	プリミティブを読み込むと、このアトリビュートには、そのプリミティブ内のポイント数が設定されます。
`numpoints`	integer	ジオメトリをフルディテールで読み込むと、このアトリビュートには、そのジオメトリ内のポイント数が設定されます。
`numvertices`	integer	ジオメトリをフルディテールで読み込むと、このアトリビュートには、そのジオメトリ内の頂点数が設定されます。
`numprimitives`	integer	ジオメトリをフルディテールで読み込むと、このアトリビュートには、そのジオメトリ内のプリミティブ数が設定されます。
`minbounds`	float array	Copy From Class パラメータを Bounds に設定すると、このアトリビュートには、そのジオメトリ境界の最小X,Y,Z値が設定されます。
`maxbounds`	float array	Copy From Class パラメータを Bounds に設定すると、このアトリビュートには、そのジオメトリ境界の最大X,Y,Z値が設定されます。
`piececount`	integer	Create Work Item For パラメータを Piece Attribute Values に設定すると、このアトリビュートには、そのPieceアトリビュート値の総数が入ります。
`piecesize`	integer	Create Work Item For パラメータを Piece Attribute Values に設定すると、このアトリビュートには、そのピース内の指定した Copy From Class のエレメントの数が入ります。
`piecevalue`	integer/string	このアトリビュート値は、 Piece Attribute パラメータで指定したPieceアトリビュートが整数または文字列のどちらかに応じて異なります。
`piecename`	string	Create Work Item For パラメータを Piece Attribute Values に設定すると、このアトリビュートには、 Piece Attribute パラメータで指定したPieceアトリビュートの名前が入ります。

パラメータ ¶

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 が設定されます。

Source

Geometry Source

ジオメトリの読み込み元を決めます。

SOP Node

現行HIPファイル内のSOPノードのパスを指定することができます。このTOPノードは、そのSOPノードをクックして、その出力ジオメトリを格納します。

Note

Evaluation Time パラメータを使用することで、タイムラインの別の時間でSOPノードをクックすることができます。

Upstream Output File(s)

入力のワークアイテムのoutputアトリビュートからファイルパスを取得して、そのファイルをジオメトリとして読み込みます。ファイルは File Tag パラメータを使ってフィルタリングすることができます。同じタグで複数のファイルが見つかった場合、 Multiple Inputs パラメータでインポートするファイルを決めます。

例えば、これは、 File Pattern TOPノードを使ってジオメトリファイルを表現したワークアイテムを生成してからそれらのジオメトリをこのノードに読み込みたい時に役立ちます。

Upstream Geometry Attribute

入力のワークアイテムのアトリビュートからジオメトリデータを取得します。例えば、これは、前のGeometry Import TOPノードで読み込まれたジオメトリデータが存在している時に役立ちます。

Custom File Path

File Path ファイルディレクトリに存在するファイルからジオメトリデータを読み込みます。

SOP Path

クックするSOPノードのネットワークパス。例えば、/obj/geo1/output1。

このパラメータは、 Geometry Source が SOP Node に設定されている場合にのみ利用可能です。

Evaluation Time

SOPをクックする時間(秒)を決めます。

このパラメータは、 Geometry Source が SOP Node に設定されている場合にのみ利用可能です。

Work Item Frame

上流のワークアイテムで指定されたフレーム値でSOPが評価されます。

Custom Time

Custom Time 値でSOPが評価されます。

Network Evaluation Time

TOPネットワークがクックを開始した時に設定されていたHoudiniプレイバー時間でSOPが評価されます。

Custom Time

ターゲットのSOPノードが評価される時間を指定します。

このパラメータは、 Evaluation Time が Custom Time に設定されている場合にのみ利用可能です。

Evaluate with Work Item Attributes

SOPネットワークが(例えばWedgeを行なうために)@attributeエクスプレッションを使ってワークアイテムから値をPullしている場合には、これを有効にしてください。 @attributeエクスプレッションを使用した場合、このノードはワークアイテム毎に別々にSOPをクックする必要があります。 @attributeエクスプレッションを使用 しなかった 場合、このノードはそのSOPを1度だけクックする必要があります。

このパラメータは、 Geometry Source が SOP Node に設定されている場合にのみ利用可能です。

Reload File Nodes

When Evaluate with Work Item Attributes is enabled, this parameter indicates whether or not file nodes should be forced to reload for each evaluating work item.

File Tag

このファイルタグが付けられたファイルパスのみから読み込みます。例えば、file/geo。

このパラメータは、 Geometry Source が Upstream Output File に設定されている場合にのみ利用可能です。

Attribute Name(s)

ジオメトリデータを含んだ上流のワークアイテム上のアトリビュートの名前を指定します。これは、ジオメトリアトリビュートを参照します。アトリビュートのパターン構文を使用することで、複数のジオメトリアトリビュート名を指定することができます。このアトリビュートのパターン構文は、 Merge Operation パラメータが入力ジオメトリをマージするように設定されている時に使用します。

このパラメータは、 Geometry Source が Upstream Geometry Data に設定されている場合にのみ利用可能です。

File Path

インポートするジオメトリファイルのファイルパス。

このパラメータは、 Geometry Source が Custom File Path に設定されている場合にのみ利用可能です。

Load Geometry During Cook

有効にすると、ワークアイテム生成時ではなくて、各ワークアイテムがクックされる度にジオメトリを読み込みます。これは、上流のワークアイテムがクックされた時に生成されたジオメトリを読み込みたい場合や読み込むジオメトリファイルが膨大にある場合に役立ちます。

このパラメータは、 Geometry Source が SOP Node に設定されている時は利用不可です。

Merge Operation

上流のワークアイテムがジオメトリソースを複数持っている場合の挙動を決めます。 Geometry Source パラメータが Upstream Output Files に設定されている場合、以下のオプションを使用してそれらのジオメトリファイルをマージすることができます。同様に、 Geometry Source パラメータが Upstream Geometry Attribute に設定、且つ、 Attribute Name(s) パラメータにパターンが設定されている場合、そのジオメトリをマージするかどうか選択することができます。

Import First Geometry

最初の有効なジオメトリソースが取り込まれ、他のジオメトリソースは無視されます。

Import and Merge All Files

Geometry Source が Upstream Output Files に設定されている場合、合致したすべてのファイルがマージされ、1つのジオメトリとして取り込まれます。 Geometry Source が Upstream Geometry Attribute に設定、且つ、入力ワークアイテムがパーティションだった場合、そのパーティション内の各ワークアイテムのジオメトリがマージされて取り込まれます。

Expand Partitions

このパラメータが有効、且つ、上流のワークアイテムがパーティションだった場合、そのパーティション内の各ワークアイテムからジオメトリがマージされます。それ以外の場合、そのパーティション自体のアトリビュートとファイルのみがマージされます。

Create Merge Attribute

取り込んだ各ファイルのジオメトリ上にアトリビュートを作成します。このアトリビュート値には、入力リスト内のそのファイルのインデックスが設定されます。

例えば、3つのファイルを取り込むと、1番目のファイルのジオメトリのアトリビュート値には0、2番目のファイルには1、3番目のファイルには2が設定されます。

このパラメータは、 Multiple Inputs が Import and Merge All Files に設定されている場合にのみ利用可能です。

None

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

Point

取り込まれたジオメトリ上にPointアトリビュートを作成します。

Primitive

取り込まれたジオメトリ上にPrimitiveアトリビュートを作成します。

Merge Attribute Type

このノードがMergeアトリビュートを整数または文字列のどちらで作成するべきかを指定します。

Integer

アトリビュート値には、ファイルインデックスが設定されます。

String

アトリビュート値には、ジオメトリの読み込み元のファイルパスが設定されます。

Merge Attribute Name

作成するアトリビュートの名前を指定します。

このパラメータは、 Create Merge Attribute が Point または Primitive に設定されている場合にのみ利用可能です。

Storage

Store Geometry As

読み込んだジオメトリデータの格納場所。

None

ジオメトリから情報を抽出し、その情報をワークアイテムアトリビュートとして格納しますが、ディスク上に実際のジオメトリデータを 格納しません 。

External File

読み込んだジオメトリデータをディスク上のファイルに書き出します。

Geometry Attribute

ネイティブHoudiniジオメトリをワークアイテム上のジオメトリアトリビュートとして格納します。

現在のところ、このように格納されたジオメトリに対して操作可能な唯一のノードはInvoke TOPノードまたは他のGeometry Import TOPノードです。

External File Path

ジオメトリデータの書き出し先のファイルパス。このファイルパスは、ワークアイテムのoutputファイルとして設定されます。

このパラメータは、 Store Geometry As が External File に設定されている場合にのみ利用可能です。

External File Tag

outputファイルに適用するファイルタグ。

このパラメータは、 Store Geometry As が External File に設定されている場合にのみ利用可能です。

Attribute Name

ジオメトリの格納先となるアトリビュートの名前。

このパラメータは、 Store Geometry As が Geometry Attribute に設定されている場合にのみ利用可能です。

Data Extraction

Set Item Index To

ワークアイテムのインデックスを設定する方法を決めます。

Element Index

ジオメトリ内のエレメント(ポイント、頂点、プリミティブ)毎に 新しく ワークアイテムを生成するように設定するために、各ワークアイテムのindexにそのエレメント番号を設定します。

Upstream Item Index

各ワークアイテムのindexに上流のワークアイテムのindexを設定します。

入力のワークアイテム毎に 複数の ワークアイテムを生成するように設定するために、これは重複したindex値を生成します。

Flatten Indices

Set Item Index To が Element Index に設定されている場合、このパラメータは、エレメント番号から生成されたワークアイテムインデックスを平坦化するかどうかを決めます。このパラメータを有効にすると、このノード内のインデックスは、すべてのワークアイテムにおいて固有であることが保証されます。無効にすると、このノードが同じ入力ジオメトリから複数のコピーを取り込むように設定されている場合に、ワークアイテムが同じインデックスを持つことができます。

例えば、このパラメータは、Wedgeを使用して異なるアトリビュートバリエーションで同じSOPネットワークを取り込む時に役立ちます。

Copy From Class

読み込んだジオメトリからワークアイテムを生成する方法を決めます。デフォルトでは、このノードはジオメトリエレメント(またはジオメトリ全体のDetailアトリビュート)のアトリビュートをそのワークアイテムにコピーします。

Tip

Houdiniジオメトリの概要に関しては、ジオメトリを参照してください。

Point

読み込んだジオメトリ内のポイント毎に1個のワークアイテムを生成します。

Vertex

読み込んだジオメトリ内の頂点毎に1個のワークアイテムを生成します。

Primitive

読み込んだジオメトリ内のプリミティブ毎に1個のワークアイテムを生成します。

Detail

ジオメトリ全体で1個のワークアイテムを生成します。

Bounding Box

ジオメトリ全体の境界ボックスデータのみを持った1個のワークアイテムを生成します。

Copy Attributes

有効にすると、このノードは読み込んだジオメトリエレメントのアトリビュート(Point/Vertex/Primitive/Detailアトリビュート)をそれに該当するワークアイテムにコピーします。テキストフィールドにスペース区切りでパターンのリストを入力することで、コピーしたいアトリビュートを指定することができます。デフォルトでは、このノードはすべてのアトリビュート(*)をコピーします。

このパラメータは、 Copy From Class が Bounding Box に設定されている時は 利用不可 です。

Tip

アトリビュートのパターンの記述方法については、アトリビュートのパターン構文のドキュメントを参照してください。

Include Bounding Box

有効にすると、各ワークアイテム上に該当するジオメトリエレメントの境界ボックスを含んだminboundsとmaxboundsのアトリビュートを作成します。

このパラメータは、 Copy From Class が Bounding Box に設定されている時は 利用不可 です。

Include Points from Primitives

有効にすると、各ワークアイテム上にプリミティブのポイントの位置を含んだアトリビュートを作成します。

このパラメータは、 Copy From Class が Primitive に設定されている場合にのみ利用可能です。

Create Work Item For

このノードで取り込まれたジオメトリからワークアイテムを生成する方法を決めます。

このパラメータは、 Copy From Class が Point 、 Vertex 、 Primitive のどれかに設定されている場合にのみ利用可能です。

All Groups

ジオメトリエレメント毎にワークアイテムを生成するのではなくて、 グループ 毎にワークアイテムを生成します。

Specified group

Group フィールドで指定したグループ(s)から1個のワークアイテムを生成します。

Elements in Specified Group

Group フィールドで指定したグループ(s)内のエレメント毎にワークアイテムを生成します。

Group フィールドを空っぽにすると、グループに関係なくエレメント毎にワークアイテムを生成します。これが Create Work Item For のデフォルトの挙動です。

Each Piece Attribute Value

Piece Attribute フィールドで指定された値別にワークアイテムを生成します。 Piece Attribute は、文字列アトリビュートまたは整数アトリビュートのどちらかの名前しか対応していません。

Each Element

ジオメトリ内のエレメント毎にワークアイテムを生成します。このエレメントタイプは、 Copy From Class パラメータで決まります。

Group

スペース区切りでグループ名/パターンのリストを指定します。

このパラメータは、 Create Work Item For が Specified Group または Elements in Specified Group に設定されている場合にのみ利用可能です。

Piece Attribute

使用するPieceアトリビュートの名前を指定します。

このパラメータは、 Create Work Item For が Piece Attribute Values に設定されている場合にのみ利用可能です。

Edit Geometry

Add Attributes

有効にすると、このノードは、このパラメータのパターンを使用して、ワークアイテムのアトリビュートを、取り込んだジオメトリにコピーします。

例えば、Pointアトリビュートを取り込んだ場合、それらのワークアイテムアトリビュートはジオメトリ上のPointアトリビュートとして生成されます。

テキストフィールドにスペース区切りでパターンのリストを入力することで、コピーしたいアトリビュートを指定することができます。

Tip

アトリビュートのパターンの記述方法については、アトリビュートのパターン構文のドキュメントを参照してください。

このパラメータは、主にInvoke TOPなどのノードと組み合わせて使用します。このノードは、ワークアイテム上のジオメトリに対して コンパイルブロック SOPネットワークを評価します。 Invokeされた(呼び出された)ネットワークは@変数を使用することができないので、PDGワークアイテムの情報をそのSOPネットワークに渡すのは少し難しいことに注意してください。しかし、 Add Attributes はワークアイテムのデータをInvoke TOPノードで使用されているジオメトリにコピーすることができるので、そのSOPネットワークにアクセスすることはできます。

Schedulers

TOP Scheduler Override

このパラメータは、このノードのTOPスケジューラを上書きします。

Schedule When

有効にすると、このパラメータを使用して、このノードのどのワークアイテムをスケジュールに組むのかを決めるエクスプレッションを指定することができます。そのエクスプレッションが指定されたワークアイテムに対して0を返すと、そのワークアイテムはスケジューラに組まれずに、即座にクック済みとしてマークされます。そのエクスプレッションが0以外の値を返すと、そのワークアイテムは従来どおりにスケジュールに組まれます。

Work Item Label

このノードがワークアイテムにどのようにラベルを付けるのかを決めます。このパラメータによって、固有でないラベル文字列をワークアイテムに割り当てることができ、そのラベルを使用してアトリビュートパネル、タスクバー、スケジューラジョブ名のワークアイテムを区別することができます。

Use Default Label

このノード内のワークアイテムは、TOPネットワークからデフォルトのラベルを使用します。デフォルトが設定されていない場合は、それらのワークアイテムにはラベルは付きません。

Inherit From Upstream Item

ワークアイテムは親ワークアイテムのラベルを継承します。

Custom Expression

ワークアイテム毎に評価される Label Expression カスタムエクスプレッションをワークアイテムのラベルに設定します。

Node Defines Label

ワークアイテムのラベルをこのノードの内部ロジックで定義します。

Label Expression

有効にすると、このパラメータを使用して、このノードで作成されたワークアイテムに独自のラベルを指定することができます。このパラメータには、ワークアイテムアトリビュートの参照またはビルトインのプロパティを含めたエクスプレッションを使用することができます。例えば、$OS: @pdg_frameは、フレーム値に基づいて各ワークアイテムのラベルを設定します。

Work Item Priority

このパラメータは、現行スケジューラがこのノード内のワークアイテムの優先度を設定する方法を決めます。

Inherit From Upstream Item

ワークアイテムは、親ワークアイテムの優先度を継承します。ワークアイテムに親ワークアイテムがなければ、その優先度は0に設定されます。

Custom Expression

ワークアイテムの優先度は、 Priority Expression の値に設定されます。

Node Defines Priority

ワークアイテムの優先度は、このノード自身の内部優先度計算に基づいて設定されます。

このオプションは、 Python Processor TOP, ROP Fetch TOP, ROP Output TOPのノードでのみ利用可能です。これらのノードは、各自のノードロジックで実装された優先度設定スキームを定義しています。