节点查找器

{modal="regular"}

节点查找器工具允许您使用文本查询执行 节点和变量 搜索。 所有与查询不匹配的节点将变暗，以使结果突出。

查询可以与以下任一条件匹配：

搜索可以递归遍历图形实例，以便可以在子图中找到节点和变量。 如果不确定需要搜索的确切术语，可使用模糊搜索选项将公差应用于查询。## 界面您可以通过两种方式访问Node Finder ：在图形视图中，按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"}使用此组合框可以筛选搜索结果，以便仅保留特定类型的节点。请注意，所有实例节点都是​相同的节点类型，实际上，是“实例”类型，而原子节点都是其自己的类型。节点类型列表该列表与当前图形类型相关联。 {modal="regular"}合成图形的节点类型 {modal="regular"}函数图表的节点类型搜索原子节点 {modal="regular"}在Substance图表中搜索“级别”节点类型搜索实例节点 {modal="regular"}在Substance图形中搜索“实例”节点类型 {modal="regular"}在Substance函数图中搜索“实例”节点类型### 搜索选项使用 可打开用于搜索的可打开和关闭设置的列表。可在下面的搜索选项部分中了解有关这些选项的更多信息。 {modal="regular"}## 搜索查询要查找节点，文本查询与下面列出的节点属性进行匹配。 NOTE键入查询时应注意以下注意事项：* 搜索不区分大小写。 例如，“my node label”和“My Node Label”返回相同的结果。
• 查询前后的空格将被忽略。
• 无法在同一个图形中同时执行多个查询。 例如，“色阶模糊”不会同时匹配“色阶”和“模糊”节点。 同样，也不支持逻辑运算符。### 实例图形标识符可以使用它们引用的图形的 标识符 找到实例节点。 {modal="regular"}单击图像可放大资源管理器中的标识符图形在资源管理器中按其标识符列出。 {modal="regular"}实例节点的工具提示中的标识符实例节点的工具提示包括它们参照图形的标识符。 {modal="regular"}### 公开的参数和变量可以直接搜索公开参数的标识符或任何其他变量。 {modal="regular"}单击图像可放大查询建议查询字段可以展开，以显示建议列表。其中包括可用于当前图形类型的内置变量，以及图形公开参数的标识符。 {modal="regular"}也可以在Substance图形属性中直接复制或编辑公开参数的标识符。 {modal="regular"}单击图像可放大从控制台警告/错误中搜索变量当某个图形具有由某个节点使用的 变量 引发的错误或警告时，请转到 Windows > Console 以显示完整的错误/警告消息，其中包含该变量。 然后，您可以将此变量复制并粘贴到Node Finder查询字段中，以快速找到导致问题的节点。还可以使用任意文本编辑器直接从SBS文件中的XML数据复制变量。 {modal="regular"}获取/设置节点在图形中搜索变量（包括公开的参数）时，搜索将突出显示所有节点，其中Get或Set节点在任何节点的参数函数中使用该变量。 {modal="regular"}### 节点UID图形中的每个节点都有一个唯一的标识号(UID)，可用于搜索该节点。 {modal="regular"}单击图像可放大复制节点的UID节点的UID可以从其上下文菜单复制到剪贴板。该操作按以下格式复制UID：uid=1234567890 {modal="regular"}从控制台搜索节点UID时出现警告/错误如果图形存在节点引发的错误或警告，请转到Windows >控制台以显示完整的错误/警告消息，其中将包含节点的UID。 然后，您可以将此UID复制并粘贴到节点查找器查询字段中，以快速找到导致问题的节点。还可以使用任何文本编辑器直接从SBS文件中的XML数据复制节点UID。 {modal="regular"}### 节点标签还可以使用节点的标签查找节点。在关闭模糊搜索的情况下使用特定节点的精确标签时，搜索特定节点特别有效。## 搜索选项使用 可以切换用于搜索节点的 递归 和 模糊 模式。可以同时启用这两者。 {modal="regular"}### 递归模式启用此选项可使搜索遍历图形实例以包含来自子图的结果。在对图形进行故障排除时，如果您需要根据从控制台中的警告或错误消息获取的UID查找节点，则此选项可能非常重要。 {modal="regular"}右侧的查询突出显示下面的实例节点，因为其左侧的引用图形与该查询匹配示例1 {modal="regular"}实例节点引用多个节点与查询匹配的图形。示例2 {modal="regular"}启用“递归搜索”选项将突出显示引用图表的实例节点，其中“像素处理器”节点使用与查询匹配的变量。### 模糊模式如果不确定查询的准确拼写，此选项将在结果中启用容差。请注意，使用此选项可能会导致不需要的匹配。 {modal="regular"}**