Projekt Micarpet Projektbericht - artecLab - Universität Bremen

Projekt MiCarpet Projektbericht
Mit 1. wird eine Funktion lua_foo aus dem Namensraum unter dem Namen foo bei der Virtual Machine
registriert. Zur Laufzeit steht damit die Funktion in LUA zur Verfügung und wenn ein Script dann
also foo() aufruft, wird die Funktion lua_foo() angesprungen und ausgeführt. Bei 2. kommt die
Template Klasse class_ zum Einsatz, welche ein CLuaObj in C++ als Objecttyp Obj unter LUA registriert.
3. ist eine Member-Funktion, die an 2. gebunden wird. Dazu gibt es noch viele Modifikationen
für abstrakte, bzw. abgeleitete Klassen, Konstruktoren und ähnliches.
Skripte Um ein Script zur Laufzeit auszuführen, muß auf der static Klasse
CScript::exec(“script.lua”) ausgeführt werden. Das Script wird dann von der Virtual Machine
interpretiert.
Den Scripten, die konkrete Aktionen innehaben, sind eine Reihe von Hilfsfunktionen zur Seite gestellt.
Die Definitionen dazu befinden sich im Unterverzeichnis ./header/, die immer nach Funktionsgruppen
zusammengefasst sind und über Funktionspointer in Tabellen verlinkt sind. Dies bedeutet, wenn
man beispielsweise auf das Titel-Textfeld zum Head-Up Display zugreifen will, findet sich dies unter
HUD.title(“Text”).
So wie wir es hier in einem einfachen Beispiel Script, welches beim Laden eines Levels geladen werden
könnte, sehen:
OBJ.getDynamic("level1"):setVisible( false )
ring_map = {"null","Ring1","Ring2","Ring3","Ring4","Ring5","won"}
ring_map_index = 1
ring_map_maxindex = table.getn(ring_map)
HUD.title("Level 1", 4000)
HUD.subtext("durchfliege alle Ringe", 4000)
OBJ.getDynamic("Ring1"):setVisible( false )
OBJ.getDynamic(“name”) liefert die Referenz auf ein CDynamicObject auf dem dann alle
freigegebenen C++ Funktionen des Objekts wie hier setVisible(..) aufgerufen werden können.
Direkt darunter sieht man mit der Tabelle eine von LUAs Standardstrukturen. Praktisch alle weiteren
Strukturen und Erweiterungen sind über die Tabellenstruktur realisiert.
Es ist zu beachten, daß jedes Script augenblicklich zurückkehren muß, da die Abarbeitung blockierend
erfolgt. Eine geplante Ablaufsteuerung kann nur über Trigger erfolgen.
Um mit Triggern bzw. Kollisionen allgemein relativ leicht arbeiten zu können, existiert das Script
additional-collisions.lua bzw. die entsprechende Handler-Stuktur in
header/collisions.lua. Hiermit lassen sich Kollisionen unter Objekten konkreten Typs durch
die Funktionen __add_(..) und __add_t(..) mit Behandlungen belegen. Also durch den Aufruf
__add_(“player”, “coin1”, __coin_hit_ )
legt man fest, daß bei einer Kollision zwischen den Objekten des Typ player und coin1 die Funktion
__coin_hit_ aufgerufen wird. Dies wird für u.a. für interaktive Elemente wie das Piratenschiff, die
einzusammelnden Münzen, Levelübergänge oder jedes Soundevent verwendet.
6. Januar 2005 Seite 113