| On this page |
このノードを使えば、アトリビュートをあるクラスから他のクラスに簡単に変換することができます。 例えば、色々なマージメソッドのどれかを使って、PointアトリビュートをPrimitiveアトリビュートに変換することができます。
indexアトリビュートに関しては、マージメソッドは、アトリビュートを文字列として扱います。 Average メソッドは平均を計算し、 Sum メソッドは連結を実行し、他の数値メソッドは、 First Match に並べ替えます。
複数コンポーネントを持つアトリビュート(例えば、ベクトルアトリビュート)に対しては、各マージは、各コンポーネントにそれぞれ実行されます。
Note
同じストリーム内のジオメトリ間でアトリビュートをコピーしたい時は、Attribute Promoteを使用します(入力が1本しかありません)。
2番目の入力のジオメトリ上のアトリビュートを1番目の入力のジオメトリ上にコピーしたい時は、
Attribute Transferを使用します。
パラメータ ¶
Original Name
ソースクラスのアトリビュートの名前。
例えば、Cdはカラーを拾います。
ここには、パターン(例えば*)やスペース区切りのアトリビュートのリスト(例えばCd pscale)を指定することもできます。
Original Class
これは、元のアトリビュートのクラスです。Point、Primitive、Detail、Vertexを設定することができます。
New Class
プロモート先のアトリビュートのクラス。 Piece Attribute が有効でない限り、 New Class には Original Class とは別のクラスを設定しないと、警告が発せられ、何も実行されません。
Piece Attribute
New Class のパーティションアトリビュートの名前。ここには、文字列または整数のタイプのアトリビュートを指定してください。 同じ値の各Point/Vertex/Primitiveアトリビュートが同じピースの一部と見なされます。 Promotion Method は、各ピースの該当する Original Class のエレメントを使って適用され、その結果が各ピースのエレメントすべてに書き出されます。 例えば、ポイントをプリミティブにプロモートさせると、 Promotion Method は、ピース内のプリミティブが参照しているポイントすべてに適用されます:
-
Original Class のエレメントは何回も含まれません(例えば、ポイントがピース内の複数のプリミティブから参照されている場合)。
-
Original Class のエレメントはインデックス順になります(例えば、 First Match は、ピースのプリミティブから参照されているポイントの内、最小ポイントインデックスのポイントの値を返します)。
-
ピースアトリビュートを使用した時、 Original Class は New Class と同じになります(例えば、これを利用することで、各ピースのアトリビュートの平均値を計算することができます)。
Promotion Method
新しいクラスの1個のエレメントに合致するアトリビュートがOriginal Classに2つ以上存在すれば、何かのメソッドを使って、新しい値を決めなければなりません。 例えば、PointアトリビュートからPrimitiveアトリビュートへ変換する場合、1個のポリゴンに相当するポイントがたくさんあります。
Maximum
一番大きい値を拾います。
Minimum
一番小さい値を拾います。
Average
平均値を取ります。
Mode
一番多い共通値を取ります。一番多い共通値が複数存在した場合は、最小の値を取ります。
Median
合致したエレメントの中間のエレメントの値を取ります。エレメントの数が偶数の場合は、その中間の2つのエレメントの内、高い値を取ります。
Sum
合致したエレメントの合計値。
Sum of Squares
合致したエレメントを二乗した合計値。
Root Mean Square
合致したエレメントを二乗した合計を平均して、それを平方根にした値。
First Match
プロモート先の1番目に相当するエレメントの値。つまり、ポイントをプリミティブにプロモートすると、プリミティブの1番目の頂点に相当するポイントの値を取ります。
Last Match
プロモート先の最後に相当するエレメントの値。つまり、ポイントをプリミティブにプロモートすると、プリミティブの最後の頂点に相当するポイントの値を取ります。
Array of All
ソースアトリビュートがタプルアトリビュートの場合、新しく配列アトリビュートが作成されます。 この配列アトリビュートには、合致したエレメントのすべての値が格納されます。
Change New Name
無効にすると、新しいアトリビュート名は、元のアトリビュート名と同じになります。
New Name
Change New Name を設定した時のアトリビュートの新しい名前。
ソースがパターンなら、この新しい名前は、同じ長さに拡張可能なパターンにしてください。
globスタイルの命名規則が使われるので、マッチングパターンをinstance*、新しい名前をmy*instanceにすると、
instancepointアトリビュート名がmypointinstanceアトリビュート名にプロモートされます。
Delete Original
有効にすると、元のアトリビュートがプロモートの後に削除されます。ただし、例えば、Vertexアトリビュートを同じ名前でPointアトリビュートにプロモートすると、元のアトリビュートは必ず削除されます。これを回避する場合は、プロモートする時にアトリビュートの名前を変更してください。
Examples ¶
AttribPromoteSphere Example for Attribute Promote geometry node
このサンプルでは、AttribPromote SOPを使って、ポイントとプリミティブ間でアトリビュートを転送(プロモート)する方法を説明しています。
| See also |
Attribute Rename
Attribute Create
