Introduccin a libGDX Descargar la librera Crear un proyecto JAVA nuevo Portar el proyecto JAVA a un proyecto Android Ciclo de vida

de una aplicacin libGDX Grficos Texturas e Interpolacin TextureRegion TextuimagrePacker Empaquetar imgenes automaticamente Carga de imgenes empaquetadas Dibujar imgenes en pantalla Entrada Detectar pulsaciones en la pantalla tctil Audio Sounds Cargar sonidos Reproducir sonidos Descargar sonidos Music Cargar una msica Descargar una msica Navegando entre pantallas del juego Vibracin Cmaras Animacin Manual de buenas prcticas Separar la lgica de la presentacin Pginas para Desarrollo de Juegos Solucin de problemas

9u Introduccin a libGDX

LibGDX es un framework multiplataforma de desarrollo de juegos para Windows, Linux y Android. Est escrito en Java con una mezcla de C/C++ para dar soporte y rendimiento a tareas relacionadas con el uso de la fsica y procesamiento de audio. LibGDX permite generar una aplicacin en su PC y utilizar el mismo cdigo en Android, de esta manera el proceso de pruebas y depuracin se realiza de forma ms rpida y cmoda ya que el PC es mucho ms rpido que el dispositivo Android. Con LibGDX nos aseguramos de que la misma aplicacin puede funcionar correctamente en diferentes dispositivos. LibGDX est compuesto por una serie de componentes de sern comunes a todas las aplicaciones. Marco de Aplicacin, que manejar el bucle principal y adems estar encargado del clico de vida, es decir, los eventos de creacin,destruccin, pausa y resume de la misma. Un componente de Grficos que nos permitir gestionar la representacin de imgenes y objetos grficos en la pantalla. Un componente de Audio, que nos facilitar el acceso a los sonidos y msica de la aplicacin. Un componente de de Entrada y Salida para leer y escribir los diferentes ficheros de datos como por ejemplo, imgenes, archivos de configuracin, sonidos, msica, texturas,... Un componente de Entrada que gestionara la entrada a travs del teclado, pantalla tcil o acelermetro.

Adicionalmente podramos ampliar la gama de mdulos con otros dos ms. Math, permite la gestin rpida de clculos matemticos orientados al desarrollo de videojuegos. Physics, que bsicamente es un wrapper de Box2D y permite controlar la gestin de colisiones. Este grfico muestra en mayor detalle el sistema de mdulos de LibGDX

Realmente, estos mdulos son slo interfaces pblicas que ofrece la librera. La propia aplicacin ser la encargada de la gestin de los diferentes mdulos. Ventajas: Soporte 2d full (bajo y alto nivel) Mucha documentacin, tutoriales, ejemplos de cdigo Releases en forma peridica la ultima fue en setiembre y anterior en Mayo Se puede probar en desktop (antes de subir a mobile) Maneja Audio, input (usuario), fsica,matemtica,archivos Mas poderoso que Andengine Soporta 3d libGDX te da un acceso ms fcil a Bajo nivel Posibilidad de tomar un juego hecho en java jar 2d o 3d y adaptarlo a libgdx para q funcione nativo en android,eso hicieron con el juego Droid Invaders 3d. Desventaja: El soporte de alto nivel en 3-d esta en construccin actualmente Links de referencia:
Pagina Oficial Wiki del proyecto Blog Foro Juego en 3d ya realizado: Droid Invaders Listado de Ejemplos Video Tutoriales Documentacin

Descargar la librera
Para descargar la librera debemos ir a la web de la misma: http://libgdx.badlogicgames.com/

A la derecha pulsamos en download y de las dos versiones de la librera que nos aparecen, seleccionamos la versin Nightly Build.

Tras pulsar en Download ya slo nos queda descargar la ltima versin de la librera.

Crear un proyecto JAVA nuevoTitanium: Titanium:

Aunque el objetivo final es que el juego funcione sobre Android, trabajaremos con un proyecto JAVA que una vez terminado se portar a Android.

Para crear un proyecto JAVA en Eclipse simplemente en el men vamos a File > New > Java Project. Le damos un nombre al proyecto (en este caso Demo1). Elegimos la ruta donde se crear en memoria y le damos a Finish.

Una vez creado el proyecto el siguiente paso ser aadir la librera. Para ello una buena prctica es crear un directorio dentro del proyecto donde incluir las libreras que usemos. Para ello click derecho sobre nuestro proyecto y New > Folder. En nuestro ejemplo esta carpeta la llamaremos libs. Una vez creada esta carpeta, simplemente tendremos que aadir a la misma lo que necesitamos para este proyecto. Para aadir, nos vamos al directorio donde hemos guardado la librera descargada en el apartado anterior y podemos arrastrar o copiar los archivos que necesitamos (en la imagen).

Nos quedara el proyecto de esta forma:

Ya tenemos las libreras en el directorio que hemos creado dentro del proyecto. Pero an no forman parte del mismo, el siguiente paso es aadirlas. Para ello seleccionamos los cuatro ficheros dentro de la carpeta libs, hacemos click derecho y en el men contextual seleccionamos Build Path > Add to Build Path. El proyecto queda de la siguiente forma:

