min3d 引擎学习笔记之一

min3d是一个小巧的android 3d UI引擎， 最近想对其进行深入源码分析， 在深入学习之前， 还是先学会怎么用它吧。

min3d是基于opengl es 1.x的， 它封装了opengl 的一些基本的绘图操作以及绘图管理和渲染操作，形成了一个框架。核心类主要包括场景类(Scene), 渲染类(Render)以及场景上的对象类(Object3d)及其子类。它提供了一个活动类RenderActivity， 使用者只需要实现其中的initScene()和updateScene()方法即可。

下面给出一个使用的例子：

如下代码绘制一个正方形，并进行纹理贴图。

import min3d.Shared;
import min3d.Utils;
import min3d.core.Object3d;
import min3d.core.RendererActivity;
import min3d.vos.Number3d;
import min3d.vos.RenderType;
import min3d.vos.Uv;
import android.graphics.Bitmap;

public class TestAndroid8Activity extends RendererActivity {

Object3d square;

@Override
public void initScene() {

Bitmap b = Utils.makeBitmapFromResourceId(this, R.drawable.icon);

/**
* 采用glDrawElements()方法， 一个face代表一个三角形
*/

square = new Object3d(4, 2, true, false, false);
square.vertices().addVertex(new Number3d(-1.0f, -1.0f, 0), new Uv(0, 0), null, null);
square.vertices().addVertex(new Number3d(1.0f, -1.0f, 0), new Uv(0, 1), null, null);
square.vertices().addVertex(new Number3d(-1.0f, 1.0f, 0), new Uv(1, 0), null, null);
square.vertices().addVertex(new Number3d(1.0f, 1.0f, 0), new Uv(1, 1), null, null);
square.renderType(RenderType.TRIANGLE_STRIP);
//		square.faces().add(0, 1, 2);
//		square.faces().add(1, 3, 2);
Utils.addQuad(square, 2, 3, 1, 0);
square.doubleSidedEnabled(true);

/**
* 采用glDrawArrays()方法， 忽略face
*/
//		square = new Object3d(4, 0, false, false, false);
//		square.vertices().addVertex(new Number3d(-1.0f, -1.0f, 0), null, null, null);
//		square.vertices().addVertex(new Number3d(1.0f, -1.0f, 0), null, null, null);
//		square.vertices().addVertex(new Number3d(-1.0f, 1.0f, 0), null, null, null);
//		square.vertices().addVertex(new Number3d(1.0f, 1.0f, 0), null, null, null);
//		square.renderType(RenderType.TRIANGLE_STRIP);
//		square.ignoreFaces(true);
//		square.doubleSidedEnabled(true);

Shared.textureManager().addTextureId(b, "icon", false);
square.textures().addById("icon");

b.recycle();

scene.addChild(square);

}

@Override
public void updateScene() {
// TODO Auto-generated method stub
square.rotation().y++;
}

}