PAlib básico (Día 1)

Seguramente a más de uno le gustaría poder crear sus propios homebrews. ¿Y a quién no? Por eso creé este tutorial, al que con un poco de suerte se le unirán más. En este primer día explicaré para qué sirve el archivo main.c que NO podemos borrar, cómo escribir un sencillo texto en ambas pantallas y cómo hacer que el programa responda ante los botones y el stylus de nuestra DS. He de advertir que hay que seguir antes el tutorial de AlmamuPP para instalar el entorno

1.-Main.c

Antes de nada, crearemos un proyecto nuevo. Para ello, nos dirigiremos a C:\DevkitPro\Palib\ y entraremos en el archivo llamado Project (si habéis instalado donde indica el anterior tutorial, si no, buscadlo en donde hayáis instalado todo. Recordad esto para siempre: NUNCA realizaremos proyectos en directorios que contengan espacios en el nombre) Hecho esto, pinchamos en File, New, New Project, y después nos aparecerá esta ventana:

En ella escribiremos: 1.-El nombre del archivo (no puede tener espacios) 2.-El directorio (recomiendo este: [dentro del directorio en el que lo pusieses] \tutoriales\textossimples\) 3.-De las posibilidades escogeremos PAlib Template (el icono de la Game Boy Advance SP)

Hecho esto aceptaremos. Volverá a mostrar el mismo programa, pero sin mostrar texto. En los iconos de la derecha abriremos main.c: aquí realizaremos todos los ejercicios. En la hoja main.c veremos este código escrito:

// Includes
 
#include // Include for PA_Lib
 
// Function: main()
 
int main(int argc, char ** argv)
 
{
 
PA_Init(); // Initializes PA_Lib
 
PA_InitVBL(); // Initializes a standard VBL
 
// Infinite loop to keep the program running
 
while (1)
 
{
 
PA_WaitForVBL();
 
}
 
return 0;
 
}
 
// End of main()

Ahora os explicaré para qué sirve cada parte del código:

#include Esto indica a PAlib que incluya las libnds, necesarias para que todo funcione.

int main(int argc, char ** argv) Esto ya es más complicado de explicar: digamos que a partir de aquí el programa comienza a funcionar. Todo lo que le indiquemos (excepto lo del while) dentro de los corchetes se cargará y ejecutará una sola vez.

PA_Init(); Inicia PAlib. Por decirlo de otro modo: prepara el papel (la DS) para escribir encima (para ejecutar lo que sigue).

PA_InitVBL(); Comienza el VBL, que es el que se encarga de que le velocidad de los frames (imágenes) sea correcta (más o menos 60 por segundo).

while(1) Indica que todo lo que se realice dentro de los corchetes se realizará infinitamente mientras la variable de dentro de los paréntesis sea 1 (por el momento entendámoslo así: el código de dentro de sus corchetes se realizará mientras la DS siga encendida [encendida=1, apagada=0]).

PA_WaitForVBL(); Esta función dentro del while sirve para que el VBL siga funcionando; si dejase de funcionar, el código seguiría, pero la imagen quedaría “congelada”.

Return 0; Literalmente significa “devuelve 0”, y eso es lo que hace. Cuando el programa sale del while (como dije antes, si la consola se apagase) el programa finalizaría, puesto que la variable del while es 0.

El resto no sirve de nada. Cuando en el código se pone //, indica que lo que se escriba después de eso es una anotación, y el programa hará caso omiso de eso. Es útil para, por ejemplo, explicar de qué sirve ese código cuando rellenemos hojas de funciones.

2.-Creación de textos básicos en ambas pantallas.

Muy bien, comprendido todo esto, aprenderemos a escribir en la pantalla. Basta con saber estos códigos:

PA_InitText(pantalla,capa); Esto indica al programa que en algún momento escribiremos en esa pantalla, y preindica en qué capa escribir el texto.

PA_OutputSimpleText(pantalla,posiciónX,posiciónY,”texto entre comillas”); Con este código le decimos al programa dónde escribir el texto y qué texto poner. ES NECESARIO haber escrito antes el PA_InitText.

NOTA: Este texto no admite caracteres extraños (ñ, acentos, & y demás). Para usar estos necesitaremos otra función, que explicaré en otro tutorial.

Variables a conocer:

Pantallas: 1=superior, 0=táctil. Capas: 0=por encima de todas, 1=por encima de todas menos del 0, 2=por encima del 3, 3=debajo de todas.

PosiciónX: posición horizontal (en tiles en el caso de texto, del tamaño de una letra [1 letra=8x8 píxels]), de 0 a 31.

PosiciónY: posición vertical (también en tiles), de 0 a 23.

AVISO: Todas, repito, TODAS las llamadas de código (a excepción de bucles) deberán acabar en “;”. Si no, el programa lee la siguiente línea como si fuese la misma.

Muy bien, ya sabemos suficiente código como para realizar el ejemplo. Recomiendo leer primero éste antes de intentarlo por cuenta propia.

 // Includes
 
#include // Include de las PAlib
 
// Funcion main()
 
int main(int argc, char ** argv)
{
 
PA_Init();
 
PA_InitVBL();
 
PA_InitText(1,2);
 
PA_InitText(0,2);
 
PA_OutputSimpleText(1,5,5,”Hola mundo!”);
 
PA_OutputSimpleText(0,5,5,”Adios mundo”);
 
while (1)
 
{
 
PA_WaitForVBL();
 
}
 
return 0;
 
}
 
// Fin de main() 

Fácil de entender, ¿no? (por favor, si alguien no lo entiende que me lo diga en un comentario e intentaré explicarlo mejor)

3.-Botones y stylus. Variables generales.

Los botones y stylus tienen variables propias. Debido a que hay que saber mucha más teoría de la que expliqué en este tutorial, veremos sólamente las variables más simples. En el próximo tutorial indicaré cómo usarlas, pero por el momento que os suenen.

Códigos para los botones:

Pad.Newpress.botón Sirve cuando se quiere dar una pulsación al botón, y luego se suelta

Pad.Held.botón “Mantiene presionado botón”. Indica al programa que se mantiene pulsado dicho botón.

Pad.Released.botón “El botón se suelta (deja de estar pulsado).”

Variables:

Simplemente sustituir botón por Up, Down, Left o Right (cruceta), A, B, X, Y, L, R, Start, Select.

Códigos para el stylus:

Stylus.Newpress Como con los botones.

Stylus.Held Como los botones.

Stylus.Released Como los botones.

Stylus.X Posición X del stylus. Se divide en varias partes:

Stylus.X “Posición X del stylus.”

Stylus.X-a “Posición X del stylus menos a.”

Stylus.X+a “Posición X del stylus mas a.”Así sería con todas las operaciones.

Stylus.X>0 “Si stylus pulsa en una posición X mayor que (de 0 a 260, en píxels).”

Stylus.X<0 “Si stylus pulsa en una posición X menor que (mismas posiciones).”

Stylus.Y Posición Y del stylus. Tiene las mismas partes que Stylus.X.

Stylus.XY Posición exacta del stylus.

NOTA: Creo que no hace falta que diga que los usos del stylus son en la pantalla táctil, así que nada de pulsar en la superior .

Y eso es todo. Bueno, no del todo. Para finalizar y para asegurarnos que lo habéis pillado, os voy a proponer una tarea para realizar por vuestra cuenta. Quiero que cubráis ambas pantallas con letras, pero nada de escribir todo seguido, no. Tenéis que hacerlo creando realizando PA_OutputText por letra. Ánimo, es tedioso, pero nada difícil.