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

Q100402:カタナの棚アイテムの編集と削除

概要

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

初めて棚アイテムを設定する場合は、この記事の手順と情報に従ってください。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:KatanaShelf 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は、シェルフアクションに表示されているスクリプトアイテムの名前です。
  • アイコンはあなたが選んだアイコンの画像位置になります。 (以下でさらに議論されます)
  • KEYBOARD_SHORTCUTは、スクリプトアイテムを実行するためのショートカットになります。

:2.6v2より前のKatanaバージョンでは、Shelf Item ScriptファイルにDROP_TYPESが表示されることがあります。これは従来のオプションであり、KEYBOARD_SHORTCUTに置き換えられました。

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

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

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

上記のdocstringの利用方法を説明するために、下記のShelf Item Scriptを空の.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

あなたのShelf Itemはカスタムキーボードショートカット、アイコン、そしてヘルプツールチップと共に 'Float Selected'として表示されるはずです。

Shelf Item Script機能は、キーボードショートカット(T)または[Shelf Action]メニューから[Shelf Item]を選択して起動すると、現在選択されているすべてのノードをフロートさせます。

左クリックして放すまで、フローティングノードはカーソルをたどります。これにより、選択したノードをクリックして手動でドラッグしなくても済みます。

似たようなPython関数をまとめることについてのより多くの情報はここKatana開発者ガイドにあります: Katana開発者ガイド - サンプルスクリプト

棚アイテムのアイコンを選択する

Shelf Actionメニューに表示されているShelf Itemのアイコンを置き換えるには、次の場所からKatanaのデフォルトのアイコンの1つを選択できます。

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

あなたのShelf ItemにKatanaで利用可能なものからアイコンを使うためには、Katanaのデフォルトのリソース検索パスの後にアイコンへのパスを指定する必要があります。

例えば:

アイコン:アイコン\シーングラフ\ locator32.png

Katanaのデフォルトのリソース検索パスは次の$KATANA_HOME\bin\python\UI4\Resourcesです。 $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

あなたがそれをあなたのShelfに再び追加したい場合は、その場所に移動して '.bak'拡張子を削除するとShelf Item Scriptがロードされ使用可能になります。

注: .bakを削除した後、シェルフアクションに移動して 'Add-> Reload ...'を使用すると、Katanaは使用可能なすべてのシェルフアイテムをセッションに表示するために再ロードします。

参考文献

初めて棚アイテムを設定する場合は、次の記事を参照してください。Q100401:Katanaでの棚アイテムの作成

Shelf Item Scriptsの詳細については、Katanaのオンラインヘルプを参照してくださいKatanaオンラインヘルプ - Shelf Scripts

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

We're sorry to hear that!

Please tell us why.
2人中2人がこの記事が役に立ったと言っています

コメント