ノードファインダー
ノードファインダーツールを使用すると、テキストクエリを使用して ノードおよび変数の検索 を実行できます。 クエリに一致しないすべてのノードがグレー表示され、結果が表示されなくなります。
クエリは次のいずれかの条件に一致します。
- インスタンス化によって参照されているグラフの識別子
- ノードパラメーター関数で使用される表示されるパラメーターまたは変数の識別子
- ノードのUID (一意の識別子)
- ノードのラベル
検索はグラフインスタンスを繰り返しトラバースできるため、ノードおよび変数をサブグラフ全体で検索できます。 検索する用語が正確にわからない場合は、あいまいな検索オプションを使用してクエリに許容値を適用できます。
インターフェイス
ノード・ファインダには、次の2つの方法でアクセスできます。
グラフビューで、Ctrl+F (Windows) / Cmd+F (macOS)を押してNode Finderツールバーを表示し、クエリフィールドに自動フォーカスを設定します。 これにより、すばやく検索を実行できます。
グラフビューツールバーで、
トラバースグラフを検索します。 つまり、次の操作でグラフを開くと、検索がアクティブなままになります。
- インスタンス化:コンテキスト内の参照を開く(Ctrl+E / Cmd+E) (注:コンテキスト内のグラフ編集は、編集/環境設定/グラフで有効にする必要があります)
- ピクセルプロセッサー:機能を編集(Ctrl+E/Cmd+E)
- バリュープロセッサー:機能を編集(Ctrl+E/Cmd+E)
- FX-Map:FX-Mapグラフを編集(Ctrl+E/Cmd+E)
- ノードパラメータ:関数の編集
検索クエリ
このフィールドに検索語を入力すると、矢印ボタンにより、現在のコンテキストで使用可能な変数の一部を含むクエリ候補のリストが開きます。
実行できるクエリの詳細については、以下のクエリの検索セクションを参照してください。
ノードタイプ
このコンボボックスを使用すると、検索結果をフィルター処理して、特定の種類のノードのみを保持できます。
すべてのインスタンスノードはノードの 同じ型 で、実際には’instance’型ですが、アトミックノードはそれぞれ独自の型です。
このリストは、現在のグラフタイプのコンテキストに応じて変化します。
グラフを合成するためのノードの種類
関数グラフのノードの種類
Substanceグラフで’レベル’ノードの種類を検索しています
Substanceグラフで’Instance’ノード型を検索しています
Substance関数グラフで’Instance’ノード型を検索しています
検索オプション
検索クエリ
ノードを検索するには、次に示すノードプロパティに対してテキストクエリが照合されます。
- 検索では、大文字と小文字は区別されません。 例:「マイノードラベル」と「マイノードラベル」は同じ結果を返します。
- クエリの前後の空白は無視されます。
- 同じグラフで複数のクエリを同時に実行することはできません。 例:「レベルぼかし」は「レベル」と「ぼかし」の両方のノードと一致しません。 同様に、論理演算子もサポートされていません。
グラフは、ExplorerのID別に一覧表示されます。
インスタンスノードのツールチップには、参照されるグラフの識別子が含まれます。
クエリフィールドを展開すると、候補のリストが表示されます。
これには、現在のグラフの種類で使用できる組み込み変数と、グラフの公開パラメーターの識別子が含まれます。
公開されたパラメーターのIDは、Substanceグラフプロパティで直接コピーまたは編集することもできます。
画像をクリックして拡大
ノードによって使用される 変数 によってグラフにエラーまたは警告が発生した場合、ウィンドウ/コンソールに移動して、変数を含む完全なエラー/警告メッセージを表示します。 次に、この変数をコピーしてNode Finderのクエリフィールドに貼り付けると、問題の原因となっているノードをすばやく見つけることができます。
任意のテキストエディターを使用して、SBSファイルのXMLデータから変数を直接コピーすることもできます。
ノードのUIDは、コンテキストメニューからクリップボードにコピーできます。
このアクションにより、UIDが次の形式でコピーされます。
uid=1234567890
グラフにノードによって発生したエラーまたは警告がある場合は、ウィンドウ/コンソールに移動して、ノードの UID を含む完全なエラー/警告メッセージを表示します。 次に、このUIDをコピーしてNode Finderのクエリフィールドに貼り付けると、問題の原因となっているノードをすばやく見つけることができます。
また、任意のテキストエディターを使用して、SBSファイルのXMLデータからノードUIDを直接コピーすることもできます。
ノードラベル
ノードは、ラベルを使用して検索することもできます。
ファジー検索をオフにして正確なラベルを使用すると、特定のノードの検索が特に効果的です。
検索オプション
再帰モード
グラフインスタンスを検索し、サブグラフの結果を含めるようにするには、このオプションを有効にします。
このオプションは、コンソールの警告またはエラーメッセージから取得したUIDでノードを検索する必要がある場合に、グラフのトラブルシューティングを行う際に重要になります。
右側のクエリは、以下のインスタンスノードを強調表示しています。これは、左側の参照グラフがそのクエリと一致するためです
インスタンスノードは、複数のノードがクエリに一致するグラフを参照します。
「再帰検索」オプションを有効にすると、ピクセルプロセッサノードがクエリに一致する変数を使用しているグラフを参照するインスタンスノードがハイライトされます。
ファジーモード
クエリの正確なスペルがわからない場合、このオプションを使用すると結果で 許容範囲 が有効になります。
このオプションを使用すると、結果として望ましくない結果が生じる可能性があることに注意してください。