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を実行した時である。

GitHub Gistでコードを見る

下記はHello Worldを出力するコードである。興味のある方はMayaのプラグインマネージャーで読み込み、スクリプトエディタでHelloWorldと実行してみてほしい。

GitHub Gistでコードを見る