Hace tiempo Cancan portó el teclado Danzel de C a Lua y, desde entonces, tenía pensado sacar un tutorial para aprender a usar este magnífico teclado. Para quienes no lo conozcáis es el que usa el AFKIM y, en su última versión, Danzel liberó el código favoreciendo la portabilidad a Lua. Las posibilidades son muchas, por ejemplo, puedes usarlo para escribir el nombre de quien haya logrado un récord en tu juego. Muchos opinan que es mejor que el propio teclado que trae el XMB de la PsP (ése que usas para ponerle en nombre a tu consola) y yo soy uno de ellos, por eso vamos allá.

Para empezar debo decir que en esta ocasión no voy a subir el script.lua sino que voy a subir una carpeta (Danzel) que contiene el index.lua (es el archivo que se usa cuando vas a lanzarlo a través del Lowser), una subcarpeta (Teclado) con el archivo danzeff.lua y otra subcarpeta (danzeff) que contiene todas las imágenes. Prefiero usar este método porque al ser muchos archivos y carpetas quedaría bastante desordenado meterlas todas en la raíz del luaplayer, por eso vamos a usar el Lowser para lanzar el programa y meteremos la carpeta Danzel dentro de luaplayer/Applications.

El archivo danzeff.lua es el teclado portado desde C, así que no voy a explicar nada de eso. Sólo comentar que he variado la ruta de las imágenes que carga para que coincida con la estructura de carpetas que vamos a utilizar. Para los más expertos, decir que el teclado es una clase, con su definición y sus métodos, pero eso ya es otra historia.

Por lo tanto nos centramos en index.lua, que es ahí donde vamos a crear nuestro propio código.

En primer lugar tenemos la ya típica creación de colores RGB:

-- Creamos los colores que vamos a utilizar
blanco = Color.new(255,255,255)
verde = Color.new(0,255,0)

Ahora llamamos al archivo Lua que crea el teclado:

-- Llamamos al archivo danzeff.lua
dofile("./Teclado/danzeff.lua")

Lo siguiente es crear una nueva instancia de teclado e inicializarlo en unas coordenadas:

-- Creamos un nuevo teclado
teclado = Danzeff:New()
-- Inicializamos el nuevo teclado en esas coordenadas
teclado:Init(330,122)

A continuación creamos una variable que almacenará lo que vayamos escribiendo con el teclado:

-- Creamos una variable texto vacía
texto =""

Ahora empezamos con el bucle principal:

-- Bucle principal
while true do
    screen:clear()
    pad = Controls.read()
    teclado:Display()
    caracter = teclado:Input(pad)
    if pad ~= oldpad and caracter ~= 0 then
       screen:print(130,130,caracter,blanco)
       texto = texto .. string.char(caracter)
    end
    screen:print(100,100,texto,verde)
    oldpad = pad
    screen.flip()
    screen.waitVblankStart()
end

Como es poco código lo he puesto completo y ahora explico línea a línea. Con el While creamos nuestro bucle infinito, luego limpiamos la pantalla y hacemos una lectura de botones. Para los que hayan seguido mis tutoriales no tendrán ningún problema con esto. Con teclado:Display() haremos que se muestre en pantalla nuestro teclado que ya habíamos creado e inicializado anteriormente. En la variable caracter guardamos un número ascii del caracter que hemos pulsado en el teclado. Expliquemos esto un poco más, con el teclado ya visible, usando el stick analógico seleccionamos las letras, números o símbolos que queremos escribir, pues cada selección nos devuelve un número perteneciente a la tabla ascii (para los que no sepan qué es, usad Google) y queda almacenado en caracter. En el if comprobamos que no sea la misma pulsación de tecla y que caracter no valga cero. Si no hacemos la comprobación de repetición de tecla ocurre que al pulsar cualquier tecla en vez de aparecer una sola vez el caracter elegido aparece muchas hasta que soltemos el botón. Y el valor cero de caracter quiere decir que no se pulsa ninguna tecla, por lo tanto hay que desecharlo. Si entra en el if primero le digo que muestre por pantalla el número ascii en color blanco que ha leído del teclado y a continuación guardo en texto su conversión a caracter. Me explico, con la instrucción string.char(caracter) consigo convertir ese número leído por teclado en una letra, un número del 0 al 9 o un símbolo (punto, coma, etc), luego lo concateno a la variable texto para ir formando el texto que queremos escribir. Si no lo concatenases, la variable texto sólo guardaría el último carácter al que la igualaras y se perderían las anteriores lecturas. Fuera del if mostramos el texto en color verde y terminamos el bucle principal como solemos.

Como podéis comprobar el programa en sí es de lo más sencillo, pero creo que cuanto más sencillo mejor se entiende la forma de utilizar el teclado Danzel en Lua. Espero que os sea útil y que lo utilicéis en vuestros programas y juegos. Saludos.

ELeNDeR 2oo6