サンプルプログラム説明 - MikuMikuStudio Wiki - MikuMikuStudio

サンプルプログラム説明

このページではサンプルプログラムの中身を解説します。

Assetsとは

Assetsとはプログラムで使用されるデータの集合です。

Assetsの構造

まずMikuMikuStudioでサンプルプログラムを開き、左側のProjectのツリー（赤○で囲った部分）を見て下さい。このProject Assetsというところにプログラムで使用するPMDモデルやテクスチャファイルなどが格納されています。

Assets

このサンプルでは初音ミクのモデルはModelの下に、モーションデータはmotionの下に格納されています。

toonの下にはトゥーンシェードで使用するビットマップが格納されています。

プログラムの構造

ProjectのツリーのSource Packageというところを展開するとMain.javaというファイルがあります。これがプログラム本体です。

Source Package

Main.javaをダブルクリックするとファイルが開きます。

ソースコード

Main.java

 package mygame;
 
 import com.jme3.app.SimpleApplication;
 import com.jme3.light.AmbientLight;
 import com.jme3.light.DirectionalLight;
 import com.jme3.light.PointLight;
 import com.jme3.math.ColorRGBA;
 import com.jme3.math.Vector3f;
 import com.jme3.scene.Geometry;
 import projectkyoto.jme3.mmd.CartoonEdgeProcessor;
 import projectkyoto.jme3.mmd.PMDNode;
 import projectkyoto.jme3.mmd.UpdateControl;
 import projectkyoto.jme3.mmd.vmd.VMDControl;
 import projectkyoto.mmd.file.VMDFile;
 
 /**
  * test
  * <p/>
  * @author kobayasi
  */
 public class Main extends SimpleApplication {
 
     PointLight pl;
     Geometry lightMdl;
     VMDControl vmdControl;
 
     public static void main(String[] args) {
 //        com.jme3.system.JmeSystem.setLowPermissions(true);
         Main app = new Main();
         app.start();
     }
 
     @Override
     public void simpleInitApp() {
         flyCam.setMoveSpeed(50);
         // Load Model
         PMDNode pmdNode = (PMDNode) assetManager.loadModel("/Model/初音ミク.pmd");
         VMDFile vmd = (VMDFile) assetManager.loadAsset("/motion/ごまえミク.vmd");
         vmdControl = new VMDControl(pmdNode, vmd);
         pmdNode.addControl(vmdControl);
         pmdNode.addControl(new UpdateControl(pmdNode));
         vmdControl.setFrameNo(0);
         vmdControl.setPause(true);
 
         rootNode.attachChild(pmdNode);
 
 
         DirectionalLight dl = new DirectionalLight();
         dl.setDirection(new Vector3f(1, 0, -5).normalizeLocal());
         dl.setColor(ColorRGBA.White.mult(0.5f));
         rootNode.addLight(dl);
         AmbientLight al = new AmbientLight();
         al.setColor(ColorRGBA.White.mult(1.0f));
         rootNode.addLight(al);
         CartoonEdgeProcessor cartoonEdgeProcess = new CartoonEdgeProcessor();
         viewPort.addProcessor(cartoonEdgeProcess);
 
         cam.setLocation(new Vector3f(0, 10, 40));
     }
     float time = 0;
 
     @Override
     public void simpleUpdate(float tpf) {
         time += tpf;
         if (time > 5) {
             // start after 5 seconds.
             if (vmdControl != null) {
                 vmdControl.setPause(false);
             }
         }
     }
 }

ソースはたったこれだけです。

順番に解説していきます。

クラス定義

 public class Main extends SimpleApplication {

MainクラスはSimpleApplicationクラスを継承しています。SimpleApplicationクラスは最も一般的なアプリケーションの機能を提供します。

main メソッド

     public static void main(String[] args) {
 //        com.jme3.system.JmeSystem.setLowPermissions(true);
         Main app = new Main();
         app.start();
     }

Mainクラスのインスタンスを作成し、start()メソッドを呼んでいます。 startメソッドが呼ばれるとSimpleApplicationはまず設定ダイアログを表示し、ユーザーが設定した解像度やフレームレートでOpenGLを初期化し、メインウィンドウを表示します。

simpleInitApp メソッド

アプリケーションの初期化を行うメソッドです。

カメラ設定

         flyCam.setMoveSpeed(50);

SimpleApplicationでは標準でflyCamが用意されています。flyCamはユーザーのマウスやキーボード操作で自由に動かす事の出来るカメラです。 ここではカメラの移動速度を50にセットしています。

PMD,VMDファイル読み込み

         PMDNode pmdNode = (PMDNode) assetManager.loadModel("/Model/初音ミク.pmd");
         VMDFile vmd = (VMDFile) assetManager.loadAsset("/motion/ごまえミク.vmd");

PMDモデルとVMDモーションデータをassetsから読み込みます。

コントロール設定

         vmdControl = new VMDControl(pmdNode, vmd);
         pmdNode.addControl(vmdControl);
         pmdNode.addControl(new UpdateControl(pmdNode));

モーションを再生するためのコントロールをpmdNodeに設定します。

vmdControlはVMDファイルの再生を行うコントロールです。 各フレームごとにVMD再生、IK計算、物理演算を行いボーンの位置を更新します。

UpdateControlは表情モーフィングと、vmdControlで更新されたボーンの位置情報をジオメトリに反映させるコントロールです。

vmdControlの設定

         vmdControl.setFrameNo(0);
         vmdControl.setPause(true);

VMDファイルの再生位置を0フレーム目にセットし、再生を一時停止しています。

シーングラフに追加

         rootNode.attachChild(pmdNode);

rootNodeにPMDモデルを追加します。

ライト追加

         DirectionalLight dl = new DirectionalLight();
         dl.setDirection(new Vector3f(1, 0, -5).normalizeLocal());
         dl.setColor(ColorRGBA.White.mult(0.5f));
         rootNode.addLight(dl);
         AmbientLight al = new AmbientLight();
         al.setColor(ColorRGBA.White.mult(1.0f));
         rootNode.addLight(al);

ライトを追加しています。尚、ライトの追加を忘れると完全な暗闇になり、何も表示されなくなるので注意して下さい。

ここではDirectionalLight（方向のあるライト）とAmbientLight（環境光）を追加しています。

CartoonEdgeProcessor追加

         CartoonEdgeProcessor cartoonEdgeProcess = new CartoonEdgeProcessor();
         viewPort.addProcessor(cartoonEdgeProcess);

CartoonEdgeProcessorはトゥーンシェードの輪郭線を描くプロセッサーです。これを忘れると輪郭線が表示されなくなります。

カメラ初期位置設定

         cam.setLocation(new Vector3f(0, 10, 40));

カメラの初期位置を設定します。

simpleUpdate メソッド

     float time = 0;
 
     @Override
     public void simpleUpdate(float tpf) {
         time += tpf;
         if (time > 5) {
             // start after 5 seconds.
             if (vmdControl != null) {
                 vmdControl.setPause(false);
             }
         }
     }

simpleUpdateメソッドは、各フレームごとに呼ばれるメソッドです。ここではプログラム開始後５秒間経つとvmdControl.setPause(false) を呼び、再生を開始しています。