Micro Lua DS

Micro Lua est un projet initialement développé par Risike à partir de septembre 2008. Le 9 juillet 2009, celui-ci rend son travail open source, ne souhaitant plus continuer le développement. Micro Lua est alors repris par la communauté.

Il est à noter que le projet de la µLibrary a été abandonné par Brunni au moins à partir de la fin de l'année 2010[1], c'est pourquoi MicroLua maintient sa propre version.

Courant juin 2013, la gestion du projet est transférée de GoogleCode à SourceForge, amenant une réflexion sur la direction à prendre et posant plus clairement les objectifs du développement de Micro Lua.

Seules les versions majeures sont répertoriées ici. Toutes les révisions sont disponibles sur le dépôt SourceForge de Micro Lua.

Le projet latent des améliorations de MicroLua est de compléter l'éventail des fonctionnalités, notamment par l'ajout du microphone ou la lecture de fichiers audio dans des formats plus courants. D'un point de vue technique, l'idée a été émise de faire évoluer la syntaxe générale vers une orientation objet (à l'exemple de la gestion de Timers ou des Sprites). Il est aussi prévu de migrer l'ensemble du code de l'interpréteur en C (actuellement, une partie des fonctionnalités est codée en Lua).

L'utilisation du middleware LuaJIT est envisagée, afin d'améliorer significativement les performances du langage Lua.

-- Condition usuelle afin de quitter la boucle principale "infinie" du programme lors d'une pression sur le bouton Start
while not Keys.newPress.Start do
-- Mise à jour des contrôles
Controls.read()
-- Affiche "Hello world!" sur l'écran du haut, dans le coin supérieur gauche
screen.print(SCREEN_UP, 0, 0, "Hello world!")
-- Commande la mise à jour des écrans
render()
end

L'ensemble de la boucle, de la fonction Controls.read() et render() constitue la structure de base d'un code avec Micro Lua.

screen.drawLine(ecran, x1, y1, x2, y2, couleur)

Micro Lua définit un type personnalisé servant à stocker une information de couleur : le type Color.

Les coordonnées indiquées sont respectivement celles du coin supérieur gauche et du coin inférieur droit.

-- Rectangle vide
screen.drawRect(ecran, x1, y1, x2, y2, couleur)
-- Rectangle plein
screen.drawFillRect(ecran, x1, y1, x2, y2, couleur)
-- Rectangle dégradé
-- Les couleurs correspondent à chaque coin du rectangle, de haut en bas et de gauche à droite
screen.drawGradientRect(ecran, x1, y1, x2, y2, couleur1, couleur2, couleur3, couleur4)

Micro Lua, tout comme la µLibrary, distingue les deux mémoires générales de la Nintendo DS : la mémoire vidéo, désignée par VRAM, et la mémoire principale, qui correspond à RAM. Les images peuvent être chargée indifféremment dans l'une ou l'autre des mémoires, mais l'affichage depuis la VRAM est plus efficace. Micro Lua supporte les types GIF, PNG et JP(E)G.

-- Chargement d'une image dans la VRAM
img = Image.load(cheminFichier, VRAM)
-- Affichage de l'image
-- Il est possible de n'afficher qu'une partie de l'image, à partir des coordonnées internes sourceX et sourceY, sur largeur/hauteur pixels
screen.blit(ecran, x, y, img[, sourceX, source Y, largeur, hauteur])
-- Rotation d'une image
-- Les coordonnées sont celles du centre de la rotation (par défaut, le centre de l'image)
Image.rotate(img, angle [, xCentre, yCentre])
-- Agrandissement / réduction d'une image
Image.scale(image, longueur, largeur)

La gestion des contrôles se fait via des conditions sur les variables suivantes :

• Pour le stylet :
  • Stylus.X et Stylus.Y : coordonnées du Stylet
  • Stylus.held : état appuyé sur l'écran du stylet
  • Stylus.released : état relâché du stylet
  • Stylus.newPress : vaut true si le stylet effectue une nouvelle pression
  • Stylus.doubleClick : vaut true si le stylet effectue un double-clic
  • Stylus.deltaX et Stylus.deltaY : delta X et Y (accroissement de X et de Y) du mouvement du stylet
• Pour les boutons :
  • Trois états pouvant être testés pour chaque bouton : held, released et newPress
  • Les boutons sont désignés par A, B, X, Y, L, R, Start, Select, Up, Down, Left, Right
  • Les variables sur les boutons sont des compositions à partir des états et des noms des boutons répondant à ce modèle : Keys.<état>.<bouton>

• (fr+en) Forum officiel Micro Lua
• (fr+en) Google Code de Micro Lua (obsolète)
• (en) SourceForge de Micro Lua
• (fr) officiel sur OpenClassrooms (anciennement le Site du Zéro)