一、简述

　　现在，移动游戏和移动应用开发极为热门！游戏中需要有时髦漂亮的图形，其设计标准比以前任何时候都要高。本文将告诉你怎样用酷毙的移动3d图形api为j2me设备开发3d图形游戏。

　　如果你在用midp1.0进行用户接口编程，那么有两条路你可以选择：使用高级的ui类或者一切由你自己从头开始。作为游戏开发者，第一种选择往往是不可能的；这是为什么游戏开发者不得不为他们的高级游戏开发自己的3d引擎的原因。无疑，这需要付出大量的时间和努力，而缺乏浮点数支持的cldc 1.0（midp 1.0正是建于其上）对问题的解决没有多大帮助。

　　在midp 2.0中，有一个可选的叫移动3d图形api的软件包，或者叫jsr 184。该api是第一个基于java标准开发的移动设备上的三维图形软件包。该api既有高级又有低级图形特征；其中，高级特征称为保留模式，低级特征称为立即模式。保留模式使得开发者有可能使用场景图形并使场景中的物体根据虚拟相机和灯光的位置进行自身的着色。立即模式能够允许应用程序直接进行物体绘制。如果需要，可以在同一个应用程序中使用这两种模式。

　　本文着重介绍立即模式。

　　二、3d api

　　让我们以列举和解释该3d api中的类作为开始。除了这些api外，jsr 184还包含了一个场景图形结构和一个相应的文件格式以有效地管理和配置3d内容。该文件格式定义了一种m3g文件，这种文件典型地从3d建模文件应用程序中转换而来。

　　表1．3d api类

类	描述
animationcontroller	控制动画顺序。
animationtrack	把一个keyframesequence同一个animationcontroller相关联。
appearance	定义一个网眼（mesh）或一个spring3d的着色属性的一组对象。
background	定义视图是怎样被清除的。
camera	一个场景图顶点，它定义了场景中观察者的位置以及从3d到2d的投影。
compositingmode	一个appearance类，它封装了每一个像素的合成属性。
fog	一个appearance类，它包含了雾化的有关属性。
graphics3d	一个单独的3d图形上下文。所有的着色操作都是在该类中的render()方法中实现的。
group	一个场景图形结点，它存储了一个无序的结点集作为它的子结点。
image2d	一个二维图像，可用于纹理，背景，或者精灵图像。
indexbuffer	该类定义了如何把顶点连接起来以形成一个几何体。
keyframesequence	封装了一系列的具有时间戳和矢量值的关键帧的动画数据。
light	描述了不同类型的光源。
loader	下载和反串行化图形结点及结点成分，以及整个场景图形。
material	封装了进行光学计算的材质属性。
mesh	描述了一个3d对象，它是用多边形面定义的。
morphingmesh	描述了一个顶点－变形的多边形网眼。
node	所有场景图形结点的抽象基类。其五个具体子类是：camera，mesh，sprite3d，light和group。
object3d	所有可以成为3d世界中组成部分的对象的抽象基类。
polygonmode	封装了多边形级别属性。
rayintersection	存储了对于分割的mesh或sprite3d的引用，以及有关分割点的信息。
skinnedmesh	描述了一个框架动画的多边形网眼。
sprite3d	用3d位置来描述一个2d图像。
texture2d	封装了一个2d纹理图像和一个属性集合，这些属性指出该图像是如何应用到子网眼上的。
transform	一个通用的4x4的浮点数矩阵，用来描述一个变换。
transformable	node和texture2d类的抽象基类。
trianglestriparray	定义了一个三角形带数组。
vertexarray	一个整型矢量数组，描述了顶点位置，法线，颜色或者纹理坐标。
vertexbuffer	存储对于vertexarrays的引用，它包含了一个顶点集的位置，颜色，法线，以及纹理坐标。
world	一个特别的group结点，它作为场景图最顶层的容器。

三、举例

　　我们将开发一个简单的旋转一个多边形的3d应用程序为例。该多边形是一个立方体，它的纹理是一张旧汽车相片。列表1展示了例程midlet的主要类-应用程序的中心类。该类负责创建应用程序并建立起运行mycanvas的计时器。

　　列表1. midletmain类

import javax.microedition.midlet.*; import javax.microedition.lcdui.*; import java.util.*; public class midletmain extends midlet { 　static midletmain midlet; 　mycanvas d = new mycanvas(); 　timer itimer = new timer(); 　public midletmain() { 　　this.midlet = this; 　} 　public void startapp() { 　　display.getdisplay(this).setcurrent(d); 　　itimer.schedule( new mytimertask(), 0, 40 ); 　} 　public void pauseapp() {} 　public void destroyapp(boolean unconditional) {} 　public static void quitapp() { 　　midlet.destroyapp(true); 　　midlet.notifydestroyed(); 　　midlet = null; 　} 　class mytimertask extends timertask { 　　public void run() { 　　　if( d != null ) { 　　　　d.repaint(); 　　　} 　　} 　} }

　　列表2显示了mycanvas类，该类包含了应用程序的所有图形逻辑。init()方法负责结点的创建，纹理文件的装载并设置纹理，外观和背景也被一起设置。paint()方法负责着色并旋转立方体。图1展示了正在一个模拟器中运行的实际程序。

　　列表2. mycanvas类

