PTInfo München Dokumentation
Das Folgende ist die Dokumentation des Programms PTInfo München.
Die Installation
Wenn Sie die JAD oder JAR-Datei von PTInfo München direkt von Ihrem Handy aus herunterladen, sollte dieses das Programm erkennen und automatisch installieren. Sie können die Dateien aber auch von Ihrem Computer aus herunterladen und das Programm dann z.B. mit einer Bluetooth- oder Infrarot-Verbindung auf dem Handy installieren. Wie das geht, erfahren Sie im Handbuch Ihres Handys oder beim Hersteller des Handys. Jetzt müssen Sie PTInfo München nur noch starten. Beim ersten Start richtet PTInfo München sich automatisch ein und erfrägt z.B. die von Ihnen gewünschte Benutzersprache. Um PTInfo München auf Ihrem Handy verwenden zu können, muss dieses Java und MIDP 2.0 oder neuer unterstützen.
Die Bedienung des Programms
Wählen Sie die von Ihnen gewünschte Linie, den Start- und Zielbahnhof aus. Daraufhin werden die nächsten beiden verfügbaren Fahrten berechnet und angezeigt. Möchten Sie Verbindungen zu anderen Zeitpunkten angezeigt bekommen, können Sie jederzeit einen anderen Abfahrtszeitpunkt wählen. Die jeweils aktuellen Einstellungen werden beim Beenden des Programms gespeichert und beim nächsten Start wiederhergestellt. Sie können auch mehrere Einstellungen als Favoriten speichern und wieder laden.
Die verwendeten Datenformate
Das Format der Sprachdateien
In der Datei "config_lang.txt" sind alle in PTInfo München verfügbaren Sprachdateien aufgelistet. Das Format dieser Konfigurationsdatei ist einfach: in jeder Zeile befindet sich ein Eintrag für eine Sprachdatei, welcher aus einem Bezeichner und einem durch einen Doppelpunkt von diesem getrennten Dateinamen besteht, und mit einem Strichpunkt abgeschlossen wird. Der Dateiname bezeichnet die eigentliche Sprachdatei, welche sich im Verzeichnis "/lang" befinden muss. In der Sprachdatei steht jede durch ein Strichpunkt abgeschlossene Zeile für einen Eintrag. Siehe dazu am besten im Quellcode von PTInfo München die Datei "Language.java". Beachten Sie unbedingt eines: ausnahmslos alle Dateien müssen als UTF-8 vorliegen!
Das Format für die Linien
Auch die Linien werden in einer zentralen Konfigurationsdatei ähnlich der für Sprachdateien verwaltet. Der Unterschied ist jedoch, dass hier nicht alle Linien explizit aufgeführt werden müssen, sondern nur die, welche in der Linienauswahl angezeigt werden sollen. Die Konfigurationsdatei für die Linien hat den Dateinamen "config_lines.txt" und die eigentlichen Linieninformationen finden sich in den Dateien im Ordner "/lines". Beachten Sie auch hier, dass alle Dateien als UTF-8 gespeichert werden müssen!
Jede Datei im Ordner "/lines" steht für eine Linie in einer Richtung. Die ersten beiden Angaben in den Dateien sind der Name der Linie, sowie der Dateiname der Linie, welche in die entgegengesetzte Richtung fährt. Jede dieser Angaben muss mit einem Strichpunkt abgeschlossen werden:
name=S2 Erding; op=s2petershausen.txt;
Die nächsten Einträge entsprechen jeweils immer eine Route der Linie und bestehen aus durch Strichpunkte abgeschlossene Aufzählungen und sind in größere Blöcke organisiert, welche durch # voneinander getrennt werden. Zwei dieser Blöcke ergeben die Informationen für eine Route: zunächst ein Block für die Haltestellen, dann ein Block für die dazugehörigen Fahrplaninformationen.
Der Block mit den Haltestellen ist eine Aufzählung der Haltestellen, die angefahren werden. Die Zahl, die bei jeder Haltestelle dabei stehen muss, ist die Zeit in Minuten, die benötigt wird, um die jeweilige Haltestelle von der ersten Haltestelle der Route aus zu erreichen. Der Block der Fahrplaninformationen ist in Stunden-Abschnitte untergliedert. Die erste Zahl bis zum Strichpunkt gibt die Stunde an, danach folgt durch Kommata getrennt bis zu einem weiterem Strichpunkt die Angabe von Minutenzahlen. Alle Abfahrtszeiten entsprechen den Abfahrtszeiten der aller ersten Haltestelle der Route!
Bei den Minuten können mit + Flags angehängt werden, welche die jeweilige Abfahrtszeiten an bestimmte Bedinungen knüpfen. Möglich sind momentan folgende Bedingungen:
| Flag | Bedingung |
|---|---|
| w | fährt nur Montag bis Freitag |
| s | fährt nur samstags und sonntags |
| f | fährt nur in den Nächten Freitag/Samstag und Samstag/Sonntag |
| dX | fährt nur am Wochentag X (1 = Sonntag, 2 = Montag, ..., 7 = Samstag) |
| nX | fährt nicht am Wochentag X |
| oTTMM | fährt nur am Tag (TT) im Monat (MM) (z.B. o2412 nur am 24.12.) |
| cTTMM | fährt nicht am Tag (TT) im Monat (MM) |
| zTTMMTTMM | fährt nur innerhalb des angegebenen Zeitraums (z.B. z01081212 nur zwischen dem 1.8. und 12.12.) |
"1; 31+f+c2412+c2512;" würde also zum Beispiel bedeuten, dass die Linie in den Nächten Freitag/Samstag und Samstag/Sonntag um 01:31 Uhr im Startbahnhof abfährt, sofern weder der 24. noch der 25. Dezember ist.