================================================================================
Allgemeine Funktionen 
================================================================================

function FaceDirection (int CharId, int dir)
  dir: DIR_UP, DIR_LEFT, DIR_DOWN, DIR_RIGHT
  Lsst die Figur <CharId> in die angegebene Richtung <dir> schauen.
  In den meisten Fllen kann diese Funktion FaceLocation ersetzen.
  Hierdurch erspart man sich das Ausrechnen des Zielpunktes.

function EnterRoom (int room, int x, int y, int dir)
  dir: DIR_UP, DIR_LEFT, DIR_DOWN, DIR_RIGHT
  Die Spielerfigur wird in den Raum <room> befrdert und dort an der
  Position (<x>, <y>) aufgestellt mit Blickrichtung <dir>.
  Der NewRoomEx-Befehl wird hier um FaceDirection erweitert.

function SetPlayer (int charid)
  Wechseln der Spielerfigur. Befindet sich die beiden Figuren im gleichen Raum, 
  dann wird ein Scrolling zur neuen Figur <charid> durchgefhrt.

function GiveInv (int invitem, int charid)
  Die Spielerfigur gibt den Gegenstand <invitem> an die Figur <charid>.

function GiveInvEx (int invitem, int charidfrom, int charidto)
  Der Gegenstand <invitem> wird von Figur <charidfrom> an Figur <charidto>
  gegeben. Keine der beiden Figuren muss die aktuelle Spielerfigur sein,
  aber eine von beiden darf die aktuelle Spielerfigur sein.


================================================================================
Funktionen fr "before fadein"
================================================================================

function PlaceCharacter (int charid, int x, int y, int dir)
  dir: DIR_UP, DIR_LEFT, DIR_DOWN, DIR_RIGHT
  Setzt die Figur <charid> an die Position (<x>, <y>) und lsst sie in Richtung
  <dir> blicken. 

function PlacePC (int x, int y, int dir)
  dir: DIR_UP, DIR_LEFT, DIR_DOWN, DIR_RIGHT
  Setzt die Spielerfigur an die Position (<x>, <y>) und lsst sie in Richtung
  <dir> blicken. 
  
function init_object (int GI, int objects)
  GI: Nummer eines GlobalInt
  objects: Nummer eines Objekts
  Ist GlobalInt <GI> = 1, dann wird Objekt <objects> eingeschaltet, sonst aus.

================================================================================
Funktionen fr "Any click on Hotspot" oder "Any click on Object"
================================================================================

function any_click_move (int x, int y, int dir)
  dir: DIR_UP, DIR_LEFT, DIR_DOWN, DIR_RIGHT
  Rckgabewert: 0, 1
  Bewegt die Spielerfigur zu den angegebenen Koordinaten und beachtet dabei 
  walkable areas. Anschlieend schaut die Spielerfigur in die angegeben Richtung 
  und wartet einen Augenblick.
  Klickt der Spieler whrend sich die Spielerfigur bewegt auf eine andere 
  Stelle, dann wird die Bewegung abgebrochen und die neue Aktion kann ausgefhrt 
  werden. 
  Die Funktion gibt 0 zurck, wenn die Bewegung abgebrochen wurde, bei 1 hat
  die Spielerfigur die Zielkoordinaten (<x>, <y>) erreicht.

function any_click_walk (int x, int y, int dir)
  dir: DIR_UP, DIR_LEFT, DIR_DOWN, DIR_RIGHT
  Rckgabewert: 0, 1, 2
  Die Funktion prft zunchst, ob die aktuelle Aktion "A_WALK_TO" ist. Trifft
  dies zu, so wird any_click_move aufgerufen. 
  Die Funktion gibt 0 zurck, wenn die die aktuelle Aktion nicht behandelt 
  wurde, 1 wenn die Ausfhrung abgebrochen wurde, 2 wenn das Ziel erreicht 
  wurde.

function any_click_walk_look (int x, int y, int dir, string lookat)
  dir: DIR_UP, DIR_LEFT, DIR_DOWN, DIR_RIGHT
  Rckgabewert: 0, 1, 2
  erweitert any_click_walk (siehe auch dort) um "A_LOOK_AT". Bei "A_LOOK_AT" 
  sagt die Spielerfigur den Text <lookat>, wenn sie die Zielkoordinaten erreicht 
  hat.
  Die Funktion gibt 0 zurck, wenn die die aktuelle Aktion nicht behandelt 
  wurde, 1 wenn die Ausfhrung abgebrochen wurde, 2 wenn das Ziel erreicht 
  wurde.

function any_click_walk_look_pick (int x, int y, int dir, string lookat, 
         int objects, int item, int GI, int sound)
  dir: DIR_UP, DIR_LEFT, DIR_DOWN, DIR_RIGHT
  Rckgabewert: 0, 1, 2
  erweitert any_click_walk_look (siehe auch dort) um "A_PICK_UP". Bei "A_PICK_UP"
  wird nach Erreichen der Zielkoordinaten zunchst ein Ton <sound> abgespielt,
  wenn sound >= 0. Ist objects >= 0, dann wird das Object <objects> ausgeschaltet
  und ist item >= 0, dann wird dem Inventar der Spielerfigur <item> hinzugefgt.
  Ist GI >= 0, dann wird das GlobalInt <GI> auf 0 gesetzt.
  Die Funktion gibt 0 zurck, wenn die die aktuelle Aktion nicht behandelt 
  wurde, 1 wenn die Ausfhrung abgebrochen wurde, 2 wenn das Ziel erreicht 
  wurde.

