ドキュメンテーション：HotKeys

HotKey

MARUIのHotKeyは、VRスペースに便利なボタンとして機能を配置する方法です。シェルフと同じように機能しますが、自由にプログラムしてその位置や内容を保存することができます。

HotKeyはPythonかMELスクリプトでプログラムすることができ、HotKey エディタを使うとより便利です。

HotKey エディタ

HotKeyエディタは、HotKeyを作成・編集・保存・削除するための簡単なグラフィカルダイアログです。
Mayaシェルフから開く場合、MARUIシェルフタブのHotKeyアイコンをクリックしてください：

Icon Hotkeys

Hotkey Menu

HotKey リスト

HotKeyエディタ（1）の上部には、作成したすべてのHotKeyのリストがあります。
初めてHotKeyエディタを開く場合、このリストは空の状態です。

HotKey の作成

テキストボックス（2）に名前を入力して「作成」をクリックすると、新しいフローティングHotKeyウィンドウを作成できます。
名前はHotKeyウィンドウの一意の識別名なので、同じ名前は使用できません。
HotKeyウィンドウを作成するとすぐに、VR内のユーザーの目の前に現れます。
作成時には、空のフローティングウィンドウです。
HotKeyウィンドウに要素を追加する方法については、セクション要素の追加を参照してください。

HotKey ウィンドウのセンター配置

VRでHotKeyウィンドウを見失った場合は、Centerボタンを使用して目の前に再配置することができます。
リストからHotKeyの名前を選択し、[Center]をクリックします。HotKeyウィンドウは自動的に再配置されます。

HotKeyの削除

既存のHotKeyをリストから選択して[削除]ボタンをクリックすると、削除できます。
これにより、選択したHotKeyウィンドウ内のすべての要素も削除されます。

要素（エレメント）リスト

HotKeyウィンドウリストの下には、現在選択されているHotKeyウィンドウの要素リスト（3）があります。
HotKeysウィンドウリスト（1）から別のHotKeyウィンドウを選択すると、リストが自動的に更新されてそのHotKeyウィンドウの要素が表示されます。
新しいHotKeyウィンドウ（またはインスタンス）を作成すると、このリストは空になります。

要素（エレメント）の追加

現在選択されているHotKeyウィンドウに新しい要素（アイテム）を追加するには、テキストフィールド（4）に入力してCreate Newボタンを押してください。

タイトル/ツールチップ

これは要素の名前です。これはElements List（3）に表示されますので、HotKeyの機能に任意の名前を付けてください。
HotKeyウィンドウのそれぞれの要素の上にカーソルを置くと、これもツールチップとしてVRに表示されます。

コマンド/スクリプト

VRのHotKey要素をクリックしたときに発行されるMELまたはPythonコマンドです。
それはMayaコマンド（例：move -relative 1 2 3）または独自のスクリプトです。
下のラジオボタンを使用して、スクリプトがPythonスクリプトのMELスクリプト内にあるかどうかを指定します。

アイコン

HotKey要素のアイコン画像を選択できます。
これは使用するハードドライブ上の画像ファイル（PNG・JPEG・BMP・TIF）もしくは、Mayaアイコン（例：activeSelectedAnimLayer.png）です。
使用可能なMayaアイコンファイルのリストについては、Mayaの “Shelf Editor”を参照するか、MayaスクリプトコマンドresourceManager -nf “*”を実行してください。
アイコンを指定しない場合は、タイトル/ツールチップの最初の文字が使用されます。

要素のアップデート

要素リストから要素を選択し（3）、テキストフィールドの値を変更し（4）、[選択項目の更新]を押すと、要素を更新できます。

[要素リスト]（3）の右側にある[上に移動]ボタンと[下に移動]ボタンを押して、HotKeyウィンドウの要素の順序を変更することもできます。

要素の削除

要素リスト（3）で要素を選択して[Delete Selected]ボタンを押すと、現在選択されているHotKeyウィンドウから要素を削除できます。

HotKeyの保存と読み込みHotKey保存ファイル

HotKey エディタ（5）の下部には、[Save]と[Load]の2つのボタンがあります。
[Save]をクリックすると、現在のHotKeyがコンピュータのハードドライブに保存されるため、次回MARUIを起動したときに利用できるようになります。
HotKey保存ファイルの場所は、Mayaの環境設定フォルダにあります。デフォルトでは、これは
C：\ Users \ <あなたの名前> \ Documents \ maya \ <mayaのバージョン> \ prefs \ MARUI_HotKeys.mel

たとえば、 “Max”という名前のMayaバージョン2018の場合、このフォルダは次のようになります。
C：¥Users¥max¥Documents¥maya¥2018¥prefs¥MARUI_HotKeys.mel

これは単純なMELスクリプトファイルなので、テキストエディタで編集して独自のスクリプトを含めることができます。
HotKey用のスクリプトを読み書きする方法については、以下のセクションを参照してください。

MARUIは起動時に保存されたHotKeyを自動的に読み込みます。

HotKeyのスクリプティング

HotKeyを自動化したい場合は、HotKeyエディタで許可されているすべての操作をPythonまたはMELスクリプトを介して手動で実行できます。
HotKeyを作成、編集、保存、削除するコマンドはMARUI_HotKeyコマンドです。
次の例は、スクリプトを使用してホットキーを作成、編集、削除する方法を示しています。

// “my HotKeys”という名前の新しいHotKeyウィンドウインスタンスを作成します
MARUI_HotKeys  –  “my HotKeys”を作成します。
// HotKeyウィンドウインスタンスに要素を追加しま
MARUI_HotKeys -addElement -title “my MELコマンド” -command “myMELcommand（）” “my HotKeys”;
MARUI_HotKeys -addElement -title “my Pythonコマンド” -command “myPythonCommand（）” -python 1 “my HotKeys”;
MARUI_HotKeys -addElement -title “アイコン” -command “anotherCommand” -icon “D付きコマンド：/ my IconsI / icon1.png” “my HotKeys”;
//リスト内の2番目の要素（0から始まるインデックスが1）を更新しますMARUI_HotKeys -setElement 1 -icon “activeSelectedAnimLayer.png” “私のホットキー“;
//リスト内の3番目の要素（0から始まるインデックスが2）を削除しますMARUI_HotKeys -deleteElement 2 “my HotKeys”;
//位置、回転、スケールまたはHotKeysウィンドウインスタンスを取得します
float $ translation [] = `MARUI_HotKeys -q -tt” my HotKeys “;
float $ rotation [] = `MARUI_HotKeys -q -tr” my HotKeys “;
float $ scale = `MARUI_HotKeys -q -ts” my HotKeys “;