Otra buena prctica, aunque no necesaria es aadir la informacin contenida en el Javadoc de la librera. El objetivo de esto es que cuando se muestre la ayuda emergente de eclipse veamos la informacin contenida en el Javadoc de la librera.

Para ello hacemos click derecho sobre el proyecto y en el men contextual Build Path > Configure Build Path... tras lo que se nos muestra lo siguiente:

En esta ventana desplegamos gdx.jar y tal como se ve en la imagen seleccionamos Javadoc location. Una vez hecho esto pulsamos sobre Edit...

Pulsamos en Browse... y buscamos la localizacin del Javadoc que se encuentra en libgdxnightly > docs > api. Una vez seleccionado este directorio pulsamos sobre Ok para confirmar el cambio. Y ya tenemos esta caracterstica habilitada. Una vez preparado Eclipse y nuestro proyecto JAVA ya podemos empezar a trabajar.

Lo primero ser crear la clase principal del juego, que ser la encargada de manejar y controlar todo lo que ocurra en el juego. Para ello click derecho sobre src > New > Class.

- Creamos la clase en el paquete com.desarrolladoresandroid.libgdx.demo1 - El nombre de la misma es Demo1Game - Esta nueva clase heredar de Game (com.badlogic.gdx.Game).

Una vez creada la clase principal del proyecto, crearemos el punto de entrada para la ejecucin de la aplicacin JAVA. Una clase que nos permitir lanzar el juego.

Para ello creamos una clase que contenga el mtodo main:

- Nombre de la clase: Demo1Desktop - Mismo paquete que la clase principal. - Seleccionamos la opcin public static void main(String[] args)

Nos quedara el proyecto de la siguiente forma:

Para poder lanzar el juego aadimos en la clase Demo1Desktop tenemos que aadir lo siguiente: new JoglApplication(new Demo1Game(), "Demo1", 320, 480, false); Los parmetros indican lo siguiente: - new Demo1Game(). Instancia de la clase que implementa Game - "Demo1". Que es el ttulo de la aplicacin. - 320. Ancho en pxeles. - 480. Alto en pxeles. - false. Para indicar que no queremos utilizar OpenGL S 2.0 en este caso. Por lo que se utilizar el 1.1 Una vez hecho esto ya tenemos un juego que no hace nada y que podemos lanzar como aplicacin JAVA. Para lanzarlo tenemos que hacer click derecho en el proyecto y Run As > Java Application Una vez hecho esto nos saldr una ventana para seleccionar el punto de entrada de la aplicacin que en nuestro ejemplo es Demo1Desktop.java

El resultado de la ejecucin ser una pantalla negra con la resolucin indicada.

Portar el proyecto JAVA a un proyecto Android

Ahora crearemos el proyecto para compilarlo en Android. Para efectos practicos usare un ejemplo que yo ya tena. Hecho en escritorio llamado HolaLibgdx.

11. Crear carpeta libs dentro del proyecto y ponerle las siguientes libreras de las que descargamos incluyendo esas carpetas: Importante! "SE DEBEN INCLUIR LAS CARPETAS armeabi y armeabi-v7a como se ve en la imagen. Estas carpetas vienen en las libreras que descargamos"

12. Referenciamos las libreras copiadas. Click derecho al proyecto / build path / configure build path...

13. Antes de cerrar esa pantalla anterior ir a la pestaa project y adjuntarle la referencia al proyecto de escritorio.

12. Modificar la Activity principal "HolaLibGdxActivity" para que no extienda de Activity sino de AndroidApplication. (crt+shift+o) para resolver los imports necesarios. package com.libgdx.holalibgdx; import android.os.Bundle; import com.badlogic.gdx.backends.android.AndroidApplication; import com.libgdx.holalibgx.HolaLibgdx; public class HolaLibGdxActivity extends AndroidApplication { /** Called when the activity is first created. */ @Override public void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState); //Aca inicializamos al app de escritorio. initialize(new HolaLibgdx(),false); } }

Debera quedarnos as. 13. Lo ejecutamos en el emulador.

Desbloqueamos el dispositivo en el emulador.

y Se ejecuta exactamente lo mismo que en escritorio. Lo que hicimos recin, tambin compil la aplicacin en un archivo .apk dentro del directorio /bin del proyecto android, ese archivo .apk se lleva al dispositivo fisico real y al ejecutarlo te instala la app creada.

Ciclo de vida de una aplicacin libGDX

