| SearchPath() |
| ************ |
| |
| |
| FUNKTION |
| ======== |
| |
| public int SearchPath(string from, string to, int para, |
| closure callback) |
| |
| |
| DEFINIERT IN |
| ============ |
| |
| /p/daemon/pathd.c |
| <sys/pathd.h> |
| |
| |
| ARGUMENTE |
| ========= |
| |
| from - Der Startpunkt |
| to - Der Endpunkt |
| para - Die Parawelt in der gesucht wird (Normalwelt: 0) |
| callback - Closure, die am Ende der Pfadsuche gerufen wird |
| |
| |
| BESCHREIBUNG |
| ============ |
| |
| Diese Funktion berechnet - sofern moeglich - den kuerzesten Pfad zwischen |
| <from> und <to> in der (Para-)Welt <para>. |
| |
| |
| |
| Die Pfadsuche wird anhand von Daten ueber von Spielern gelaufene Wege |
| durchgefuehrt. D.h. Gebiete, die von Spielern nicht (in letzter Zeit mal) |
| betreten werden, sind auch dem Pfaddaemon nicht bekannt. Auch kann es |
| Gebiete geben, wo zwar gebietsintern Pfade bekannt sind, aber keine Wege |
| in den Rest vom MG. |
| |
| Da diese Suche im Allgemeinen SEHR aufwendig sein kann, wird sie meistens |
| nicht sofort fertig, sondern dauert eine Weile. Wenn sie fertig ist, wird |
| die Closure <callback> aufgerufen und ihr die Argumente <from>, <to>, |
| <parawelt>, <kosten>, <path> und <cmds> uebergeben. Die Bedeutung |
| dieser Argumente ist unten erklaert. |
| |
| Eine Suche nach einem Pfad in einer Parawelt fuehrt durch Raeume der |
| gewuenschen Parawelt und durch Raeume der Normalwelt. |
| |
| |
| RUeCKGABEWERT |
| ============= |
| |
| 1 - Suche wurde gestartet |
| 2 - Pfad gefunden (und callback gerufen) |
| -1 - es laeuft schon ein Suchauftrage fuer die UID des anfragenden |
| Objektes |
| -2 - es laufen bereits zuviele Suchanfragen |
| -3 - <from> und/oder <to> sind nicht bekannt |
| |
| |
| |
| An <callback> uebergebene Argumente am Ende der Pfadsuche: |
| <from> - Startpunkt des Weges (string) |
| <to> - Zielpunkt des Weges (string) |
| <para> - Parawelt des Weges (int) |
| <costs>- Kosten des Wege. (int) Je hoeher, desto |
| laenger/unguenstiger. 0, wenn kein Pfad gefunden |
| <path> - Array mit Raumnamen, die durchlaufen werden (string*) |
| 0, wenn kein Pfad gefunden |
| <cmds> - Array mit Kommandos zum Ablaufen des Weges (string*) |
| 0, wenn kein Pfad gefunden |
| |
| |
| BEMERKUNGEN |
| =========== |
| |
| Es ist natuerlich nicht dazu gedacht, Spielern fertige Routen zwischen |
| Orten zu geben - bzw. nur in Ausnahmefaellen. |
| Pfadabfrgen werden geloggt. |
| |
| Die Angabe <costs> sagt grob etwas ueber die Laenge und vor allem ueber die |
| "Qualitaet" des Pfades aus. Die steigt bei Paraweltwechseln, wenig |
| abgelaufenen Verbindungen zwischen Raeumen oder wenn eine Verbindung kein |
| normaler Ausgang ist. |
| |
| Die Closure <callback> sollte nicht zuviele Ticks verbrauchen. |
| |
| |
| BEISPIEL |
| ======== |
| |
| #include <pathd.h> |
| void suchergebnis(string from, string to, int para, int costs, string* |
| path, string* cmds) { |
| tell_object(find_player("zesstra"), sprintf( |
| "Ergebnis Pfadsuche von %s nach %s in Para %d fuer %d:\n %O\n %O\n", |
| from, to, para, costs, path, cmds)); |
| }; |
| |
| ... |
| mixed res=PATHD->SearchPath("/gilden/abenteurer", |
| "/d/ebene/dancer/lucky/room/pova_la3", |
| 0, #'suchergebnis); |
| |
| 22.12.2015, Zesstra |