
Klimt for GP32
==============

1. Qu hay de nuevo, viejo?
----------------------------

- 0.1.9
  -----
   Versin inestable para pruebas
   Basada en el cvs de Klimt (Septiembre 2004)
   Apta para el SDK de Mr.Mirko 0.90
   Incorporada librera matemtica optimizada para ARM (aumento de velocidad)
   Deshabilitado el ejemplo "shapes" (funcionamiento incorrecto)
   Incluido el ejemplo "torus" (demo de klimt)
   Aadido contador de FPS en la mayora de ejemplos
   Aadida la posibilidad de activar/desactivar la correccin de color con
    el botn B en la mayora de ejemplos

- 0.1
  ---
   Primera versin pblica
   Basada en Klimt 0.6.1
   Usa el SDK de Mr.Mirko 0.85
   Funciones bsicas de OpenGL
   Modo "portrait"
   Conversion a RGB555 con la funcion externa "torgb555" en espacio de usuario



2. Acerca de
------------

Klimt for GP32 es un porte de la librera de grficos 3D "Klimt" para dispositivos mviles
a la consola porttil GP32 de Gamepark.

El objetivo de este porte es dotar a la GP32 de la capacidad de trabajar con grficos 3D
usando la conocida API OpenGL, que la librera Klimt ya implementa.

Klimt fue originalmente desarrollada para dispositivos pequeos (PocketPC, Smartphones, etc...)
pero con suficiente potencia de clculo como para procesar operaciones de grficos 3D.
Muchos de estos dispositivos poseen caractersticas muy similares a las de la GP32 (procesador
ARM9, 8 MB de RAM, etc...), as que portar Klimt a la GP32 pareca algo factible y obvio.

Klimt for GP32 se apoya en el SDK especfico realizado por Mr.Mirko para la consola y en
un entorno de compilacin cruzada hacia ARM basado en GCC y otras herramientas libres.

Al igual que el software en el que se basa, Klimt for GP32 es enteramente Software Libre y
est lanzado bajo y protegido por la licencia abierta GPL de la Free Software Foundation.

La motivacin principal de portar Klimt a la GP32 fue facilitar a los programadores grficos
de mi grupo scener (Necrostudios) la faena de desarrollar demos en la consola, permitiendo
que "le puedan hablar en su idioma" :-) Por supuesto, la idea misma de poder programar la
GP32 usando OpenGL sospecho que le resultar atractiva a ms gente :-)


3. Instalacin y configuracin
------------------------------

Para desarrollar con Klimt for GP32, en necesario tener instalado en el sistema un entorno
de compilacin cruzada hacia la GP32 basado en en una versin moderna de GCC. Adems, es 
necesario contar con el SDK de Mr.Mirko para toda la mecnica propia de la consola. Ambos
deben estar compilados soportando operaciones de coma flotante POR SOFTWARE (-msoft-float).

Es un buen primer paso usar el script de creacin automtica del entorno de desarrollo que
el propio Mr.Mirko tiene publicado en su pgina web.

En el momento de escribir este documento,
Klimt for GP32 ha sido construido con xito nicamente en ordenadores usando el S.O.
Linux sobre procesadores PowerPC G4 y AMD Athlon o bien usando Windows conjuntamente con el
entorno Cygwin. Ahora mismo, no s si funcionar en otras plataformas, no lo he probado.

Lo primero que hay que hacer es preparar el SDK de Mr.Mirko para que pueda compilar programas
con Klimt for GP32 (si no se ha hecho ya). Dentro del directorio lib.src/ del SDK encontramos
las fuentes del propio kit de desarrollo. A su vez, dentro de ese directorio estn divididas
en subdirectorios las sub-partes del SDK. Entramos en cada una de ellas y editamos el archivo
Makefile para que use unos buenos flags de compilacin, por ejemplo:

-s -march=armv4t -marm -msoft-float -ffast-math -fshort-enums -mstructure-size-boundary=8

Tambin podemos activar algun flag del tipo -O para optimizar ms el cdigo.

Es importante resaltar que en aquellas sub-partes en las que se usen archivos en ensamblador,
es necesario especificar al menos que se "compilen" con la opcion -msoft-float.

Una vez retocados todos los Makefile, volvemos al directorio lib.src/ y ejecutamos:

make

Vamos al directorio lib/ y tambin ejecutamos:

make

Con lo que el SDK debera construirse, a pesar de que nos d unos cuantos warnings.