Este apartado describe cmo se estructura una aplicacin libgdx. LA APLICACION Es el principal punto de entrada para cualquier aplicacin libgdx. La interfaz Application determina la plataforma y los graficos de fondo que sern utilizados por la aplicacin. La interfaz tambin proporciona los mtodos para acceder a grficos, audio, archivos de entrada y mdulos de E/S. Tambin da acceso a un mdulo de Logging el cual funciona en todas las plataformas. LibGDX es compatible actualmente con dos back-ends de aplicaciones de escritorio (lwjgl y JOGL) y otra para Android. Para crear una aplicacin libGDX, se ha de implementar la interfaz ApplicationListener primero. APPLICATION LISTENER ApplicationListener es el responsable de la inicializacin de la aplicacin, la actualizacin del estado del juego (es decir, la lgica del juego), renderizacin de la imagen, pausado del juego, guardar el estado y la liberacin de los recursos al salir de la aplicacin. Es tambin el lugar donde los eventos del ciclo de vida son manejados. Cada aplicacin / juego, sin importar el back-end y / o plataforma de destino tendr que implementar la interfaz ApplicationListener. La implementacin es exactamente la misma para todas las plataformas.

Por tanto, Application es responsable del circuito de juego y ApplicationListener es el lugar donde se implementa la lgica del juego. La implementacin de la interfaz ApplicationListener

Los eventos que son desencadenados por los en la aplicacin del ciclo de vida tal como se describe: create (): Se llama una vez cuando se crea la aplicacin. resize(int width, int height): Se llama a este mtodo cada vez que la pantalla del juego cambia su tamao y el juego no est en el estado de pausa. Tambin se le llama slo una vez justo despus del mtodo create (). Los parmetros son la nueva anchura y altura de la pantalla. render (): Mtodo llamado por el bucle del juego de la aplicacin cada vez que se renderiza. La actualizacin del juego tambin tiene lugar aqu antes de la representacin real. pause (): El mtodo de pausa se llama justo antes que se destruya la aplicacin. En Android se llama cuando el botn de inicio se presiona o haya una llamada entrante. En el escritorio se llama justo antes de dispose () al salir de la aplicacin. Es un buen lugar para guardar el estado del juego en Android, ya que no se garantiza que sea reanudado.

resume(): Este mtodo es llamado slo en Android, cuando la aplicacin recibe el foco. En el escritorio este mtodo no ser llamado nunca. dispose (): Se le llama cuando la aplicacin se destruye. Es precedido por una pausa ().

Ciclo de vida de una aplicacion

Los mtodos antes mencionados son provocados por la aplicacin durante su ciclo de vida. El siguiente diagrama muestra las diferentes fases por las que pasa una aplicacin libGDX:

Grficos
El mdulo de grficos es un resumen de la comunicacin con el GPU y proporciona mtodos de conveniencia para obtener las instancias de OpenGL ES. Se encarga de todo el cdigo repetitivo necesarios para hacerse con el ejemplo de OpenGL y se ocupa de todas las implementaciones proporcionadas por el fabricante. Dependiendo del hardware subyacente, los contenedores pueden ser o pueden no estar disponible. El mdulo de grficos tambin proporciona mtodos para generar mapas de pixels y texturas. En el siguiente cdigo podemos ver cmo obtener una instancia de la API OpenGL 1.0:
GL10 gl = Gdx.graphics.getGL10 ();

El mtodo devuelve una instancia que puede ser usada para dibujar en la pantalla. En el caso que la configuracin de hardware no sea compatible con OpenGL ES 1.0, devuelve null. El siguiente fragmento de cdigo borra la pantalla y la pinta de rojo:
gl.glClearColor(0.1f, 0.0f, 0.0f, 1); gl.glClear(GL10.GL_COLOR_BUFFER_BIT);

Texturas e Interpolacin
Texture es una "imagen" en la memoria del chip grfico (las imgenes en disco se cargarn en esta zona de memoria). En OpenGL el ancho y alto de una textura tiene que ser potencia de 2 (...32, 64, 128, 256, 512, 1024, etc). Aunque en los ejemplos se definen la textura cuadrada, no tiene por qu ser as. Puedes tener una textura de 128x32, 32x256, etc. Por ejemplo, el HTC G1 soporta como mucho, una textura de 1024x1024 (Aunque puedes tener ms de una textura a la vez). Intentar utilizar texturas ms grandes en este dispositivo provocarn errores en el juego.La recomendacin es que no pases del valor 1024 para establecer el ancho o alto de tus texturas. Un parmetro muy importante que hay que indicar a la hora de crear un objeto Texture es un valor TextureOptions que indicar qu mtodo se utilizar para redimensionar las imgenes que tenemos dentro de la textura. (Para no complicar las cosas, dejaremos esa explicacin).

Se pueden elegir los siguientes modos: NEAREST: La imagen aparecer pixelada. Es mucho ms rpido, pero la imagen tiene menor calidad. Original:

Ampliada con NEAREST:

BILINEAR: La imagen aparece ms difuminada. Es un poco ms lento, pero no vers pxeles en la misma. Original:

Ampliada con BILINEAR:

REPEATING: Si la textura es de 32x32 y tiene que dibujarse sobre una superficie de 64x64, veremos 4 imgenes rellenando ese hueco. Como si pusiramos la misma imagen una y otra vez repitindola. Este modo no funciona con los Sprites normales, as que por ahora, vamos a ignorarlo.

