%ancestors(<node_path>, [inclusive, traverse])

<node_path>で指定したノードの祖先であるグラフノードを検索します。

inclusiveオプションは、返されるノードのリストに<node_path>のノードも含めます。例えば、%ancestors(trs_output, inclusive)は、trs_outputの祖先に加え、trs_output自体も返します。

traverseオプションは、サブネットおよびテンプレート内の祖先を含む、<node_path>の祖先を返します。

短縮形だと、inclusiveオプションにはi、traverseオプションにはt、両方にはitを使用することができます。

例:

• %ancestors(<node>)

• %ancestors(<node>, inclusive)

• %ancestors(<node>, traverse)

• %ancestors(<node>, inclusive, traverse)

• %ancestors(<node>, traverse, inclusive)

• %ancestors(<node>, i, t)

• %ancestors(<node>, it)

%callback(<callback_name>)

コールバックとは、APEXグラフノードのタイプです(例: graph::AddNode)。%callbackは、コールバック名<callback_name>と一致するすべてのサブネットレベルのグラフノードを検索します。コールバック名は、ノード上のcallbackアトリビュートに格納されています。

<callback_name>にはワイルドカードを指定することができます(%callback(graph*)など)。

%descendants(<node_path>, [inclusive, traverse])

<node_path>で指定したノードの子孫であるグラフノードを検索します。

inclusiveオプションは、返されるノードのリストに<node_path>のノードも含めます。例えば、%descendants(trs_output, inclusive)は、trs_outputの子孫に加え、trs_output自体も返します。

traverseオプションは、サブネットおよびテンプレート内の子孫を含む、<node_path>の子孫を返します。

短縮形だと、inclusiveオプションにはi、traverseオプションにはt、両方にはitを使用することができます。

例:

• %descendants(<node>)

• %descendants(<node>, inclusive)

• %descendants(<node>, traverse)

• %descendants(<node>, inclusive, traverse)

• %descendants(<node>, traverse, inclusive)

• %descendants(<node>, i, t)

• %descendants(<node>, it)

%isconnected()

コネクションを持つノード/ポートを検索します。ポートのいずれかが接続されている場合、そのノードは接続されているとみなされます。

%ispromoted()

入力または出力としてプロモートされる(グラフの入力/出力ノードに接続されている)ノードを検索します。また、トップレベルのグラフ入力/出力ノードまで遡ってプロモートされる、ネスト化されたサブネット内のノードも検索します。

%properties(<property_name>, [<value>])

プロパティは、ノード上のproperties辞書アトリビュートに格納されています。%properties関数は、<property_name>と一致するキーを持つエントリがproperties辞書アトリビュートに含まれているすべてのノードを検索します。

プロパティの値は、オプションの2つ目の引数として指定することができます。

%tag(<tag_name>)

タグは、ノード上のtag文字列配列アトリビュートに格納されています。%tag関数は、タグ<tag_name>を含んでいるすべてのサブネットレベルのノードを検索します。

<tag_name>内にはワイルドカードを指定することができます(%tag(left_*)など)。

<tag_name>内では複数のエントリを指定することができ、各エントリはカンマまたはスペースで区切られます。例えば、%tag(<tag1>, <tag2> <tag3>)は<tag1>、<tag2>、<tag3>のタグを持つすべてのノードと一致します。

#<tag_name>

%tag関数に加えて、#leftのようにタグ名の前に“#”を付けることで、タグをフィルタリングすることも可能です。

<tag_name>にはワイルドカードを指定することができます(#left_*など)。

%tagと異なり、#<tag_name>の<tag_name>にスペースを含めることはできません。

%isconnected()

接続されているポートを検索します。

%ispromoted()

入力または出力としてプロモートされる(グラフの入力または出力ノードに接続されている)ポートを検索します。また、トップレベルのグラフ入力/出力ノードまで遡ってプロモートされる、ネスト化されたサブネット内のポートも検索します。

%tag(<tag_name>)

タグは、ノード上のtag文字列配列アトリビュートに格納されています。%tag関数は、タグ<tag_name>を含んでいるすべてのサブネットレベルのポートを検索します。

ポートタグは、グラフノード上に<port>:<tag>の形式で格納されています。%tagを使用してポートを検索する場合、ポート名なしでタグ名だけを指定してください。例えば、%tag(r:xyz)ではなくて%tag(xyz)を使用します。

<tag_name>内にはワイルドカードを指定することができます(%tag(left_*)など)。

<tag_name>内では複数のエントリを指定することができ、各エントリはカンマまたはスペースで区切られます。例えば、%tag(<tag1>, <tag2> <tag3>)は<tag1>、<tag2>、<tag3>のタグを持つすべてのノードと一致します。

#<tag_name>

%tag関数に加えて、#leftのようにタグ名の前に“#”を付けることで、タグをフィルタリングすることも可能です。

<tag_name>にはワイルドカードを指定することができます(#left_*など)。

%tagと異なり、#<tag_name>の<tag_name>にスペースを含めることはできません。

%valuetype(<type_name>)

値の型が<type_name>(%valuetype(Vector3)など)であるポートを検索します。

<type_name>内にはワイルドカードを指定することができます(%valuetype(Vector*)など)。