Si no disponemos del cdigo fuente del subsistema de acceso a la SMC, bastar con
copiar el fuente de una versin anterior del SDK (por ejemplo la 0.85) y descomentar
en los Makefile las lineas referentes a su compilacin.

Una vez preparado el SDK de Mr.Mirko, estamos listos para compilar Klimt for GP32.
En el directorio raiz de Klimt for GP32:

cd klimt/build/GP32

Habr que modificar brevemente el Makefile para que se ajuste a los parmetros exactos
del sistema (sobretodo las rutas de los ficheros). Limpiamos y compilamos:

make clean
make

Eso debera construir la librera libKlimt.a ya preparada para la GP32.



4. Ejemplos
-----------

En la carpeta klimt/test/simple_gp32 tenis una serie de ejemplos (algunos de ellos extraidos
de los excelentes tutoriales de NeHe sobre OpenGL) de la librera as como un Makefile (que
probablemente tengis que editar para que est acorde con vuestro sistema) modelo y
bastante autoexplicativo para compilar proyectos que usen Klimt for GP32 y el SDK de Mr.Mirko.

He intentado escribir los ejemplos de la forma ms didctica posible, aun as s que quiz les
falte un poco de documentacin, pero bueno, me tena que centrar en el cdigo, no? ;-)

El ejemplo "simple.cpp" es un porte del ejemplo bsico de Klimt donde se usa la primitiva
klutSolidCube para generar un cubo.

El ejemplo "shapes.cpp" es un ejemplo bsico de NeHe que muestra dos cuerpos 3D bsicos
coloreados sin texturas rotando. Este ejemplo no se compila por defecto dado que con la ltima
versin de la librera no se comporta correctamente.

El ejemplo "glxgears.cpp" es el clsico programa de testing de OpenGL con unos engranajes
girando. Los engranajes se pueden girar con la cruceta. Ahora mismo tiene unos cuantos bugs.

El ejemplo "texture.c" est hecho en C porque las funciones de acceso a ficheros de
Mr.Mirko no parecen funcionar muy bien desde C++ (al menos yo no he sabido hacerlas
funcionar :-) . Est basado en otro ejemplo bsico de NeHe (de hecho la textura es suya) y
muestra cuatro cubos texturados rotando mientras suena msica de fondo. Tiene unos cuantos bugs
tambin, el ms notable de ellos, que se carga la textura al revs y no se muy bien porqu.
Recordad que al subir el .fxe a la consola, tenis que pornerlo en /GPMM junto con el archivo
.bmp que contiene la textura.

El ejemplo "torus.c" es un ejemplo bsico de dibujado de malla. Muestra un toroide que puede ser
rotado sobre sus diferentes ejes con la cruceta.

Todos los ejemplos resetean la consola al pulsar el botn A.
La mayora de ejemplos activan/desactivan el modo de correccin de color al pulsar el botn B.



5. Agradecimientos y saludos
----------------------------

Este porte no habra sido posible sin la inestimable ayuda de Corsario del grupo TLOTB,
el rey de los 3D en dispositivos pequeos ;-)

Adems quiero agradecer a mi grupo scener Necrostudios, la ayuda y apoyo prestados desde que
comenc el porte en la Xplanada Party 2004.
Necrostudios es: Octal, Polge, Lemoniac, aTMsa, Piedachu, Slack, PPlux, Pixel y Maulo (ese soy
yo :-) .

Y como marca la tradicin, saludo a:
TLOTB
PPG
Alicante Zone
Lucera
Stravaganza
Threepixels
Zon@n
RGBA
Collapse
Insiders
Capsule
Dust Inc
Level 64
Unknown
Sector Omega
Concept
Spntz
xplsv
Polinux

Mis respetos a:
Farbrausch
Future Crew
Ozone

Gracias a:
Corsario, el 3D no sera lo mismo sin ti ;-)
Anarchy, por ser el motor de la scene GP32 en Espaa y por venderme una :-)
Mr.Mirko, por su SDK
NeHe, por sus tutoriales
Locke, por usar mi librera para hacer algo bonito :-)
uVe, por todo



6. Links y referencias
----------------------

www.gp32spain.com -- El lugar donde ir si tienes una GP32 y hablas castellano :-)
www.mirkoroller.de/gp32  -- Homepage de Mr.Mirko, el gran gur :-)
nehe.gamedev.net -- El mejor sitio donde aprender OpenGL
studierstube.org/klimt/ -- La pgina oficial de la Klimt


Hecho por Maulo <maulo_EN_on.to>

