サポートチケットを作成する
フォローする

Q100402:Katanaでシェルフアイテムを編集および削除する

概要

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

シェルフアイテムを初めてセットアップする場合は、この記事の手順と情報に従ってください。Q100401:Katanaでシェルフアイテムを作成する

詳しくは

Shelf Itemは、作成後にKatanaのShelf Item Pythonスクリプトにアクセスするか、 .katanaと関連するShelves、ShelvesNodeSpecificまたはShelvesScenegraphディレクトリに移動して、そこにスクリプトを配置することで編集できます。

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

View_Source.PNG

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

firstShelf.PNG

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

これは、シェルフアイテムにちなんで命名された、これらのディレクトリのいずれかのサブフォルダにあります。そこから、目的のPythonエディターでファイルを開くことができます。

この記事で説明されているプロセスを使用してシェルフアイテムスクリプトを作成した場合、 Q100401:Katanaシェルフアイテムを作成するには、デフォルトで次のような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バージョンでは、シェルフアイテムスクリプトファイルにDROP_TYPESが表示される場合があります。これはレガシーオプションであり、KEYBOARD_SHORTCUTに置き換えられました。

注:カスタムシェルフアイテムのキーボードショートカットを設定する場合、Katanaに既に存在するショートカットを使用することはできません。警告が表示され、Katanaのデフォルトのキーボードショートカットのリストは次の場所にありますKatanaオンラインヘルプ-キーボードショートカット

  • SCOPEは、シェルフアイテムが適用される特定のノードタイプを定義するために使用されます
  • <description>は、シェルフアイテムのヘルプツールチップになります

作成後の棚アイテムの編集

上記のdocstringの使用方法を示すために、以下のシェルフアイテムスクリプトを空の.pyファイルにコピーし、 .katana / Shelves / Custom_Shelves /ディレクトリに保存します。

注: .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」シェルフをリロードします。

Reload_Shelf.PNG

シェルフアイテムは、カスタムキーボードショートカット、アイコン、およびヘルプツールチップと共に「Float Selected」として表示されます。

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

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

類似のPython関数をまとめる方法の詳細については、こちらのKatana開発者ガイドをご覧ください: Katana開発者ガイド-サンプルスクリプト

シェルフアイテムアイコンの選択

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

棚アイテムにKatanaで使用可能なアイコンを使用するには、Katanaのデフォルトのリソース検索パスの後にアイコンへのパスを指定する必要があります。

例えば:

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

Katanaのデフォルトのリソース検索パスは次の$KATANA_HOME\bin\python\UI4\Resourcesです。 $KATANA_HOME\bin\python\UI4\Resources

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

棚アイテムの削除

シェルフアイテムを削除する場合は、次のようにします。

  • シェルフアイテムスクリプトを含むPythonファイルを削除する
  • [シェルフアクション]メニューに移動し、削除するシェルフアイテムを右クリックして、 [削除...]を選択します

Delete_Item.PNG

押すと、ポップアップウィンドウが表示され、削除の確認が求められます。 [ 削除]をクリックすると、シェルフアイテムが削除されます。

Delete_Item2.PNG

注:上記のポップアップウィンドウに表示されるように、Katanaはシェルフアイテムスクリプトを削除せず、最後に拡張子.bakを追加して、Katanaでロードおよび表示されないようにします。

バックアップファイルとして保存され、必要に応じて復元されます。

Delete_Item3.PNG

シェルフに追加し直す場合は、その場所に移動して「.bak」拡張子を削除すると、シェルフアイテムスクリプトが読み込まれ、使用可能になります。

注: .bakを削除した後、Shelf Actionに移動して「Add-> Reload ...」を使用し、セッションで表示するためにKatanaが使用可能なすべてのシェルフアイテムをリロードするようにします。

参考文献

シェルフアイテムを初めてセットアップする場合は、次の記事を参照してください。Q100401:Katanaでシェルフアイテムを作成する

シェルフアイテムスクリプトの詳細については、次のKatanaオンラインヘルプを参照してください: Katana Online Help-Shelf Scripts

この記事は役に立ちましたか?

私たちはそれを聞いて申し訳ございません

理由をお聞かせください
2人中2人がこの記事が役に立ったと言っています

コメント