Cuando utilizas imgenes que contienen valores alpha (transparencia) puedes encontrarte con que te aparezcan "halos" que rodean los bordes de las mismas. Aqu es donde entra en juego la tcnica "premultiplied alpha", la cual corrige ese problema. Intenta evitar utilizar "premultiplied alpha" a menos que veas cosas raras en los bordes de tus imgenes, como sobras o halos resplandecientes que no deberan estar. Si quieres una interpolacin bilineal, estableces: TextureOptions.BILINEAR Si quieres una interpolacin bilineal con "premultiplied alpha", estableces: TextureOptions.BILINEAR_PREMULTIPLYALPHA Lo mismo ocurre si quieres interpolacin NEAREST con o sin "premultiplied alpha". Es cosa tuya explorar los valores que puedes elegir de TextureOptions. Para finalizar, decir que TextureOptions.DEFAULT = TextureOptions.NEAREST_PREMULTIPLYALPHA

TextureRegion
Define un rea rectangular de una textura. El sistema de coordenadas utilizado tiene su origen en la esquina superior izquierda con el eje x apuntando hacia la derecha y el eje y apuntando hacia abajo. Las textureRegion son empleadas para crear nuevas imagenes( o tambin llamados actores de tipo imagen) asociadas a un rea de una textura. Tiene varias opciones para construir un objeto de esta clase, son los siguientes:
TextureRegion()

Construye una region sin textuta ni coordenadas definidas.Se podran definir despues empleando los mtodos de la clase.
TextureRegion(Texture texture)

Construye una region de tamao especificado en la textura.

TextureRegion(Texture texture, float u, float v, float u2, float v2)

TextureRegion(Texture texture, int width, int height)

Construye una regin con con las coordenadas de la textura y el ancho y alto especificado.
TextureRegion(Texture texture, int x, int y, int width, int height)

Define una tetura especificando el punto (x,y) de origen y el tamao del area (ancho,alto)
TextureRegion(TextureRegion region)

Construye una regin con la misma textura y coordenadas que la regin pasada como parmetro.
TextureRegion(TextureRegion region, int x, int y, int width, int height)

Construye una regin con la misma textura y coordenadas que la regin pasada como parmetro.

Un ejemplo de seleccin de un rea con TextureRegion es el siguiente

TextureRegion texture = new TextureRegion(new Texture( Gdx.files.internal("data/jugador.png")), 0, 0, 40, 40);

TexturePacker
Empaqueta imagenes en un Texture Atlas.

Lo ideal es almacenar muchas imgenes ms pequeas en una imagen ms grande,obligar a la textura ms una vez, luego dibujar porciones de la misma muchas veces. libgdx tiene una clase TexturePacker que es una aplicacin de lnea de comandos queempaqueta muchas imgenes ms pequeas en 1imgen ms grande. TexturePacker se basa en este algoritmo. Tambin tiene una fuerza bruta, el embalaje de varias maneras y luego elegir el resultado ms eficiente.

Empaquetar imgenes automaticamente

Se deber importar la libreria: gdx-tools.jar El cdigo para ejecutar el TexturePacker: Settings settings = new Settings(); settings.padding=2; settings.maxHeight=1024; settings.maxWidth=1024; settings.incremental=true; TexturePacker.process(settings, "images", "data"); Se deber tener en el proyecto una carpeta images, con las imagenes a procesar. El proceso generar la carpeta data con el pack realizado.

Carga de imgenes empaquetadas

Asi se recuperan las texturas de un textureAtlas Generado por un packer. public static AtlasRegion background; atlas = new TextureAtlas(Gdx.files.internal("data/pack")); background = atlas.findRegion("background");

Dibujar imgenes en pantalla

