创建支持服务单
关注

Q100402:编辑和删除Katana中的货架物品

摘要

本文介绍如何编辑/自定义Shelf Item以及在需要时删除一个Shelf Item的过程。

如果您想第一次设置货架物品,请按照本文中的步骤和信息进行操作: Q100401:在Katana中创建货架物品

更多信息

在创建之后编辑Shelf Items可以通过访问Katana中的Shelf Item Python脚本,或导航到.katana和相关的Shelves,ShelvesNodeSpecific或ShelvesScenegraph目录,并在那里找到脚本来完成。

1.要在Katana中访问您的脚本,请打开您的Shelf Action,选择所需的Shelf Item并右键单击“ View Source ”:

View_Source.PNG

这将在文本编辑器中打开Shelf Item Python脚本,如:

firstShelf.PNG

2.要在Katana之外访问脚本,请导航到.katana / Shelves,.katana / ShelvesNodeSpecific.katana / ShelvesScenegraph文件夹,然后找到相关的.py文件。

这将位于其中一个目录的子文件夹中,以您的Shelf Item命名。从那里,您可以在所需的Python编辑器中打开该文件。

如果您使用本文中描述的过程创建了Shelf Item Script: Q100401:在Katana中创建一个Shelf Item,默认情况下它将包含一个docstring,如下所示:

""" 
NAME: <the name of the script to show in the UI>
ICON: <the filename of icon to use in the UI>
KEYBOARD_SHORTCUT: <the keyboard shortcut to use in the UI to run the Shelf Item Script> SCOPE: <names of types of nodes to target by node-specific shelf items> <description> """

这包含有关您的脚本的信息,如下所述:

  • NAME将是您的脚本项目在货架行动中显示的名称
  • ICON将是您所选图标的图像位置。 (下面进一步讨论)
  • KEYBOARD_SHORTCUT将是您可以运行脚本项的快捷方式

注意 :在2.6v2之前的Katana版本中,您可能会在Shelf Item Script文件中看到DROP_TYPES。这是一个遗留选项,已被KEYBOARD_SHORTCUT取代。

注意:为自定义货架项目设置键盘快捷方式时,您将无法使用Katana中已存在的快捷方式。应显示警告,可在此处找到Katana默认键盘快捷键列表: Katana在线帮助 - 键盘快捷键

  • SCOPE将用于定义Shelf Item适用的特定节点类型
  • <description>将成为Shelf Item的帮助工具提示

在创建后编辑货架项目

要演示如何使用上述文档字符串,请将下面的Shelf Item Script复制到空白.py文件中,并将其保存在.katana / Shelves / Custom_Shelves /目录中:

注意:如果.katana不存在,请在.katana中创建文件夹路径。

"""
NAME: Float Selected
ICON: Icons\Scenegraph\locator32.png
KEYBOARD_SHORTCUT: T
SCOPE: none
Float Selected Nodes via Keyboard Shortcut
"""

# Get list of selected nodes
nodeList = NodegraphAPI.GetAllSelectedNodes()

# Find Nodegraph tab and float nodes
nodegraphTab = UI4.App.Tabs.FindTopTab('Node Graph')
if nodegraphTab:
    nodegraphTab.floatNodes(nodeList)


保存脚本后,通过Katana Shelf Action菜单中的“ Add - > Reload Shelf”重新加载Shelf

Reload_Shelf.PNG

您的货架项目应显示为“浮动选定”,并带有自定义键盘快捷键,图标和帮助工具提示:

Shelf Item Script功能用于浮动任何当前选定的节点,当使用键盘快捷键(T)触发或从Shelf Action菜单中选择Shelf Item时。

浮动节点将跟随光标,直到您左键单击以放开,这节省了必须手动单击并拖动所选节点或背景。

有关组合类似Python函数的更多信息,请参阅Katana开发人员指南: Katana开发人员指南 - 示例脚本

选择您的货架项目图标

要替换“货架操作”菜单中显示的货架项目图标,您可以从以下位置选择Katana的默认图标之一:

$KATANA_HOME\bin\python\UI4\Resources\Icons

要使用Katana中可用的图标作为您的货架项目,您需要在Katana的默认资源搜索路径之后指定图标的路径。

例如:

ICON:Icons \ Scenegraph \ locator32.png

其中Katana的默认资源搜索路径为: $KATANA_HOME\bin\python\UI4\Resources

注意:如果您想使用其他自定义图标,则需要将完整图标路径添加到Python脚本的ICON:部分。

删除货架物品

如果您想要移除货架物品,可以通过以下方式完成:

  • 删除包含Shelf Item Script的Python文件
  • 导航到Shelf Action菜单并右键单击要删除的Shelf Item,然后选择'Delete ... ':

Delete_Item.PNG

按下后,弹出窗口将要求您确认删除。单击“ 删除”将删除“货架项目”。

Delete_Item2.PNG

注意:如上面的弹出窗口所示,Katana不会删除Shelf Item Script,而是在末尾添加扩展名.bak,以便它不再加载并显示在Katana中。

它将保存为备份文件,以便在需要时进行恢复。

Delete_Item3.PNG

如果您希望将其添加回您的货架,请导航至其位置并删除“.bak”扩展名,并且将加载货架项目脚本并使其可用。

注意:删除.bak后,转到Shelf Action并使用'Add-> Reload ...',以便Katana重新加载所有可用的Shelf Items以在会话中显示。

进一步阅读

如果您是第一次设置货架物品,请参阅以下文章: Q100401:在Katana中创建货架物品

有关货架物品脚本的更多信息,请参阅我们的Katana在线帮助: Katana在线帮助 - 货架脚本

这篇文章有帮助吗?
/

We're sorry to hear that!

Please tell us why.
2 人中有 2 人觉得有帮助

评论