Tutorial on Min3D framework using Android Studio

Salam peeps,


UPDATES***, the model on the old link is no longer working. so i have create a github repo, where i put the source code in a project, you guys can try to clone in and run on your android studio device emulator or directly on your phone, Ive replaced the model with a cube.

https://github.com/aliaramli/Min3DTutorial




Previously i ve posted tutorial on min3D using eclipse IDE, i believe most of us has moved to Android Studio IDE in developing android apps?

As previous tutorial shows a lot of support from readers and among hot post in my blog, i ve decided to post the same tutorial but this time using Android Studio.

For those who are familiar with Eclipse/Android Studio migration they might not have problem in running this tutorial.


For more detail explanation on min3D please visit this website page

Ok lets get started.

Step One
Create a new android project in android studio. you may name it as what you like, below are how i defined my project settings.

new Activity class created as defined above.


Step two
Create a package name min3d under java folder as below

Step three
Checkout the min3d framework code from SVN into our new project.
SVN path : http://min3d.googlecode.com/svn/trunk
**UPDATED..use github source code for min3d library at https://github.com/mengdd/min3d


select only the min3d package under src

 

in checkout path, choose  the newly create min3d package.

in end we can see under our android explorer checkout code added to the new min3d package. after checkout completed android studio will prompt to open the new checkout in another window. select open in another window. then you may close the newly open window and go back to our project window.

 
Step four
Download obj , mtl and png files from

 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 five
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 Six
Res folder

Under res folder create a folder name raw..
Insert the obj and mtl file inside that folder
It should be like this, if you cant see the newly create raw folder please refresh the res folder or rebuild project.

Under res folder create a folder name drawable

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

Step Seven

Code the main activity class as below.

  
package my.blogspot.ubuntuanakramli.min3dtutorial;

import android.app.Activity;
import android.support.v7.app.AppCompatActivity;
import android.os.Bundle;
import android.view.Menu;
import android.view.MenuItem;

public class Min3dTutActivity extends Activity {

    @Override    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_min3d_tut);
    }

    @Override    public boolean onCreateOptionsMenu(Menu menu) {
        // Inflate the menu; this adds items to the action bar if it is present.        getMenuInflater().inflate(R.menu.menu_min3d_tut, menu);
        return true;
    }

    @Override    public boolean onOptionsItemSelected(MenuItem item) {
        // Handle action bar item clicks here. The action bar will        // automatically handle clicks on the Home/Up button, so long        // as you specify a parent activity in AndroidManifest.xml.        int id = item.getItemId();

        //noinspection SimplifiableIfStatement        if (id == R.id.action_settings) {
            return true;
        }

        return super.onOptionsItemSelected(item);
    }
}
  

Create a new class under your activity package, name the class as Obj3DView

package my.blogspot.ubuntuanakramli.min3dtutorial;

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(), "my.blogspot.ubuntuanakramli.min3dtutorial: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 "

"my.blogspot.ubuntuanakramli.min3dtutorial:raw/face_obj"

IParser myParser = Parser.createParser(Parser.Type.OBJ, getResources(), "my.blogspot.ubuntuanakramli.min3dtutorial:raw/face_obj",true);

Step Eight
Edit AndroidManifest.xml

change the activity name.

<activity    android:name=".Obj3DView"    android:label="@string/app_name" >
    <intent-filter>
        <action android:name="android.intent.action.MAIN" />
        <category android:name="android.intent.category.LAUNCHER" />
    </intent-filter>
</activity>

Step Nine
Run it!!

additional ** avd setting to run project in android emulator. else the app will
stopped itself, ensure that you uncheck the host gpu.

Result!