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

概括

书架项脚本是包含在书架项中的 Python 脚本，这些书架项分组在书架下，可以通过Katana的用户界面执行。书架非常实用，用户可以通过从书架启动 Python 操作或使用自定义键盘快捷键来创建工具，从而节省时间。书架项脚本可以使用Katana的 API，例如NodegraphAPI ，来访问Katana的各个部分，并进行查询或修改。

本文将进一步解释书架工具，并提供一个关于如何设置第一个书架项目的简短教程。如果您已经设置了第一个书架项目，并希望了解如何更新或删除它，请参阅Q100402：如何在Katana中编辑和删除书架项目以修改现有的自定义 Python 脚本。

货架位置

货架上的商品会被整理到名为“货架操作”（齿轮图标）的弹出式用户界面中。图标）。“书架动作”可用于更广泛的功能，也可以为场景图或特定节点创建，如下所示：

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

• 场景图选项卡的专门货架位置

• 节点内的控件工具栏可通过“参数”选项卡访问。

要了解有关不同类型货架以及如何为特定位置设置货架项目脚本的更多信息，请参阅货架项目脚本用户指南。

创建货架商品脚本

设置第一个货架商品脚本时，需要经过以下几个步骤：

1. 首先，打开Katana并选择“操作架”（齿轮图标）。主工具栏上的图标）。
2. 在用户界面右上角，选择“添加 -> 新建 Shelf... ”，这将为您的脚本创建一个自定义 Shelf。
   
   
   
   输入新的书架名称，然后单击“确定”。
   
   
3. 返回书架操作齿轮图标，选择您新建的书架，然后使用“添加 -> 新建项目... ”添加您的第一个书架项目。
   
   此时会弹出一个窗口，您可以在其中为书架项目命名，并根据需要设置键盘快捷键。然后选择“确定”：
   
   
   注意：为自定义书架项目设置键盘快捷键时，您将无法使用Katana中已存在的快捷键。系统会显示警告，您可以在“ 键盘快捷键资源”中找到Katana默认键盘快捷键列表。
   
   
4. 创建完成后，将打开一个文本文件，其中包含您的书架项目 Python 脚本文件。
   默认情况下，这将在Katana终端窗口中打印“hello, world”。
   
   注意：使用NodegraphAPI命令，您可以为 Python 脚本添加额外的功能。
   
   
5. 可以通过以下两种方式运行书架项目脚本：从主书架操作中选择新书架并单击新书架项目，或者使用前面添加的键盘快捷键。
   
   
   这将在Katana终端窗口中打印“hello, world”。

延伸阅读

有关Katana中书架物品脚本的概述，请访问书架物品脚本用户指南。

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

要查看使用 Shelf Item Script 重命名输入/输出端口的示例，请阅读Q100372：如何使用 Python 重命名输入和输出端口以实现更清晰的连接。