import javax.microedition.lcdui.*; import javax.microedition.m3g.*; public class mycanvas extends canvas { 　private graphics3d graphics3d; 　private camera camera; 　private light light; 　private float angle = 0.0f; 　private transform transform = new transform(); 　private background background = new background(); 　private vertexbuffer vbuffer; 　private indexbuffer indexbuffer; 　private appearance appearance; 　private material material = new material(); 　private image image; 　public mycanvas() { 　　// 创建displayable对象以探听命令事件 　　setcommandlistener(new commandlistener() { 　　　public void commandaction(command c, displayable d) { 　　　　if (c.getcommandtype() == command.exit) { 　　　　　midletmain.quitapp();}} 　　　　}); 　　　　try { init();} 　　　　catch(exception e) { e.printstacktrace();} 　　　} 　　/** 　　* 组件的初始化 　　*/ 　　private void init() throws exception { 　　　addcommand(new command("exit", command.exit, 1)); 　　　graphics3d = graphics3d.getinstance(); 　　　camera = new camera(); 　　　camera.setperspective( 60.0f,(float)getwidth()/ (float)getheight(),1.0f,1000.0f ); 　　　light = new light(); 　　　light.setcolor(0xffffff); 　　　light.setintensity(1.25f); 　　　short[] vert = { 　　　　5, 5, 5, -5, 5, 5, 5,-5, 5, -5,-5, 5, 　　　　-5, 5,-5, 5, 5,-5, -5,-5,-5, 5,-5,-5, 　　　　-5, 5, 5, -5, 5,-5, -5,-5, 5, -5,-5,-5, 　　　　5, 5,-5, 5, 5, 5, 5,-5,-5, 5,-5, 5, 　　　　5, 5,-5, -5, 5,-5, 5, 5, 5, -5, 5, 5, 　　　　5,-5, 5, -5,-5, 5, 5,-5,-5, -5,-5,-5 }; 　　　vertexarray vertarray = new vertexarray(vert.length / 3, 3, 2); 　　　vertarray.set(0, vert.length/3, vert); 　　　//立方体的各个结点法线 　　　byte[] norm = { 　　　　0, 0, 127, 0, 0, 127, 0, 0, 127, 0, 0, 127, 　　　　0, 0,-127, 0, 0,-127, 0, 0,-127, 0, 0,-127, 　　　　-127, 0, 0, -127, 0, 0, -127, 0, 0, -127, 0, 0, 　　　　127, 0, 0, 127, 0, 0, 127, 0, 0, 127, 0, 0, 　　　　0, 127, 0, 0, 127, 0, 0, 127, 0, 0, 127, 0, 　　　　0,-127, 0, 0,-127, 0, 0,-127, 0, 0,-127, 0 }; 　　　vertexarray normarray = new vertexarray(norm.length / 3, 3, 1); 　　　normarray.set(0, norm.length/3, norm); 　　　//各个结点的纹理坐标 　　　short[] tex = { 　　　　1, 0, 0, 0, 1, 1, 0, 1, 　　　　1, 0, 0, 0, 1, 1, 0, 1, 　　　　1, 0, 0, 0, 1, 1, 0, 1, 　　　　1, 0, 0, 0, 1, 1, 0, 1, 　　　　1, 0, 0, 0, 1, 1, 0, 1, 　　　　1, 0, 0, 0, 1, 1, 0, 1 }; 　　　vertexarray texarray = new vertexarray(tex.length / 2, 2, 2); 　　　texarray.set(0, tex.length/2, tex); 　　　int[] striplen = { 4, 4, 4, 4, 4, 4 }; 　　　// 对象的vertexbuffer 　　　vertexbuffer vb = vbuffer = new vertexbuffer(); 　　　vb.setpositions(vertarray, 1.0f, null); 　　　vb.setnormals(normarray); 　　　vb.settexcoords(0, texarray, 1.0f, null); 　　　indexbuffer = new trianglestriparray( 0, striplen ); 　　　//纹理图像 　　　image = image.createimage( "/pic1.png" ); 　　　image2d image2d = new image2d( image2d.rgb, image ); 　　　texture2d texture = new texture2d( image2d ); 　　　texture.setfiltering(texture2d.filter_nearest,texture2d.filter_nearest); 　　　texture.setwrapping(texture2d.wrap_clamp,texture2d.wrap_clamp); 　　　texture.setblending(texture2d.func_modulate); 　　　// 创建外观（appearance）对象 　　　appearance = new appearance(); 　　　appearance.settexture(0, texture); 　　　appearance.setmaterial(material); 　　　material.setcolor(material.diffuse, 0xffffffff); 　　　material.setcolor(material.specular, 0xffffffff); 　　　material.setshininess(100.0f); 　　　background.setcolor(0xffffcc); 　　} 　　protected void paint(graphics g) { 　　　graphics3d.bindtarget(g, true, 　　　graphics3d.dither | graphics3d.true_color); 　　　graphics3d.clear(background); 　　　//设置照相机 　　　transform transform = new transform(); 　　　transform.posttranslate(0.0f, 0.0f, 30.0f); 　　　graphics3d.setcamera(camera, transform); 　　　//设置灯光 　　　graphics3d.resetlights(); 　　　graphics3d.addlight(light, transform); 　　　//设置旋转 　　　angle += 1.0f; 　　　transform.setidentity(); 　　　transform.postrotate(angle, 1.0f, 1.0f, 1.0f); 　　　graphics3d.render(vbuffer, indexbuffer, appearance, transform); 　　　graphics3d.releasetarget(); 　} }

图1 正在一个模拟器中运行的应用程序

　　四、小结

　　jsr 184对于可以运行midp 2.0的设备来说，是一个节省时间和空间的可选的软件开发包。它允许开发者使用两种图形方式-保留模式和立即模式-来产生3d图形。本文集中讲述了立即模式，并给出一个例子程序来说明怎样使用3d。