Q100402: Katana でシェルフアイテムを編集および削除して、既存のカスタム Python スクリプトを変更する方法

Bradley Webster

更新しました: 2026年05月12日 22:45

作成した: 2018年05月11日 07:35

まとめ

この記事では、シェルフアイテムを編集またはカスタマイズする方法と、必要に応じてシェルフアイテムを削除する手順について説明します。

初めてシェルフアイテムを設定する場合は、「Q100401: Katanaでシェルフアイテムを作成して、簡単にアクセスできるカスタム Python スクリプトを提供する方法」の手順と情報に従ってください。

棚のアイテムを編集する

シェルフアイテムは、作成後にKatanaの Shelf Item Python スクリプトにアクセスするか、 .katanaと関連する Shelves、ShelvesNodeSpecific、または ShelvesScenegraph ディレクトリに移動して、そこでスクリプトを見つけることによって編集できます。

1. Katanaでスクリプトにアクセスするには、シェルフアクションを開き、目的のシェルフ項目を選択して、「ソースの表示」を右クリックします。

ビューソース.png

これにより、次のようなテキストエディターで Shelf Item Python スクリプトが開きます。

シェルフスクリプト_メモ帳.PNG

2. Katanaの外部でスクリプトにアクセスするには、 .katana/Shelves 、 .katana/ShelvesNodeSpecific 、または.katana/ShelvesScenegraphフォルダーに移動し、関連する.pyファイルを見つけます。

このファイルは、シェルフアイテムの名前が付いたディレクトリのサブフォルダに保存されます。そこから、任意のPythonエディタでファイルを開くことができます。

シェルフアイテムスクリプトのドキュメント文字列

Q100401: Katanaでシェルフアイテムを作成して簡単にアクセスできるカスタム Python スクリプトを提供する方法で説明されているプロセスを使用してシェルフアイテムスクリプトを作成した場合、次のような 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はスクリプトアイテムを実行するためのショートカットです
SCOPEは、シェルフアイテムが適用される特定のノードタイプを定義するために使用されます。
<description>は棚のアイテムのヘルプツールチップです

注意：カスタムシェルフアイテムにキーボードショートカットを設定する場合、 Katanaに既に存在するショートカットは使用できません。警告が表示され、 Katanaデフォルトのキーボードショートカットのリストはキーボードショートカットリソースで確認できます。

棚アイテムのスクリプトを編集する

上記の docstring をどのように活用できるかを示すために、以下の Shelf Item Script を空の .py ファイルにコピーし、 .katana/Shelves/Custom_Shelves/ディレクトリに保存します。

"""
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シェルフアクションメニュー内の [追加] -> [シェルフの再ロード]でシェルフを再ロードします。

リロードシェルフ.png

シェルフアイテムは、カスタムキーボードショートカット、アイコン、ヘルプツールチップとともに「フロート選択」として表示されます。

フロート選択ツールチップ.png

シェルフアイテムスクリプト機能は、キーボードショートカット (T) でトリガーされるか、シェルフアクションメニューからシェルフアイテムを選択すると、現在選択されているノードをフロート表示します。

フローティングされたノードは、左クリックして放すまでカーソルに追従します。これにより、選択したノードまたは背景を手動でクリックしてドラッグする必要がなくなります。

同様の Python 関数を組み合わせる方法の詳細については、開発者ガイドのサンプルスクリプトを参照してください。

棚アイテムアイコンの選択

シェルフアクションメニューに表示されるシェルフアイテムのアイコンを置き換えるには、次の場所からKatanaのデフォルトアイコンの 1 つを選択できます: $KATANA_HOME\bin\python\UI4\Resources\Icons

Katanaで利用可能なアイコンをシェルフアイテムに使用するには、 Katanaのデフォルトのリソース検索パスの後にアイコンへのパスを指定する必要があります。Katana のデフォルトのリソース検索パスは $ Katana $KATANA_HOME\bin\python\UI4\Resourcesです。例:

アイコン: Icons\Scenegraph\locator32.png

注:他のカスタムアイコンを使用する場合は、Python スクリプトの ICON セクションに完全なアイコンパスを追加する必要があります。

棚の取り外し

シェルフアクションからシェルフを削除したい場合は、 .katana\Shelvesフォルダからシェルフフォルダを削除してください。Katana Katana開いて変更内容を確認したい場合、またはドロップダウンシェルフからシェルフを削除したい場合は、「シェルフを再読み込み」をクリックしてください。.katana/shelfファイルに加えられた変更は、 Katanaシーンに反映されます。