Game Development with AndEngine

Introduction

Basic Elements

Creating the rst scene with AndEngine

Handling Scene touches

Game Development with AndEngine GLES2
Daniela da Cruz

Computação Móvel
Licenciatura em Engenharia de Jogos Digitais
Instituto Politécnico do Cávado e do Ave
October 28, 2013

Computação MóvelLicenciatura em Engenharia de Jogos DigitaisInstituto Politécnico do Cávado e do Ave

Introduction

Basic Elements



Introduction
Basic Elements
Camera
Engine
Scene
Entity
Texture TextureRegion


Introduction

Basic Elements



Introduction

AndEngine is a free open source OpenGL Android game engine,
developed by Nicolas Gramlich.
AndEngine is currently available in two avors: GLES1 and GLES2.
GLES2, as you might guess, supports OpenGL ES 2.0.

https://github.com/nicolasgramlich
http://www.matim-dev.com/

Latest version:
Tutorials:


Introduction

Basic Elements



Introduction
AndEngine Advantages:

It has a complete 2-D scene graph, with a very easy-to-use
API.
It works great with the Android activity lifecycle.
It has a number of extensions that can be added as plugins.
It has multi-touch support.
It's free and open-source.
AndEngine Disadvantages:

The API is undocumented.
Sometimes slower in comparison to other engines.


Introduction

Basic Elements



Basic Elements

To create a scene we need 3 basic elements:
Camera
Engine
Scene


Introduction

Basic Elements



Camera

Camera

Since all is based in a game scene we need to setup a camera:

Camera(pX, pY, pWidth, pHeight);
pX and pY are the coordinates for the origin of the camera
pWidth and pHeight are the dimensions, in pixels, of the
camera


Introduction

Basic Elements



Engine

Engine
In the engine we dene which camera will be used on the scene:

EngineOptions(pFullscreen, pScreenOrientation,
pResolutionPolicy(pWidth, pHeight), pCamera)
pFullscreen determines whether the game will be play full
screen or not
pScreenOrientation, here we can choose between
LANDSCAPE and PORTRAIT
pResolutionPolicy is the ratio of our Engine (same values as in
Camera)
pCamera is the camera object


Introduction

Basic Elements



Scene

Scene
The Scene class is the root container for all objects to be drawn on
the screen.
A Scene has a specic amount of Layers, which themselves can
contain a (xed or dynamic) amount of Entities.
There are subclasses, like the CameraScene/HUD/MenuScene that
are drawing themselves to the same position of the Scene no
matter where the camera is positioned to.
HUD (heads-up display) usage for example for score (it has

to be all the time in the same position, follow camera
changes).


Introduction

Basic Elements



Entity

Entity
An

Entitiy is an object that can be drawn, like Sprites, Rectangles,

Text or Lines.
An Entity has a position/rotation/scale/color/etc.
Sprite - entity with texture
TiledSprite - entity with tiled texture, you may switch between
tiles.
AnimatedSprite - extension of the TiledSprite, you may
animate tiles in specied intervals.


Introduction

Basic Elements





A Texture is a 'image' in the memory of the graphics chip.
A TextureRegion denes a rectangle on the Texture. A
TextureRegion is used by Sprites to let the system know what part
of the big Texture the Sprite is showing.


Introduction

Basic Elements




The rst le created by the project is an

Activity.

And the rst thing to do in our project is to change the class that
this Activity extends.
Instead of extending the Activity class, we want to make it extend a
class called SimpleBaseGameActivity.


Introduction

Basic Elements




The SimpleBaseActivity class provides additional callbacks and
contains the code to make AndEngine work with the Activity life
cycle.
Each callback that it provides is used for a specic purpose. As
soon as you extend this class, we will have to override three
functions.


Introduction

Basic Elements



Extending SimpleBaseGameActivity
onCreateEngineOptions this function is where you create

an instance of the engine. Every activity that the game uses
will have its own instance of the engine that will run within the
activity lifecycle.
onCreateResources this is the function where we load all

the resources that the activity requires into the the VRAM.
onCreateScene this function is called after the above two

callbacks are executed. This is where we create the scene for
our game and use all the textures that we previously loaded
into memory.


Introduction

Basic Elements



Extending SimpleBaseGameActivity


Introduction

Basic Elements



Creating a Sprite
When creating a Sprite object, we pass four parameters:
xCoordinate: Denes the X-position of the sprite.
yCoordinate: Denes the Y-position of the sprite.
TextureRegion: Denes what part of the texture the sprite will
use to draw itself.
VertexBuerObjectManager: Think of a vertex buer as an
array holding the coordinates of a texture. These coordinates
are passed to the OpenGL ES pipeline and ultimately dene
what will be drawn. A VertexBuerObjectManager holds all
the vertices of all the textures that need to be drawn on the
scene.


Introduction

Basic Elements



Attaching a Sprite to a Scene

To attach a sprite, to a dierent entity, for example to the Scene,
we have to simply call

attachChild

method:

anyEntity.attachChild(yourSprite);


Introduction

Basic Elements



Lets say we want to execute a certain action, every time the player
touches the screen.
We have to implement

IOnSceneTouchListener

interface.

Add unimplemented method.


Introduction

Basic Elements




The methods that identify if an event occurred or not are:

isActionDown(), isActionMove(), isActionUp().
Now all you have to do is to register this touch listener in a certain
scene:

scene.setOnSceneTouchListener(this);


Introduction

Basic Elements



Handling Entity touches
The problem of this approach is that it will handle every event that
occurs in the whole scene.
If we want to handle touch events of specic entities, we will need
to implement the method

onAreaTouch()

(the parameters are the

event and its coordinates).


Game Development with AndEngine

More Related Content

Game Development with AndEngine