まとめ
シェルフ アイテム スクリプトは、シェルフの下にグループ化されたシェルフ アイテムに含まれる Python スクリプトであり、 Katanaの UI から実行されます。
シェルフは非常に便利で、ユーザーはシェルフから、またはカスタム キーボード ショートカットを介して Python 操作を起動することで時間を節約できるツールを作成できます。
シェルフ アイテム スクリプトは、 NodegraphAPI
などのKatanaの API を使用して、クエリまたは変更できるKatanaのさまざまな部分にアクセスできます。
この記事では、シェルフ ツールについてさらに説明し、最初のシェルフ アイテムを設定するための短いチュートリアルを提供します。
最初のシェルフ アイテムをすでに設定していて、それを更新または削除するためのヒントが必要な場合は、Q100402: Katanaでシェルフ アイテムを編集および削除する方法 を参照してください。
棚の位置
シェルフ アイテムはシェルフ アクション(cog) という名前のポップアップ UI にまとめられます。アイコン)。シェルフ アクションは、以下に示すように、より広範な機能に使用したり、シーン グラフや特定のノード用に作成したりできます。
- メインのシェルフの場所。メイン メニュー ツールバーから利用可能
- 「Scene Graph」タブ専用のシェルフの場所
- ノード内のウィジェット ツールバー ( [パラメータ]タブから利用可能)
シェルフのタイプと特定の場所へのシェルフ アイテム スクリプトの設定の詳細については、 シェルフ アイテム スクリプトユーザー ガイドを確認してください。
シェルフアイテムスクリプトの作成
最初の棚アイテム スクリプトを設定するときは、いくつかの手順が必要です。
1. 開始するには、 Katanaを開き、シェルフ アクション(歯車) を選択します。アイコン)をメインツールバーに追加します。
2. UI の右上で、「追加 -> 新しいシェルフ... 」を選択します。これにより、スクリプト用のカスタム シェルフが作成されます。
新しいシェルフ名を入力し、「OK」をクリックします。
3. シェルフ アクションの歯車アイコンに戻り、新しく作成したシェルフを選択し、「追加 -> 新しいアイテム... 」で最初のシェルフ アイテムを追加します。
ポップアップ ウィンドウが表示され、シェルフ アイテムに名前を付け、必要に応じてキーボード ショートカットを与えることができます。次に、「OK」を選択します。
注:カスタム シェルフ アイテムにキーボード ショートカットを設定する場合、 Katanaに既に存在するショートカットは使用できません。警告が表示されます。Katana Katanaデフォルトのキーボード ショートカットのリストは、 キーボード ショートカットリソースにあります。
4. 作成を初期化すると、Shelf Items Python Script ファイルを含むテキスト ドキュメントが開きます。
これにより、デフォルトでKatanaターミナル ウィンドウに「hello, world」が出力されます。
注: NodegraphAPI
コマンドを使用すると、Python スクリプトに追加の機能を追加できます。
5. メインのシェルフアクションから、新しいシェルフを選択して新しいシェルフ アイテムをクリックするか、前に追加したキーボード ショートカットを使用して、シェルフ アイテム スクリプトを実行します。
これにより、 Katanaターミナル ウィンドウに「hello, world」が出力されます。
参考文献
Katanaのシェルフ アイテム スクリプトの概要については、 シェルフ アイテム スクリプトユーザー ガイドを参照してください。
カスタム Python 関数を追加し、ドキュメント文字列を編集してカスタム アイコンやキーボード ショートカットを含めることによってシェルフ アイテムを改善するには、「Q100402: Katanaでシェルフ アイテムを編集および削除する方法」を参照してください。
入力/出力ポートの名前変更に使用されるシェルフ アイテム スクリプトの例については、「Q100372: Python を使用した入力ポートと出力ポートの名前変更」を参照してください。
私たちはそれを聞いて申し訳ございません
理由をお聞かせください