一:AndEngine的小例子
首先导入架包,下载:http://download.csdn.net/detail/duancanmeng/4060082 lib文件夹中
像我们写android程序entends Activity一样,我们一开始也要extends BaseGameActivity,而且实现四个必须被重载函数:
- public class Main extends BaseGameActivity {
- public void onLoadComplete() {
- }
- public Engine onLoadEngine() {
- return null;
- }
- public void onLoadResources() {
- }
- public Scene onLoadScene() {
- return null;
- }
- }
只需实现上面四个方法,把业务逻辑和数据加进去,便可完成一个简单的小例子。
先上效果图:
具体代码如下:
- public class ShapeModifierExample extends BaseGameActivity{
- private static final int CAMERA_WIDTH = 720;
- private static final int CAMERA_HEIGHT = 480;
- private Camera mCamera;
- private Texture mTexture;
- private TiledTextureRegion mFaceTextureRegion;
- @Override
- public Engine onLoadEngine() {
- Log.i("test","onLoadEngine");
- //游戏摄像机,在AndEngine的Camera有两种作用,一是用以调节屏幕的显示区域,二是利用HUD类实际绘制游戏屏幕于手机之上。
- //new Camera中的四个参数,第一个和第二个是代表camera的左顶点,第三个和第四个分别代表camera的宽和高
- this.mCamera = new Camera(0,0,CAMERA_WIDTH,CAMERA_HEIGHT);
- //Engine是AndEngine的核心所在,
- //它对AndEngine引擎中Camera、Scene等重要组件进行了统一管理,
- //但必须和BaseGameActivity合作使用,
- //利用EngineOptions类可以对其进行必要的参数配置。
- //其中EngineOptions中的参数:
- // 第一个判断是否为全屏
- // 第二个判断屏幕横屏还是竖屏
- // 第三个RatioResolutionPolicy(按比例修正画面大小,以适应屏幕大小),
- // 第四个便是我们自己定义的
- //第三个参数还可以:BaseResolutionPolicy(除了会校验一下屏幕大小外,什么也不做)、
- // FillResolutionPolicy(拉伸游戏画面为全屏填充,视摄像机大小不同,会有不同程度变形)、
- // FixedResolutionPolicy(强行规定游戏画面为固定大小,此设置不会自动适应屏幕大小),
- // RatioResolutionPolicy(按比例修正画面大小,以适应屏幕大小),
- // RelativeResolutionPolicy(根据构建RelativeResolutionPolicy时的缩放参数,缩放游戏屏幕为指定比例)。
- return new Engine(new EngineOptions(true,ScreenOrientation.LANDSCAPE,new RatioResolutionPolicy(CAMERA_WIDTH,CAMERA_HEIGHT),this.mCamera));
- }
- @Override
- public void onLoadResources() {
- Log.i("test","onLoadResources");
- //该处Texture的构造方法中三个参数:
- // 第一个:要使用的纹理图片的宽度
- // 第二个:要使用的纹理图片的高度
- // 第三个:纹理的渲染方式
- //第三个参数其中有如下情况:
- //1、NEAREST(Nearest滤波,实现上依赖GL_NEAREST做不光滑过滤,纹理环绕模式为GL_CLAMP_TO_EDGE,显示速度快画质差)
- //2、BILINEAR(双线性插值,实现上依赖GL_LINEAR做线性滤波,纹理环绕模式为GL_CLAMP_TO_EDGE,显示速度慢画质佳)
- //3、REPEATING(与NEAREST同为Nearest滤波,但纹理环绕模式为GL_REPEAT,会自动填充纹理上的空白区域,显示速度较快画质差)
- //4、REPEATING_BILINEAR(与BILINEAR同为双线性插值,但纹理环绕模式为GL_REPEAT,会自动填充纹理上的空白区域,显示速度很慢画质佳(低端机跑此模式异常悲剧,高端机尚可))
- //5、NEAREST_PREMULTIPLYALPHA(所有[PREMULTIPLYALPHA]结尾的TextureOptions与其它同名类差别仅在于是否支持根据Alpha值设置透明纹理,以下同)
- //6、BILINEAR_PREMULTIPLYALPHA
- //7、REPEATING_PREMULTIPLYALPHA
- //8、REPEATING_BILINEAR_PREMULTIPLYALPHA等静态对象。
- //等等
- this.mTexture = new Texture(64,32,TextureOptions.BILINEAR_PREMULTIPLYALPHA); //前2个参数意义是划出<span style="FONT-SIZE: 12px; LINE-HEIGHT: 17px"> //pWidth*</span><span style="FONT-SIZE: 12px; LINE-HEIGHT: 17px">pHeight大小的一块空间用来存储</span><span style="FONT-SIZE: 12px; LINE-HEIGHT: 17px">createFromAsset装载的贴图</span> //备注1
- //将纹理图片“贴”到我们上面定义的Texture上
- //其中的参数:第二个代表本context,第四个:代表纹理贴到Texture上的X坐标,第五个:代表贴到Texture上的Y坐标,第六个:代表纹理要贴的列数,第七个:代表纹理要贴的行数
- this.mFaceTextureRegion = TextureRegionFactory.createTiledFromAsset(this.mTexture, this, "face_box_tiled.png", 0, 0, 2, 1);
- this.mEngine.getTextureManager().loadTexture(mTexture);
- }
- @Override
- public Scene onLoadScene() {
- Log.i("test","onLoadScene");
- //registerUpdateHandler函数注册得到IUpdateHandler接口,内部有onUpdate以及reset两个函数等待实现,几乎所有AndEngine应用中都必然会看到它的身影,它也是AndEngine添加具体业务到游戏业务线程中的主要方法之一。
- //主要用来供外部方法调用,以便更新业务
- //可以看到所有的exmaples中都有如此写法
- this.mEngine.registerUpdateHandler(new FPSLogger()); //备注2
- //场景容器,作用类似于LGame中的Screen,能够将某一特定场景作为游戏模块进行调用,我们可以利用它来切换当前游戏的画面与触摸屏监听,切换方法是利用Engine.setScene
- final Scene scene = new Scene(1);
- //这里的颜色的值设置必须在0.0到1.0,例如(1,0,0)为红色
- scene.setBackground(new ColorBackground(0.09804f, 0.6274f, 0.8784f));
- final int centerX = (CAMERA_WIDTH - this.mFaceTextureRegion.getWidth()) / 2;
- final int centerY = (CAMERA_HEIGHT - this.mFaceTextureRegion.getHeight()) / 2;
- Log.i("test","centerX:"+centerX+",centerY:"+centerY);
- //定义一个方块
- final Rectangle rect = new Rectangle(centerX + 100, centerY, 32, 32);
- rect.setColor(1, 0, 0);
- //定义一个动画精灵,并设置一些属性
- final AnimatedSprite face = new AnimatedSprite(centerX - 100, centerY, this.mFaceTextureRegion);
- face.animate(100);
- face.setBlendFunction(GL10.GL_SRC_ALPHA, GL10.GL_ONE_MINUS_SRC_ALPHA); //备注3
- //主要设置上面定义的两个组件的动作
- //LoopShapeModifier(final IShapeModifierListener pShapeModiferListener, final int pLoopCount, final ILoopShapeModifierListener pLoopModifierListener, final IShapeModifier pShapeModifier)
- //从打印的语句可以看出,第一个参数是当整个动作结束的时候所做的一些操作,第二个参数就是动作的循环的次数,第三个就是一个动作完成后所做的一些操作,第四个就是具体的动作
- final LoopShapeModifier shapeModifier =
- new LoopShapeModifier(
- new IShapeModifierListener() {
- @Override
- public void onModifierFinished(final IModifier<IShape> pShapeModifier, final IShape pShape) {
- ShapeModifierExample.this.runOnUiThread(new Runnable() {
- @Override
- public void run() {
- Toast.makeText(ShapeModifierExample.this, "Sequence ended.", Toast.LENGTH_LONG).show();
- }
- });
- }
- },
- 1,
- new ILoopShapeModifierListener() {
- @Override
- public void onLoopFinished(final LoopModifier<IShape> pLoopShapeModifier, final int pLoopsRemaining) {
- ShapeModifierExample.this.runOnUiThread(new Runnable() {
- @Override
- public void run() {
- Toast.makeText(ShapeModifierExample.this, "Loops remaining: " + pLoopsRemaining, Toast.LENGTH_SHORT).show();
- }
- });
- }
- },
- new SequenceShapeModifier(
- //这里面的参数,第一个是Duration,第二个是From,第三个是to
- new RotationModifier(1, 0, 90),
- new AlphaModifier(2, 1, 0),
- new AlphaModifier(1, 0, 1),
- new ScaleModifier(2, 1, 0.5f),
- new DelayModifier(0.5f),
- //这里是一些组合动作
- new ParallelShapeModifier(
- new ScaleModifier(3, 0.5f, 5),
- new RotationByModifier(3, 90)
- ),
- new ParallelShapeModifier(
- new ScaleModifier(3, 5, 1),
- new RotationModifier(3, 180, 0)
- )
- )
- );
- face.addShapeModifier(shapeModifier);
- rect.addShapeModifier(shapeModifier.clone());
- scene.getTopLayer().addEntity(face);
- scene.getTopLayer().addEntity(rect);
- return scene;
- }
- @Override
- public void onLoadComplete() {
- // TODO Auto-generated method stub
- Log.i("test","onLoadComplete");
- }
- }