AndEngine Example(3):SpriteExample

目标：

1.理解纹理

2.理解纹理区域

3.创建资源回调函数onCreateResources

4.了解BitmapTexture

5.理解Sprite

---------------------------------------------------

由于本例子使用了纹理，且通过在assets下加载，所以你需要在assets创建gfx目录，然后放一张名为face_box.png的图片(注意，请保持长宽比1:1)。

如果成功，将会出现一张静止的图。

package org.andengine.examples;

import java.io.IOException;
import java.io.InputStream;

import org.andengine.engine.camera.Camera;
import org.andengine.engine.options.EngineOptions;
import org.andengine.engine.options.ScreenOrientation;
import org.andengine.engine.options.resolutionpolicy.RatioResolutionPolicy;
import org.andengine.entity.scene.Scene;
import org.andengine.entity.scene.background.Background;
import org.andengine.entity.sprite.Sprite;
import org.andengine.entity.util.FPSLogger;
import org.andengine.opengl.texture.ITexture;
import org.andengine.opengl.texture.bitmap.BitmapTexture;
import org.andengine.opengl.texture.region.ITextureRegion;
import org.andengine.opengl.texture.region.TextureRegionFactory;
import org.andengine.ui.activity.SimpleBaseGameActivity;
import org.andengine.util.adt.io.in.IInputStreamOpener;
import org.andengine.util.debug.Debug;

/**
* (c) 2010 Nicolas Gramlich
* (c) 2011 Zynga
*
* @author Nicolas Gramlich
* @since 11:54:51 - 03.04.2010
*/
public class SpriteExample extends SimpleBaseGameActivity {
// ===========================================================
// Constants
// ===========================================================

private static final int CAMERA_WIDTH = 720;
private static final int CAMERA_HEIGHT = 480;

// ===========================================================
// Fields
// ===========================================================

private ITexture mTexture;
private ITextureRegion mFaceTextureRegion;

// ===========================================================
// Constructors
// ===========================================================

// ===========================================================
// Getter & Setter
// ===========================================================

// ===========================================================
// Methods for/from SuperClass/Interfaces
// ===========================================================

@Override
public EngineOptions onCreateEngineOptions() {
final Camera camera = new Camera(0, 0, CAMERA_WIDTH, CAMERA_HEIGHT);

return new EngineOptions(true, ScreenOrientation.LANDSCAPE_SENSOR, new RatioResolutionPolicy(CAMERA_WIDTH, CAMERA_HEIGHT), camera);
}

@Override
public void onCreateResources() {
try {
this.mTexture = new BitmapTexture(this.getTextureManager(), new IInputStreamOpener() {
@Override
public InputStream open() throws IOException {
return getAssets().open("gfx/face_box.png");
}
});

this.mTexture.load();
this.mFaceTextureRegion = TextureRegionFactory.extractFromTexture(this.mTexture);
} catch (IOException e) {
Debug.e(e);
}
}

@Override
public Scene onCreateScene() {
this.mEngine.registerUpdateHandler(new FPSLogger());

final Scene scene = new Scene();
scene.setBackground(new Background(0.09804f, 0.6274f, 0.8784f));

/* Calculate the coordinates for the face, so its centered on the camera. */
final float centerX = (CAMERA_WIDTH - this.mFaceTextureRegion.getWidth()) / 2;
final float centerY = (CAMERA_HEIGHT - this.mFaceTextureRegion.getHeight()) / 2;

/* Create the face and add it to the scene. */
final Sprite face = new Sprite(centerX, centerY, this.mFaceTextureRegion, this.getVertexBufferObjectManager());
scene.attachChild(face);

return scene;
}

// ===========================================================
// Methods
// ===========================================================

// ===========================================================
// Inner and Anonymous Classes
// ===========================================================
}

整个逻辑大致为：

(1)从资源文件中加载纹理

(2)使用纹理得到纹理区域

(3)使用纹理区域渲染精灵

其中：

mTexture 纹理通过两步，实现纹理加载：

mTexture = new BitmapTexture(TextureManager, IInputStreamOpener);

mTexture.load();

mFaceTextureRegion 纹理区域，通过纹理工厂和纹理来创建

mFaceTextureRegion = TextureRegionFactory.extractFromTexture(this.mTexture);

精灵：Sprite 需要 : 位置的两个参数，纹理区域，对象buffer

Sprite face = new Sprite(centerX, centerY, this.mFaceTextureRegion, this.getVertexBufferObjectManager())

-------------------------------------------------------------

扩展阅读:

Sprite是AndEngine中最重要的概念之一，

它用于表示可以独立绘制的东西，

它也是一个Entity。

Entity (实体)

作为一切虚拟可见的东西，实体包含了场景，包含了可见物体的通用属性。这些属性通过getter和setter访问和设置。

这些属性包含下面这些元素：

float mX, mY:实体的当前位置

float mInitialX, mInitialY: 实体的初始位置

boolean mVisible :实体当前是否可见

boolean mIgnoreUpdate : 实体是否需要更新

int mZindex: 实体处于需要显示的实体栈的位置

IEntity mParent:实体的父类（实际是个接口）

SmartList<IEntity> mChildren :实体包含的孩子们（并非继承上的子类,更像是空间上一个大的空间包含若干小的空间）

EntityModifierList mEntityModifiers: 一系列的实体修饰符（Modifiers）

UpdateHandlerList mUpdateHandlers:一组用于更新实体的Handlers

float mRed, mGreen, mBlue : 实体颜色

float mAlpha:透明度

float mRotation : 旋转角度

float mRotationCenterX, mRotationCenterY: 旋转中心

float mScale : 缩放

float mScaleCenterX, mScaleCenterY:缩放中心