AddRoute()
**********


FUNKTION
========

   public varargs void AddRoute(string room, int stay, int next,
       string harbour_desc, mixed dest_ids, string deststr)


DEFINIERT IN
============

   /std/transport.c


ARGUMENTE
=========

   string room
       Filename der Haltestelle (des Ziels)
   int stay
       Aufenthaltszeit an der Haltestelle.
   int next
       Fahrtzeit von dort bis zum naechsten Fahrplanpunkt
   string harbour_desc
       Name der Haltestelle (fuer QueryArrived)
   mixed dest_ids
       kleingeschriebene IDs der Haltestelle
   string destrstr
       Unbenutzt / Undefiniert.


BESCHREIBUNG
============

   Dem Fahrplan des Transporters wird eine neue Haltestelle hinzugefuegt.

   Bei Erreichen der Haltestelle wird der Transporter in den Raum 'room'
   bewegt und sichtbar gemacht. Nun kann man ihn fuer 'stay' Sekunden
   betreten oder verlassen, bevor er ablegt (unsichtbar gemacht wird).
   Nach 'next' Sekunden wird dann der naechste Punkt des Fahrplans
   ausgefuehrt.


   'harbour_desc' ist ein String, den QueryArrived() zurueckgibt, wenn sich
   der Transporter an einer Haltestelle befindet. In der Regel ist das ein
   String, der die Haltestelle naeher beschreibt.


   'dest_ids' ist ein Array von Strings, die als ID-Code fuer diese
   Haltstelle dienen. Das wird zB bei der Ermittlung einer Haltestelle bei
   "reise nach" benutzt. Wenn 'dest_ids' nicht gesetzt ist, und auch
   P_HARBOUR des Zielhafens nicht korrekt gesetzt ist, werden
   grossgeschriebene Begriffe aus 'harbour_desc' verwendet.


BEISPIELE
=========

   #1 Hier ein Auszug aus /d/inseln/schiffe/jolle.c:

     AddRoute("/d/ebene/room/PortVain/po_haf2", 40,
              10, "Hafen von Port Vain");

   Die Jolle wird also beim Anlegen in den Port Vainer Hafen bewegt und
   laesst sich dort 40 Sekunden lang betreten oder verlassen.
   QueryArrived() liefert waehrend dieser Zeit den String "Hafen von Port
   Vain" zurueck. Nach den 40 Sekunden legt die Jolle ab, und nach
   weiteren 10 Sekunden wird die naechste Station in ihrem Fahrplan
   angefahren.

   #2 Die Galeere nach Orkhausen:
     AddRoute(INSEL("steg"), 30, 20, "Verlorene Land ( Orkhausen )" );
     - haelt 30 Sekunden
     - reist 20 Sekunden
     - reist nach INSEL("steg"), bekannt als "Verlorene Land ( Orkhausen )"
     - da keine 'dest_ids' angegeben sind, waere eine so definierte
       Haltstelle nur mit den IDs ansprechbar, die in P_HARBOURS im Zielraum
       angegeben sind.

   Wenn man nun erreichen wollte, dass das Ziel auch mit dem Kuerzel "vland"
   ansprechbar ist, kann man zum einen explizite 'dest_ids' eintragen:
     AddRoute(INSEL("steg"), 30, 20, "Verlorene Land ( Orkhausen )",
              ({"verlorenes", "land", "orkhausen", "vland"}));
   Dies laesst sich im Zielhafen aber auch durch Eintragen des Kuerzels
   "vland" in P_HARBOUR erreichen. Dies hat den Vorteil, dass dieser Hafen
   dann von allen Transportern, die dort anlegen, unter demselben Namen
   erreicht werden kann.


HINWEISE
========

   Dadurch, dass die Eintraege aus P_HARBOUR und 'dest_ids' gleichberechtigt
   fuer "reise nach <ziel>" verwendet werden koennen, ist es moeglich,
   dass die Reiseziele auf einem Schiff unter zusaetzlichen Bezeichnungen
   bekannt sind, als an Land (zum Beispiel koennte eine fernwestliche
   Besatzung die Ziele anders nennen).


SIEHE AUCH
==========

Funktionen  AddMsg(L), AddFun(L), /std/transport.c Properties
P_HARBOUR, P_NO_TRAVELING, P_TRAVEL_INFO


2015-Jan-18, Arathorn.
======================