Maya .NET API と Maya C++ API の違い

Maya .NET API と Maya C++ API の主な違いは次のとおりです。

getter と setter に代わるプロパティ: C++ API の getter および setter 関数の多くが C# プロパティにマップされています。たとえば、MFnDagNode クラスの isInstanceable および setInstanceable メソッドは、isInstanceable と呼ばれる C# プロパティ(get および set アクセサ)として公開されています。
getter 関数は、値を返し、引数は持たず、アプリケーションの状態に対する識別可能なエフェクトを持たない関数です。getter 関数名は get、is、has、または can のプリフィックスから始まるか、C++ ヘッダーファイルでは「const」関数として修飾されます。setter 関数は、単一の引数を持ち、set のプリフィックスで始まり、getter 関数と同じルート名を持つ void 関数です。対応する setter 関数(同じルート名)を持つ getter 関数は、読み書き可能なプロパティにマップされますが、setter 関数を持たない getter 関数は、読み取り専用プロパティにマップされます。プロパティの名前は getter 関数と同じですが、プリフィックスが除去されています。

場合によっては、新しいプロパティが既存のメソッド名と重複するため、プロパティの名前を変更しなければならい場合があります。Property という語が、新しいプロパティ名に追加されました。たとえば、index() は、indexProperty になりました。

C# のプロパティに関する詳細については、MSDN (http://msdn.microsoft.com/ja-jp/default.aspx)および「プロパティ(C# プログラミングガイド)」を参照してください。
関数ポインタに代わるイベント: MMessage 派生クラス(MSceneMessage、MNodeMessage など)のメッセージ登録メカニズムは、C# イベントパターンに置き換えられました。これにより、MMessage 派生クラスの対応するイベントハンドラに対してコールバックを追加または除去するだけでコールバックを登録または登録解除できるようになりました。
たとえば、MDagMessage::addParentAddedCallback(callback) の代わりに、MDagMessage.ParentAddedEvent += callbackを実行します。

MSceneMessage クラスでは、enum Message の値で指定された各メッセージには独自のイベントハンドラが含まれるようになったため、enum は有効ではなくなりました。たとえば、MSceneMessage::addCallback( MSceneMessage::kSceneUpdate, callback ) の代わりに、MSceneMessage.SceneUpdate += callback を実行します。

オブジェクトのインスタンスに関連するコールバック(MDagPath、MPlug など)の場合、イベントハンドラはそのオブジェクトのクラスで直接見つけることができます。たとえば、MModelMessage::addNodeAddedToModelCallback(obj, callback) の代わりに、obj.NodeAddedToModel += callback (MObjectwith 型の obj を使用)を実行します。

メモリリークが発生しないように、コールバックが不要になった場合は、コールバックを登録解除する(対応するイベントハンドラからコールバックを除去する)必要があります。プラグインが Maya からアンロードされると自動的にコールバックの登録を解除する新しいメカニズムが追加されました。

イベントの使用方法を確認するには、Developer Kit インストールの devkit¥dotnet¥examples フォルダの pluginCallbacks サンプルを参照してください。C# イベントの詳細については、MSDN の「イベント(C# プログラミングガイド)」を参照してください。
MStatus エラーコードに代わる例外: エラーや例外が発生すると、プラグインでは MStatus を返すのではなく、例外が発生します。このパターンが採用されることで、SDK のほとんどの関数は、C# SDK には存在しない MStatus ではなく、void を返します。例外として、C++ で MStatus を使用して行っていた Maya に情報を返す必要があるメソッドについてのみ、この規則は適用されません。詳細については、「.NET API から MStatus 戻りコードを除去する」を参照してください。
IEnumerable<T>の使用: イテレータは、LINQ の使用を容易にする IEnumerable<T>をサポートしています。IEnumerable の詳細については、「Maya .NET API で IEnumerable および LINQ を使用する」および MSDN の「IEnumerable インターフェイス」を参照してください。
.NET コレクションのサポート: Maya API の特殊なコレクションクラス(MPointArray、MIntArray など)は、C# インタフェースの IEnumerable および IList をサポートしています。さらに、これらのクラスには、C# 配列および C# 配列を返すメソッドを受け入れるコンストラクタがあります。C# 配列の詳細については、MSDN の「配列 (C# プログラミングガイド)」を参照してください。
OpenMayaFX クラスがない: OpenMayaFX モジュールのクラスは .NET Maya API に移植されていません。
MDockStation: これは、Maya UI 内への WPF ウィンドウのドッキングを容易にするために定義された新しいクラスです。さらに、MDockStation を使用して、Maya 内に HWND を埋め込むこともできます(WPF だけではなく、WF ウィンドウなども可能)。WPF コントロールの詳細については、MSDN の「WPF の概要」を参照してください。