Creamos la clase Asset para almacenar los recursos de imagenes. */ public class Assets { /** Contiene el paquete de texturas. */ public static TextureAtlas atlas; /** Regiones dentro de la imagen de textura empaquetada */ public static AtlasRegion background; public static AtlasRegion soundoff; public static AtlasRegion soundon; public static AtlasRegion start; public static AtlasRegion title;

/** * Load. */ public static void load(){ atlas = new TextureAtlas(Gdx.files.internal("data/pack")); background = atlas.findRegion("background"); soundoff = atlas.findRegion("soundoff"); soundon = atlas.findRegion("soundon"); start = atlas.findRegion("start"); title = atlas.findRegion("title");

} public static void dispose(){ atlas.dispose(); }

public class HolaLibgdxExample implements ApplicationListener { /** The gui cam. */ OrthographicCamera guiCam; /** Se utiliza para dibujar y optimizar las imagenes en el renderizado de la pantalla. */ SpriteBatch batcher;

@Override public void create() { } @Override public void dispose() { batcher.dispose(); } @Override public void pause() { } @Override public void render() { GL10 gl = Gdx.graphics.getGL10(); //referencia a OpenGL 1.0 gl.glClearColor(0,1,0,1); gl.glClear(GL10.GL_COLOR_BUFFER_BIT); guiCam = new OrthographicCamera(10, 15); //definicion de nuestra propia medida del juego guiCam.position.set(10f / 2, 15f / 2, 0); // Donde estara mirando la camara batcher = new SpriteBatch(); //crear solamente un batcher por pantalla y eliminarlo cuando no se use

guiCam.update(); batcher.setProjectionMatrix(guiCam.combined); //Dibujando el Background batcher.disableBlending(); //se elimina graficamente la transparencia ya que es un fondo batcher.begin(); batcher.draw(Assets.background, 0, 0, 10, 15); batcher.end(); //Dibujando elementos en pantalla activamos el Blending batcher.enableBlending(); batcher.begin(); batcher.draw(Assets.title, 1, 8, 8, 6); batcher.draw(Assets.start, 2, 5, 6, 1); batcher.draw(Assets.soundon, 2, 3, 6, 1); batcher.end(); } @Override public void resize(int arg0, int arg1) { } @Override public void resume() { } }

Entrada
El mdulo de entrada permite capturar los diversas formas de entrada de cada plataforma. Permite saber del estado de cada tecla, la pantalla tctil y el acelermetro. En el escritorio la pantalla tctil se sustituye por el ratn, mientras que el acelermetro no est disponible. En el fragmento de cdigo siguiente se obtiene el touch actual de coordenadas si hay un touch del celular (o del ratn en el escritorio): if (Gdx.input.isTouched ()) { System.out.println ("de entrada se produjo en x =" + x + ", y =" + y); } De manera similar a todos los medios de entrada pueden ser consultados y manipulados.

Detectar pulsaciones en la pantalla tctil

Se debe difinir un Vector, un area ficticia donde se captar el evento de pulsacin del dedo. Usamos tambien el objeto de OrthographicCamera, para convertir los pixeles en nuestra medida en metros. Luego preguntamos si el boton que creamos BoundingBox tiene un touch. Y escribimos el cdigo para manejar ese evento.

Audio
LibGDX cuenta con un mdulo de audio que ofrece dos tipos de recursos: El sonido y la msica. Ambos tipos soportan el formato WAV,MP3 y OGG. Tambin ofrece acceso al hardware de sonido. La diferencia entre el sonido y la msica es que el sonido se almacena en memoria y se usa cada vez que se quiere reproducir alguno de ellos, mientras que la msica son streams de sonido que estn almacenados en ficheros y a los que se accede cada vez que se quiere reproducir algo. El siguiente fragmento de cdigo reproduce un fichero de msica desde el disco con el volumen a la mitad:

Music music = Gdx.audio.newMusic(Gdx.files.getFileHandle("data/myMusicFile.mp3", FileType.Internal)); music.setVolume(0.5f); music.play(); music.setLooping(true);

Sounds
Sound es una clase destinada a la reproduccin de un efecto de sonido. Lo normal es cargar el sonido desde un archivo a memoria y luego reproducirlo a travs del mtodo Sound.play(). Los sonidos son generalmente cortos, llegando a durar unos pocos segundos ya que al ser cargados en memoria pueden llegar a ocupar demasiado, incidiendo directamente en el rendimiento. Cuando ya no vayamos a usar ms ese sonido ser necesario llamar al mtodo Sound.dispose() para liberar memoria en el dispositivo.

Cargar sonidos
Los Archivos para los efectos de sonido los pondremos dentro de una carpeta llamada data Para cargar en memoria un efecto de sonido tan slo ser necesario definirlo como tipo Sound y llamar al mtodo Gdx.audio.newSound pasando como parmetro el fichero dentro del directorio data. El siguiente fragmento de cdigo carga un sonido en memoria. Sound explosion explosion = Gdx.audio.newSound(Gdx.files.internal("data/explosion.ogg")); Puesto que el sonido ser una cosa que slo se cargar una vez durante toda la vida de la aplicacin, haremos la llamada a newSound en nuestro mtodo destinado a la carga de datos.

Reproducir sonidos
Para reproducir un sonido previamente cargado en memoria tan slo ser necesario hacer una llamada al mtodo play del sonido pasando como parmetro un valor entre 0 y 1 que representar el volumen. explosion.play(1);

Descargar sonidos
Una vez que no queramos hacer uso del sonido ser necesario descargarlo de memoria ya que en los dispositivos mviles, la memoria RAM sigue siendo un elemento muy precidado. Para descargar de memoria un sonido tan slo ser necesario llamar al mtodo dispose del objeto. Esto podemos hacerlo en nuestro apartado destinado a la descarga de datos o bien en el mtodo dispose de la aplicacin, como ya hemos visto en el apartado de ciclo de vida de la aplicacin. explosion.dispose();

Music
Music es la clase de libgdx para cargar archivos de sonido en nuestros juegos deriva de la clase Disposable consta de los siguientes mtodos: play() Comienza a la cancin,en el el caso de estar pausada la reanuda donde se quedo y en el caso de que se hubiera parado la comienza desde el principio. pause() Pausa la cancin, si la cancin no ha empezado aun o esta ya ha finalizado, este mtodo es ignorado al llamarlo. stop() Para la cancin.La siguiente vez que se llame al mtodo play() la cancin comenzar desde el principio. isPlaying() Funcin que devuelve un booleano, indicando si es verdad o no que la cancin esta sonando. setLopping() Admite como parmetro un booleano para indicar si se activa la funcin loop en la cancin, esta funcin activa la repeticin indefinida de la msica, de tal forma que si se llama al procedimiento indicando true, la cancin se repite indefinidamente hasta que la paremos o hasta que desactivemos el loop. isLopping() Funcin que devuelve un booleano, indicando si es verdad o no que la cancin esta sonando. setVolume() Vara el volumen del sonido, admite por parmetros (0 1) ,con un 0 se pone en silencio y con 1 se pone el volumen al mximo. getPosition() Funcin que devuelve un float con la posicin de la cancin en milisegundos dispose() Es el destructor de la clase. Es muy conveniente llamarlo cuando no sea necesaria la musica ya que consume memoria del disposivoLibgdx soporta los formatos MP3, OGG y WAV. Es conveniente usar Ogg en casi todos los casos. Si necesita ms control sobre el dispositivo de audio, puede utilizar el AudioDevice y clases Audiorecorder que tambin se obtiene de la interfaz de audio. Estas clases permiten a la salida de las muestras de PCM para el dispositivo fsico de audio, as como muestras PCM registro de un micrfono conectado.

Cargar una msica

Las msicas se pueden almacenar de forma interna en el proyecto que estamos desarrollando o en una ruta fija(por ejemplo para poner como msica un sonido standard del sistema) Para cargar una msica en memoria debemos instanciar un objeto de la clase Music pasandole como parmetro un puntero al fichero del tipo FileHandle nativo de java, de la siguiente forma: Music music = Gdx.audio.newMusic(Gdx.files.getFileHandle("data/8.12.mp3", FileType.Internal) );

En este ejemplo la cancin 8.12.mp3 esta guardada dentro de la carpeta del proyecto data, por lo que el tipo de archivo le indicamos que es interno. FileType.Internal. En el caso de no poder abrir el archivo se genera una excepcin GdxRuntimeException Los tipos posibles de ficheros son los nativos de Javade tipo File.FileType, estos son: External Path relativo a la raiz del almacenamiento SD de android. Internal Path relativo a la ruta de la aplicacion android o dicho de otro modo relativo al directorio raiz de la aplicacin creada. Classpath El path del fichero esta en una ruta relativa a la raiz del Clashpath Absolute El path esta indicado de forma absoluta, indicando el filesystem que lo contiene.

Reproducir una msica

Para reproducir una msica como hemos mencionado antes basta con llamar al metodo play() desde el objeto instanciado de tipo Music. Vamos a verlo mas claramente con un pequeo ejemplo de como dejar una msica reproducindose en un bucle infinito donde la msica es un archivo mp3 almacenado en una carpeta que hemos llamado data Music music = Gdx.audio.newMusic(Gdx.files.getFileHandle("data/8.12.mp3", FileType.Internal) ); music.setLooping(true); music.play();

Descargar una msica

Una vez que no queramos hacer uso del sonido ser necesario descargarlo de memoria. Para descargar de memoria un sonido tan slo ser necesario llamar al mtodo dispose del objeto. Esto podemos hacerlo en nuestro apartado destinado a la descarga de datos o bien en el mtodo dispose de la aplicacin, como ya hemos visto en el apartado de ciclo de vida de la aplicacin. En el caso de que la msica estuviera en un bucle lo lgico es pararla antes de eliminarla por seguir una secuencia lgica, y en parte por esttica de la programacin, estos se hace llamando al mtodo stop, por tanto el orden seria : music.stop(); music.dispose();

Navegando entre pantallas del juego

Game extiende de AplicationListener para implementar multiples pantallas. Una Screen es una pantalla de un juego. Opciones, Menu principal, nivel 1, nivel 2, creditos, etc. Para cambiar entre pantallas haremos: Screen gameScreen = new GameScreen(game); game.setScreen(gameScreen); return; es decir, creamos la screen, y se la seteamos a la instancia del juego.

Vibracin
Para agregarle al juego del arkanoid (el del video tutorial) que vibre al chocar la barrita con la pared izquierda por modificamos el mtodo render() de la clase GameScreen. try { Gdx.input.vibrate(200); System.out.println("vibra"); } catch (Exception e) { System.out.println(e); }

Cmaras
OrthographicCamera guiCam; guiCam = new OrthographicCamera(10, 15); //definicion de nuestra propia medida del juego

10x15 metros: Esto es porque dividmos los 320x480 pixeles en bloques de 32px. guiCam.position.set(10f / 2, 15f / 2, 0); // Donde estara mirando la camara

Animacin
Crearemos un personaje de un personaje y haremos una animacin, es decir, que camine como si se estuviera moviendo.
Aqu se ve el ejemplo de un hombre corriendo. La imagen se puede ver como una matriz de imgenes las cuales se van a recorrer con dos ciclos y se van a pasar por imagen a un vector. Cuando se crea la animation, se le pasa por parametro la velocidad con la que se mueve el frame y el vector de imgenes. Por ltimo cuando se invoca al spriteBatch.draw(); se le indica el vector que contiene las imgenes, la posicin de X y de Y en donde se quieren dibujar las mismas.

Usaremos la siguiente Imagen como

secuencia: Copiaremos esta imagen, en la carpeta /imagen del proyecto Creamos una clase que implemente screen animacin: public class AnimationScreen implements Screen { Game game; static final float WORLD_WIDTH = 5; static final float WORLD_HEIGHT = 3.3f; private static final int FRAME_COLS = 6; // #1 private static final int FRAME_ROWS = 5; // #2 OrthographicCamera guiCam; SpriteBatch batcher; Animation walkAnimation; // #3 Texture walkSheet; // #4 TextureRegion[] walkFrames; // #5

SpriteBatch spriteBatch; // #6 TextureRegion currentFrame; // #7 float positionX=1; float stateTime; // #8 Inicializamos en el constructor lo referente a la animacin: public AnimationScreen(Game game) { this.game = game; batcher = new SpriteBatch(); guiCam = new OrthographicCamera(WORLD_WIDTH, WORLD_HEIGHT); guiCam.position.set(WORLD_WIDTH / 2, WORLD_HEIGHT / 2, 0);

walkSheet = new Texture(Gdx.files.internal("images/man.png")); // #9 TextureRegion[][] tmp = TextureRegion.split(walkSheet, walkSheet.getWidth() / FRAME_COLS, walkSheet.getHeight() / FRAME_ROWS); // #10 walkFrames = new TextureRegion[FRAME_COLS * FRAME_ROWS]; int index = 0; for (int i = 0; i < FRAME_ROWS; i++) { for (int j = 0; j < FRAME_COLS; j++) { walkFrames[index++] = tmp[i][j]; } } walkAnimation = new Animation(0.025f, walkFrames); // #11 spriteBatch = new SpriteBatch(); // #12 stateTime = 0f; // #13 }

Ahora en el render hacemos: Gdx.gl.glClear(GL10.GL_COLOR_BUFFER_BIT | GL10.GL_DEPTH_BUFFER_BIT); // #14 stateTime += Gdx.graphics.getDeltaTime(); // #15 currentFrame = walkAnimation.getKeyFrame(stateTime, true); // #16 spriteBatch.begin();

spriteBatch.draw(currentFrame, positionX, 2); // #17 spriteBatch.end(); update(delta); (16: obtenemos el frame correspondiente en base al tiempo que lleva moviendose) Metodo Update public void update(float delta){ positionX+=0.1f; }

Si necesitan el cdigo fuente completo de este ejemplo: javi10823@gmail.com

Manual de buenas prcticas

TO DO: Introduccin a cosas para ser ms eficientes y limpios escribiendo cdigo. Para ser limpios y eficientes escribiendo cdigo es importante tener en cuenta varias cosas como creaciones de mtodos para simplificar el cdigo, no hacer condiciones muy largas o muchos bucles anidados, estos son solo algunos ejemplos, ahora explicare un poco mas extenso algunos de los puntos mencionados anteriormente. - Definir variables al principio de la clase/mtodo, de esta forma se tiene un acceso rpido a esa variable y sabemos de un simple vistazo que atributos tiene. - Respetar las reglas de nomenclatura de los lenguajes tales como los siguientes:

- Los nombres de las variables comienzan con letras minsculas, y en caso de contener varias palabras se le pondr mayscula a la primera letra de cada palabra a partir de la segunda palabra. - Los nombres de los mtodos se escribirn en minscula siguiendo la misma regla que el nombrado de las variables. Por lo general, el nombre de estos suelen ser verbos. - Las variables finales se escribirn integramente en mayscula, separando, si fuera necesario, diferentes palabras por medio del carcter guin bajo _ - El nombre de los paquetes se realizar integramente en minscula, aunque contenga varias palabras. - El nombre de las clases comenzar con la primera letra en mayscula y las siguientes en minscula. En caso de contener varias palabras se las distingir poniendo mayscula la primera letra de cada palabra. - Tabular el cdigo para una mayor compresin del mismo. En java, a diferencia de otros lenguajes de programacin como puede ser python, no es necesario que las lineas de cdigo estn tabuladas para pertenecer a un mtodo/funcin/clase ya que para esto se utilizan las llaves, pero de esta forma se hace el cdigo ms legible. - Realizar un estudio que relacione el tiempo de procesamiento vs almacenamiento. En ocasiones una lista puede estar muy bien para almacenar datos, pero un array tiene un acceso inmediato al dato contenido. - Si ves que programando escribes varias veces lo mismo, creaciones de objeto que varan muy poco, comprobacin de un objeto, cambiar un objeto, lo mas probable es que puedas cambiarlo por una funcin o un mtodo. Por ejemplo: - Crear un casillero de 10 x 10, esto implica dibujar o crear 100 casillas, escribiras 100 veces: batcher.draw(casilla, posX, posY, 1, 1); Y esto no es eficiente, pero podras dibujarlo con: for (int i = 1; i < 11 ; i++) { for (int j = 1; j < 11; j++) { batcher.draw(casilla, i, j, 1, 1); } } } - Usar switch case si ves que comparas lo mismo dentro de muchos if, teniendo en cuenta que un case solo comprueba integer y enumerados. - Antes de crear un mtodo comprobar que no existe ya, o parecido, para que puedas modificarlo, siempre que al modificarlo no haya nada dependiendo de el.

- Usar varios for anidados hace que el programa se ralentice mucho, ya que podemos encontrarnos con recorridos con muchos elementos y los recorre todos por lo que ralentiza mucho y no es eficiente, esto no suele aparecer mucho pero hay que tener cuidado a la hora de meter for while o do, uno dentro de otros ya que puede dar problemas Otra de las cosas que hay que tener en cuenta a la hora de programar es ser limpio y no escribir como se nos van ocurriendo las cosas y dejarlo as, ya que si despus alguien quiere usar nuestro o cdigo o simplemente saber como funciona le sera imposible, por eso cuando estemos programando hay que intentar dejar lineas simples, o explicar con comentarios cuando veamos que algo puede que no se entienda. Lo que tambin ayudara a la hora de la limpieza y de la claridad seran la clases, lo mas importante en el caso de la programacin orientada a objetos. Siempre que vallas a utilizar un objeto que vaya a tener mas de una propiedad se utilizan clases. Algunos ejemplos: - Pelota en un espacio: Adems de su nombre tendr un x e y indicando su posicin. - Personaje: Adems de su nombre puede tener su posicin indicada con x e y, un inventario guardado en un array, o cualquier cosa. En estos y en muchos mas la creacin de una clase es lo mejor, cuando veas que estas creando dos variables para guardar informacin sobre un objeto dentro de una clase seguramente podrs instanciar ese objeto desde otra clase y sera mas claro que poniendo tantos atributos.

Separar la lgica de la presentacin

Con lgica nos referimos a todas las comprobaciones, modificaciones o creaciones que se hacen antes de renderizar, ya que el proceso de renderizado solo ya es lento si metes tambin toda la logica ara que el juego sea lento, por esto es recomendable hacerlo en una clase aparte. Para hacer la parte lgica basta con crear un clase aparte del renderizado donde comprobemos lo que haga falta antes de pintar en pantalla. Por ejemplo: -Cambiar la velocidad de una pelota al chocar con una pared: // Choque en pared izquierda if(ball.position.x - 0.25 < 1){ ball.position.x = 1 + 0.25f; ball.direction.x = ball.VELOCITY; } -Comprobar el valor de una casilla para pintarla de un color diferente: public AtlasRegion casilla(int x, int y){ switch(matriz[x][y]){ case 0: return Assets.casillaG; break; case 1: return Assets.casillaB; break; case 2: return Assets.casillaR; break; case 3: return Assets.barco; break; default: return Assets.barco2; break; } } -Actualizar valores de las variables. En resumen todo lo que no sea dibujar en pantalla y deba ejecutarse siempre se ha de poner fuera del renderizado, pero teniendo en cuenta que el render lo debe llamar, si hicieramos la parte logica en una clase llamada World deberia quedar algo parecido a esto: public class World { //atributos internos //constructor

public World(){ initialize();//metodo interno, abajo creado. } //inicializar variables o limpiar public void initialize(){ } //actualizacion public void update(){ //aqui deber ir todo lo que forma parte de la lgica para el renderizado de la pantalla, teniendo en cuenta que hay que llamarlo desde el render, que se el puede pasar los parmetros que se necesiten } } Puede haber distintos World, y puede usarse en las pantallas que se necesiten, no tiene porque ser solo de una. Para usar el World hay que llamarlo desde el render, pero antes tiene que haber un objeto desde el que llamarlo, que sera creado en la clase de la pantalla, aqui un ejemplo: public class GameScreen implements Screen{ World world; //Atributos public GameScreen(){ this.world = new World();//esto llama al contructor, que a la vez llama al inizialite. //inicializacion de atributos. } @Override public void dispose() {

} @Override public void hide() { } @Override public void pause() { } @Override public void render(float delta) {//delta es el tiempo transcurrido desde la ultima llamada por si la logica lo necesita. World.update();//aqui actualizamos la logica del juego. //Pintar imgenes. } @Override public void resize(int width, int height) { } @Override public void resume() { } @Override public void show() { } }

Pginas para Desarrollo de Juegos

Descargar Sonidos
http://www.mysoundfx.com/

Musica para dar ambiente a tu juego

http://pro.jamendo.com/es/

Tutorial creacin Sprites Animadas desde cero

http://ilovepixel.net/tutorial.html

2d Game Art For Programmers

http://2dgameartforprogrammers.blogspot.com/

Crear un personaje para Animacin

http://2dgameartforprogrammers.blogspot.com/2011/10/creating-game-character.html

Caras
http://2dgameartforprogrammers.blogspot.com/2011/11/creating-basic-face.html

Fondos http://2dgameartforprogrammers.blogspot.com/2011/10/more-fun-with-gradients.html

Solucin de problemas
TODO: Se describen los problemas que ms pueden aparecer junto con sus soluciones.