Q100401：如何在 Katana 中创建货架项目以提供易于访问的自定义 Python 脚本

概括

Shelf Item Scripts 是包含在 Shelves 下的 Shelf 项目中的 Python 脚本，这些脚本从Katana的 UI 运行。

Shelf 非常有用，它们允许用户创建工具，通过从 Shelf 或通过自定义键盘快捷键启动 Python 操作来节省时间。

Shelf Item 脚本可以使用Katana的 API（例如NodegraphAPI来访问Katana的各个可查询或修改的部分。

本文将进一步解释架子工具，并提供有关设置第一个架子项目的简短教程。

如果您已经设置了第一个架子项目并希望获得更新或删除它的提示，请参阅Q100402：如何在Katana中编辑和删除架子项目。

货架位置

架子项目被整理到名为架子操作（cog图标）。架子动作可用于更广泛的功能，或为场景图或特定节点创建，如下所示：

• 主书架位置，可通过主菜单工具栏访问

• 专门用于“场景图”选项卡的架子位置

• 节点内的小部件工具栏，可通过“参数”选项卡使用

要了解有关货架类型以及将货架项目脚本设置到特定位置的更多信息，请查看货架项目脚本用户指南。

创建货架项目脚本

设置第一个货架项目脚本时，涉及几个步骤：

1. 首先，打开Katana并选择Shelf Action (cog图标）在主工具栏上。

2. 在 UI 的右上角，选择“添加 -> 新架子... ”，这将为您的脚本创建自定义架子。

输入新的书架名称并单击“确定”。

3. 返回到架子操作齿轮图标，选择新创建的架子并使用“添加 -> 新项目... ”添加第一个架子项目

将出现一个弹出窗口，您可以在其中命名架子项目，并根据需要为其提供键盘快捷键。然后选择确定：

注意：为自定义架子项目设置键盘快捷键时，您将无法使用Katana中已存在的快捷键。应显示警告，并且可以在键盘快捷键资源中找到Katana默认键盘快捷键列表。

4. 初始化创建后，将打开一个文本文档，其中包含您的 Shelf Item Python 脚本文件。

默认情况下，这将在您的Katana终端窗口中打印“hello, world”。

注意：使用NodegraphAPI命令，您可以为 Python 脚本添加其他功能。

5. 从主Shelf Action运行 Shelf Item 脚本，方法是选择新 Shelf 并单击新 Shelf 项目，或者使用之前添加的键盘快捷键。

这会将“hello, world”打印到您的Katana终端窗口。

延伸阅读

有关Katana中的货架项目脚本的概述，请访问货架项目脚本用户指南。

要通过添加自定义 Python 函数并编辑文档字符串以包含自定义图标或键盘快捷键来改进您的架子项目，请阅读Q100402：如何在Katana中编辑和删除架子项目。

要查看用于重命名输入/输出端口的 Shelf Item 脚本示例，请阅读Q100372：使用 Python 重命名输入和输出端口。