PythonでMayaプラグインを作成する - HelloWorld編
先日、Autodesk Maya 2016 (以下、Mayaと略す)を試用した。PythonでMayaプラグインを開発するためである。
Maya Python API
本当にこのAPIは使われているのだろうか。
MayaはPythonでコールできるAPI "Maya Python API" を提供している。同APIは1.0と2.0と2つのバージョンが存在するが、Maya ヘルプ: Python API 2.0 を使用する を読む限り互換性はない。
新しい API クラスと古い API クラスを同じスクリプト内で使用することができますが、 それらのオブジェクトには相互運用性はありません。
APIに互換性がないということは、プログラム内でバージョンを明示する必要があるはず。先のAutodeskのドキュメントを読み進めるとこのように記されている。
新しい API を使用するプラグインを記述する場合、プラグインは maya_useNewAPI と呼ばれる関数を定義しなければなりません。
さらに、Maya ヘルプ: Maya Maya Python プラグインの Learning Path を読むと、よりショッキングな記述がある。同APIの2.0は1.0の機能を受け継いでいるわけではないようだ。廃止されたAPIがあって、そのような流れなら理解できるが、下記の記述はAPIに対する不安を抱かせる。本当に大丈夫なのか。
2.0 API は高速化され、より「Python に近い」ものになりましたが、まだ 1.0 のすべてのフィーチャは 2.0 で使用 できません。この API と旧式の 1.0 API の違いについては、「Maya Python API 2.0」を参照してください。
このように私はMaya Python APIに不安を感じているが、業界の方々は本当にこのAPIを使っているのだろうか。
プラグインの実装
気を取りなして、具体的な実装方法について見ていきたい。どうやらMayaのプラグインには種類があるようだ。ここでは大まかな流れを把握したいので、Hello Worldと表示するコマンドプラグインを作っていく。
まずはMayaのプラグイン機構に対応するために実装が必要のメソッドを探す。Maya ヘルプ: コマンド プラグインにはこのように書かれている。
Maya プラグインには initializePlugin() および uninitializePlugin() という 2 つの関数が必要であり、 それぞれ Maya がプラグインのロードおよびアンロードを試みるときに呼び出されます。 これら 2 つの関数がファイル内に存在しない場合、プラグインはロードに失敗します。
つまり、Python API 2.0を使ってMayaプラグインを実装する場合は前述のmaya_useNewAPI()を含め下記のメソッドの実装が必要だ。
- maya_useNewAPI()
- initializePlugin()
- uninitializePlugin()
コマンドプラグインの場合には、Mayaに読み込ませるためにクラス MFnPlugin が持つregisterCommandおよびderegisterCommandの実装をする。initializePluginでregisterCommandを呼び、uninitializePluginでderegisterCommandを呼ぶといった形になる。
実際に処理内容は、maya.api.OpenMaya.MPxCommandクラスを継承し、doItメソッドに記述する。今回はここにHello Worldと出力する処理を入れる。
プラグインのロードとパス
さて、次に自作プラグインのデプロイ先について調べたい。
Mayaは特定のパスからプラグインをロードする。このパスは同アプリのスクリプトエディタで"getenv MAYA_PLUG_IN_PATH"とMELコマンドを実行することで確認が可能だ。実行結果はOS毎に異なる。AutodeskのMaya ヘルプ: ファイル パス変数に詳細がある。下表に示す。なお、変数で表記できるところはそのようにした。
Windows
%SystemDrive%:/Users/%USERNAME%/Documents/maya/{version}/plug-ins{ユーザ フォルダ}/Documents/maya/plug-ins{Maya ディレクトリ}/bin/plug-ins
Mac OS X
$HOME/Library/Preferences/Autodesk/maya/{version}/plug-ins$HOME/Library/Preferences/Autodesk/maya/plug-ins/Users/Shared/Autodesk/maya/{version}/plug-ins/Users/Shared/Autodesk/maya/plug-ins/Applications/Maya {version}/Maya.app
Linux
$MAYA_APP_DIR/maya/{version}/plug-ins$MAYA_APP_DIR/maya/plug-ins/usr/autodesk/userconfig/maya/{version}/plug-ins/usr/autodesk/userconfig/maya/plug-ins$MAYA_LOCATION/bin/plug-ins
実際にどこまでのパスをMayaが認識しているかは各自で確認されたい。
もし、上記の他に任意のパスを追加したい場合は環境変数 MAYA\_PLUG\_IN\_PATHにそのパスを宣言すればよい。シェルがbashなら、$HOME/.bashrcに以下のように追記する。なお、この値が有効になるのはbashからMayaを実行した時である。
下記はHello Worldを出力するコードである。興味のある方はMayaのプラグインマネージャーで読み込み、スクリプトエディタでHelloWorldと実行してみてほしい。