17.プラグイン

Sceneオブジェクトを使って、MMM内部の様々なオブジェクトにアクセスすることができます。

Sceneオブジェクトは下記のような構造を持っています。

各要素に対して可能な操作については、クラスライブラリを参照してください。

Scene

+ モデル

+ 材質

+ 表示枠

+ ボーン

+ レイヤ

+ キーフレーム

+ プロパティ

+ キーフレーム

+ アクセサリ

+ レイヤ

+ キーフレーム

+ エフェクト

+ キーフレーム

+ カメラ

+ レイヤ

+ キーフレーム

+ ライト

+ キーフレーム

+ 全体プロパティ

+ キーフレーム

+ 字幕

+ オーディオ

+ ブックマーク

+ スクリーンオブジェクト （後述）

コマンドプラグインでは、ICommandPlugin インターフェースを実装する必要があります。

Runメソッド内に、プラグインの処理を記述します。

なお、コマンドプラグインはRunメソッド内で処理を完結する必要があります。

Runメソッド内で、フォームなどの別メソッドを作成した処理は保証されません。

常駐型プラグインでは、IResidentPlugin インターフェースを実装する必要があります。

Initializeメソッドにて、初期化処理を、

Updateメソッドにて、毎フレーム実行される処理を記述します。

また、プラグインが有効化されたときの処理を Enabledメソッドに、無効化されたときの処理を記述します。

常駐型プラグインでは、Sceneオブジェクトから取得する情報はUpdate内で完結させる必要があります。

Updateが終わって次のUpdateが開始されるまでの間に、ユーザーによりモデルやキーフレームが追加/削除されることがあるからです。

MMM内部データについては、ローカルに保持しないようにしてください。

ScreenObjectを使用すると、MMMのスクリーン上に、画像を配置し、マウスイベントを取得することができます。

画像は2D位置（スクリーン上）、3D位置（三次元空間内）に置くことができます。

Initializeメソッド内でScreenObjectインスタンスを生成し、Scene.ScreenObject.Add メソッドで追加します。

作成したScreenObjectを破棄は、プラグイン内で行ってください。

プラグインのデータをプロジェクトに保存するには、ICanSavePluginインターフェースを実装する必要があります。

OnSaveProjectで保存データをStreamとして返し、

OnLoadProjectでStreamから保存データを受け取ります。

なお、どちらのメソッドでもStreamはDisposeする必要はありません。

プラグインはユーザーコントロールを持つことができます。

IHaveUserControlインターフェースを実装する必要があります。

ユーザーコントロールは、CreateControlメソッドにて生成するようにしてください。

作成されたユーザーコントロールは、MMM上でプラグイン画面に表示されます。

- DxMath (MikuMikuMoving付属)

- MikuMikuPlugin (MikuMikuMoving付属)

- System.Drawing

- System.Windows.Forms

その他不要なアセンブリを削除し、必要に応じてアセンブリを追加します。