function any_click_use_inv (int item, int x, int y, int dir)
  dir: DIR_UP, DIR_LEFT, DIR_DOWN, DIR_RIGHT
  Rckgabewert: 0, 1, 2
  behandelt nur die Aktion "A_USE_INV". Ist der aktive Inventory-Gegenstand 
  <item>, dann bewegt sich die Spielerfigur (siehe any_click_move).
  Die Funktion gibt 0 zurck, wenn die die aktuelle Aktion nicht behandelt 
  wurde, 1 wenn die Ausfhrung abgebrochen wurde, 2 wenn das Ziel erreicht 
  wurde.

--- Alternative Funktionen ---
Diese Funktionen knnen verwendet werden, wenn in einer Interaktion mehrere der 
oben beschriebenen Funktionen nacheinander aufgerufen werden sollen und man nicht
jedesmal x, y und dir bergeben mchte.

function SetWalkTo (int x, int y, int dir) 
  Speichert x, y und dir fr die nachfolgenden Funktionen

function MovedTo () {
  ruft any_click_move (Beschreibung siehe dort) auf.

function WalkedToLookedAt (string lookat) {
  ruft any_click_walk_look (Beschreibung siehe dort) auf.

function WalkedToLookedAtPickedUp (string lookat, int objects, int item, int GI, int sound) {
  ruft any_click_walk_look_pick (Beschreibung siehe dort) auf.

function UsedInvItem (int item) {
  ruft any_click_use_inv (Beschreibung siehe dort) auf.

================================================================================
Tr-Funktionen fr "Any click on Hotspot" oder "Any click on Object"
================================================================================

--- NORMALE TRE ---
function any_click_on_door (int GI, int objects, int x, int y, int dir, 
         int nr_room, int nr_x, int nr_y, int nr_dir)
  wie any_click_on_door_special (siehe dort), wobei Werte vorbelegt sind:
  Die Texte sind alle leer, opensound=2, closesound=3, key=-1, closevalue=0

--- VERSCHLOSSENE TRE ---
function SetDoorStrings (string lookat, string islocked, string wrongitem)
  Speichert die Texte fr die nachfolgende Funktion.
  lookat:    Text fr A_LOOK_AT
  islocked:  Text fr A_OPEN, wenn Tr verschlossen ist
  wrongitem: Text fr A_USE_INV, wenn aktiver Inventory-Gegenstand nicht <key> 
             ist

function any_click_on_door_special (int GI, int objects, int x, int y, int dir, 
         int nr_room, int nr_x, int nr_y, int nr_dir, int opensound, 
         int closesound, int key, int closevalue)
  Aktionen: A_CLOSE, A_OPEN, A_WALK_TO, A_LOOK_AT, A_USE_INV
  GI gibt das GlobalInt an, in dem der Zustand der Tr gespeichert ist.
  Zustand: 0=geschlossen, 1=offen, 2=verschlossen
  objects gibt das Objekt im Raum an, das die geffnete Tr darstellt (der
  Hintergrund zeigt die geschlossene Tr)
  x, y, dir werden fr any_click_move (Beschreibung siehe dort) verwendet.
  nr_room gibt den Raum an, in den die Tre fhrt; nr_x, nr_y, nr_dir geben
  Position und Blickrichtung im neuen Raum an.
  opensound und closesound bezeichnen die Tondateien, die beim ffnen bzw.
  Schlieen der Tr abgespielt werden sollen.
  key >= 0 bezeichnet den Inventory-Gegenstand, mit dem die Tr aufgeschlossen
  werden kann.
  key = -1: Die Tr kann geffnet werden, auch wenn sie als verschlossen
  gekennzeichnet ist.
  key = -2: Die Tr kann gar nicht geffnet werden (bspw. nur von der anderen 
  Seite aus zu ffnen nicht von dieser Seite aus)
  closevalue: Zustand der Tre nach dem Schlieen (0=geschlossen, 
  2=verschlossen) wird in GlobalInt <GI> gespeichert.
  Bei A_WALK_TO wird die Spielerfigur nach Erreichen der offenen Tr in den 
  neuen Raum nr_room an die angegebene Position gebracht.

================================================================================
Weitere Funktionen fr "Any click on Hotspot" oder "Any click on Object"
================================================================================

function UsedAction (int test_action)
  test_action: A_WALK_TO, A_LOOK_AT, A_TALK_TO, A_GIVE_TO, A_PICK_UP,
               A_USE, A_OPEN, A_CLOSE, A_PUSH, A_PULL, A_USE_INV
  Rckgabewert: Boolean
  Da in MMM eigentlich gar keine anderen Interaktionen (wie bspw. 
  "Look at object") verwendet werden, wird die Unterscheidung der aktuellen 
  Aktion mit dieser Funktion vorgenommen.
  Der Rckgabewert ist Boolean, kann also in einer if-Bedingung direkt verwendet 
  werden.
  Bsp.: 
  if (UsedAction (A_WALK_TO)) { ... Aktionen fr "Walk to" ... }
  if (!UsedAction (A_WALK_TO)) { ... Aktionen fr alles auer "Walk to" ... }

function MovePlayer (int x, int y)
  Rckgabewert: 0, 1
  Bewegt die Spielerfigur zu den angegebenen Koordinaten und beachtet dabei 
  walkable areas. 
  Klickt der Spieler whrend sich die Figur bewegt auf eine andere Stelle, 
  dann wird die Bewegung abgebrochen und die neue Aktion kann ausgefhrt 
  werden. 
  Die Funktion gibt 0 zurck, wenn die Bewegung abgebrochen wurde, bei 1 hat
  die Spielerfigur die Zielkoordinaten (<x>, <y>) erreicht.
  [identisch mit MovePlayerEx (int x, int y, 0)]

  In Filmszenen, in denen der Spieler keinen Einfluss auf das Geschehen hat, 
  sollte statt dessen eine der MoveCharacter-Funktionen verwendet werden.
  Bsp.:
  Ein Schrank soll weggeschoben werden, wenn der Spieler "Schiebe Schrank"
  auswhlt. In der Interaktion des Schrankes wird zunchst MovePlayer verwendet,
  um die Spielerfigur zum Schrank hingehen zu lassen (diese Aktion kann 
  abgebrochen werden). Schiebt die Spielerfigur daraufhin den Schrank, so soll
  dies nicht abgebrochen werden knnen, sondern einmal angefangen bis zum Ende
  durchgefhrt werden. Dafr wird dann bspw. MoveCharacterBlocking eingesetzt.

function MovePlayerEx (int x, int y, int direct)
  direct: 0, 1
  Rckgabewert: 0, 1
  verhlt sich wie MovePlayer, allerdings kann gesteuert werden, ob walkable 
  areas beachtet werden (direct = 0) oder nicht (direct = 1)

function Go ()
  Rckgabewert: 0, 1
  Mit dieser Funktion wird die Spielerfigur dorthin geschickt, worauf zuletzt 
  geklickt wurde. (Weiteres Verhalten wie MovePlayer)
  Handelt es sich bei dem Ziel um eine Figur, dann hlt die Spielerfigur in
  einem Abstand vor der Figur an.
  Handelt es sich um einen Hotspot, dann geht die Spielerfigur zum Hotspot-
  Punkt.
  Handelt es sich um ein Objekt, dann zum Objekt.
  Die Funktion gibt 0 zurck, wenn die Bewegung abgebrochen wurde, bei 1 hat
  die Spielerfigur die Zielkoordinaten (<x>, <y>) erreicht.
  [identisch mit GoTo (2)]

function GoTo (int blocking)
  blocking: 0, 1, 2
  Rckgabewert: 0, 1
  Entspricht der Go-Funktion mit dem Unterschied, dass gewhlt werden kann, ob
  die Scriptausfhrung blockiert werden soll oder nicht.
  blocking=0: nicht blockiert, der Rckgabewert ist bedeutungslos, da nicht auf
              das Ende der Bewegung gewartet wird
  blocking=1: blockiert, der Rckgabewert ist immer 1, weil das Ziel immer 
              erreicht wird.
  blocking=2: Verhalten und Rckgabewert wie bei Go()

function GoToCharacter (int charid, int direction, int NPCfacesplayer, 
         int blocking){
  entspricht GoToCharacterEx, wobei xoffset und yoffset schon vergegeben sind
  und charidwhogoes die Spielerfigur angibt.

function NPCGoToCharacter (int charidwhogoes, int charidtogoto, int direction, 
         int NPCfacesplayer, int blocking)
  entspricht GoToCharacterEx, wobei xoffset und yoffset schon vergegeben sind

function GoToCharacterEx (int charidwhogoes, int charid, int direction, 
         int xoffset, int yoffset, int NPCfacesplayer, int blocking)
  direction: 1, 2, 3, 4
  NPCfacesplayer: 0, 1
  blocking: 0, 1, 2
  Rckgabewert: 0, 1
  Die Figur <charidwhogoes> wird zur Figur <charid> geschickt und bleibt dort
  im Abstand <xoffset> oder <yoffset> je nach Richtung <direction> stehen:
  direction: 1=oberhalb, 2=rechts neben, 3=unterhalb, 4=links neben
  Die Spielerfigur schaut immer die andere Figur an, ist <NPCfacesplayer>=1,
  dann schaut die andere Figur auch die Spielerfigur an.
  Zur Erklrung von blocking und Rckgabewert siehe GoTo (int blocking)

================================================================================
Wichtiger Hinweis:
Sollten einzelne Funktionen in den Rumen nicht verfgbar sein, dann mssen sie
im "global header" als import-Zeile deklariert werden
================================================================================
