Houdini 20.0 ノード APEXノード

graph::AddNode

APEXグラフにノードを追加します。

On this page
Since 20.0

指定した namecallback を持つノードをAPEXグラフに追加します。 オプションで、このノードにさらにグラフ内の位置、カラー、このノードのポートのパラメータ、追加メタデータを設定することができます。 ノードのメタデータは、 properties という名前の辞書に格納したり、または、文字列配列の形式で tags として格納することができます。

Warning

name と同じ名前のノードが既に graph にある場合でも、その新しいノードが追加され、グラフ内に同じ名前のノードが2つ存在してしまいます。 これが原因で、ノードの検索やフィルタリングに問題が起きてしまいます。 同じ名前のノードが既にグラフ内にあるかどうか不明であれば、代わりにgraph::FindOrAddNodeを使用してください。

このノードの graph ポートはインプレースポートです。つまり、コピーを作成せずにグラフが更新されます。

入力

*graph: ApexGraphHandle Required

ノードが追加されるグラフ。

name: String

グラフに追加するノードの名前。

callback: String

グラフに追加するノードのタイプ名。

pos: Vector3

グラフレイアウト内の新しいノードの位置。

color: Vector3

新しいノードのカラー。

parms: Dict

ノードのポートに設定するパラメータ。 辞書エントリーのキー/値ペア:

  • キー: 新しいノード上のポート名

  • 値: そのポートのパラメータ値

tags: StringArray

新しいノードに関連付ける文字列値。 タグを使用することで、名前とは別でノードをフィルタリングすることができます。

properties: Dict

新しいノードのカスタムメタデータ辞書。

出力

*graph: ApexGraphHandle

ノードを追加して更新されたグラフ。

nodeid: ApexNodeID

新しく作成されたノードのノードID。 このIDは、グラフ内のノードの識別子です。

See also

APEXノード