GetPhiolenInfos()
=================

GetPhiolenInfos(L)
------------------
::

FUNKTION
--------
::

     mixed *GetPhiolenInfos();

BESCHREIBUNG
------------
::

     Wird von der Phiole aufgerufen:
     /d/inseln/miril/sternquest/obj/phiole.c
     Der Raum muss /p/service/miril/phiole.h includen.     
     Mit der Phiole kann ein Spieler durch Tueren schauen. Bei Tueren, die
     vom Doormaster (/obj/doormaster.c) verwaltet werden, klappt dies auto-
     matisch. Moechte man das verbieten, so muss die Funktion 
     GetPhiolenInfos() im entsprechenden Raum definiert sein.
     Befinden sich Tueren im Raum, die nicht vom Doormaster verwaltet werden,
     aber bei denen die Phiole funktionieren soll, so kann dies ebenfalls
     mittels GetPhiolenInfos() geschehen.

     

     Funktion der Phiole:
     Sie projiziert ein Bild dessen, was hinter der Tuer liegt auf die Tuer.
     Steht die Tuer offen, so sieht der Spieler nur eine Wand, denn es wird
     gezeigt, was hinter dieser Tuer ist.

     

     Ist die Tuer jedoch ge- oder verschlossen, so sieht er auf der Tuer
     die Langbeschreibung des Raumes, der hinter der Tuer liegt, sowie das
     Inventar dieses Raumes. 

     Aufbau der Funktion:
     mixed *GetPhiolenInfos() {
       return ({
                ([
                  PHIOLE_DEST:     string,       
                  PHIOLE_IDS:      *string,             
                  PHIOLE_GENDER:   int,           
                  PHIOLE_STATUS:   int,     (optional)
                  PHIOLE_LONG:     string,  (optional)
                  PHIOLE_VERBOTEN: int      (optional)
                ]),
                ([
                  ... Naechste Tuer
                ])
              });
     }

     

     PHIOLE_DEST      Dateiname des Zielraums
     PHIOLE_IDS	      Array der Strings, mit denen sich die Tuer 
                      ansprechen laesst
     PHIOLE_GENDER    Geschlecht der Tuer
     PHIOLE_STATUS    aktueller Status der Tuer:
                      0 geschlossen/verschlossen, 1 offen
                      Bei Tueren, die mit NewDoor erzeugt wurden
                      nicht setzen
     PHIOLE_LONG      Beschreibung des Zielraums (z.B. bei einer 
                      Faketuer)
     PHIOLE_VERBOTEN  0 erlaubt, 1 verboten

BEISPIEL
--------
::

     Ein Raum enthaelt eine Holztuer und ein Portal. Erstere ist mittels 
     NewDoor(...) gebaut, soll aber nicht zu durchschauen sein, letztere ist 
     selbstgestrickt. Die erste fuehrt in den Workroom von Jof, die zweite
     ist nur ein Fake und immer geschlossen. Bei vom Doormaster erzeugten 
     Tueren sollte PHIOLE_STATUS nicht gesetzt werden, da dies automatisch
     abgefragt wird.

     

     #include "/p/service/miril/phiole.h"
     ...
     mixed *GetPhiolenInfos(){
       return ({
                ([
                  PHIOLE_DEST:"/players/jof/workroom",
                  PHIOLE_IDS:({"holztuer"}),           
                  PHIOLE_GENDER:FEMALE,                    
                  PHIOLE_VERBOTEN:1          
                ]),
                ([
                  PHIOLE_DEST:0,
                  PHIOLE_IDS:({"portal"}),           
                  PHIOLE_GENDER:NEUTER, 
                  PHIOLE_STATUS:0,
                  PHIOLE_LONG:"Du stehst in einer riesigen Schatzkammer und "
                              "kannst Dein Glueck kaum fassen. Nun brauchst "
                              "Du nur noch zuzugreifen und bist der reichste "
                              "Bewohner des MorgenGrauen.",
                  PHIOLE_VERBOTEN:0
                ])
              });
      }
      Mittels PHIOLE_LONG laesst sich auch bei erlaubten und verbotenen Tueren 
      einstellen, was der Spieler statt der normalen Raumbeschreibung und den 
      im Raum befindlichen Objekten sehen soll. Das koennte z.B. sinnvoll 
      sein, falls der Spieler zwar die Raumbeschreibung, aber nicht den fiesen 
      Drachen sehen soll, der sich ebenfalls im Raum befindet.

      

SIEHE AUCH
----------
::

      NewDoor(), QueryDoorStatus(), SetDoorStatus(), QueryAllDoors()

Letzte Aenderung: Sam, 14. Jan 2006, 12:21, Miril