OpenMayaの概略とコンパイル・実行の方法

Maya API の種類

OpenMayaと呼ばれているMayaのAPI(Aplication Programming Interface)には以下のものがある。

OpenMaya: 基本的なクラスを集めたライブラリ
OpenMayaUI: ユーザーインターフェイス(GUI)を作るためのライブラリ
OpenMayaAnim: アニメーションのためのライブラリ(デフォーマーやインバース・キネマティクスなど)
OpenMayaFX: ダイナミクスをあつかうためのライブラリ
OpenMayaRender: レンダリングを行うためのライブラリ

これらのAPIを使用してプラグインとアプリケーションを作ることができる。

コンパイル方法と実行(WindowsNT, Visual C++)

まず、最初に簡単なプログラム(helloWorld.cpp)をコンパイルして、プラグインとして読み込めるようにしてみよう。

設定
プラグインをつくるために Visual C++ の設定を行う。
1. 新しいプロジェクトを作る。
  1. ファイル(File) -> 新規作成(New)
  2. Projects tab を選ぶ
  3. Win32 Dynamic-Link Library を選択
  4. プロジェクトのディレクトリを指定
  5. OK ボタンを押す
2. プロジェクトにファイル(プログラムソース)を追加する。
  1. プロジェクト(Project) -> プロジェクトへの追加(Add To Project) -> ファイル(Files)
  2. ファイルのディレクトリとファイル名(helloWorld.cpp)を指定
  3. OK ボタンを押す
3. 新たなマクロとインクルードファイルのパスを追加する。
  1. プロジェクト(Project) -> 設定(Settings)
  2. 設定の対象を"全ての構成"(All Configurations)にする
  3. C/C++ tab を選ぶ
  4. カテゴリ(Category box) でプリプロセッサー(select Preprocessor)を選ぶ
  5. NT_PLUGIN をプリプロセッサの定義(Preprocessor definitions list)に加える
  6. インクルードファイルのパスにincludeファイルのディレクトリを追加する。
  7. OK ボタンを押す
4. ライブラリを追加する。
  1. プロジェクト(Project) -> 設定(Settings)
  2. 設定の対象を"全ての構成"(All Configurations)にする
  3. リンク(Link tab)を選ぶ
  4. カテゴリ(Category box) で"一般"(General)を選ぶ
  5. オブジェクト/ライブラリモジュールにFoundation.lib と OpenMaya.lib をライブラリに加える
  6. OKボタンを押す
5. ランタイムライブラリーを設定。
  1. プロジェクト(Project) -> 設定(Settings)
  2. 設定の対象を"全ての構成"(All Configurations)にする
  3. Settings For box で C/C++ tab を選ぶ
  4. カテゴリ(Category box)で"コード生成"(Code Generation)を選ぶ
  5. 使用するランタイムライブラリ(Use run-time library box)で"マルチスレッド(DLL)"(Multithreaded DLL)を選ぶ
  6. OK ボタンを押す
6. プラグインのエントリーポイントをエクスポートする。
  1. プロジェクト(Project) -> 設定(Settings)
  2. 設定の対象を Win32 Debug にする
  3. リンク(Link tab)を選ぶ
  4. プロジェクトオプション(Project Options box)に
    /export:initializePlugin /export:uninitializePlugin
    を追加
  5. 設定の対象を Win32 Relese にする
  6. 同じくプロジェクトオプション( Project Options box)に
    /export:initializePlugin /export:uninitializePlugin
    を追加
  7. OK ボタンを押す
7. プラグインファイルの拡張子を変更する。
  1. プロジェクト(Project) -> 設定(Settings)
  2. リンク(Link tab)を選ぶ
  3. 設定の対象を Win32 Debug にする
  4. カテゴリ(Category box) で"一般"(General)を選ぶ
  5. 出力ファイル名(Output file name)の拡張子を.mllに変更
  6. 設定の対象を Win32 Relese にする
  7. 出力ファイル名(Output file name)の拡張子を.mllに変更
  8. OK ボタンを押す
