Q100496：如何使用 Python 在节点周围添加红色错误光晕以标记错误

概括

例如，在使用 SuperTools 或基于 NodeTypeBuilder 的节点类型创建自定义节点类型时，用户可能希望在其节点周围添加红色错误光晕，以指示是否存在可能阻止节点正常工作的问题（例如，缺少输入连接或未找到插件）。

本文演示了用于向节点添加此错误发光效果的 API 函数。

更多信息

Katana的节点图选项卡中，通常表示特定节点出现错误的红色光晕可以通过UI4.Util.NodeErrors Python 模块进行控制。

给定一个特定节点：

node = NodegraphAPI.GetNode('GafferThree')

涂抹红色荧光：

UI4.Util.NodeErrors.SetNodeError(node, 'Something is wrong.')

第二个参数是错误消息，可以通过在节点图选项卡中将鼠标指针指向节点并按T键（表示工具提示）来查看：

去除红色光晕：

UI4.Util.NodeErrors.ClearNodeError(node)

这可以在自定义节点类型（如 SuperTools）中使用，以向用户指示特定节点出现了一些问题，例如，在 SuperTool 的参数界面中单击按钮执行某些操作后。

延伸阅读

有关创建自定义节点类型的更多信息：

Katana用户指南中的组、宏和超级工具

Katana开发者指南中的自定义节点类型

更多关于如何使用 Python自定义节点图选项卡中节点外观的信息：

Katana开发人员指南中的节点属性
Q100108：如何向节点的上下文菜单添加自定义菜单项
Q100277：如何使用 Python 创建和定位新节点

如果您在使用以上信息时遇到任何问题，请提交支持工单，并告知我们您遇到的问题以及您目前已采取的故障排除步骤。

有关如何提交支持工单的更多信息，请参阅Q100064：如何提交支持工单。