Tutorial on min3d framework

Salam all. This time I want to share a bit, how I tried out the mid3d framework for the first time. Acknowledge that I am new to android development.  I just follow the tutorial on Mat-d website but there are certain things that I don’t understand how they actually work. Thus I want to share what I did step by step to make this example work. For explanations on coding/steps or errors please visit Mat-d website here J you ll understand more ….

mat-d original tutorial load a 3d obl model with min3d for android

Step one.

Download min3d into your eclipse.

Select File>Import>SVN>Checkout projects from SVN

Next.

Choose radio button : Create a new repository location

Next.

Enter the svn location

http://min3d.googlecode.com/svn/trunk

the thing that we want to check out from the svn is the min3d framework code.

Step two.

Download obj file 

www.3dvia.com …you need to register first..it has free acc version.. and download the following 3d model of a face http://www.3dvia.com/models/66964B5C6E405264/face

Change the face.obj into face_obj

Change the face.mtl into face_mtl
Change the image name to use all lowercase, as android doesnot allow images with capital letter.
from face_eyeL_hi.jpg to face_eyel_hi.jpg
from face_eceR_hi.jpg to face_ecer_hi.jpg

Step three.

Create android project for min3d test

Add main java name  Min3dTest.java

Add second java class Obj3DView.java

Under source create new package by right click and choose new package.

Name the package min3d.

Copy all these files as follows

Then paste inside the new package you created just now .. in min3d package

After paste the package should look like this …

Step four

Code the java classes…

For the Min3dTest please use this code…to call the load object 3d activity

  
 package com.example.min3dtest;  
 import android.os.Bundle;  
 import android.app.Activity;  
 import android.content.Intent;  
 public class Min3dTest extends Activity {  
   /** Called when the activity is first created. */  
   @Override  
   public void onCreate(Bundle savedInstanceState)   
   {  
     super.onCreate(savedInstanceState);  
      this.startActivity( new Intent(this,Obj3DView.class));  
   }  
 }  

***the package should be according to your declaration while creating your project.

For the Obj3DView please use this code

 package com.example.min3dtest;  
 import min3d.core.Object3dContainer;  
 import min3d.core.RendererActivity;  
 import min3d.parser.IParser;  
 import min3d.parser.Parser;  
 import min3d.vos.Light;  
 public class Obj3DView extends RendererActivity {  
   private Object3dContainer faceObject3D;  
   /** Called when the activity is first created. */  
   @Override  
   public void initScene()  
   {  
     scene.lights().add(new Light());  
     scene.lights().add(new Light());  
     Light myLight = new Light();  
     myLight.position.setZ(150);  
     scene.lights().add(myLight);  
     IParser myParser = Parser.createParser(Parser.Type.OBJ, getResources(), "com.example.min3dtest:raw/face_obj",true);  
     myParser.parse();  
     faceObject3D = myParser.getParsedObject();  
     faceObject3D.position().x = faceObject3D.position().y = faceObject3D.position().z = 0;  
     faceObject3D.scale().x = faceObject3D.scale().y = faceObject3D.scale().z = 0.009f;  
     // Depending on the model you will need to change the scale faceObject3D.scale().x = faceObject3D.scale().y = faceObject3D.scale().z = 0.009f;  
     scene.addChild(faceObject3D);  
   }  
   @Override  
   public void updateScene() {  
     faceObject3D.rotation().x += 0.5;  
     faceObject3D.rotation().z += 1;  
   }  
 }   

 -------------------------------------------------------------------------------------------------------------------
***take note here the resource must be the same as you have declared mine one is "

com.example.min3dtest:raw/face_obj

 IParser myParser = Parser.createParser(Parser.Type.OBJ, getResources(), "com.example.min3dtest:raw/face_obj",true);  

--------------------------------------------------------------------------------------------------------------------

Step five 

Res folder

Under res folder create a folder name raw..

Insert the obj and mtl file inside that folder

It should be like this 

Under res folder create a folder name drawable

Insert all the model texture into it like picture below notice all names in lowercase

 

Step 6 

Edit face_mtl and face_obj

Edit the face_mtl into this. Notice the differences before this it has tabulation and spaces between lines.. this will not let our object to have textures..
ensure that the map_Kd face_eyel_hi.jpg above the Kd 0.7 0.7 0.7 repeat the same thing for other .jpg. please refer below.

newmtl Texture0  
Ns 20  
d 1  
illum 2  
map_Kd face_eyel_hi.jpg  
Kd 0.7 0.7 0.7  
Ks 0 0 0  
Ka 0 0 0  
newmtl Texture1  
Ns 20  
d 1  
illum 2  
map_Kd face_eyer_hi.jpg  
Kd 0.7 0.7 0.7  
Ks 0 0 0  
Ka 0 0 0  
newmtl Texture2  
Ns 20  
d 1  
illum 2  
map_Kd face_skin_hi.jpg  
Kd 0.7 0.7 0.7  
Ks 0 0 0  
Ka 0 0 0  
newmtl Texture3  
Ns 20  
d 1  
illum 2  
map_Kd face_sock.jpg  
Kd 0.7 0.7 0.7  
Ks 0 0 0  
Ka 0 0 0  

IN face_obj 

eyeL_hi to eyel_hi

and

ayeR_hi to eyer_hi

Step 7 

Edit AndroidManifest.xml

Add this activity into your androidManifest.xml 

 <activity   
       android:name=".Obj3DView"   
       android:label="@string/app_name">  
 </activity>  

Step 8 

Run it!

Save all, build project and run apps. I tried on my real device never try on emulator.. another this because rendering is a bit slow.. please unplug your usb cable after you have run the app.. you will see the 3d object rotating…like this… well Done!

additional ** avd setting to run project in android emulator.