8. 変更点をセーブする。
  File -> Save Workspace

プログラムをエディタで書く。


#include <maya/MSimple.h>
#include <maya/MPxCommand.h>

DeclareSimpleCommand( helloWorld, "Alias|Wavefront", "4.0");

MStatus helloWorld::doIt( const MArgList& )
{
	MPxCommand::setResult(MString("Hello World !!\n"));
	return MS::kSuccess;
}

ビルドする。
1. Build -> Set Active Configuration で Debug か Release かを選ぶ
2. Build -> Build
  または、F7
3. helloWorld.mll というプラグインが作られる。
Maya にプラグインとして読み込ませる。
以下のどちらかの方法で読み込む。
- プラグイン・マネージャによって読み込む。
  Choose Window -> General Editors -> Plug-in Manager
- MEL コマンドによって読み込む。
  Maya_PLUG_IN_PATH に指定してあるディレクトリからの場合は以下のコマンドで読み込む。
  loadPlugin "helloWorld";
実行する。
コマンドラインまたは Script Editor から以下のように打ち込んで実行する。
helloWorld

コマンドラインからのコンパイル方法

以下のバッチファイルを実行することによってコンパイルできる。
環境変数 mayahome (Maya をインストールしたディレクトリ)は適宜変更すること。


set prog=helloWorld
set mayahome=c:\aw\maya4.0
cl /nologo /MTd /W3 /Gm /GX /ZI /Od /I "%mayahome%\include" /D "WIN32" /D "_DEBUG" /D "_WINDOWS" /D "_MBCS" /D "_USRDLL" /D "STRINGS_EXPORTS" /D "NT_PLUGIN" /Fp".\%prog%.pch" /YX /Fo".\\" /Fd".\\" /FD /GZ /c .\%prog%.cpp
link kernel32.lib user32.lib gdi32.lib winspool.lib comdlg32.lib advapi32.lib shell32.lib ole32.lib oleaut32.lib uuid.lib odbc32.lib odbccp32.lib foundation.lib openmaya.lib /LIBPATH:"%mayahome%\lib" /export:initializePlugin /export:uninitializePlugin /nologo /dll /incremental:no /pdb:".\%prog%.pdb" /machine:I386 /out:".\%prog%.mll" /implib:".\%prog%.lib" .\%prog%.obj

コンパイル方法と実行(UNIX)

プログラム(helloWorld.cpp)をエディタで書く。


#include <maya/MSimple.h>

DeclareSimpleCommand( helloWorld, "Alias|Wavefront", "4.0");

MStatus helloWorld::doIt( const MArgList& )
{
	printf("Hello World\n");
	return MS::kSuccess;
}

コンパイルする。

IRIX

% CC -n32 -c -I/usr/aw/maya/include -o helloWorld.o helloWorld.cpp 
% CC -n32 -shared -no_transitive_link -o helloWorld.so helloWorld.o -L/usr/aw/maya/lib -lOpenMaya

Linux

%  c++ -shared -O3 -pipe -mpentiumpro -D_BOOL -DLINUX -I/usr/aw/maya/include -L/usr/aw/maya/lib -o helloWorld.so helloWorld.cpp -lOpenMaya

helloWorld.so というファイルが作られる。
Mayaにプラグインとして読み込ませる。
- プラグイン・マネージャによって読み込む。
  Choose Window -> General Editors -> Plug-in Manager
- MEL コマンドによって読み込む。
  loadPlugin "helloWorld";
Maya のプラグインは Maya_PLUG_IN_PATH に設定してあるディレクトリの中から読み込まれる。
helloWorld プラグインを読み込む時は、helloWorld.so というファイルを探して読み込む。
実行する。
コマンドラインまたは Script Editor から以下のように打ち込んで実行する。
helloWorld

参考

Maya
Mayaについての簡単な解説
Maya Programming
MELについての講義(01AD)

Prev | Next
Home | Contents

Mail