1、第八讲 NEC扩展API1. 引言在上讲中，我们对网络的相关功能进行了解说。截止上讲以前的讲座，我们讲述的都是关于MIDP的JAVA相关技术的内容，本讲将收尾，介绍NEC扩展API。2. NEC扩展NEC扩展API中有如下的类。类AudioClip 处理声音数据类。已在第五讲解说。AudioListenerAudio事务监听器。已在第五讲解说。ImageEffector 颜色变换类。将在本讲解说。ImageMap模拟PCG（）类。因为能轻松的把多种画面分配在格子里，所以能很容易的制作出背景和棋面（ImageMap）。不在本讲解说。Media 取得媒体数据类。已在第五讲解说。NxCanvasNE
2、C扩展canvas，支持多重按键。将在本讲解说。NxGraphicsNEC扩展Graphics。描画Sprite、ImageMap。将在本讲解说。PhoneControl 控制震动、逆光类。不在本讲解说。Sprite Sprite类。将在本讲解说。SpriteSet管理Sprite类。将在本讲解说。关于上表的ImageEffector、NxCanvas、NxGraphics、Sprite、SpriteSet，我们将按顺序展开介绍。2.1. 扩展图形类 NxGraphics 类是Graphics 的扩展类。下面介绍可以实现的Sprite、ImageMap的描画以及矩形区域的复制。NxGraphi
3、cs 类定义了以下方法。void copyArea(int sx, int sy, int width, int height, int dx, int dy)把Canvas描画的矩形区域复制后描画。利用此功能能够把描画过一次的东西复制下来进行描画，因此当描画相同内容的拷贝时，可以简化步骤。void drawImageMap(ImageMap map, int x, int y)对将多种画面分配在格子里的ImageMap进行描画。void drawSpriteSet(SpriteSet sprites)描画Sprite。后面有Sprite的相关介绍。static NxGraphics getN
4、xGraphics(javax.microedition.lcdui.Graphics g)取得NxGraphics对象。下面展示的是使用copyArea方法的范例。该范例使用copyArea对移动球的一部分进行复制。import java.util.Timer;import java.util.TimerTask;import javax.microedition.lcdui.Canvas;import javax.microedition.lcdui.Graphics;import javax.microedition.lcdui.Image;import com.nec.graphics
5、.NxGraphics;/* * copyArea范例动画canvas */public class CopyAreaMovingBallCanvas extends Canvas private int x; /球的x坐标private Image img;private Timer timer;private TimerTask task;/* * 构造函数 */public TimerMovingBallCanvas() /读取画面tryimg = Image.createImage(/back.PNG);catch(Exception e)e.printStackTrace();/ 设
6、定Timer,TimerTasktimer = new Timer();task = new TimerMovingBallTask(this);timer.schedule(task, 100, 100); /从100毫秒后起每100毫秒执行一次任务/* * 描画方法 */protected void paint(Graphics g) /清除画面g.setColor(255, 255, 255); /白g.fillRect(0, 0, getWidth(), getHeight();/查看球g.setColor(255, 0, 0);g.drawString(copyArea Test,0
7、,0,Graphics.TOP|Graphics.LEFT);g.fillArc(x, 50, 40, 40, 0, 360);/复制矩形区域NxGraphics ng = NxGraphics.getNxGraphics(g);ng.copyArea(x,50,20,20,x,100);/* * 改变球的x坐标 */public void increment() x += 3;/* * timer task * 根据计时器设定的时间表执行run()方法。 */class TimerMovingBallTask extends TimerTask private TimerMovingBall
8、Canvas canvas;/* * 构造函数 * param canvas */public TimerMovingBallTask(TimerMovingBallCanvas canvas) this.canvas = canvas;/* * 被计时器呼叫时进行的处理 */public void run() canvas.increment();canvas.repaint();运行结果如下所示。2.2. SpriteSprite是指具有描画位置与大小的对象。Sprite的特征有以下三点。把SpriteImage分配、移动到任意位置设定SpriteImage中的优先顺序进行SpriteIm
9、age同类的碰撞判定比如，在Canvas类中，根据描画顺序对画面进行描画，其中重复的部分，需要对描画的处理顺序进行正确的编程，很繁琐。在这种情况下，如果利用Sprite优先顺序，就不用担心描画顺序，很方便。而且，Sprite的碰撞判定，对于经常发生碰撞判定处理的shooting game等应用程序，非常有效。为了利用Sprite，在NEC扩展API中准备了以下两类。 Sprite SpriteMapSprite类中有以下方法。方法作用boolean isVisible()取得Sprite的可视/非可视信息。Void setImage(javax.microedition.lcdui.Image
10、 image) 设定Sprite使用画面。void setLocation(int x, int y) 设定Sprite查看位置。void setVisible(boolean b)设定Sprite的可视/非可视信息。SpriteMap 类使用Sprite对象，因此能够进行Sprite对象的同类碰撞判定和设定Sprite对象的描画优先顺序。SpriteMap中有以下方法。intgetCollisionFlag(int index) 取得由自变量index指定的Sprite碰撞判定flag。intgetCount() 返回保持的Sprite数。SpritegetSprite(int index)
11、返回由自变量index指定的索引Sprite。SpritegetSprites() 返回Sprite排列。booleanisCollision(int index1, int index2)取得由自变量index1和index2指定的Sprite碰撞判定结果。voidsetCollisionAll() 进行全体Sprite的相互碰撞判定。voidsetCollisionOf(int index)进行由自变量index指定的Sprite碰撞判定。voidsetPriority(int index, int prior)设定Sprite优先顺序。Sprite查看利用上述NxGraphics类的方法
12、drawSpriteSet。利用drawSpriteSet方法，能够在画面上查看在SpriteSet注册的Sprite。但是，visible被false指定的Sprite却不能在画面上查看。ng.drawSpriteSet(spriteSet);下面是Sprite中两球发生碰撞的演示程序的source code。该演示中，使球运动发生碰撞，则相撞的球就会消失。import javax.microedition.lcdui.Display;import javax.microedition.midlet.MIDlet;import javax.microedition.midlet.MIDlet
13、StateChangeException;/* * 进行Sprite test的演示程序 */public class SpriteSample extends MIDlet Display display;SpriteCanvas canvas;/* * 构造函数 */public SpriteSample()display = Display.getDisplay(this);canvas = new SpriteCanvas();/* * 打开程序 */protected void startApp() throws MIDletStateChangeException display.
14、setCurrent(canvas);protected void pauseApp() protected void destroyApp(boolean arg0) throws MIDletStateChangeException import javax.microedition.lcdui.Canvas;import javax.microedition.lcdui.Graphics;import javax.microedition.lcdui.Image;import com.nec.graphics.NxGraphics;import com.nec.graphics.Spri
15、te;import com.nec.graphics.SpriteSet;/* * Sprite test用canvas * 球发生碰撞后消失 */public class SpriteCanvas extends Canvasprivate final String IMAGE_PATH = /ball.png;private Image img = null;private Sprite ball1 = null;private Sprite ball2 = null;private int ball2X = 100;private int ball2Y = 100;private Spr
16、iteSet spriteSet;/* * 构造函数 */public SpriteCanvas()/读取画面try img = Image.createImage(IMAGE_PATH); catch (Exception e) e.printStackTrace();/Sprite的初始化spriteSet = new SpriteSet(2);ball1 = spriteSet.getSprite(0);ball2 = spriteSet.getSprite(1);if(img != null)/球1的初始化ball1.setImage(img);ball1.setLocation(0,
17、0);ball1.setVisible(true);/球2的初始化ball2.setImage(img);ball2.setLocation(ball2X,ball2Y);ball2.setVisible(true);/* * 描画方法 */protected void paint(Graphics g) /清除画面g.setColor(255,255,255);g.fillRect(0,0,getHeight(),getWidth();/取得NEC扩展GraphicsNxGraphics ng = NxGraphics.getNxGraphics(g);ng.drawSpriteSet(sp
18、riteSet);/* * 按键处理 */protected void keyPressed(int keycode) switch(keycode)case -1:ball2Y -= 3;break;case -2:ball2Y += 3;break;case -3:ball2X -= 3;break;case -4:ball2X += 3;break;default:break;/使球运动ball2.setLocation(ball2X,ball2Y);ball2.setVisible(true);/进行球的碰撞判定spriteSet.setCollisionAll();if(sprite
19、Set.getCollisionFlag(1) = Integer.parseInt(1,2)ball1.setVisible(false);/再次描画repaint();实际运行上述演示程序的结果如下所示。使移动。发生碰撞后画面上部的球消失。上述演示程序的碰撞判定如下所示。/进行球的碰撞判定spriteSet.setCollisionAll();if(spriteSet.getCollisionFlag(1) = Integer.parseInt(1,2)ball1.setVisible(false);进行碰撞判定时，必须使用setCollisionOf和setCollisionAll方法。
20、然后，通过isCollision或者getCollisionFlag方法取得结果。getCollisionFlag 方法的返回值是int型。第n项的Sprite和，由指定的自变量索引指定的Sprite发生碰撞，第n项的bit变为1，而不发生碰撞则为0。也就是说，与第三项的Sprite发生碰撞时，由二进数返回“100”的值。第五项和第二项的Sprite发生碰撞时，由二进数返回“10010”的值。使用getCollisionFlag方法调查与第n项Sprite发生的碰撞时，使用以下计算式。spriteSet.getCollisionFlag(x) % 的n次方的值= 的(n-1)次方的值下面是判断
21、与第三项Sprite发生碰撞的例子。If( spriteSet.getCollisionFlag(2) % 8 = 4)System.out.println(“碰撞!”);elseSystem.out.println(“不碰撞”);2.3. 颜色变换 利用ImageEffector类，能够改变图片的颜色，而被指定的颜色可以进行最多两种颜色的变换。例如，在选择时/非选择时描画已改变颜色的图标图片，或者描画只有颜色不同的肖像画时，使用该颜色变换功很方便。ImageEffector 类中有以下的方法。static javax.microedition.lcdui.Image changeColors
22、(javax.microedition.lcdui.Image image, int colormap, int nelems)使用changeColors 方法进行颜色变换。在image中，指定变换前的画面，在colormap中指定colormap来改变颜色。在Nelems中指定进行变换的颜色的数量。例如，把某画面图片image的蓝色变为红色时，如下所示书写。int colormap= 0,0,255,255,0,0;ImageEffector.changeColors(image, colormap, 1);颜色变换用的colormap是二次元排列，RGB三要素的值按以下所示进行指定。 1
23、色调的色替换设定colormap00 = 变换对象RGB色1的R値; colormap01 = 变换对象RGB色1的G值; colormap02 = 变换对象RGB色1的B值; colormap10 = 变换结果RGB色1的R值; colormap11 = 变换结果RGB色1的G值; colormap12 = 变换结果RGB色1的B值; 2色调的色替换设定colormap20 = 变换对象RGB色2的R値; colormap21 = 变换对象RGB色2的G值; colormap22 = 变换对象RGB色2的B值; colormap30 = 变换结果RGB色2的R值; colormap31 =
24、变换结果RGB色2的G值; colormap32 = 变换结果RGB色2的B值;下面展示利用ImageEffector的演示程序。该程序把画面上球的颜色变换后的结果在画面下表示出来。import javax.microedition.lcdui.Display;import javax.microedition.midlet.MIDlet;import javax.microedition.midlet.MIDletStateChangeException;/* * 进行Sprite test的演示程序 */public class ImageEffectorSample extends MI
25、Dlet Display display;ImageEffectorCanvas canvas;/* * 构造函数 */public ImageEffectorSample()display = Display.getDisplay(this);canvas = new ImageEffectorCanvas();/* * 程序的打开方法 */protected void startApp() throws MIDletStateChangeException display.setCurrent(canvas);protected void pauseApp() protected void
26、 destroyApp(boolean arg0) throws MIDletStateChangeException import javax.microedition.lcdui.Canvas;import javax.microedition.lcdui.Graphics;import javax.microedition.lcdui.Image;import com.nec.graphics.ImageEffector;import com.nec.graphics.ImageMap;import com.nec.graphics.NxGraphics;import com.nec.g
27、raphics.Sprite;import com.nec.graphics.SpriteSet;/* * 颜色变换test用canvas */public class ImageEffectorCanvas extends Canvasprivate final String IMAGE_PATH = /ball.png;private Image img = null;private Sprite ball1 = null;private Sprite ball2 = null;private SpriteSet spriteSet;private ImageMap im;/* * 构造函
28、数 */public ImageEffectorCanvas()/读取画面try img = Image.createImage(IMAGE_PATH); catch (Exception e) e.printStackTrace();/Sprite的初始化spriteSet = new SpriteSet(2);ball1 = spriteSet.getSprite(0);ball2 = spriteSet.getSprite(1);if(img != null)/球1的初始化ball1.setImage(img);ball1.setLocation(0,0);ball1.setVisibl
29、e(true);/进行画面转换int colormap = 0,0,0,0,0,255,255,255,255,0,0,0;Image img2 =ImageEffector.changeColors(img,colormap,4);ball2.setImage(img2);ball2.setLocation(100,100);ball2.setVisible(true);/* * 描画方法 */protected void paint(Graphics g) /取得NEC扩展GraphicsNxGraphics ng = NxGraphics.getNxGraphics(g);ng.draw
30、SpriteSet(spriteSet);运行上述演示程序后的结果如下所示。2.4. 多重按键利用NEC扩展Canvas的NxCanvas类，能够判断同时按下两个按键。利用该多重按键功能，例如，人物在画面上活动时，可以实现斜向移动。（例如，按右键下键，向右下移动等）。NxCanvas 类中有以下方法。int getPressedKeys()我们可以利用getPressedKeys 方法判断被按的按键。按键信息32bit被分为8bit单位，其中包括由canvas类定义的KEY_NUM1等信息。也就是说，我们同时按“0”和“1”时，例）【0】按键（Keycode=48）和【1】按键（Keycode
31、=49）同时被按时00000000 00000000 0011000000110001|-未使用 经常0-| 【0】【1】getPressedKeys()的返回值变为12337由于两个按键被特别指定，值必须被分成8bit单位，如下所示，所以可以取得的信息。int key1 = getPressedKeys() % 256;int key2 = (getPressedKeys() key1) / 256下面展示演示程序。在该程序中如果同时按按键，画面下的球的颜色将产生变化。import javax.microedition.lcdui.Display;import javax.microedit
32、ion.midlet.MIDlet;import javax.microedition.midlet.MIDletStateChangeException;/* * 进行多重按键test的演示程序 */public class MultiplKeySample extends MIDlet Display display;MultiplKeyCanvas canvas;/* * 构造函数 */public MultiplKeySample()display = Display.getDisplay(this);canvas = new MultiplKeyCanvas();protected
33、void startApp() throws MIDletStateChangeException display.setCurrent(canvas);protected void pauseApp() protected void destroyApp(boolean arg0) throws MIDletStateChangeException import javax.microedition.lcdui.Graphics;import javax.microedition.lcdui.Image;import com.nec.graphics.ImageEffector;import
34、 com.nec.graphics.NxCanvas;import com.nec.graphics.NxGraphics;import com.nec.graphics.Sprite;import com.nec.graphics.SpriteSet;/* * 多重按键用canvas */public class MultiplKeyCanvas extends NxCanvasprivate final String IMAGE_PATH = /ball.png;private Image img = null;private Sprite ball1 = null;private Spr
35、ite ball2 = null;private SpriteSet spriteSet;/* * 构造函数 */public MultiplKeyCanvas()/读取画面try img = Image.createImage(IMAGE_PATH); catch (Exception e) e.printStackTrace();spriteSet = new SpriteSet(2);ball1 = spriteSet.getSprite(0);ball2 = spriteSet.getSprite(1);if(img != null)ball1.setImage(img);ball1.
36、setLocation(0,0);ball1.setVisible(true);ball2.setImage(img);ball2.setLocation(100,100);ball2.setVisible(true);/* * 进行img2的颜色变换 */public void changeColor()/进行画面转换int colormap = 0,0,0,0,0,255,255,255,255,0,0,0;Image img2 =ImageEffector.changeColors(img,colormap,4);ball2.setImage(img2);/* * 描画方法 */prot
37、ected void paint(Graphics g) /取得NEC扩展GraphicsNxGraphics ng = NxGraphics.getNxGraphics(g);/描画Spriteng.drawSpriteSet(spriteSet);/* * 按键处理 */protected void keyPressed(int keycode) if(getPressedKeys() 255)/如果同时按两个按键changeColor();repaint();运行结果如下所示。 3. 制作应用程序下面介绍如何利用上面解说的扩展API制作应用程序。本讲我们利用Sprite来对“泡泡龙”游戏
38、进行改写。同时，通过判断按键是否被同时按下也可以调节小棒的速度。这里为使source code简单，将与声音相关的功能、使用网络的高分处理省略掉。Source code如下所示。block_src.zip这里添加的方法有下面两个。 对球、小棒、彩球进行Sprite化。 同时按方向按键和确定按键，改变小棒的速度。3.1. Sprite化球、小棒、彩球都由Sprite表现并进行碰撞判定。因为由Sprite来进行碰撞判定，所以就不用单独进行碰撞判定处理的书写了。3.1.1. 变量的定义为了进行Sprite处理，首先定义例子变数。这里按以下所示进行定义。/SpriteSpriteSet spriteS
39、et = new SpriteSet(30);Sprite ball = spriteSet.getSprite(0); /* 在排列的第一位设定球的Sprite */Sprite bar = spriteSet.getSprite(1); /* 在排列的第二位设定小棒的Sprite */spriteSet 的分配如下所示。0 球1 小棒229 彩球按照上述变量的定义，则Sprite的数为30。球1，小棒1，彩球28，合计30。以前程序的彩球数是35，但因为SpriteSet规定最多不超过32，所以彩球的数量减到了28。改变常量BLOCJ_V，减少彩球纵向的个数。private final i
40、nt BLOCK_V = 4; /彩球纵向的个数3.1.2. Sprite的初始化接下来进行Sprite的初始化。设定实际的球、小棒、彩球图片和查看坐标。为进行初始化准备了initilizeSprite方法。/* * 进行Sprite的初始化 */public void initiliseSpriteSet() /进行球的初始化ballX = barX;ballY = barX - BALL_HEIGHT;ball.setLocation(ballX, ballY);ball.setImage(ballImg);ball.setVisible(true);/进行小棒的初始化bar.setLoc
41、ation(barX, barY);bar.setImage(barImg);bar.setVisible(true);/进行彩球的初始化blockCount = BLOCK_H * BLOCK_V;Sprite block = null;int index = 2;for (int i = 0; i BLOCK_H; i+) for (int j = 0; j BLOCK_V; j+) block = spriteSet.getSprite(index+);/* 从SpriteSet 中取得Sprite */block.setImage(blockImg); /* 设定画面为Sprite */block.setLocation(i * BLOCK_WIDTH, (j + 1) * BLOCK_HEIGHT);/* 设定查看坐标*/block.setVisibl
