ノードファインダー

ノードファインダーツールバー {modal="regular"}

ノードファインダーツールを使用すると、テキストクエリを使用して ノードおよび変数の検索 を実行できます。 クエリに一致しないすべてのノードがグレー表示され、結果が表示されなくなります。

クエリは次のいずれかの条件に一致します。

  • インスタンス化によって参照されているグラフの識別子
  • ノードパラメーター関数で使用される表示されるパラメーターまたは変数の識別子
  • ノードの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)
  • ノードパラメータ:関数の編集

ノードファインダー:検索中のグラフの探索 {modal="regular"}

検索クエリ

ノードファインダークエリフィールド {modal="regular"}

このフィールドに検索語を入力すると、矢印ボタンにより、現在のコンテキストで使用可能な変数の一部を含むクエリ候補のリストが開きます。

実行できるクエリの詳細については、以下のクエリの検索セクションを参照してください。

ノードタイプ

ノードの種類 {modal="regular"}

このコンボボックスを使用すると、検索結果をフィルター処理して、特定の種類のノードのみを保持できます。

すべてのインスタンスノードはノードの​ 同じ型 ​で、実際には’instance’型ですが、アトミックノードはそれぞれ独自の型です。

ノード型リスト

このリストは、現在のグラフタイプのコンテキストに応じて変化します。

ノードの種類(合成) {modal="regular"}

グラフを合成するためのノードの種類

ノードの種類(関数) {modal="regular"}

関数グラフのノードの種類

アトミックノードの検索

ノードファインダー: 'レベル'の種類で検索(合成) {modal="regular"}

Substanceグラフで’レベル’ノードの種類を検索しています

インスタンスノードの検索

ノードファインダー: 'インスタンス'の種類(合成)で検索 {modal="regular"}

Substanceグラフで’Instance’ノード型を検索しています

ノードファインダー: 'Instance'型(関数)で検索 {modal="regular"}

Substance関数グラフで’Instance’ノード型を検索しています

検索オプション

をクリックすると、検索に使用する設定の一覧が開きます。この一覧の表示と非表示を切り替えることができます。

これらのオプションについて詳しくは、以下の「検索オプション」セクションを参照してください。

ノードファインダー検索オプション {modal="regular"}

検索クエリ

ノードを検索するには、次に示すノードプロパティに対してテキストクエリが照合されます。

NOTE
クエリは、次の点に注意して入力する必要があります。
  • 検索では、大文字と小文字は区別されません。 例:「マイノードラベル」と「マイノードラベル」は同じ結果を返します。
  • クエリの前後の空白は無視されます。
  • 同じグラフで複数のクエリを同時に実行することはできません。 例:「レベルぼかし」は「レベル」と「ぼかし」の両方のノードと一致しません。 同様に、論理演算子もサポートされていません。

インスタンスグラフ識別子

インスタンスノードは、参照するグラフの 識別子 を使用して見つけることができます。

ノードファインダー:グラフIDで検索 {modal="regular"}

画像をクリックして拡大

エクスプローラーのID

グラフは、ExplorerのID別に一覧表示されます。

エクスプローラー:パッケージの内容 {modal="regular"}

インスタンスノードのツールチップの識別子

インスタンスノードのツールチップには、参照されるグラフの識別子が含まれます。

インスタンスノードのツールヒントのグラフ識別子 {modal="regular"}

公開されたパラメーターと変数

公開されたパラメーターのIDまたはその他の変数は、直接検索できます。

ノードファインダー:ノード変数 {modal="regular"}

画像をクリックして拡大

クエリの候補

クエリフィールドを展開すると、候補のリストが表示されます。

これには、現在のグラフの種類で使用できる組み込み変数と、グラフの公開パラメーターの識別子が含まれます。

ノード検索クエリの提案 {modal="regular"}

公開されたパラメーターのIDは、Substanceグラフプロパティで直接コピーまたは編集することもできます。

ノードファインダー:公開されたパラメーター {modal="regular"}

画像をクリックして拡大

コンソールの警告/エラーからの変数の検索

ノードによって使用される 変数 によってグラフにエラーまたは警告が発生した場合、ウィンドウ/コンソールに移動して、変数を含む完全なエラー/警告メッセージを表示します。 次に、この変数をコピーしてNode Finderのクエリフィールドに貼り付けると、問題の原因となっているノードをすばやく見つけることができます。

任意のテキストエディターを使用して、SBSファイルのXMLデータから変数を直接コピーすることもできます。

ノードファインダー:コンソールの警告/エラーから変数を検索 {modal="regular"}

ノードの取得/設定

グラフ内の変数(公開されたパラメーターを含む)を検索すると、GetまたはSetノードが、ノードのパラメーター関数のいずれかでその変数を使用しているすべてのノードが強調表示されます。

ノードファインダー:変数を検索すると、それを使用しているGetノードに一致します {modal="regular"}

ノードUID

グラフ内の各ノードには、そのノードの検索に使用できる一意のUID(識別番号)があります。

ノード検索: UIDで検索 {modal="regular"}

画像をクリックして拡大

ノードのUIDのコピー

ノードのUIDは、コンテキストメニューからクリップボードにコピーできます。

このアクションにより、UIDが次の形式でコピーされます。

uid=1234567890

ノードの検索:ノードUIDアクションのコピー {modal="regular"}

コンソールからのノードUIDの検索に関する警告/エラー

グラフにノードによって発生したエラーまたは警告がある場合は、ウィンドウ/コンソールに移動して、ノードの UID を含む完全なエラー/警告メッセージを表示します。 次に、このUIDをコピーしてNode Finderのクエリフィールドに貼り付けると、問題の原因となっているノードをすばやく見つけることができます。

また、任意のテキストエディターを使用して、SBSファイルのXMLデータからノードUIDを直接コピーすることもできます。

ノード検索:コンソールからノードUIDを検索しています {modal="regular"}

ノードラベル

ノードは、ラベルを使用して検索することもできます。

ファジー検索をオフにして正確なラベルを使用すると、特定のノードの検索が特に効果的です。

検索オプション

をクリックすると、ノードを検索するための 再帰的 および ファジー モードを切り替えることができます。

両方を同時に有効にすることができます。

ノードファインダー検索オプション {modal="regular"}

再帰モード

グラフインスタンスを検索し、サブグラフの結果を含めるようにするには、このオプションを有効にします。

このオプションは、コンソールの警告またはエラーメッセージから取得したUIDでノードを検索する必要がある場合に、グラフのトラブルシューティングを行う際に重要になります。

ノードファインダー:再帰検索 {modal="regular"}

右側のクエリは、以下のインスタンスノードを強調表示しています。これは、左側の参照グラフがそのクエリと一致するためです

例1

ノードファインダー:再帰検索の例1 {modal="regular"}

インスタンスノードは、複数のノードがクエリに一致するグラフを参照します。

例2

ノードファインダー:再帰検索の例2 {modal="regular"}

「再帰検索」オプションを有効にすると、ピクセルプロセッサノードがクエリに一致する変数を使用しているグラフを参照するインスタンスノードがハイライトされます。

ファジーモード

クエリの正確なスペルがわからない場合、このオプションを使用すると結果で 許容範囲 が有効になります。

このオプションを使用すると、結果として望ましくない結果が生じる可能性があることに注意してください。

ノードファインダー:ファジーモード {modal="regular"}

recommendation-more-help
substance-3d-designer-help-guide