====== Der Traffic-Fahrplan ======

Neben dem [[de:traffic:configwindow:start|Konfigurationsfenster]] und der [[de:traffic:vehiclelist:start|Fahrzeugliste]] ist der Fahrplan eine der drei Hauptkomponenten von Traffic. Er definiert, wie Traffic letztlich im Betrieb aussieht und was alles auf welche Weise sich über den Bildschirm bewegt.

In Traffic können beliebig viele Fahrpläne erstellt werden. Der jeweils zu verwendende Fahrplan wird im Konfigurationsfenster ausgewählt, und zwar entweder ein individueller Fahrplan pro [[de:traffic:modes:start|Modus]] oder einer für alle Modi. Wenn der gewählte Fahrplan [[de:traffic:timetable:options|Optionen]] hat, wird das Optionsmenü im Konfigurationsfenster entsprechend befüllt.

Die Dateiendung für Traffic-Fahrpläne ist *.ttt.

Ein Fahrplan kann verschiedene Arten von Angaben enthalten:

===== Globale Angaben =====

Zu den globalen Angaben, die in Traffic-Fahrplänen eingetragen werden können, zählen:

  * [[de:traffic:timetable:include_require|mittels $INCLUDE oder $REQUIRE eingebundene andere Fahrpläne]]
  * [[de:traffic:timetable:options|Optionen]], die immer am Anfang eines Fahrplans stehen sollten und über das sonst ausgegraute [[de:traffic:configwindow:options|Optionsmenü des Konfigurationsfensters]] gesteuert werden
  * [[de:traffic:speed|ein globaler Geschwindigkeitsmultiplikator]]
  * [[de:traffic:speed|eine globale Anfahrgeschwindigkeit aus dem Stillstand]]
  * [[de:traffic:speed|eine globale Geschwindigkeit beim Kuppeln zweier Zusammenstellungen]]
  * [[de:traffic:timetable:backgroundcolor|eine globale Hintergrundfarbe]]
  * [[de:traffic:timetable:skiperr|eine Angabe zum Überspringen fehlerhafter Bewegungen]]

===== Definitionen =====

Gewisse Elemente, die häufiger im Fahrplan verwendet werden oder auf diese Art leichter aufzurufen gehen, können vorab entsprechend definiert werden. Dies geschieht über:

  * [[de:traffic:timetable:macros|Makros]], über die [[de:traffic:timetable:motion:consist:start|Zusammenstellungen von Fahrzeugen]] oder [[de:traffic:timetable:foreground_background|Vorder-/Hintergrundbilder]] vorab definiert werden können
  * [[de:traffic:timetable:additional_parameters|hinzuzufügende Parameter]], die etwa in [[de:traffic:timetable:motion:start|Bewegungen]] oder Definitionen von Vorder- und Hintergrundbildern "nachträglich" eingefügt werden können

===== Bewegungen =====

Der essentiellste Teil von Traffic-Fahrplänen sind die [[de:traffic:timetable:motion:start|Bewegungen]], die definieren, wie sich Fahrzeuge letztlich über den Bildschirm bewegen. Ein Fahrplan, der im Traffic-Hauptfenster ausgewählt wird, muß immer mindestens eine Bewegung enthalten, ob intern oder [[de:traffic:timetable:include_require|per $INCLUDE/$REQUIRE]] eingebunden; alles andere ist optional.

Bewegungen können auch in [[de:traffic:timetable:pool|POOLs]] zusammengefaßt werden, die dann wiederum wie einzelne Bewegungen in der Segmentierung eingetragen werden können.

===== Segmentierung =====

Es gibt verschiedene Arten, wie Bewegungen in [[de:traffic:timetable:segments|Segmenten]] geführt werden können.

  * Das grundlegendste Segment ist die LINE, die normalerweise nicht ausdrücklich definiert wird. Jede einzelne Bewegung erzeugt eine LINE. LINEs können in praktisch beliebiger Anzahl gleichzeitig existieren, sofern Platz dafür ist.
  * SECTIONs stellen ihre eigenen Vorder- und Hintergrundbilder und enthalten nur eine Trasse. Es kann auch immer nur eine SECTION zur Zeit dargestellt werden. Sie eignen sich besonders für Fotohintergründe.
  * GROUPs fassen Bewegungen sozusagen logisch zusammen. Sie können ihre eigenen Vorder- und Hintergrundbilder stellen oder solche aus den Bewegungen übernehmen. Es kann immer nur eine GROUP laufen, aber jede GROUP kann mehrere Trassen erzeugen.
  * SCENEs können mehrere Trassen hintereinander darstellen, die jeweils als PATHs definiert werden. Die SCENE und jeder einzelne PATH kann eigene Vorder- und Hintergrundbilder haben. SCENEs können mehrfach auf dem Bildschirm existieren und mit LINEs in wiederum praktisch beliebiger Anzahl die Anzeige teilen.

===== Andere Fahrplanelemente =====

==== Kommentare ====

Fahrpläne können Kommentarzeilen enthalten. Alle Zeilen, die mit einer Raute (''#'') beginnen, gelten als Kommentare und werden von Traffic nicht ausgewertet.

<code>#Dies ist ein Kommentar.</code>

==== Zeilenumbrüche ====

Fahrplanzeilen können umgebrochen und somit übersichtlich über mehrere Textzeilen aufgeteilt werden, indem an den Enden aller Textzeilen außer der letzten ein Backslash (''\'') eingetragen wird.

**Vorsicht:** Intern formuliert Traffic den Umbruch und alles, was an Leerzeichen oder Tabs vor dem Anfang der nächsten Zeile steht, in ein Leerzeichen um. Es darf also nicht innerhalb eines Bild- oder Makronamens umgebrochen werden!

==== Ende des Fahrplans ====

Ein Ende des Fahrplans muß nicht definiert werden, kann aber. Alles, was hinter der Zeile

<code>$END</code>

steht, wird ignoriert. Das ist zum Beispiel nützlich, um einen Fahrplan zum Zwecke des Debuggings zu kürzen, ohne unerwünschte Fahrplanzeilen löschen zu müssen.