http://wiki.omnibussimulator.de/omsiwikineu.de/api.php?action=feedcontributions&feedformat=atom&user=Marcel+KuhntOMSIWiki - Benutzerbeiträge [de]2026-04-10T08:43:47ZBenutzerbeiträgeMediaWiki 1.31.0http://wiki.omnibussimulator.de/omsiwikineu.de/index.php?title=Hofdatei&diff=1575Hofdatei2018-08-18T16:43:12Z<p>Marcel Kuhnt: Änderung 1574 von Tatra (Diskussion) rückgängig gemacht.</p>
<hr />
<div>''Hinweis: Dieser Artikel wurde noch nicht ins Englische übersetzt!''<br />
<br />
Die Hofdatei ist eine einfache Textdatei und dient dem Bus als Informationsort, für die im und am Bus möglichen Anzeigen. Sie enthält die IBIS-Codes für die Endstellen, alle Endhaltestellen und Haltestellen, sowie die möglichen Routen. Ohne eine passende Hofdatei, kann ein Bus keinerlei Informationen ausgeben, was dieser auf einer Map, als Fahrziel oder andere Informationen, anzeigen soll. Die Hofdatei muß sich im Ordner des Busses befinden und dient dem Spielerbus, sowie dem KI-Bus (mit Fahrplan) als Grundlage zum Anzeigen des Fahrzieles.<br />
<br />
Hier soll es um den Aufbau einer Hofdatei gehen, wie man eine Hofdatei erstellt und es soll die "universelle Hofdatei" erklärt werden.<br />
<br />
<br />
= '''Hofdateien für Omsi''' =<br />
<br />
<br />
<br />
== '''Was ist eine Hofdatei''' ==<br />
<br />
Eine Hofdatei ist die Grundlage, um einen Bus auf einer Linie einer Map fahren zu können. Ohne Hofdatei kann der Bus keine Informationen anzeigen (Matrix, Rollbänder) und dadurch steigen keine Fahrkunden ein. Diese beinhaltet eine Liste der Endhaltestellen einer Karte (alle Endstellen, ob auf der Map vorhanden oder nicht), alle auf der Map vorhandenen Haltestellen und die Routen der einzelnen Linien. Sie dient lediglich der Information der Anzeigen und die Audiowiedergabe der Haltestellen / Endstellen im und am Bus. Nur über die Hofdatei wird eine vorgegebene Linie (im Editor) mit den Anzeigen identifiziert.<br />
Die in der Hofdatei eingetragenen Routen geben nicht den Linienverlauf in Omsi vor, dies wird über den Fahrplan im Editor gestellt. Aber die Hofdatei dient der Informationsausgabe für die Zielanzeigen im Bus, die Innenanzeigen im Bus, die Anzeigen im Informationsgerät (IBIS, IBIS 2, EFAD, Atron, INIT usw) und die Texturnamen der Rollbandtexturen, sowie den passenden Ansagen.<br />
Eine Hofdatei muß im Busordner vorliegen (in keinem Unterordner des Busses) und muß als Endung .hof haben. Diese Datei kann mit einem Editor oder Schreibprogramm erstellt werden, muß aber dann als Textdatei.txt abgespeichert werden. Schlußendlich wird dann der Dateiname .txt gelöscht und durch .hof ersetzt.<br />
<br />
----<br />
<br />
<br />
== '''Externe Programme zum Erstellen einer Hofdatei''' ==<br />
<br />
Um eine Hofdatei zu erstellen, gibt es mehrere Möglichkeiten. Man kann eine Hofdatei erstellen, indem man mit Notepad von Windows, eine Textdatei erstellt- Dieses Programm ist standardmäßig in Windows dabei. Für große und umfangreiche Hofdateien, verliert man aber hier schnell den Überblick. Wahlweise kann man auch mit [https://notepad-plus-plus.org/ Notpad++] arbeiten. Dieses Programm kann kostenfrei im Internet runtergeladen und installiert werden.<br />
Eine weitere Möglichkeit bietet auch der [http://www.omnibussimulator.de/forum/index.php?page=Thread&threadID=22| HofCreator von Jan Kiesewalter]. Dieses Programm erstellt Hofdateien für Omsi 1. Außerdem gibt es für dieses Programm noch Templates, um für weitere Busse eine passende Hofdatei zu erstellen.<br />
<br />
Für Omsi 2, empfielt sich [http://www.omnibussimulator.de/forum/index.php?page=Thread&threadID=40888&highlight=| '''HOF Suite'''] vom User '''Rumpelhans'''. Damit bekommt man eine übersichtliche Arbeitsfläche um einfach und schnell, eine oder mehrere Hofdateien zu erstellen. Dies geht dann komplett ohne Fehler. Auch dieses Programm ist kostenlos auf der Omsi-WebDisk zu bekommen.<br />
<br />
----<br />
<br />
== '''Aufbau einer Hofdatei''' ==<br />
<br />
Man kann reinschreiben was man möchte, solange es nicht am Zeilenanfang steht (einmal TAB drücken) da es sonst zu <br />
Fehlermeldungen beim einlesen der Hofdatei kommen kann. Alles was nicht am Zeilenanfang steht, wird von Omsi nicht <br />
erkannt und daher nicht beachtet.<br />
Was am Zeilenanfang steht wird von Omsi beachtet und ausgewertet. Zuerst muß ein Befehl geschrieben werden. Nach dem Befehl kommen eventuell Informationen der sich auf den Befehl bezieht und eine Identifikation oder Zuordnung. Erst dadrauf folgen die einzelnen Strings, für die einzelnen Informationsgeräte.<br />
<br />
<br />
=== '''Allgemeiner Aufbau einer Hofdatei - interne Informationen für Omsi''' ===<br />
<br />
In der Hofdatei ist dies ein wiederkehrender Prozess. In eckigen Klammern werden Befehle geschrieben und direkt darunter die Strings. Ein String ist ein Eingabewert der einen Verweis auf Punkte einer Map haben kann, oder einen Informationswert für eine Anzeige. Der Aufbau der einzelnen Befehle erklärt sich später bei den einzelnen Bereichen einer Hofdatei.<br />
<br />
Eine Hofdatei gliedert sich in 4 Bereiche<br />
#Teil 1 - Informationen zur Hofdatei<br />
#Teil 2 - Liste der Endhaltestellen<br />
#Teil 3 - Liste der Haltestellen<br />
#Teil 4 - Linienlisten der einzelnen Routen<br />
<br />
----<br />
<br />
<br />
=== '''Aufbau des ersten Bereiches einer Hofdatei''' ===<br />
<br />
Der erste Bereich enthält Informationen, wo sich bestimmte Ordner befinden, die der Bus später benötigt, wie Rollbandtexturen, Steckschildtexturen oder Ansagen, Anzahl der verwendeten Strings in den Bereichen 2 und 3.<br />
Der erste Befehl ist der Name der Hofdatei, so wie diese später im Auswahlmenü angezeigt wird. Der Name sollte passend zur Map sein und, falls die Chronologiefunktion benutzt wurde, auch die Zeit. Bedenke dabei, daß auch andere User die eine Strecke erstellen den gleichen Namen nutzen könnten, wenn deren Strecke zum Beispiel real ist, während die eigene fiktiv erstellt wurde.<br />
<br />
<pre>[name]<br />
Spandau 1990<br />
<br />
[servicetrip]<br />
Betriebsfahrt</pre><br />
<br />
Zuerst folgt der Name, damit Omsi diese Hofdatei zuordnen kann. Dies ist besonders beim KI-Verkehr wichtig. Wenn der Name mit dem Eintrag in der AI-List nicht übereinstimmt, können die KI-Busse nichts anzeigen. Diese Eintrag muß sich aber nicht auf den Namen der Textdatei beziehen. Vorteilhaft wäre es aber auf jeden Fall.<br />
Servicetrip gibt an, was ein Bus schildern soll, wenn er nicht auf einer Linie fährt. Das sind unter anderem Ein- und Aussetzfahrten. Dazu muß Betriebsfahrt später eingetragen werden und als "nicht einsteigen" markiert werden, mit dem Befehl: [addterminus_allexit].<br />
<br />
<pre>[global_strings]<br />
6<br />
Spandau_old<br />
Spandau<br />
Spandau_90<br />
3<br />
8<br />
16</pre> <br />
<br />
Mit dem Befehl [Global_Strings] wird angegeben, wie die Ordner heißen, die Informationen zu der Karte haben. Diese Strings sind festgelegt:<br />
<pre><br />
6 - zeigt an wieviele Strings unter diesem Befehl folgen<br />
Spandau_old - Name des Unterordners der die Ansagen der Karte enthält. Dieser Unterordner muß unter<br />
Vehicles\Announcements<br />
angelegt werden. Diese einzelnen Ansagen der Haltestellen und Endhaltestellen, sollten im <br />
Audioformat .wav enthalten sein. Die Dateinamen der Audiofiles sollten einen Bezug<br />
zur Haltestelle / Endhaltestelle haben.<br />
Spandau - Unterordner im Ordner Anzeigen für die Rollbandtexturen<br />
Spandau_90 - Unterordner für die zusätzlichen Seitenschildtexturen.<br />
4 - Ibis-Specialcode die auf dieser Map verwendet werden können. Diese Zahl gibt an,<br />
welche Liniencodes mit Buchstaben auf speziellen Linien genutzt werden.</pre><br />
*String 4= 900'er-Linien (Anzeige der Linie N.. oder ..N) <br />
*String 5= 800'er-Linien (Anzeige der Linie X) <br />
*String 6= 500'er-Linien (Anzeige der Linie M)<br />
<br />
Dieser Bereich ist nur für Omsi 2 wichtig, in Omsi 1 hingegen entfällt dieser Befehl und die Eintragungen, weil sich die entsprechenden Dateien in den Unterordnern des jeweiligen Busses befinden bzw. Funktionen wie Seitenschilder nicht funktionieren.<br />
Die Ziffern darunter können beliebig gesetz werden, wenn man Linien einfach mit Buchstaben ausstatten möchte. Erstellt man in der Matrix.osc oder einer vergleichbaren Datei unter dem IBISCode 00016 den Buchstaben "A", so gibt man oben die Zahlen vorn für den Hunderter Bereich ein, die später mit dem entsprechenden Buchstaben versehen wird. Möchte man also auf einer Linie die Linie 83A mit dem Buchstaben "A" versehen und diesen Buchstaben mit der 800-er Linie versehen, trägt man im 2. Zahlenstring die 16 ein. Damit ergibt sich dann die IBIS-Eingabe: Linie/Kurs: 88300 und der Bus schildert dann 83A.<br />
Bleiben die jeweiligen Strings leer, kann für die Map die Linien wie gewohnt eingetragen werden, was dann notwendig ist, wenn eine Linie im 500-er, 800-er oder 900-er Bereich existiert. Werden die Codes oder einer der Codes nicht gebraucht, trägt man entweder die Null ein, oder man kürzt die Stringanzahl auf 3, wobei die Liniencodes nichtmehr gelesen werden. Mit dem oberen Beispiel, würde ein Bus dann die Linie 883 anzeigen.<br />
In der Matrix.osc kann jeder beliebige Buchstabe mit einem der 3 Ziffernplätze belegt werden. Die Zuordnung, welcher Buchstabe wo genau in der Linienanzeige angezeigt wird, wird generell nur in der Matrix.osc eingetragen. Mit Hilfe des Codes, kann dann der Buchstabe über den zugordneten Code, gesetzt werden.<br />
Übrigens, muß eine Matrix nicht zwangsläufig mit dem Dateinamen Matrix.osc gesteuert werden. Der Dateiname ist frei wählbar. So kann auch die Datei VMatrix.osc oder Matrix_d.osc heißen.<br />
<br />
Die folgenden Befehle werden nicht in eckigen Klammern geschrieben. Sie enthalten nur die Information, wieviele Strings in den Bereichen 2 und 3 folgen, damit Omsi genau erkennt, wieviele Strings ausgelesen werden sollen. Wichtig ist dies bei Omsi 1 und 2, weil nur die genaue Stringszahl ausgelesen wird, die hier eingetragen werden. Die tatsächliche Anzahl ist dagegen irrelevant.<br />
<br />
<pre>Stringcount_terminus<br />
7<br />
<br />
Stringcount_busstop<br />
5</pre><br />
<br />
Terminus gibt den Bereich an, der für die Endstellen vorgesehen ist. Und Busstop bleibt damit nur für die Haltestellenliste. Die genaue Anzahl richtet sich nach den geschriebenen Strings. Wichtig wird dies für eine [http://www.omnibussimulator.de/omsiwiki.de/index.php?title=Hofdatei#Die_Universelle_Hofdatei.| "Universelle Hofdatei"], die für alle verwendeten Anzeigesysteme in den Bussen Verwendung finden. Man kann bis 999 Strings verwenden, alles darüber hinaus, wird mit einem Fehler von Omsi quittiert, da normal nicht so viele Strings benötigt werden können. '''Es richtet sich ja nach den unterschiedlichen Anzeigesystemen der Busse, nicht um jeden einzelnen Bus selbst.'''<br />
<br />
----<br />
<br />
=== '''Aufbau des zweiten Bereiches einer Hofdatei - Endstellenliste''' ===<br />
<br />
In dieser Liste werden die Anzeigen für die Busse geschrieben, wie diese die entsprechenden Endstellen später anzeigen sollen. Wichtig hierbei ist, daß die Buchstabenanzahl nicht überschritten wird, weil sonst die Ziele nicht vollständig angezeigt werden. Welche Buchstaben genau angezeigt werden können, entscheidet der Font der Anzeigegeräte. Beinhaltet dieser Font nur Großbuchstaben, muß die Anzeige in Großbuchstaben gesetzt werden. Das gleiche gilt für Umlaute, Satzzeichen oder Symbole. <br />
<br />
Der Aufbau dieses Bereiches kann zwei Formen annehmen. Für Omsi 1 gilt nur eine Form, wobei bei Omsi 2 beide Formen genutzt werden können. Der Übersicht wegen, wird hier die alte Schreibform (untereinander gegliedert) gezeigt. Um eine Hofdatei ganz einfach zu erstellen empfielt sich die Verwendung des [http://www.omnibussimulator.de/forum/index.php?page=Thread&threadID=40888&highlight=| Programm's '''Hof Suite von Rumpelhans'''], dass eine Hofdatei problemlos und Fehlerfrei vollständig erstellt. Einzelheiten zum Programm entnehmt ihr bitte dem beiliegenden Handbuch. Etwas schwerer, aber auch Möglich, ist die Nutzung eines Schreibprogrammes wie Office Word. Für die neuere Schreibform wie in Omsi 2 ist ein Tabellenprogramm wie Exel sinnvoller, da hier die Anzeigen nacheinander, getrennt von einem Tabulator gesetzt wird. Jeder gesetzte Abstand des Tabulator's, setzt den nächsten String fest. Ein String darf damit nicht als Platzhalter oder zur Zentrierung benutzt werden. Das [http://www.omnibussimulator.de/forum/index.php?page=Thread&threadID=40888&highlight=| Programm '''Hof Suite von Rumpelhans'''], ist aber die einfachste und leichteste Variante, da dieses Programm eine übersichtliche Oberfläche bietet, viel Schreibkram einspart, auf Fehler hinweißt und auch größere Hofdateien, schnell und einfach, im Omsi-2-Format erstellt. Außerdem kann man eine Hofdatei damit sehr einfach erweitern, ergänzen, umstellen oder berichtigen und anpassen. So können auch Hofdateien aus Omsi 1 problemlos umgestellt werden, um diese auf Maps in Omsi 2 zu nutzen. Änderungen in der Hofdatei werden aber immer erst nach einem Neustart von Omsi umgesetzt.<br />
Aus beiden letztgenannten Programmen (Word und Exel), kann man diese Hofdatei als Textdatei abspeichern und die Dateiendung umbenennen.<br />
<br />
In dem zweiten Bereich gibt es nur zwei Befehle, die wiederrum das Verhalten der Fahrkunden steuert. <br />
[addterminus] bedeutet, daß die Fahrkunden einsteigen können, spätestens beim erreichen dieser Endstelle den Bus verlassen müssen,<br />
[addterminus_allexit] bedeutet, egal was die Anzeige zeigt, es darf nicht eingestiegen werden.<br />
Direkt darunter kommen zwei Informationen und darauf folgend die Strings:<br />
<br />
<pre><br />
[addterminus_allexit]<br />
123<br />
Name der Endstelle<br />
String 0<br />
String 1<br />
String 2<br />
String 3<br />
String 4<br />
String 5<br />
String 6</pre> <br />
<br />
Gemäß der Vorgabe im ersten Bereich der Hofdatei unter [stringcount_...] kann man hier die Strings für die Anzeigesysteme schreiben. Die ersten beiden Punkte unter dem Befehl sind fest vorgegeben und beinhalten nichtangezeigte Informationen. Besonders wichtig ist hier die richtige Stringanzahl. Stehen hier mehr Strings als unter "Stringcount_terminus" eingetragen, werden die folgenden Strings nicht beachtet (gelten also als nicht vorhanden). Außerdem ist zu Beachten, daß die Stingzählung bei NULL beginnt und nicht bei Eins. Das bedeutet, daß sieben Strings ausgelesen werden, von String 0 bis String 6.<br />
<br />
123 - die 3-stellige Zahl gibt dieses Ziel einen IBIS-Code. Da man im Ibis keine Buchstaben eingeben kann, werden alle Ziele mittels Code identifiziert. Welchen Code ein Ziel bekommt ist dabei egal, solange der Code für ein einziges Ziel eingetragen wird. Das Ziel kann zwar mit dem Code mehrmals in der Liste erscheinen, aber ein bestimmter Zahlencode darf nicht zwei unterschiedliche Ziele beinhalten.<br />
<br />
Gefolgt vom Namen der Endstelle. Hierbei erhält jede Endstelle einer Map seinen eigenen Zahlencode für das IBIS. Der Name der Endhaltestelle, der hier eingetragen wurde, muß dem Endstellenwürfel im Editor entsprechen. Sind diese nicht gleich, wird diese Endstelle nicht mit dem Ziel in Verbindung gebracht und ignoriert. Das bedeutet, daß diese Endstelle (im Editor) keinen IBIS-Code besitzt und daher nicht geschildert werden kann. Im Ibis wird eine Endstelle angezeigt, aber diese existiert für Omsi garnicht. <br />
Im gegenzug müßen nicht alle Endstellen einen Haltestellenwürfel haben. Liegt die Endstelle ausserhalb des Kartenbereich's, sollte dennoch eine Endstelle dazu in der Hofdatei erstellt werden. Diese Endstellen sind für KI-Busse interessant. Die Endstellen werden im Fahrplan genannt, da alle Busse nur mit Fahrplan, im Liniendienst fahren könne. Ohne Fahrplan verhalten sich die Busse wie gewöhnliche KI-Fahrzeuge.<br />
<br />
Nun folgen die Strings der einzelnen Anzeigen. Diese Strings werden für die jeweiligen Anzeigegeräten in den Script-Dateien festgelegt. Die Verwendung welcher String für welche Anzeige genutzt wird, ist frei, sollte aber sinnvoll eingetragen werden, damit die Hofdatei für andere Busse genutzt werden kann.<br />
<br />
Das folgende Beispel, zeigt die Eintragungen einer ANNAX-Matrix, Rollbandanzeige, IBIS 1 und IBIS 2 Gerät:<br />
<pre>[addterminus]<br />
123<br />
Endhaltestelle<br />
BHF KIESELSTEIN<br />
Bahnhof<br />
Kieselstein<br />
Bhf. Kieselstein<br />
Rollbandtextur.tga<br />
Bahnhof Kieselstein</pre> <br />
<br />
Aufgeschlüsselt bedeuten die Eintragungen (hier am Beispiel eines MAN SD 202) folgende Punkte am Bus:<br />
<pre>[addterminus]<br />
123 - Durch Eingabe dieses Zahlencode in das IBIS, Atron, EFAD, etc. bei der Taste Ziel, wird die <br />
gewählte Endhaltestelle ausgewählt.<br />
Endhaltestelle - hier muß der korrekte Name der Endstelle wie im Editor/ oder Fahrplan eingetragen werden.<br />
BHF KIESELSTEIN - Anzeige für das IBIS 1 (max. 16 Zeichen [incl. Leerzeichen] und nur Großbuchstaben, <br />
weil es im Font des IBIS 1 nur Großbuchstaben gibt.<br />
Bahnhof - Anzeige der oberen ANNAX-Zeile an der Front des Busses. Hier dürfen ebenfalls nur<br />
16 Zeichen vorhanden sein, und Buchstaben in Groß- und Kleinschrift.<br />
Kieselstein - Anzeige der unteren ANNAX-Zeile an der Fahrzeugfront. Hier dürfen ebenfalls nur max. 16 <br />
Zeichen erstellt werden.<br />
Bhf. Kieselstein - Zielanzeige an der einzeiligen Seitenmatrix (ANNAX-Seite) mit max. 16 Zeichen.<br />
Rollbandtextur.tga - Name der Rollbandtextur im Ordner Anzeigen. Wichtig: die Dateiendung muß richtig<br />
eingetragen werden.<br />
Bahnhof Kieselstein - Anzeige für das IBIS 2-Gerät (Groß- und Kleinschreibung, max. 20 Zeichen).</pre><br />
<br />
Die hier gezeigte Schreibweise kann für Omsi 1 und Omsi 2 verwendet werden. Um bei Omsi 1 kurze Namen zu zentrieren, sollte man Leerzeichen verwenden. Für Omsi 2 ist es ratsam, hinter einer Eintragung ein Tabulator zu setzen. Wurden alle Endstellen, die auf der Map vorhanden sind geschrieben, können alle Endstellen geschrieben werden, die nicht auf der Map sind, aber von Linien die auf der Map fahren (KI-Linien) geschrieben werden. Der Präfix "_allexit" hinter dem Befehl addterminus sorgt dafür das keine Fahrkunden einsteigen und eventuell im Bus sitzende Fahrkunden, nach der Eingabe, sofort aussteigen.<br />
<br />
Die Reihenfolge der eingetragenen Endstellen, bestimmt später die Reihenfolge der Rollbandtexturen, wenn man diese in einem Bus manuell einstellt (also nicht über das Omsi-Menü).<br />
<br />
----<br />
<br />
=== '''Aufbau des dritten Bereiches einer Hofdatei - Haltestellenliste''' ===<br />
<br />
In dieser Liste ändert sich lediglich der Befehl und die Anzeige-Orte im Bus. Es gibt nur ein Befehl der eine weitere Haltestelle hinzufügt. Und es werden nur Haltestellen geschrieben, die vom Spieler bedient werden können (unabhägig, ob diese Haltestellen auf der Map existieren oder nicht).<br />
<br />
<pre>[addbusstop]<br />
Haltestelle<br />
BUSPLATZ AM WALD<br />
Busplatz<br />
Am Wald<br />
Busplatz am Wald</pre><br />
<br />
Hier wieder die Aufschlüßelung der Eintragungen:<br />
<pre>[addbusstop]<br />
Haltestelle - Name der Haltestelle wie im Editor und Name der Audiodatei der Ansage (ohne Dateiendung).<br />
BUSPLATZ AM WALD - Anzeige für das IBIS 1 Gerät<br />
Busplatz - Innenanzeige erste Sicht vor dem Umschalten.<br />
Am Wald - Innenanzeige zweite Sicht nach dem Umschalten, die beiden Anzeigen werden im Takt <br />
automatisch umgestellt und zentriert.<br />
Busplatz am Wald - Name der Haltestelle für das IBIS 2.</pre><br />
<br />
Die Reihenfolge der einzelnen Haltestellen ist dabei irrelevant. Die Ausstiegspunkte der Endstellen werden genauso mit eingetragen, wie alle anderen Haltestellen. Damit erscheinen die Endstellen also in beiden Listen, was hauptsächlich den Ansagen, der Innenanzeige und der Anzeige im IBIS dient.<br />
<br />
Damit ist dieser kurze Abschnitt schnell geschafft.<br />
<br />
----<br />
<br />
=== '''Aufbau des vierten Bereiches der Hofdatei - Routenlisten''' ===<br />
<br />
Hier werden nun, für jede einzelne Route die Liste in der Reihenfolge der abzufahrenden Haltestellen eingetragen. Die richtige Reihenfolge ist nicht für die Linie entscheidend, sondern der Fahrplan, so wie er im Editor erstellt wurde. Die richtige Reihenfolge wird aber benötigt, wenn die Ansagen der Haltestellen passen sollen und die Anzeigen in den Businternen Informationsgeräten. Schreibfehler oder die falsche Reihenfolge führt bei Bussen mit automatischer Haltestellenweiterschaltung nicht zu Fehlern im Bus, da nur der Bus diese Daten ausließt.<br />
<br />
'''Zur Definition:''' Eine Route ist der Weg von einer Endstelle zu einer anderen, also der wahre Anfangs- und Endpunkt einer Linie in einer Richtung. Zwei Routen sind nötig um einen Umlauf zu definieren. Bestehend aus der Hintour und der Rücktour. Es wird also lediglich eine Route je Liste geschrieben, kein kompletter Umlauf.<br />
<br />
Dieser Bereich teilt die Liste in 2 Gruppen auf. Hier gibt es auch wieder zwei festgelegte Befehle. Im ersten Teil '''[infosystem_trip]''' befinden sich die Information, der Linie und Routennummer, wo eine Linie beginnt und wo diese endet sowie den IBIS-Code welches Zeil geschildert werden soll. Das hat zur Folge, das es vollkommen ausreichend ist, wenn man nur die Linie und die Route im IBIS einträgt, daß Ziel und die Linie werden dann bereits bei einer Matrix geschildert. Rollbänder müßen hingegen, manuell oder über das Menü eingestellt werden.<br />
In der ersten Gruppe befinden sich also die Informationen für die Route und in der zweiten Gruppe '''[infosystem_busstop_list]''' die Liste der Haltestellen.<br />
<br />
<pre>[infosystem_trip]<br />
901<br />
Busplatz-Kieselstein<br />
123<br />
9 <br />
<br />
................<br />
<br />
[infosystem_busstop_list]<br />
5<br />
Busplatz<br />
Busplatz Am Wald<br />
Einsteindorf<br />
Krankenhaus<br />
Bhf Kieselstein<br />
<br />
</pre> <br />
<br />
Dies soll nur eine kurze Liste darstellen die rein fiktiv ist, um zu erklären was wo steht. Hier geht es um die Linie 9 und die erste Route. Nun geht es wieder um die Aufschlüsselung der einzelnen Zeilen:<br />
<br />
<pre><br />
[infosystem_trip] - Dieser Befehl sagt aus, daß hier Infos zur folgenden Route stehen.<br />
901 - Die Linie und die Routennummer. Also Linie 9 und die erste Route. <br />
Diese Zahl "kann" auch 6-stellig sein (also 4-stellig, die Liniennummer und<br />
2-stellig für die Route), während die Route 2-stellig sein "muß".<br />
Busplatz-Kieselstein - Diese Zeile wird nicht ausgelesen, sie dient nur der Orientierung, von welche<br />
Route jetzt die Liste folgt.<br />
123 - IBIS-Code der Zielendstelle (also in diesem Beispiel "Kieselstein").<br />
9 - Wiederholung der Liniennummer.<br />
<br />
................<br />
<br />
[infosystem_busstop_list]- Dieser Befehl sagt aus, das hier die Liste der Haltestellen kommt <br />
(inclusive Anfangs- und Endhaltestelle)<br />
5 - Anzahl der Haltestellen insgesamt. Beginnend bei der Zahl 1 (nicht NULL)<br />
Busplatz - erste Haltestelle (also die Einstiegshaltestelle)<br />
Busplatz Am Wald<br />
Einsteindorf<br />
Krankenhaus<br />
Bhf Kieselstein - Endhaltestelle, wo die Fahrkunden aussteigen sollen.<br />
</pre><br />
<br />
Dies wird nun für jede, im Editor erstellte Route eingegeben, allerdings nur für die Linien, die auch vom Spieler gefahren werden können. KI-Busse brauchen dies nicht, da KI-Busse keine Ansagen, Innenanzeigen oder sonstige Infos tragen, außer die Außenanzeigen (die aber aus der Endstellenliste ausgelesen werden). Die geschriebene Anzahl der Haltestellen muß mit der tatsächlichen Anzahl der eingetragenen Haltestellen übereinstimmen, sonst werden weitere Haltestellen nicht angezeigt oder angesagt, oder die Fahrkunden steigen alle zu früh aus.<br />
<br />
Es müßen nicht alle Linien geschrieben werden. einige gesonderte Linien kommen auch ohne Linienlisten aus. Dann gibt es aber weder eine Anzeige noch Ansagen, was z.B. bei kurzeitigen Linien gedacht ist oder Zielen die zu einer bestimmten Zeit nicht in einer Matrix oder Röllbänder existierten, wie zum Beispiel die Linie E522 in Spandau, zwischen November 1989 und Dezember 1990.<br />
<br />
<br />
----<br />
<br />
==== '''Sonstiges:''' Wenn ein Ziel, über das Steckschild angezeigt werden soll (nur in Omsi 2) ====<br />
<br />
Wenn es keine Anzeigen im Bus geben soll, sondern die Ziele nur über ein Steckschild angezeigt werden sollen, muß der IBIS-Code über eine 4-stellige Nummer verfügen. 4-stellige IBIS-Codes können nicht im IBIS eingetragen werden. Daher bleibt die Anzeige leer, aber die Linie bleibt erhalten und das Steckschild fungiert als Anzeigen-Ersatz, womit auch die Fahrkunden einsteigen. Im String für das IBIS 1 (String 0) sollte dann ein Rautezeichen eingetragen werden (#).<br />
Da alle Ziele in Omsi über den IBIS-Code identifiziert werden (Endstellen-ident), können nur hier ein Ziel über einen zweiten Zielcode identifiziert werden. Der Zielcode für das Steckschild wird it dem 4-stellugen IBIS-Code 1000 eingetragen. Damit dies ausgelesen wird, mußt der Code im jeweiligen Script der Zielanzeige mit 1000 addiert werden. Dies kann für andere Anzeigegeräte ebenfalls verwendet werden, wenn in den Scripten der IBIS-Code mit höheren Codes addiert wird. <br />
<br />
<br />
----<br />
<br />
== '''Form der Hofdatei in Omsi 1''' ==<br />
<br />
Die Form der Hofdatei ist bei Omsi 1 einfacher und übersichtlicher, als in Omsi 2. Der Ablauf wie oben beschrieben ist einfach gestaffelt. Mit einem Befehl werden die einzelnen Zeilen zum Auslegen festgestellt, die dann durch die Scripte des einzelnen Busses ausgelesen werden:<br />
Ein Befehl wird immer in einer Klammer festgelegt<br />
<br />
[name]<br />
Spandau<br />
<br />
Damit beginnt die Hofdatei und legt fest, wie die Hof-Datei OMSI-intern heißt. Beim Erstellen einer Map kann ein Standard-Hof definiert werden (es muss der Name eingtragen werden, der in der Hof-Datei festgelegt wurde), der dafür sorgt, dass bei der Busauswahl gleich die richtige Hof-Datei vorausgewählt wird. Was unter dem Namensblock eingetragen wird, steht später auch im Busauswahldialog in OMSI. Außerdem wird dieser Name auch für die KI-Busse verwendet, die in der AI-List eingetragen sind. Stimmt der Name in der AI-List nicht mit dem Namen der Hofdatei überein, wird diese Hofdatei von den KI-Bussen nicht erkannt/geladen. Anmerkung: der Dateiname der Hofdatei ist an dieser Stelle für das Auslesen irrelevant. Die Hofdatei wird lediglich über den Befehl [name] identifiziert und damit genutzt.<br />
<br />
[servicetrip]<br />
Dienstfahrt<br />
<br />
Dieser Befehl legt fest, welche Anzeige am Bus angezeigt wird, wenn der Bus als KI ohne Route fährt. Es wird hier offensichtlich nicht festgelegt, welche Anzeige eingestellt wird nach dem Laden/Platzieren eines Spieler-Busses. OMSI nimmt dafür immer das erste Ziel aus der Endstellenliste.<br />
<br />
Die nächsten zwei Befehle (die ohne eckige Klammer geschrieben werden) legen fest, wieviele Strings insgesamt ausgelesen werden können. In der Endstellenliste und der Haltestellenlsite kann man soviele Strings schreiben wie man möchte, aber nur die festgelegte Anzahl wird auch tatsächlich ausgelesen. Beide Befehle bestehen aus zwei Teilen:<br />
<br />
Stringcount_terminus<br />
18<br />
<br />
Stringcount_busstop<br />
9<br />
<br />
Stringcount sagt aus, das hier die Anzahl der auszulesenden Strings hier festgelegt werden. Der zweite Teil bezieht sich auf die folgenden Bereiche wofür die Stringanzahl festgesetzt wird.<br />
_terminus bezieht sich auf die Liste der Endstellen,<br />
_busstop legt fest, wieviele Strings dort ausgelesen werden müßen.<br />
<br />
----<br />
<br />
=== '''Endstellen''' ===<br />
<br />
Mit dem Befehl [addterminus] kann man die Entstellen festlegen. Direkt darunter werden erst die Zugehörigkeiten festgelegt und dann folgen die eigentlichen Strings. Ein String ist der auszulesende Teil der für die Anzeigeinformation ausgelesen werden soll. Der erste String beginnt aber erst in der dritten Zeile nach dem Befehl. Die zwischenliegenden Zeilen werden von Omsi für die Zugehörigkeit der Endstellen benötigt. Danach kann Omsi genau die gewünschten Anzeigen für die Endstelle definieren.<br />
Ein Bus liest aber nicht alle Strings aus, sondern jeder Bus liest nur die Strings aus, die in den jeweiligen Strings des busses festgelegt sind, egal ob das dortige Format der Anzeige entspricht oder nicht. Stimmt das Format wird die Anzeige korrekt dargestellt, ist das Format für die jeweilige Anzeige ungeeignet wird entweder nichts angezeigt oder nur der Teil der verwendet werden kann.<br />
Das gewünschte Verhalten, wie die Fahrkunden auf die jeweilige Anzeige reagieren soll, wird mit dem Präfix _allexit festgelegt. Die Personen in Omsi können nicht lesen, sie reagieren nur stur auf die gewählte Anzeige.<br />
Jetzt folgen zwei Beispiele für Anzeigen. Zur besseren Übersicht werde ich die Zeilen Nummerieren und bezeichnen. Als Trennung verwende ich Wellenlinien. Ich beziehe mich hier ganz bewußt auf eine universelle Hofdatei.<br />
<br />
<pre><br />
1 ~~~Befehl ~~~~[addterminus]<br />
2 ~~~IBIS-Code~~123<br />
3 ~~~Name der Endstelle~Potzdamer Straße<br />
4 ~~~String0~~~~POTZDAMER STR<br />
5 ~~~String1~~~~Potzdamer<br />
6 ~~~String2~~~~Strasse<br />
7 ~~~String3~~~~Potzdamer Str.<br />
8 ~~~String4~~~~Potzdamer.bmp<br />
9 ~~~String5~~~~Potzdamer Strasse<br />
10~~~String6~~~~Potzdamer.bmp<br />
11~~~String7~~~~Potzd_Stra.bmp<br />
12~~~String8~~~~M48 Potzdamer<br />
13~~~String9~~~~M48<br />
14~~~String10~~~246<br />
15~~~String11~~~Potzdamer*I<br />
16~~~String12~~~Straße*I<br />
17~~~String13~~~Potzdamer Str/<br />
18~~~String14~~~Lützow Str.<br />
19~~~String15~~~Potzdamer<br />
20~~~String16~~~Straße<br />
21~~~String17~~~Potzdamer Straße<br />
22~~~String18~~~Potzdamer Straße/*B<br />
23~~~String19~~~Lützow Straße<br />
24~~~String20~~~Potzdamer Straße<br />
25~~~String21~~~Warschauer Straße<br />
26~~~String22~~~Leer<br />
</pre><br />
<br />
Wie bereits geschrieben, liest jeder Bus nur ganz bestimmte Strings aus. Um dieses zu verdeutlichen mal 4 Busse als Beipiel:<br />
* MB O 305 - braucht String0 für das IBIS1 und String 4 für das Rollband,<br />
* MAN NG 272 - Braucht String 1 und 2 für die Krügeranzeige und String 5 für das IBIS 2,<br />
* SD 202 - braucht String 1 und 2 für die ANNAX vorn, String 3 für die ANNAX an der Seite und String 5 für das IBIS 2,<br />
* MAN ÜL - braucht String 8 für die Matrix vorn und Seite sowie den String 9 für die Heckmatrix.<br />
* MB O407 - benötigt die String's 4, 5, 6, 8, 9, 13 ,14, 15, 16 für die unterschiedlichen Anzeigesysteme.<br />
<br />
Die genaue Zeichenanzahl, also die Länge eines Strings ist hier nicht begrenzt, sondern ist abhängig vom jeweiligen gescripteten Gerät, mit Ausnahme des Rollbandes, des Steckschildes und der Krüger++ da diese Texturen verwenden. Die Texturnamen sollten aber für Omsi kurz sein. Kürzere Texturnamen lädt Omsi schneller als lange, was sich bei vielen Texturnamen irgendwann bemerkbar macht.<br />
<br />
2. Beispiel für eine Anzeigevariante<br />
<pre><br />
1 ~~~Befehl ~~~~[addterminus_allexit]<br />
2 ~~~IBIS-Code~~101<br />
3 ~~~Name ~~~~~~Aussetzfahrt<br />
4 ~~~String0~~~~AUSSETZFAHRT<br />
5 ~~~String1~~~~Aussetzfahrt<br />
6 ~~~String2~~~~BT Meullerstr.<br />
7 ~~~String3~~~~Betriebsfahrt<br />
8 ~~~String4~~~~Endfahrt.bmp<br />
9 ~~~String5~~~~Heimfahrt<br />
10~~~String6~~~~Aussetzen.tga<br />
11~~~String7~~~~Diensfahrt.bmp<br />
12~~~String8~~~~END<br />
13~~~String9~~~~Dienstfahrt<br />
14~~~String10~~~201<br />
15~~~String11~~~Nicht einsteigen*B<br />
16~~~String12~~~<br />
17~~~String13~~~Feierabend<br />
18~~~String14~~~<br />
19~~~String15~~~Nicht<br />
20~~~String16~~~einsteigen!<br />
</pre><br />
<br />
Was in den einzelnen Strings drin steht ist fast egal. Die Texturen müßen mit den entsprechenden Texturnamen übereinstimmen. Was in den einzelnen Anzeigen steht ist vollkommen egal, da die Fahrkunden auf die Bedeutung der Worte nicht reagieren. Entscheidend für die Passagiere in Omsi ist der IBIS-Code des in Verbindung mit dem Namen der Endstelle, so wie diese in der Map eingetragen sind oder im Fahrplan. Oder das Präfix _allexit, womit die Figuren in Omsi das Fahrzeug vollkommen ignorieren.<br />
<br />
----<br />
<br />
=== '''Haltestellen''' ===<br />
<br />
Das ganze wiederholt sich nun auch für die Haltestellen. Was dort im einzelnen angezeigt wird, ist auch hier vollkommen egal. Wichtig ist nur der Name der Haltestelle wie im Editor und auch die entsprechende Ansage. Der Dateiname der Audiodatei muß genauso geschrieben sein, damit Omsi die Audiodatei der Haltestelle zuordnen kann. Die Reihenfolge, wie die Audiodateien abgespielt werden, ist im letzten Abschnitt "Routenlisten" festgelegt. Die genaue Reihenfolge der Haltestellen die in der Route abgefahren werden sollen, wird im Fahrplan mit dem Editor festgelegt. Wird eine neue Haltestelle angefahren, wird aus der Hofdatei der Name der Haltestelle ausgeleden, im IBIS angezeigt und die entsprechende Audiodatei abgespielt. <br />
<br />
Zum besseren Verständnis:<br />
Wie die Haltestelle im Editor heißt ist für die Hofdatei irrelevant. Steht im Fahrplan für die nächste Haltestelle Breite Straße und in der Hofdatei steht Baumalle, muß die nächste Haltestelle Breite Straße angefahren werden, da sonst alle Fahrkunden aussteigen. Der Bus liest für die nächste Haltestelle aber die Baumallee aus und spielt auch die dazugehörige Audiodatei ab.<br />
Ihr solltet immer daran denken, was in der Hofdatei drinsteht ist nicht für die Perosnen in Omsi, sondern ausschließlich für euch. Steigt eine Person in einem Bus ein, orientiert diese sich nur nach zweit Punkten. Welchen IBIS-Code fahrt ihr an und welche Endstelle ist mit diesen IBIS-Code verbunden. Omsi legt dann fest das diese Figur eine bestimmte Anzahl an Haltestellen mitfährt und steigt dann aus. Welche Ziele am Bus stehen, was dort geschrieben oder angezeigt wird, wie die nächste Haltestelle heißt und welche Audiodatei abgespielt wird, ist der Figur in Omsi egal, sollange ihr auf dem Pfad der Tugend (also dem festgelegten Pfad zur Haltestelle, wie im Fahrplan angegeben) bleibt. Ihr braucht also lediglich nur im IBIS den Ziel-Code eintragen und die Leute steigen ein. Dies kann man am besten im MB O 305 sehen. Gibt man in diesen Bus die Linie und Route ein, wird aus der Hofdatei der Zielcode ermittelt und übernommen. Außen am Bus stehen keinerlei Informationen, aber die Leute steigen ein.<br />
<br />
<pre><br />
1 ~~~Befehl ~~~~[addbusstop]<br />
2 ~~~Name der Haltestelle~Baumallee<br />
3 ~~~String0~~~~BAUMALLEE<br />
4 ~~~String1~~~~Baumallee/<br />
5 ~~~String2~~~~Hammerweg<br />
6 ~~~String3~~~~Baumallee/Hammerweg<br />
7 ~~~String4~~~~4<br />
</pre><br />
<br />
Direkt nach dem Befehl in Zeile 1 folgt die Identifizierung mit dem Haltestellenwürfel im Editor von Omsi. Die nachfolgenden Informationen werden nun im Bus für diese Haltestelle angezeigt. Was genau angezeigt wird, ist euch überlassen.<br />
<br />
----<br />
<br />
== '''Form der Hofdatei in Omsi 2''' ==<br />
<br />
Zuersteinmal sei an dieser Stelle erwähnt, daß Omsi 2 beide Formationen der Hofdatei auslesen kann. Im Grunde ist die Hofdatei gleich, es werden nur andere Trennungen verwendet. Dadurch ergeben sich einige kleine Änderungen. Somit braucht ein Befehl nicht mehr, mehrfach geschrieben werden, sondern leicht verändert in einmaliger Form.<br />
<br />
Im ersten Abschnitt einer Hofdatei kommt ein weiterer Befehl hinzu. Dieser regelt die dazugehörigen Unterordner in Omsi, da nun einige Dateien (Audiodateien und Texturdateien für Rollband, Steckschilder und Krüger++ Matrix), nichtmehr in jeden Bus-Ordner eingestellt werden, sondern zentral in einem Unterordner zusammengefast sind. Der Vorteil liegt dabei klar auf der Hand: Man spart Speicherplatz auf der Festplatte und muß nicht bei neuen Bussen alles einzeln einkopieren. Damit Omsi genau weiß, welche Daten für die jeweilige Hofdatei genau zu finden sind, wird mit einem neuen Befehl die Namen der Unterordner angegeben.<br />
<br />
<pre><br />
1 ~~~Befehl ~~~~[global_strings]<br />
2 ~~~Stringanzahl~~~~6<br />
3 ~~~String0~~~~Name des Ansagen-Unterordners <br />
4 ~~~String1~~~~Name des Rollband-Unterordners <br />
5 ~~~String2~~~~Name der Seitenschild-Unterordners<br />
6 ~~~String3~~~~IBIS-Spezialcode für 900-er Liniennummern<br />
7 ~~~String4~~~~IBIS-Spezialcode für 800-er Liniennummern<br />
8 ~~~String5~~~~IBIS-Spezialcode für 500-er Liniennummern<br />
</pre><br />
<br />
Hier folgen die genaue Anzahl der Strings die ausgelesen werden sollen. Nach der festlegung der Anzahl folgen die 3 Unterordner für die Ansagen (Audiodateien) sowie die Namen der Unterordner für die Texturen des Rollbandes und der Seitenschilder im Ordner Anzeigen.<br />
<br />
Die IBIS-Spezialcodes sind bereits in der jeweiligen Matrix-osc eines Busses festgelegt. Die darunter liegenden Zahlen die dort eingetragen werden, müßen den Buchstabencodes der Busse entsprechen. Da man in den IBIS-Geräten keine Buchstabentasten hat, werden Buchstaben nur über Codes eingetragen. Hier kann man also festlegen, welche Buchstaben an welcher Liniennummerposition angezeigt werden sollen. Eventuell muß ein Buchstabe in der jeweiligen Matrix.osc neu festgelegt werden.<br />
<br />
Hier folgt nun eine kleine Tabelle mit einigen ausgewählten Buchstaben:<br />
<pre><br />
1 ~~~ "E" an erster Stelle<br />
4 ~~~ "N" an erster Stelle<br />
5 ~~~ "S" an erster Stelle<br />
6 ~~~ "A" an erster Stelle<br />
9 ~~~ "E" an zweiter Stelle<br />
10~~~ "E" an dritter Stelle<br />
15~~~ "N" an zweiter Stelle<br />
16~~~ "A" an dritter Stelle<br />
28~~~ "M" an erster Stelle<br />
32~~~ "M" an dritter Stelle<br />
36~~~ "X" an erster Stelle<br />
</pre><br />
<br />
Soll also für eine bestimmte Linie ein Buchstabe angezeigt werden, so kann man drei Gruppen festlegen. Mit Hilfe der Codes für die Buchstaben, werden zusätzlich zur Liniennummer auch die Buchstaben entsprechend ihrer Platzierung angezeigt.<br />
Soll also als Beispiel die Linie 23A für alle Busse mit den Liniennummern 800 angezeigt werden, schreibt man einfach bei String 5 den Buchstabencode 16 ein. Über das IBIS stellt man die Liniennummer 02317 ein oder die Linie 82300. In der jeweiligen Matrix.osc des Busses im Scriptordner sollte dann natürlich der Buchstabe A für den Buchstabencode 16 eingetragen sein. Fehlt dieser Eintrag, wird an der Stelle ein Leerzeichen angezeigt.<br />
<br />
----<br />
<br />
=== ''' Endstellen ''' ===<br />
<br />
Im Omsi 1-Format werden die jeweiligen Strings einfach untereinander geschrieben. Im einfachen Windowsseitigen Editor (Wordpad) schreibt man einfach unter dem Befehl die gewünschte Anzeige für den entsprechenden String ein. Dazu ist es aber erforderlich den jeweiligen Befehl immer wieder zu schreiben und neu die genaue stringposition zu zählen. Im Omsi 2-Format kann man nun alle Strings nacheinander schreiben, wobei man am Anfang lediglich den Grundfehel schreibt, dann folgt die Liste der Anzeigen und beendet die Liste mit einem "end". Mit dem windowseigenen Editor Wordpad gibt es hier einen riesigen Nachteil. Da die Zeichenlänge der Anzeigen variieren kann, erscheinen nicht die jeweiligen Strings sauber untereinander. Die Trennung der jeweiligen Strings wird mit der TAB-Taste gesetzt. Auch diese Abstand variiert. Bei einer geringen Anzahl von Strings und auch von Endstelle kann man das ganze noch überschauen.<br />
Aber wenn eine Karte doch etwas umfangreich ist, Wird das ganze zunehmend unübersichtlich und ungenau. Dann können Tababstände ein Feld mit der Leertaste entsprechen. <br />
<br />
''Daher wird dringend die Verwendung eines externen Programmes empfohlen, wie das [http://www.omnibussimulator.de/forum/index.php?page=Thread&threadID=40888&highlight=| '''Hof Suite von Rumpelhans''' ''].<br />
<br />
Übersichtlich wird es aber auch mit einem Tabellenprogrammen wie Windows Office Exel oder ähnlichen Tabellenprogrammen, die es auch kostenlos gibt, wie Open Office. Dabei erstellt man die Anzeigen Zeilenweise und erstellt die Strings sauber nebeneinander in Spalten.<br />
<br />
Als erstes eröffnet man eine Liste mit den entsprechenden Befehl<br />
[addterminus_list]<br />
Nun folgen die Einträge für jede Endstelle in einer Zeile, wobei die einzelnen Strings mittels TAB getrennt werden. Damit ergeben sich zwar nacheinander mehrere Spalten, aber die Übersicht bleibt bei der verwendung externer Programme erhalten.<br />
Nachfolgend nun eine Liste, was in die entsprechenden Spalten eingetragen werden soll.<br />
<br />
<pre><br />
Spalte 1 Soll bei dieser Anzeige niemand einsteigen, wird diese Spalte mit dem Präfix {allexit} geschrieben,<br />
andernfalls bleibt dieses Feld leer<br />
Spalte 2 IBIS-Code<br />
Spalte 3 Identifikation der Endstelle<br />
Spalte 4 String 0<br />
Spalte 6 String 1<br />
Spalte 7 String 2<br />
Spalte 8 String 3<br />
Spalte 9 String 4<br />
Spalte 10 String 5<br />
Spalte 11 String 6<br />
Spalte 12 String 7<br />
Spalte 13 String 8<br />
Spalte 14 String 9<br />
Spalte 15 String 10<br />
Spalte 16 String 11<br />
Spalte 17 String 12<br />
Spalte 18 String 13<br />
Spalte 19 String 14<br />
Spalte 20 String 15<br />
Spalte 21 String 16<br />
</pre><br />
<br />
Wurden alle Endstellen eingetragen, wird die Liste mit dem Befehl<br />
[end]<br />
abgeschlossen. Anschließend folgt die nächste Liste, also die Haltestellenliste, was dem 3. bereich einer Hofdatei entspricht.:<br />
<br />
----<br />
<br />
=== ''' Haltestellen ''' ===<br />
<br />
Das selbe Prinzip wie zuvor, wird auch in dieser Liste angewendet:<br />
<pre><br />
[addbusstop_list]<br />
Spalte 1 Name der Haltestelle<br />
Spalte 2 String 0<br />
Spalte 3 String 1<br />
Spalte 4 String 2<br />
Spalte 5 String 3<br />
Spalte 6 String 4<br />
Spalte 7 String 5<br />
</pre><br />
<br />
Und auch diese Liste wird am Ende mit dem Befehl<br />
[end]<br />
geschlossen.<br />
<br />
Der vierte und letzte Teil der Hofdatei bleibt wie im Omsi 1-Format erhalten.<br />
<br />
'''Bitte beachtet, daß einige Fahrkartendrucker noch zusätzliche Routeneinträge benötigen, <br />
die mit einem mehrstelligen Zahlencode eingetragen werden. Der mehrstellige Zahlencode hat den Vorteil, <br />
daß kein IBIS-Gerät diese Routen ausliest und somit einzig und allein nur für den jeweiligen<br />
Fahrkartendrucker nützlich sind. Es mag im ersten Moment keine Sinn machen,<br />
diese zusätzlichen Routen zu erstellen, ist aber sehr sinnvoll, wenn für andere Fahrkartendrucker,<br />
diese Routen erstellt werden, um den vollständig Umfang der jeweiligen Fahrkartendrucker<br />
nutzen zu können, was auch den Spielspaß deutlich erhöhen kann. '''<br />
<br />
<br />
----<br />
----<br />
<br />
= '''Die Universelle Hofdatei.''' =<br />
<br />
Dieser Abschnitt richtet sich an alle Personen die einen Bus bauen, Anzeigegeräte erstellen und komplette Add-Ons produzieren.<br />
<br />
<br />
----<br />
<br />
== '''Was bedeutet ''"Universelle Hofdatei"'' ?''' ==<br />
<br />
Wie der Name schon vermuten läßt, bedeutet Universell = Vielseitig! Also eine einzige Datei die vielseitig eingesetzt werden kann. Diese vielseitigkeit bezieht sich hierbei (in Bezug auf Omsi) für '''alle''' [[Fahrtzielanzeiger an Bussen|Gruppen von Anzeigegeräten]], die in den Bussen verbaut wurden. Es wird nie eine einzige Hofdatei für alle Map's geben, aber es ist Möglich, eine einzige Hofdatei (für jede einzelne chronologische Zeitspanne), für jede einzelne Map anzulegen, wenn diese nicht in einem Busordner eingestellt wird, sondern in einem seperaten Ordner, wie die Ansagen (Announcement) oder die Rollbandtexturen (Anzeigen). <br />
<br />
----<br />
<br />
<br />
=== '''Wenn eine ''"universelle Hofdatei"'' sinnvoll wäre, hätten M+R Software diese umgesetzt.''' ===<br />
<br />
'''M+R Software haben eine universelle Hofdatei mit Omsi 1 eingeführt.''' Es geht also nicht um etwas neues, sondern vielmehr um die Rückkehr zum Anfang, ''Back to Basic''. Zwei unterschiedliche Anzeigegeräte (Rollband und ANNAX-Matrix) und zwei unterschiedliche Informationssteuergeräte (IBIS 1 und IBIS 2). Wer meint das die beiden IBIS-Geräte nicht unterschiedlich wäre, sollte sich nur mal die Anzeigen ansehen. Wärend das IBIS 1 nur Großbuchstaben anzeigen kann und die Anzeige auf maximal 16 Anzeigestellen begrenzt ist, kann das IBIS 2 Groß- und Kleinbuchstaben anzeigen und 20 Anzeigestellen vorweisen. Dafür wurde beiden Geräten, unterschiedliche String zugewiesen. Neue Busse mit [[Fahrtzielanzeiger an Bussen|neuartigen Anzeigesystemen]] haben die Strings benutzt, die für die ANNAX-Anzeige vorgesehen waren und mußten dafür umgeschrieben werden. Andere Busse nutzen die Strings, die bereits für die IBIS-Geräte eingestellt wurden. Dazu wurden die bereits festgelegten Strings umgeschrieben. Stellt man diese Hofdatei in einem MAN SD 202, erhält man teilweise unerwünschte Anzeigeformen. Das Umschreiben einer Hofdatei ist dabei aufwendiger als die Hofdatei zu erweitern und das Anpassen der Scripte im Bus für die Anzeigegeräte und die Matrix, ist sehr einfach. Es müssen jeweils nur zwei Ziffern je Script geändert werden. Die Scripte müßen dafür nicht komplett umgestellt werden, keine neuen Scripte entwickelt werden und keine Scripte erweitert werden. Es werden nur zwei Ziffern in den entsprechenden Scripten geändert und die Hofdatei um die entsprechend benötigten Strings erweitert.<br />
<br />
Befürchtungen, daß die Hofdatei dadurch aus einem überschaubaren Rahmen fällt, dem sei gesagt, daß dies auch in der Zukunft und auf längere Sicht hin, nicht passieren wird. Sicher werden noch einige neue Anzeigegeräte hinzu kommen. Aber man sollte beim Erstellen schon darauf achten, ob man nicht vielleicht den ein oder anderen String, der für andere Anzeigegräte erstellt wurde, weiterhin nutzen kann. Unterschiedliche Anzeigen, kann man mittels eingestelltem Code verändern, so wie dies in der Busfanat Vollmatrix schon umgesetzt wurde. Es kann also nicht davon ausgegangen werden, daß künftig über hunderte Strings benötigt werden könnten.<br />
<br />
'''Dazu möchte ich gern ein passendes Zitat von Busfanat aus dem offiziellen Forum einfügen:'''<br />
<br />
"Wenn man sich aber anschaut, wie viele Busse, die umgesetzt wurden, mit großteils den gleichen Scripts<br />
rumfahren, dann ist meiner Meinung nach der Bedarf nach verschiedenen Strings sowieso bald gedeckt.<br />
Ich glaube, mit 25 Strings pro Zielcode kommen wir die nächsten Monate wenn nicht Jahre über die Runden,<br />
weil sich einfach die Anzahl der Scripter in Grenzen hält."<br />
<br />
----<br />
<br />
=== '''Sinn und Zweck einer ''"universellen Hofdatei"''. ''' ===<br />
<br />
Seitdem Omsi 2011 erschienen ist, sind viele weitere Busse erschienen. Nicht alle haben eine Rollbandanzeige oder eine ANNAX-Matrix. Neue Anzeigen sind auch nicht erst mit Omsi 2 erschienen, wie die Krüger-Matrix. Es gab schon die BUSE-Vollmatrix, die [http://www.omnibussimulator.de/forum/index.php?page=Thread&threadID=13846%7C| Busfanat-Vollmatrix] oder Flipdot-Anzeige. Auch andere Informationsgeräte im Bus, haben ihren Platz in Omsi gefunden. Alle Anzeige- und Informationsgeräte brauchen die Hofdatei als Informationsquelle. Für fast jede Konfiguration von Anzeige-Geräten & Informationssteuergeräten, muß die Hofdatei angepasst werden. Möchte man nun einen anderen Bus nehmen, der eines der beiden verwendeten Geräte nicht besitzt, muß eine neue Hofdatei angefertig oder die vorhandene Hofdatei umgeschrieben werden.<br />
<br />
Damit gibt es für eine Map ohne Chronologiefunktion schon mehrere Hofdateien, was völlig unnötig ist. Für eine Karte mit Chronologiefunktion gibt es allein schon mehrere Hofdateien, um die einzelnen Zeitspannen abzudecken. Stellt man nun noch für die einzelnen Anzeigesystemen noch die umgeschriebenen Hofdateien hinzu, werden es soviele Dateien, das man in der Busauswahl nichtmehr genau unterscheiden kann, welche Hofdatei nun für den entsprechenden Bus passend ist und man muß die einzelnen Busse in der ''AI-List'' genau zuweisen, damit diese richtig anzeigen. Dies würde mit einer universellen Hofdatei wegfallen, weil alle Busse auf diese eine universell angepasste Hofdatei zugreifen. <br />
<br />
Das mag insgesamt nicht schwer sein, aber nicht alle User haben dazu Zeit oder die Fähigkeit eine entsprechende Hofdatei zu erstellen. Mit einer universellen Hofdatei kann jeder Bus, unabhängig vom verwendeten Anzeige- und Informationssteuergerät, eine einzige Hofdatei für eine Karte verwenden. Bei Einführung eines neuen Anzeigesystems oder eines neuen Informationssteuergerätes braucht der User nur noch eine Hofdatei aus einem anderen Bus kopieren, ohne verher nachfragen zu müßen, oder testen zu müßen, welche Hofdatei eigentlich am besten passt. Das ist nichtnur für Buserbauer und Mapersteller sinnvoll, sondern ganz besonders für Paywarehersteller, da somit gewährleistet ist, daß wirklich alle Busse auf jeder Karte einsetzbar sind, ohne zuvor eine Hofdatei erstellen oder im Internet suchen zu müßen.<br />
<br />
<br />
----<br />
<br />
=== '''Vor- & Nachteile einer universellen Hofdatei.''' ===<br />
<br />
Es gibt für eine ''universelle Hofdatei'', natürlich einige Vorteile, aber leider auch einige Nachteile. Hier soll aufgezeigt werden, daß eine Umstellung durchaus sinnvoll ist und die Umstellung auch lohnt. Bei der Umsetzung einer ''universellen Hofdatei'' reicht es nicht aus, einfach die Hofdfatei ansich, zu erweitern. Es müßen auch einige Kleinigkeiten in den jeweiligen Bussen geändert werden.<br />
<br />
Vorteile einer ''universellen Hofdatei'':<br />
<br />
* Eine Hofdatei passt für alle Busse, unabhängig vom verwendeten Anzeige- & Informationssystem.<br />
* Es werden auch alle verwendeten Informationsgeräte und Anzeigen im Bus unterstützt.<br />
* Bei neuen Bussen mit bisher veröffentlichten Systemen, passt die universelle Hofdatei.<br />
* Eine universelle Hofdatei ist unabhängig vom verwendeten Hofsystem (also für Omsi 1 oder Omsi 2).<br />
* Diese Hofdatei kann bei Bussen mit neuen Systemen leicht angepasst/ erweitert werden.<br />
* Bei neuen Bussen muß der User lediglich die Hofdatei in den Busordner einsetzen.<br />
* Alle Busse werden dadurch leichter für alle Karten kompatibel.<br />
* Ein Ziel kann unterschiedliche Anzeigen erhalten, die auf den unterschiedlichen Systemen angezeigt werden.<br />
* Eine ''universelle Hofdatei'' kann durch kopieren/ einfügen schnell ergänzt und erweitert werden.<br />
* Es muß nichtmehr getestet werden, welche Hofdatei für einen Bus passender ist.<br />
* Bei Maps, kann ein User alle Busse problemlos einsetzen.<br />
* Kann sehr einfach mit der [http://www.omnibussimulator.de/forum/index.php?page=Thread&threadID=40888&highlight=| '''Hof Suite von Rumpelahns''' erstellt werden].<br />
<br />
Nachteile einer ''universellen Hofdatei'':<br />
<br />
* Einige bereits erstellte Hofdateien werden überflüssig (und auch die haben Arbeit und Zeit gekostet).<br />
* Die Übersichtlichkeit innerhalb einer Hofdatei leidet (hauptsächlich beim Hofformat in Omsi 2).<br />
* Bei nichtabsprache, welche Strings verwendeten werden können, kann es zu Problemen/ Streitigkeiten kommen.<br />
<br />
Insgesamt bleibt aber die Anzahl der verwendeten Strings, innerhalb eines kleinen und leicht überschaubaren Rahmen.<br />
<br />
<br />
----<br />
<br />
== '''Wie man eine "universelle Hofdatei" umsetzen kann. ==<br />
<br />
Um eine universelle Hofdatei umzusetzen, muß man lediglich drei Dinge beachten:<br />
* Welche vorhandenen Strings kann ich nutzen, ohne die Strings in der Hofdatei umstellen zu müssen?<br />
* Welche neuen Strings kann ich verwenden, die noch nicht von anderen Geräten ausgelesen werden?<br />
* Wie kann ich neue Geräte auf weitere Strings umsetzen?<br />
<br />
Im folgenden geht es um bereits verwendete Strings, neu verwendete Strings und Strings die dadurch bereits vergeben sind und wie man das Auslesen der Strings beeinflußt.<br />
<br />
<br />
----<br />
<br />
==== '''Vergabe der Strings''' ====<br />
<br />
Sinn und Zweck einer "universellen Hofdatei" ist natürlich die Anpassung an mehrere verschiedene Informationssysteme an den einzelnen Bussen. Hierbei ist es natürlich unsinnig, wenn die von M+R Software vorgegebenen Strings beachtet werden (String 0 bis String 7) und einfach die nachfolgenden bereits vergebenen Strings verwendet werden. Hier ist es eine schwachsinnige Umsetzung der "universellen Hofdatei". Es ist natürlich verständlich das jeder die benötigten Strings dicht bei einander haben möchte. Wenn aber bereits vergebene Strings einfach wieder umgeschrieben werden, die bereits für andere Informationssysteme vergeben wurden, wurde der Sinn der "universellen Hofdatei" nicht verstanden. Durch die Veröffentlichung hatte jeder die Möglichkeit, sich für eine beteiligung an der Umsetzung einer "universellen Hofdatei" einzubringen, um benötigte strings im Vorfeld zu reservieren. Besonders Add-On Herstellen wurden von mir direkt angeschrieben. Da aber entweder keine Antwort kam oder die Umsetzung nur Überlegt wurde, wurden bereits weitere Strings an andere User vergeben. Hier greift ganz klar das bekannte Sprichwort: "Wer zuerst kommt, mahlt zuerst". <br />
Für neue Projekte müßen dementsprechend neue Strings am Ende angepasst werden. Für einige neue Informationssysteme ergeben sich damit leider längere Stringlisten. Für andere Informationssysteme ist es nicht notwendig (aber sinnvoll und zweckmäßig) die bereits vergebenen, nicht benötigten Strings auszufüllen. Diese können auch frei gelassen werden.<br />
<br />
Sinnvoll ist es sich vorher Gedanken zu machen, welche bereits vergebene Strings mitbenutzt werden können und ob neue Strings erweitert werden müßen. Sinnvoll sind neue Strings dann, wenn die Schriftlänge mit anderen Systemen nicht passt oder zum Anzeigesystem gehörige Codes in die Strings geschrieben werden. Ein Anzeigesystem das keine Codes akzeptiert, oder bereits verwendete Codes anders auslegen, ergeben auf den verschiedenen Systemen falsche Anzeigen. Eine ANNAX-Matrix würde bei verwendung eines Codes für die Busfanat-Vollmatrix den Buchstaben des verwendeten Codes mit anzeigen. Andererseits gibt es auch Busse, wo die verwendeten Informationsgeräte bestimmte Eingabeformate erforderlich machen, die kein anderes Informationsgerät sinnvoll nutzen kann. Als Beispiel soll hier nur das Ansagesystem des LU-200 genannt werden. Dieses kann lediglich zwei einzelne Ziffern anzeigen, da dieses Gerät real umgesetzt wurde. Kein anderes bereits erstellte Informationsgerät kann etwas mit dieser Anzeige anfangen. Daher werden zum Beispiel in einem IBIS 2 lediglich die Zahlencodes wiedergegeben, statt einer lesbaren Anzeige.<br />
<br />
Besonders Payware-Herstellen sollten, um einen langen Spielspaß zu ermöglichen, eine "universelle Hofdatei" annehmen, statt blind einfach vorhandene Strings zu überschreiben. Man kann natürlich auch so unüberlegt handeln und seine Busse scriptseitig auf einer bestimmten Map festlegen. Das verkürtzt den Spielspaß aber erheblich, wenn man nicht ohne weiteres andere Busse, besonders dann wenn die mitgelieferten Busse schnell langweilig werden oder Freeware-Busse qualitytiv gleich- oder höherwertiger sind, einsetzen kann. Besonders Freeware-Busse die keine festgelegten Karten haben, können hier mit einbezogen werden.<br />
<br />
So wie Menschen sich anpassen können, sind auch die einzelnen String's individuell anpassbar. Besonders in Hinblick auf die verwendbaren Zeichen und Symbole, wie auch in der Zeichenlänge der damit versorgten Anzeigesysteme oder die Verwendung von Codes zur Anzeigeform. <br />
<br />
Für Hilfe zur Anpassung oder zur Einigung von neuen Strings, ist es sinnvoll die Kommunikation zwischen Paywareherstellern und Usern deutlich zu verbessern. Wenn man weiterhin, blind vorhandene bereits vegebene Strings benutzt, braucht man sich folglich nicht wundern, wenn es negative Kritiken (die dann auch berechtigt sind) für das jeweilige Produkt gibt. Man weiß nun nicht, ob es Faulheit oder Dummehit ist, wenn man bereits vorhandene Strings für eigene Systeme benutzt, daß soll hier auch nicht diskutiert werden, aber wenn es Omsi-seitig schon die Möglichkeit gibt, sollte man diese natürlich auch benutzen.<br />
<br />
<br />
----<br />
<br />
<br />
=== '''Veränderungen in der Hofdatei.''' ===<br />
<br />
<br />
==== '''Welche Strings bereits umgesetzt wurden und ausgelesen werden''' ====<br />
<br />
M+R Software haben bereits angefangen, neue Strings zu verwenden, als Omsi 2 eingeführt wurde. Hier wurden lediglich weitere Strings in der Hofdatei umgesetzt und neue Informationsteile auf die neuen Strings eingestellt. Busfanat hat auf bitten einer umsetzung, die von ihm erstellte [http://www.omnibussimulator.de/forum/index.php?page=Thread&threadID=13846%7C|Busfanats-Vollmatrix], sofort auf andere neue Strings umgesetzt. Auch Perontinus hat die von ihm entworfenen [http://www.omnibussimulator.de/forum/index.php?page=Thread&threadID=26274|Überlandbusse MAN ÜL 242, 272, 292 und 312], auf bereits neue und erweiterte Strings umgestellt.<br />
<br />
Im übrigen sei an diese Stelle erwähnt das alle Busse mit einer Rollbandtextur, oder Busse, die auf dieser Basis funktionieren, bereits einen einzigen String nutzen. Alle Busse auf dieser Basis nutzen nur den String 4. Der Unterschied der Texturgröße, wird über den Zugriff der Anzeige-Ordner geregelt. Dies betrifft mehrere Busse:<br />
* MAN SD 200 Rollband von '''M+R Software'''<br />
* MAN NL 202 Rollband von '''FRENZYMAX'''<br />
* MB O305 von Rolf '''(RW1HH)'''<br />
* Setra S215 UL von '''L.M.M.W.'''<br />
* MB O307 V2 Banhnbus von '''Perotinus'''<br />
* MB O407 von '''Perotinus'''<br />
* GSÜH 240 von '''iTram'''<br />
* Gemeinschaftsbusse von '''iTram'''<br />
* LU 200 und GU 240 von '''ViewApp'''<br />
und einige mehr<br />
<br />
<br />
Im Folgenden soll es um die Stringsvergabe gehen und um die Anpassungen im Bus.<br />
<br />
----<br />
<br />
==== '''Bereits verwendete Strings''' ====<br />
<br />
Bisher wurden folgende Terminus-Strings in der Hofdatei bis zum '''String 24''' erweitert und festgelegt:<br />
<br />
''Unter dem Befehl '''stringcount_terminus''' muss die Anzahl der Strings auf 25 gesetzt werden.''<br />
<br />
[addterminus]<br />
123<br />
Endhaltestelle<br />
String 0 - Anzeige IBIS 1 (nur Großbuchstaben, maximal 16 Zeichen)<br />
String 1 - Anzeige ANNAX-Matrix obere Zeile (maximal 16-Zeichen)<br />
String 2 - Anzeige ANNAX-Matrix untere Zeile (maximal 16-Zeichen)<br />
String 3 - Anzeige Seiten-ANNAX-Matrix, wenn diese einzeilig ist (maximal 16-Zeichen)<br />
String 4 - Rollbandtextur (.tga-Datei)<br />
String 5 - Anzeige IBIS 2 (Groß- & Kleinbuchstaben, maximal 20-Zeichen)<br />
String 6 - Texturname für Steckschild (wenn Ziel in Matrix nicht darstellbar ist, <br />
oder nicht angezeigt werden soll)<br />
String 7 - Texturname für Bildanzeige in Krüger-Matrix (Krüger+)<br />
String 8 - Frontanzeige für ANNAX-Matrix (Groß- & Kleinbuchstaben, maximal 15-Zeichen)<br />
String 9 - Heckanzeige für ANNAX-Matrix (maximal 4-Zeichen)<br />
String 10 - IBIS-Code für Gegenroute für künftige Ikarus-Beschilderung (Ikarus 280.02)<br />
String 11 - Anziege für [http://www.omnibussimulator.de/forum/index.php?page=Thread&threadID=13846&pageNo=1| Busfanats-Vollmatrix] obere Zeile (oder Komplettanzeige, Wenn diese Zeile leer ist, <br />
wird String 1 ausgelesen)<br />
String 12 - Anzeige für [http://www.omnibussimulator.de/forum/index.php?page=Thread&threadID=13846&pageNo=1| Busfanats-Vollmatrix] untere Zeile (falls erforderlich, Wenn diese Zeile leer ist, <br />
wird String 2 ausgelesen)<br />
String 13 - Anzeige für Coopers Lawo-Matrix Front oben (bleibt dieser String leer, wird String 1 ausgelesen)<br />
String 14 - Anzeige für Coopers Lawo-Matrix Front unten (bleibt dieser String leer, wird String 13 ausgelesen)<br />
String 15 - Anzeige für Coopers Lawo-Matrix Seite oben (bleibt dieser String leer, wird String 16 ausgelesen)<br />
String 16 - Anzeige für Coopers Lawo-Matrix Seite unten (bleibt dieser String leer, wird String 15 ausgelesen)<br />
String 17 - IBIS-Anzeige für Niederflur-Busse aus den Wien-Add-Ons 1 und 2<br />
String 18 - MAN ÜL Vollmatrix oben<br />
String 19 - MAN ÜL Vollmatrix unten<br />
String 20 - MAN NL 2x3 Innenanzeige<br />
String 21 - MAN NL 2x3 Innenanzeige II (zeigt eine zusätzliche Information an [über])<br />
String 22 - Zusätzliche Heckanzeige für Coopers LAWO-Matrix, wenn Ziele keine Liniennummer haben (Betriebsfahrt)<br />
String 23 - einfache Krüger-Matrix oben<br />
String 24 - einfache Krüger-Matrix unten<br />
String 25 - Anzeigecode für das Ansagegerät im LU 200 / GU 240 aus Wien (Zwei Ziffern getrennt durch Leerzeichen)<br />
<br />
<br />
<br />
Bisher wurden folgende Busstop-Strings in der Hofdatei bis zum '''String 8''' erweitert und festgelegt:<br />
<br />
''Unter dem Befehl '''stringcount_busstop''' muss die Anzahl der Strings auf 9 gesetzt werden.''<br />
<br />
[addbusstop]<br />
Haltestelle<br />
String 0 - Anzeige IBIS 1 (nur Großbuchstaben, maximal 16 Zeichen)<br />
String 1 - Innenanzeige <br />
String 2 - Innenanzeige nach Umschaltung<br />
String 3 - IBIS 2 (Groß- & Kleinbuchstaben, 20 Zeichen)<br />
String 4 - Haltestellencode für die Ansagengeräte der Hochflurbusse aus den Wien-Add-Ons 1 und 2<br />
String 5 - Wabencode von iTram (aktuell im GSÜH 240 umgesetzt)<br />
String 6 - IBIS-Anzeige für Niederflur-Busse aus den Wien-Add-Ons 1 und 2<br />
String 7 - Ansagenlänge in Sekunden für IBIS-Geräte der Busse aus den Wien-Add-Ons 1 und 2<br />
String 8 - Innenanzeige für Niederflur-Busse aus den Wien-Add-Ons 1 und 2 <br />
(fixe Länge von 2x24 Zeichen (24 Zeichen (= Zeile 1), dann "@" und nochmals 24 Zeichen (= Zeile 2)))<br />
String 9 - weitere Strings wurden noch nicht festgelegt<br />
<br />
<br />
<br />
''Diese bereits zugewiesenen Strings sollten unbedingt beachtet werden, da es unsinnig ist, bereits veröffentlichte Scripte neu anzupassen - im Gegenteil ist es einfacher, neue Objekte und Systeme auf neue Strings anzupassen!''<br />
<br />
Hinweis zur LAWO-Matrix von Cooper: Diese Vollmatrix verwendet in erster Linie die Strings 13 bis 16. Es müßen aber<br />
nicht alle Felder ausgefüllt werden. Cooper hat hier gleich mehrere Möglichkeiten eingebaut um auf andere Strings<br />
ausweichen zu können.<br />
<br />
String 13 - bleibt dieser String leer, wird String 1 ausgelesen,<br />
String 14 - bleibt dieser String leer, wird String 13 ausgelesen,<br />
String 15 - bleibt dieser String leer, wird String 16 ausgelesen,<br />
String 16 - bleibt dieser String leer, wird String 15 ausgelesen,<br />
- Bleiben String 15 und 16 leer, werden die Strings 13 und 14 benutzt.<br />
<br />
Solange der String 13 benutzt wird, werden keine anderen Ersatzstrings verwendet. Bleiben aber alle für die<br />
Lawo-Matrix verwendeten Strings (also String 13 bis 16) leer, werden von der Lawo-Matrix, ersatzweise die<br />
String 1 bis 4 verwendet. Hier gibt es wieder mehrere Möglichkeiten Ersatzstrings zu benutzen:<br />
String 1 - bleibt dieser leer, wird String 2 ausgelesen,<br />
String 2 - bleibt dieser leer, wird String 1 ausgelesen,<br />
String 3 - bleibt dieser leer, wird String 4 ausgelesen,<br />
String 4 - bleibt dieser String leer oder wird ein Textureintrag mit der Dateiendung TGA eingetragen,<br />
wird String 3 ausgelesen.<br />
<br />
'''Mit dieser Variante hat man sogar die Möglichkeit ein Ziel in verscheidenen Varianten anzeigen zu lassen.'''<br />
----<br />
<br />
==== '''Zeichenlänge eines String''' ====<br />
<br />
Wie bereit's geschrieben, gibt es von Omsi keinerlei Begrenzung wie lang der Inhalt eines String sein darf. Auch die Hofdatei ansich (also Textdokument) setzt keine Längengrenze. Einige Anzeigen geben aber eine bestimmte Maximallänge, also eine maximale Anzahl von Zeichen vor. Benutzt man also zwei Anzeigen die eine unterschiedliche Zeichenanzahl zulassen und setzt diese auf einen String, wird eine Anzeige falsche Ergebnisse liefern. Als einfaches Beispiel kann man hier die beiden IBIS-Geräte nehmen, wie sie von M+R Software umgesetzt wurden.<br />
Während das IBIS 1 nur und ausschließlich Großbuchstaben verwendet und nur diese anzeigen kann, kann das IBIS 2 Groß- und Kleinbuchstaben verwenden. Dadurch ist auch die Anzahl an verwendbaren Zeichen begrenzt. Umlaute wie "Ä,Ö und Ü" fallen vollständig beim IBIS 1 raus (sowie auch das "ß").<br />
Die genaue Länge eines Strings ist einerseits in dem jeweiligen Script genau festgelegt und auch in der verwendeten Font. Das Script des IBIS 1 mit der verwendeten Font, läst insgesamt nur maximal 16 Zeichen zu. Dazu zählen alle in dem String verwendeten Zeichen, also Buchstaben, Zahlen, und Leerzeichen. Alles was nach den 16 Zeichen geschrieben wird, kann einfach im Display des IBIs 1 nicht angezeigt werden. Hat man als Beipiel einen Haltestellennamen der Länger als 16 Zeichen ist, werden nur maximal 16 Zeichen angezeigt:<br />
I N V A L I D E N S I E D L U N G<br />
Im IBIS 1 würde nun also der letzte Buchstabe fehlen. Um dies anständig anzeigen zu lassen, sollte man also die Anzeige kürzen<br />
I N V A L I D E N S I E D .<br />
Solch eine Abkürzung macht im IBIS 2 keinen Sinn, da dort Umlaute genauso angezeigt werden können, wie längere Haltestellennnamen:<br />
I n v a l i d e n s i e d l u n g<br />
Ein Kürzen ist hier in diesem Fall also nicht nötig. Entwickelt oder setzt jemand eine neue Anzeige um, die beispielsweise nur Großbuchstaben aber 18 Zeichen anzeigen kann, emfpielt sich die verwendung eines weiteren String. Oder man weicht vom Original ab. <br />
<br />
Um nun genau zu wissen, welche Strings man nun verwenden kann oder ob man neue verwenden muß, ist es sinnvoll es an den originalen Fahrzeugen von M+R Software zu testen. Auch die folgenden Strings die von Freewarefahrzeugen verwendet werden sollte man beachten.<br />
<br />
'''<br />
Wer sich nur an den von M+R Software vorgegebenen Standard hält und alle folgenden belegten Strigs mißachtet, <br />
kann auch ganz auf eine universelle Hofdatei verzichten, da der Sinn einer universellen Hofdatei definitiv <br />
nicht verstanden wurde.<br />
Wer also unbedingt nur die Standardfahrzeuge und ihre Strings beachtet und andere bereits vergebenen Strings <br />
ungeachtet läßt und diese sinnlos überschreibt, sollte sich unbedingt nochmal den Sinn und Zweck der <br />
universellen Hofdatei durchlesen. <br />
Ich habe jedem die Möglichkeit gegeben sich rechtzeitig bei mir zu melden, um weitere Strings zu vegeben. <br />
Einige haben diese Möglichkeit genutzt, wie Busfanat, Perotinus, iTram, Chrizzly92 und Cooper. Bekannte Payware-Hersteller habe <br />
ich vor Veröffentlichung dieses Artikels auch angeschrieben!<br />
Hier greift ganz klar das Sprichwort: " ''Wer zuerst kommt, malt zuerst.'' " und " ''Den letzten beißen die Hunde'' ". <br />
'''<br />
<br />
Nachfolgend nocheinmal einige Zeichenlängen für einige Anzeigen in Bussen:<br />
<br />
IBIS 1 = 16 Zeichen, nur Großbuchstaben (String 0)<br />
IBIS 2 = 20 Zeichen, Groß- & Kleinbuchstaben, Umlaute (String 5)<br />
ANNAX = 16 Zeichen in 2 Zeilen (String 1 und 2)<br />
Seiten-ANNAX = 16 Zeichen einzeilig (String 3)<br />
Ansagegerät im LU-200 = 2 Ziffern (String 4 in der Haltestellenliste)<br />
Innenanzeige SD 202 oder MAN NL/NG = 2x 20 Zeichen mit automatischer Umschaltung (String 1 und 2 <br />
in der Haltestellenliste)<br />
Vollmatrix, Die Zeichenlänge ist von der Form der Schrift (Font) und die Mitnutzung von Liniennummern abhängig.<br />
ANNAX-Matrix vom MB O307, O407 und MAN ÜL, Maximal 15 Zeichen incl. Liniennummer (String 8)<br />
ANNAX-Matrix am Heck des MB O307, O407, MAN ÜL maximal 4 Zeichen (String 9)<br />
LAWO-MATRIX am Heck von Modifizierten Bussen von Cooper, maximal 6 Zeichen (String 22)<br />
<br />
<br />
Die Zeichenanzahl in den unterschiedlichen Matrizen ist vom jeweilig verwendeten Font abhängig. Hier kann man keine festgelegte Zeichenanzahl angeben. Das selbe betrifft auch die Innenanzeige, wenn diese auf einer LED-Animation umgestellt wird. Auch dann entscheidet wieder die einzelne Zeichenlänge der Font die zu verwendete maximale Länge in den Innenanzeigegeräten. Auch die Krüger-Matrix vom MAN NL und NG von M+R Software sind nicht genau festgelegt, es sieht nur passender aus, wenn man hier die Anzahl der Dots beachtet.<br />
<br />
----<br />
<br />
==== '''Hinzufügen und erweitern von zusätzlichen Strings.''' ====<br />
<br />
Um weitere Strings einzubinden sollte man sich vorher überlegen:<br />
* Wieviele Strings brauche ich für die im Bus verwendete Frontanzeige?<br />
* Benötige ich seperate Strings für eine anders anzeigende Seitenanzeige?<br />
* Soll die Heckanzeige seperat und unabhängig der anderen Anzeigen, Informationen darstellen?<br />
* Brauche ich einen zusätzlichen Strings für ein im Bus verbautes Informationssteuergerät?<br />
* Können einige Anzeigeräte bereits vergebene Strings auslesen ohne das diese Strings angepasst oder geändert werden müßen?<br />
* Wie einigt man sich auf neue zusätzliche Strings.<br />
<br />
Man kann im offiziellen Omsi-Forum die künftige Verwendung neuer Strings ankündigen und diese in den Scripten des Fahrzeug's einstellen. Wer ganz sicher gehen möchte, kann sich im offiziellen Omsi-Forum an den User [http://www.omnibussimulator.de/forum/index.php?page=User&userID=1152| <<Tatra>> ], via PN wenden und die Verwendung weiterer Strings abklären. Oder via E-Mail an: e_marko@web.de - das gilt für neue und auch bereits erschienende Fahrzeuge.<br />
<br />
<br />
----<br />
<br />
<br />
=== '''Veränderungen in den BusScripten''' ===<br />
<br />
<br />
==== '''Welche Scripte betroffen sind''' ====<br />
<br />
Hauptsächlich finden sich die Änderungen, nur in zwei Scripten wieder. Zum einen muß das Auslesen des Zieles in den Scripten der Matrixanzeige stattfinden. Diese Scripte haben im Dateinamen meist den Präfix: ''Matrix'', ''Rollband`` oder ähnliches und die Dateiendung lautet immer auf osc.<br />
<br />
Zum anderen finden sich Änderungen in dem jeweils verbauten Informationssteuergerät wieder. Die Dateinamen der verwendeten Steuergeräte sind noch unterschiedlicher als bei der Matrix. Teilweise sind die Scripte zum Steuern der Informationsanlage mit den Fahrkartendruckern zusammengelegt, da es in einigen Bussen kombinierte IBIS-Fahrkartendrucker gibt, wie dem EFAD, INIT, Atron etc, muß man hier eventuell nach mehreren Präfixen suchen:<br />
* IBIS<br />
* IBIS_2<br />
* EFAD<br />
* Atron<br />
* Ticketprinter<br />
* Printer<br />
Aber auch hier lautet die Dateiändungen generell: osc.<br />
<br />
Die jeweils in den Bussen verbauten Informationssteuergeräten, steuern alle Informationsgeräte die es im Bus gibt, also nicht nur die äußeren Matrix-Anzeigegeräte, sondern auch die inneren Haltestellenanzeigen. In diesen dazugehörigen Scripten werden auch die jeweils benannten Strings angegeben, welche ausgelesen werden sollen.<br />
<br />
==== '''Die Befehle zum Auslesen bestimmter Strings.''' ====<br />
<br />
Zum Auslesen der entsprechenden Strings gibt es zwei Befehle:<br />
<br />
* ''(M.V.GetTerminusString)''<br />
Zum Auslesen eines bestimmten Strings aus der Endstellenliste (2.Bereich einer Hofdatei)'''[addterminus]'''<br />
<br />
* ''(M.V.GetBusstopString)''<br />
Zum Auslesen eines bestimmten Strings aus der Haltestellenliste (3.Bereich einer Hofdatei) '''[addbusstop]'''<br />
<br />
Nur diese beiden Befehle sind für das Auslesen eines bestimmten Strings zuständig. In diesem Bezug finden sich leider nicht immer die entsprechenden nummerierten String, was das umstellen sehr erschwert.<br />
<br />
<br />
==== '''Einstellungen zum Auslesen der Strings.''' ====<br />
<br />
Als Beispiele sollen hier die Stringeinstellungen im IBIS 1 des MAN SD 200 und des IBIS 2 des SD 202 dienen, sowie die Stringeinstellungen der ANNAX-Matrix.<br />
<br />
===== ''' IBIS 1 ''' =====<br />
<br />
Das IBIS 1 ließt den String 0 aus der Endstellenliste [addterminus]:<br />
<pre><br />
{macro:IBIS_RefreshTerminusText}<br />
(L.L.IBIS_TerminusIndex) 0 (M.V.GetTerminusString) (S.$.IBIS_terminus_name)<br />
{end}<br />
</pre><br />
und den String 0 aus der Haltestellenliste aus:<br />
<pre><br />
'Sonst zeige die Bushaltestelle<br />
(S.L.IBIS_busstop_index) 0 (M.V.GetBusstopString)<br />
(S.$.IBIS_busstop_name)<br />
</pre><br />
<br />
Die hier eingestellten Ziffern NULL, stehen für den String 0 in beiden Listen.<br />
<br />
===== ''' IBIS 2 ''' =====<br />
<br />
Für das IBIS 2 Gerät sind es zwei verschiedene Strings die ausgelesen werden. In der Endstellenliste ist es String 5:<br />
<pre><br />
{macro:IBIS_RefreshTerminusText}<br />
(L.L.IBIS_TerminusIndex) 5 (M.V.GetTerminusString) (S.$.IBIS_terminus_name)<br />
{end}<br />
</pre><br />
und String 3 in der Haltestellenliste:<br />
<pre><br />
'Sonst zeige die Bushaltestelle<br />
(L.L.IBIS_busstop_index) 3 (M.V.GetBusstopString)<br />
(S.$.IBIS_busstop_name)<br />
</pre><br />
Die hier gezeigten Ziffern 5 und 3 weisen auf die Strings hin, die die Information für das IBIS 2 Gerät enthält.<br />
<br />
===== '''Innenanzeige ''' =====<br />
<br />
Auch die Innenanzeige des MAN SD 202 (D92) ließt bestimmte Strings aus. Diese findet sich ausschließlich in der Haltestellenliste (3.Bereich) der Hofdatei. Da die Innenanzeige zwei unterschiedliche Informationen anzeigen kann, die im zeitlichen Interval umschaltet, finden sich dort natürlich 2 Strings:<br />
<pre><br />
{macro:IBIS_LCD-refresh}<br />
<br />
'Formatierung der D92-Innenanzeige<br />
<br />
(L.L.IBIS_LCD-zeile) 1 = <br />
(L.L.IBIS_busstop_index) 2 (M.V.GetBusstopString) $length 0 > &&<br />
{if}<br />
(L.L.IBIS_RouteIndex) 0 >=<br />
{if}<br />
(L.L.IBIS_LCD-zeile) <br />
(L.L.IBIS_busstop_index) 2 (M.V.GetBusstopString)<br />
(S.$.IBIS_cabindisplay)<br />
{endif}<br />
{else}<br />
(L.L.IBIS_RouteIndex) 0 >=<br />
{if}<br />
(L.L.IBIS_LCD-zeile) <br />
(L.L.IBIS_busstop_index) 1 (M.V.GetBusstopString) <br />
(S.$.IBIS_cabindisplay)<br />
{endif}<br />
{endif}<br />
{end}<br />
</pre><br />
Hier erkennt man, daß aus der Haltestellenliste zwei unterschiedliche Strings ausgelesen werden sollen. Für die Innenanzeige sind in der Hofdatei die String 1 und 2 vorgesehen.<br />
<br />
===== '''Rollbandanzeige ''' =====<br />
<br />
Für das Rollband gibt es nur einen String der ausgelesen werden soll:<br />
<pre><br />
'Aktualisierung der Strings für das Austauschen der Texturen:<br />
(L.L.rlbnd_ziel) trunc s0<br />
"..\..\Anzeigen\Rollband_SD79\" 1 (M.V.GetDepotStringGlobal) $+ "\" $+ (S.$.Rollband_Tex_H)<br />
l0 4 (M.V.GetTerminusString) $+ (S.$.Rollband_Tex_V)<br />
(L.$.Rollband_Tex_H) l0 1 + 4 (M.V.GetTerminusString) $+ (S.$.Rollband_Tex_H)<br />
<br />
'Internen Index aktualisieren:<br />
(M.L.rollband_refreshIntIndex)<br />
{endif}<br />
{endif}<br />
</pre><br />
Hier steht der String der ausgelesen werden soll, direkt vor dem Befehl (M.V.GetTerminusString) und zeigt auf den String 4. Für Rollbandbusse, sollte dieser String beibehalten werden (unabhängig von der Form der Rollbandtextur), da jeder Bus im Unterordner ''Anzeige'' seine eigene Rollbandtextur benutzt kann, wenn sich die Form der Textur von den Formen anderer Rollbandbusse unterscheidet. Bei bereits vorhandenen Maps, sollte man die Dateinamen der Rollbandtexturen, aus einer vorhandenen Hofdatei abschreiben. So ist gewährleistet, daß man keinen seperaten String benötigt, um die richtigen Texturen anzeigen zu lassen.<br />
Wichtig ist auch die Beachtung der verwendeten Dateiendungen.<br />
<br />
===== ''' ANNAX-Matrix ''' =====<br />
<br />
Damit auch die Außenanzeige (Matrix) die richtigen Strings ausließt, muß in der Scriptdatei ''matrix.osc'' oder einer ähnlich lautenden Datei, die Matrix auf die richtigen Strings gesetzt werden.<br />
<pre><br />
{if}<br />
"xxx" 30 random 1 (M.V.GetTerminusString) 10 $SetLengthL $+ "xxx" $+ "@" $+<br />
"xxx" 30 random 2 (M.V.GetTerminusString) 10 $SetLengthL $+ "xxx" $+ "@" $+ $+<br />
"xxx" 30 random 3 (M.V.GetTerminusString) 10 $SetLengthL $+ "xxx" $+ $+ <br />
(S.$.Matrix_NewTerminus) <br />
{else}<br />
"yxyxyxyxyxyxyxyx@xyxyxyxyx @zzzzzzzzzzzzzzzz" (S.$.Matrix_NewTerminus)<br />
{endif}<br />
</pre><br />
Bei den Bussen MAN SD 200 sowie SD 202, stehen diese Einträge zweimal drin. Und es gibt natürlich auch 3 Strings die Ausgelesen werden müßen. Die auszulesenden String stehen auch hier wieder direkt vor dem Befehl (M.V.GetTerminusString) und beziehen sich bei den MAN SD-Bussen auf die Drei verbauten Matrix-Zeilen.<br />
<br />
#String enthält die Information der oberen Zeile der Front-Anzeige (maximal 16 Zeichen),<br />
#String enthält die Information der unteren Zeile der Front-Anzeige (maximal 16 Zeichen), was eine erweiterung für die obere Zeile darstellt und<br />
#String befindet sich seitlich am Bus. Hier gibt es nur eine Zeile (maximal 16 Zeichen).<br />
Wenn sich die Seitenmatrix am Bus von der vorderen unterscheidet, sollte ein seperater String verwendet werden, da man auf der Front-Matrix mehr Informationen unterbringen kann als an der Seite.<br />
<br />
Die Verwendung des 3. Strings entfällt, wenn sich die Front-Anzeige und die Seiten-Anzeige gleichen. Dann werden für die Seiten-Anzeige ebendfalls die Strings 1 & 2 ausgelesen, damit das angezeigte Ziel identisch ist.<br />
<br />
===== ''' Steckschild ''' =====<br />
<br />
Für das Steckschild gilt der gleiche Befehl, aber abhängig vom verwendeten IBIS-Code. Soll statt einer Anzeige in der Matrix oder einer vewendeten Rollbandtextur, ein Steckschild in der Frontscheibe verwendet werden, Sollte der IBIS-Code in der Hofdatei 4-stellig sein. Also ein IBIScode größer als die Zahl 1.000, setzt den auszulesenden String um auf den String 6, wo sich die Texturname des Steckschildes befinden sollte, daß Verwendtet werden soll.<br />
<pre><br />
' Trigger für Steckschild<br />
<br />
{trigger:bus_matrix_change_steckschild}<br />
(L.L.matrix_steckschild_index) 1 + (S.L.matrix_steckschild_index)<br />
1000 + (M.V.GetTerminusIndex) (S.L.matrix_steckschild_Termindex)<br />
<br />
(M.L.matrix_setsteckschild)<br />
(M.L.matrix_refreshIntIndex)<br />
{end}<br />
<br />
{macro:matrix_setsteckschild}<br />
(L.L.matrix_steckschild_Termindex) s0<br />
0 >= <br />
{if}<br />
l0 6 (M.V.GetTerminusString) (S.$.Matrix_SchildFrnt)<br />
1 $SetLengthL $StrToFloat 1 max (S.L.matrix_steckschild_vis)<br />
"..\..\Anzeigen\SteckSchilder\" (L.$.Matrix_SchildFrnt) $+ (S.$.Matrix_SchildFrnt)<br />
{else}<br />
0 (S.L.matrix_steckschild_index) (S.L.matrix_steckschild_vis)<br />
"" (S.$.Matrix_SchildFrnt)<br />
{endif}<br />
{end}<br />
</pre><br />
Im oberen Bereich dieses Abschnittes, steht die Zahl 1000, was darauf hindeutet, daß das Steckschild verwendet werden soll. Im unteren Abschnitt folgenden dann der Verweis auf den String 6 für die richtige Textur des Steckschildes und darunter der Pfad, wo sich die Steckschilder befinden.<br />
<br />
<br />
----<br />
<br />
=== '''Auslesen von zusätzlichen String, mit der Möglichkeit von "Ersatz-Strings". ''Die Busfanat-Vollmatrix.'' ''' ===<br />
<br />
Der folgende Abschnitt ist von Busfanat erstellt worden und soll zeigen, wie man Ersatzstrings verwendet. Diese Möglichkeit kann in allen Bussen umgesetzt werden, solange diese, die Anzeigen einer ANNAX-Matrix sauber anzeigen können (für die BUSE-Vollmatrix ungeeignet).<br />
Während eine ANNAX-Matrix nur wenige Möglichkeiten bietet ein Ziel anzuzeigen, gibt es andere Anzeigen, die die Möglichkeit bieten, ein und das selbe Ziel unterschiedlich darzustellen. Eine Variante bietet die Krüger+ Anzeige. Hier kann statt eines Ziels das nur über Buchstaben verfügt, mittels Textur auch Zeichen dargestellt werden. Diese Anzeige verwendet dann den String 7 und beinhaltet ebenfalls einen Texturdateinamen.<br />
<br />
Eine andere, raffinierte Möglichkeit bietet die [http://www.omnibussimulator.de/forum/index.php?page=Thread&threadID=13846%7C| '''Busfanats-Vollmatrix''']. Diese beschränkt sich nicht nur auf 2 Strings, sondern bietet zusätzlich die Möglichkeit 2 originale Strings als Ersatz zu verwenden. <br />
Die [http://www.omnibussimulator.de/forum/index.php?page=Thread&threadID=13846%7C| '''Busfanats-Vollmatrix'''] ermöglicht Teile der Zielinformation besonders darzustellen, ohne Bildtexturen zu verwenden. Mit zusätzlichen Befehlen, hinter der Information kann ein Ziel Großgeschrieben oder Invertiert dargestellt werden. Diese Vollmatrix kann aber auch Ziele so darstellen, wie es die ANNAX-Anzeige ermöglicht. Dazu brauchen die String 1 und 2 nicht kopiert werden, da die [http://www.omnibussimulator.de/forum/index.php?page=Thread&threadID=13846%7C| '''Busfanats-Vollmatrix'''] diese String mitausließt.<br />
<br />
<br />
==== '''Grundlegende Funktion der ''Busfanat-Vollmatrix'' ''': ====<br />
<br />
<br />
Soll eine Ziel besonders dargestellt werden, schreibt man in String 11 und 12 das Ziel wie gewünscht ein und mittels Befehlen werden diese Ziele dann verändert.<br />
String 11: '''Bahnhof'''*B<br />
String 12: Kieselstein<br />
Hier wird das Wort "Bahnhof", dick geschrieben, während der "Kieselstein" normal dargestellt wird.<br />
String 11: '''Pause'''*I<br />
String 12:<br />
Hier wird das Wort "Pause" invertiert. Dabei erscheinen die Buchstaben dunkler als die umgebung, wo die Dot's erscheinen.<br />
<br />
<br />
==== ''' Die erweiterte Funktion der ''Busfanats-Vollmatrix''. ''' ====<br />
<br />
<br />
Wenn das gewünschte Ziel so angezeigt werden soll, wie in einer ANNAX-Matrix, bedarf es bei dieser Möglichkeit keinen besonderen Aufwand, da die [http://www.omnibussimulator.de/forum/index.php?page=Thread&threadID=13846%7C| '''Busfanats-Vollmatrix'''], die String 1 und 2 ebenfalls ausließt. Stehen in den Strings 11 und 12 Informationen drin, werden die Informationen aus den Strings 11 und 12 ausgelesen und dargestellt. Bleiben diese beiden String leer, werden die Informationen aus den Strings 1 & 2 ausgelesen und diese in der Matrix gezeigt.<br />
<br />
<pre><br />
' WENN die Zielanzeige wechseln soll<br />
(L.L.Matrix_TerminusIndex) 1 (M.V.GetTerminusString) (S.$.Matrix_Hofdatei_oben)<br />
(L.L.Matrix_TerminusIndex) 2 (M.V.GetTerminusString) (S.$.Matrix_Hofdatei_unten)<br />
(L.L.Matrix_TerminusIndex) 11 (M.V.GetTerminusString) "" $= !<br />
(L.L.Matrix_TerminusIndex) 12 (M.V.GetTerminusString) "" $= ! ||<br />
{if}<br />
(L.L.Matrix_TerminusIndex) 11 (M.V.GetTerminusString) (S.$.Matrix_Hofdatei_oben)<br />
(L.L.Matrix_TerminusIndex) 12 (M.V.GetTerminusString) (S.$.Matrix_Hofdatei_unten)<br />
{endif}<br />
</pre><br />
<br />
Zuerst ließt das Script der [http://www.omnibussimulator.de/forum/index.php?page=Thread&threadID=13846%7C| '''Busfanat-Vollmatrix'''] die Strings 1 und 2 aus. Bevor die Matrix die Anzeige umstellt, ließt das Script die Strings 11 und 12 aus der Hofdatei aus. Bleiben diese Zeilen leer, wird das zuerst eingelesene Ziel auf der Matrix dargestellt. Wenn aber in der Zeile 11 und 12 Informationen enthalten sind, werden die Informationen die zuerst aus den Strings 1 und 2 ausgelesen wurden, überschrieben und durch die neuen Informationen ersetzt.<br />
<br />
Weitere Informationen zur [http://www.omnibussimulator.de/forum/index.php?page=Thread&threadID=13846%7C| '''Busfanats-Vollmatrix'''], findet ihr im Omsi-Forum.<br />
<br />
<br />
<br />
----<br />
<br />
----<br />
<br />
== Quellen ==<br />
<br />
* [http://www.omnibussimulator.de/forum/index.php?page=Thread&threadID=13846| Busfanat-Vollmatrix],<br />
* Perotinus [http://www.omnibussimulator.de/forum/index.php?page=Thread&threadID=26274| MAN ÜL's], [http://www.omnibussimulator.de/forum/index.php?page=Thread&threadID=20384| MB O 307 Bahnbus], [http://www.omnibussimulator.de/forum/index.php?page=Thread&threadID=40032| MB O307 Bahnbus V2] und [http://www.omnibussimulator.de/forum/index.php?page=Thread&threadID=32580&highlight=| MB O407] <br />
* Hofdatei Spandau von M+R Software aus Omsi 1 & Omsi 2,<br />
* [http://omnibussimulator.de/| Offizielles Omsi-Forum],<br />
* [http://www.omnibussimulator.de/forum/index.php?page=Thread&threadID=31619| Gräf & Stift GSÜH 240 M12 von iTram].<br />
* [http://www.omnibussimulator.de/forum/index.php?page=Thread&threadID=35285| Grät & Stift Gemeinschaftsbusse von iTram].<br />
* [http://www.omnibussimulator.de/forum/index.php?page=Thread&postID=504330| Lawo-Matrix und Mod's von Cooper]<br />
<br />
== Einen herzlichen Dank ==<br />
geht an<br />
<br />
* Busfanat,<br />
* Perotinus,<br />
* Marcel Kuhnt,<br />
* Davidps,<br />
* Danny,<br />
* Nuorahino,<br />
* Janine,<br />
* Rumpelhans,<br />
* iTram,<br />
* Cooper,<br />
* Chrizzly92,<br />
* ViewApp,<br />
* Teneberus,<br />
<br />
=== Anhang ===<br />
<br />
Ich würde mich freuen, wenn man diese "universelle Hofdatei" wieder umsetzen könnte. Es ist wirklich keine neue Idee, da Marcel Kuhnt und Rüdiger Hülsmann, diese mit Omsi 1 schon richtig umgesetzt haben. Durch neue Busse, Maps und kompletten Add-On's wurden bereits vergebenen Strings überschrieben und die Hofdatei für speziell diese Busse umgeschrieben. Somit gibt es in Omsi heute für eine Map, mehrere verschiedene Hofdateien, die jeweils nur für eine Gruppe von Bussen passen.<br />
Für das einfache und schnelle Umsetzen einer ''universellen Hofdatei'' sollte besonders die Kommunikation verbessert werden, nicht nur zwischen den Usern, sondern besonders zwischen den Firmen die Add-On's herstellen. Leider war es mir in der Vergangenheit nicht möglich, den Kontakt zu einer Softwareschmiede herzustellen. Bei einer anderen Firma konnte ich Kontakt herstellen, aber eine Umsetzung wurde nicht angestrebt oder um Hilfe gebeten.<br />
Während einige User dem ganzen Thema der "universellen Hofdatei" offen gegenüber standen, reagierten Firmen garnicht oder zeigten sich uninteressiert.<br />
Wenn jemand eine universelle Hofdatei für sein Projekt umsetzen möchte, bin ich gern bereit, ohne irgendeiner Gegenleistung, Hilfe zu geben.<br />
Marcel Kuhnt und Janine stehen dieser Idee positiv gegenüber und unterstützten mich, hier das Thema Hofdatei zu veröffentlichen.<br />
Busfanat stellte die von ihm entwickelte Vollmatrix sehr schnell um. Auch Perotinus stellte seine neu erstellten Busse MAN ÜL nach Absprache und mit Hilfe von Busfanat und Cooper um. <br />
Die ersten Schritte sind damit getan und ich danke Busfanat, Cooper und Perotinus recht herzlich, für ihre großartige Mitarbeit und die Umsetzung. Und ich hoffe das es in Zukunft mehr Gehör findet um eine "universelle Hofdatei" umsetzen zu können. Denn diese dient allen und die Vorteile sollten, eigentlich überwiegen.<br />
<br />
<br />
<br />
geschrieben von <br />
[[Benutzer:Tatra|Tatra]]<br />
<br />
[[Kategorie:Tutorials für Addon-Entwickler]]</div>Marcel Kuhnthttp://wiki.omnibussimulator.de/omsiwikineu.de/index.php?title=Editor_-_%C3%9Cberblick&diff=913Editor - Überblick2014-03-06T09:23:11Z<p>Marcel Kuhnt: /* Begriffe */</p>
<hr />
<div>''Hinweis: Dieser Artikel wurde noch nicht ins Englische übersetzt!''<br />
<br />
''OMSI-Version: 1.0 - 2.0''<br />
<br />
Dieser Artikel liefert einen Überblick über alle Funktionen des OMSI-Mapeditors, geht dabei auch ins Detail, liefert aber keine einzelne Themen fokussierenden Tutorials zu einzelnen Themen.<br />
<br />
Da der Editor noch nicht fehlerfrei arbeitet und einige Funktionen (noch) nicht implementiert sind, werden auch nicht alle Kontrollelemente beschrieben.<br />
<br />
== Starten des Editors ==<br />
<br />
Um den Editor erreichen zu können, ist eine Verknüpfung z.B. auf dem Desktop zu kopieren. Dann ist darauf mit rechts zu klicken und "Eigenschaften" auszuwählen. Der Pfad im Feld "Ziel" ist um den Parameter ''-editor'' zu ergänzen. Diese Verknüpfung dient fortan dem Starten des Mapeditors.<br />
<br />
== Begriffe ==<br />
<br />
{| class="wikitable" style="font-size:95%;" <br />
|- class="hintergrundfarbe5"<br />
| align="left" |''Begriff (engl.)''<br />
| align="left" |''Begriff (dt.)''<br />
| align="left" |''Beschreibung''<br />
|-<br />
| align="left" |Tile<br />
| align="left" |Kachel<br />
| align="left" |Die Karte besteht aus zahlreichen quadratischen Kacheln. Auf Karten mit klassischen kartesischen Koordinaten haben alle Kacheln eine Kantenlänge von 300m, handelt es sich um eine Weltkoordinaten-Karte, dann schwankt die Kantenlänge in Abhängigkeit von der geographischen Breite (s.u.).<br />
|-<br />
| align="left" |Terrain<br />
| align="left" |Gelände<br />
| align="left" |Üblicherweise wird die engl. Bezeichnung ''Terrain'' gewählt. Beim Terrain handelt es sich um den Untergrund. Es handelt sich hierbei um ein Raster von 60 mal 60 Quadraten, deren Eckpunkte nach Belieben angehoben oder gesenkt werden können, wodurch Berge, Hügel oder Mulden usw. geformt werden können. Außerdem können Splines und Objekte je nach deren Eigenschaften Löcher in das Terrain schneiden. Darüber hinaus kann das Terrain mit farblichen Strukturen versehen werden.<br />
|-<br />
| align="left" |Spline<br />
| align="left" |-<br />
| align="left" |Ein in einer *.sli-Datei gespeichertes Profil wird entlang einer geraden oder gebogenen Linie extrudiert. Auf diese Weise entstehen bspw. Straßen, Gleise und Zäune in OMSI, die direkt im Map-Editor in ihrer Länge und Biegung geformt und zu längeren Verbänden aneinandergehängt werden können.<br />
|-<br />
| align="left" |DEM<br />
| align="left" |DEM<br />
| align="left" |DEM bedeutet "Digital Elevation Mesh" und steht auch stellvertretend für Datensätze, welche reale Geländeformen und -höhen beschreiben.<br />
|}<br />
<br />
== Registerkarten ==<br />
<br />
Die Editorfunktionen werden gruppiert nach den entsprechenden Registerkarten am rechten Rand erläutert.<br />
<br />
=== Tile ===<br />
<br />
==== Create New Tile Here ====<br />
<br />
Sobald der Sichtmittelpunkt auf einen Bereich außerhalb der Karte gesetzt ist, wird dieser Button aktiv und erlaubt die Erweiterung der Karte um eine Kachel an dieser Stelle.<br />
<br />
==== Add Water / Remove Water ====<br />
<br />
Stattet die Kachel mit einer Wasserebene aus. Wasserebenen können auf der Registerkarte "Terrain" in ihrer Höhe verändert werden. Normalerweise liegt das Terrain über der Wasserfläche - sobald das Terrain unter das Wasser taucht, entsteht ein See oder Fluss.<br />
<br />
==== Aerial Download (ab OMSI 2) ====<br />
<br />
Sofern die Karte mit Weltkoordinaten arbeitet, können in diesem Bereich Luftbilder heruntergeladen und angezeigt werden.<br />
<br />
Bereits heruntergeladene Luftbilder werden angezeigt, sobald der Haken "Use tile aerials" gesetzt wird.<br />
<br />
Heruntergeladen werden können Luftbilder, wenn der folgende Eintrag mit einem funktionierenden Download-Link in die Options.cfg eingetragen wird, wobei ~x, ~y und ~z für die drei Koordinaten x, y und Zoom stehen:<br />
<br />
<pre><br />
[Editor_LinkAerial]<br />
http:www.dummy.de&x=~x&y=~y&z=~z<br />
</pre><br />
<br />
Dann fokussiert man die Sicht auf die Kachel, für welche das Luftbild heruntergeladen werden soll, stellt den Schieberegler "Resolution" auf den gewünschten Wert und klickt auf "Dnl. current Tile".<br />
<br />
==== DEM (ab OMSI 2) ====<br />
<br />
Im Bereich DEM können reale Höhendaten importiert werden, sofern die Karte Weltkoordinaten nutzt. Hierfür ist zunächst die zugehörige DLL auszuwählen und der Vorgang mit "Rund curr. Tile" für die aktuell fokussierte Kachel auszuführen.<br />
<br />
Standardmäßig liefert OMSI eine Import-DLL für freie SRTM-Daten mit, welche in *.hgt-Dateien im Ordner \SRTM\Data hinterlegt sein müssen. Die Dateien für das Grad-Quadrat N46 und E7 bzw. N52 E13 ist bereits in OMSI hinterlegt.<br />
<br />
Der DEM-Import für OMSI läuft über DLLs, damit beliebige DEM-Importvarianten frei programmiert werden können (übrigens auch generisch-zufällige, sofern gewünscht!).<br />
<br />
Siehe hierzu: [[DEM-Import-DLLs selbst programmieren]]<br />
<br />
==== Create Roadmap ====<br />
<br />
Eine noch nicht ganz ausgereifte Funktion erlaubt es, eine zweidimensionale Landkarte der Karte zu erstellen, welche im Unterordner "texture\map" der Karte abgespeichert wird: Einerseits kachelweise mit 256 Pixel Kantenlänge, andererseits als Gesamtkarte mit 128 Pixeln Kantenlänge je Kachel.<br />
<br />
==== Convert into x terrain ====<br />
<br />
Mit dieser Funktion kann die aktuell fokussierte Kachel in eine x-Datei exportiert werden - bspw. um ein komplexeres Objekt mit starker Abhängigkeit zum Boden genau erstellen zu können. Allerdings ist zu beachten, dass die exportierte x-Datei noch nicht für den Import in Blender optimiert ist und insbesondere die Koordinaten noch vertauscht sind.<br />
<br />
=== Objects ===<br />
<br />
Der Wechsel auf diese Registerkarte aktiviert die Objektbearbeitung in OMSI.<br />
<br />
==== All Objects on Tile Nr. # ====<br />
<br />
Ganz oben auf der Registerkarte findet sich ein Dropdown-Feld, über welches alle Objekte der aktuellen Kachel ausgewählt werden können. Andernfalls kann ein Objekt auch ausgewählt werden, indem es mit der Maus angeklickt wird. Es wechselt dann seine Farbe auf rot.<br />
<br />
==== Actual Object Types ====<br />
<br />
Die Baumstruktur zeigt alle bisher geladenen Objekttypen an. Wenn man sich auf der Karte bewegt und hierbei weitere Objekttypen auftreten, wird die Struktur entsprechend ergänzt. Es können aber auch weitere, bisher nicht verwendete Objekte hinzugefügt werden:<br />
<br />
''Load....'' ermöglicht es, gezielt ein Objekt auszuwählen, ''Load directory!'' lädt den Inhalt eines ganzen Objektordners.<br />
<br />
Ist ein Objekt ausgewählt (rot), dann wechselt der Objekttyp, sobald man in der Baumstruktur ein anderes Objekt ausgewählt hat. Andernfalls wird lediglich ein Objekttyp vorgewählt, welcher beim Erstellen eines neuen Objektes verwendet wird.<br />
<br />
Ist ''Random'' gesetzt, dann wird beim Neuerstellen eines Objektes nicht das ausgewählte Objekt gewählt, sondern ein zufälliges aus derselben Gruppe. Sehr praktisch ist diese Funktion insbesondere beim Platzieren von zufälligen Bäumen oder Häusern.<br />
<br />
==== Objekte bewegen, rotieren, löschen und neu erstellen ====<br />
<br />
Dies geschieht über folgende Tastenkombinationen:<br />
<br />
'''G''' ''(grab)'' ermöglicht es, das selektierte Objekt zu bewegen. ''Enter'' oder ein Klick mit der linken Maustaste bestätigt den Vorgang, ''Esc'' bricht ihn ab.<br />
<br />
'''R''' erlaubt das Rotieren von Objekten<br />
<br />
'''N''' erstellt ein neues Objekt und wechselt automatisch in den Bewegungs-Modus<br />
<br />
'''Entf''' löscht das selektierte Objekt.<br />
<br />
==== Object Properties ====<br />
<br />
In diesen Feldern können die zahlreichen Eigenschaften der Objekte eingestellt werden. Die Textfelder wechseln nach einer Eingabe automatisch in den Bearbeitungsmodus und färben sich blau. Der Modus kann abgebrochen werden und die neuen Werte verworfen werden, indem auf ''Esc'' gedrückt wird. Sollen die Werte angewendet werden, ist ''Enter'' zu drücken.<br />
<br />
===== x, y, z und rot, pitch und bank =====<br />
<br />
Hier können numerisch exakte Werte für die drei Koordinaten und die Rotation eingegeben werden. ''Pitch'' und ''Bank'' entsprechen den Neigungen ''nicken'' und ''rollen''.<br />
<br />
===== Attach to Object... =====<br />
<br />
Infolge muss ein Objekt angeklickt werden, was über Anknüpfpunkte, auf engl. Attachpoints verfügt. Dann wird das selektierte Objekt an das angeklickte angehängt und folgt diesem bei weiteren Veränderungen.<br />
<br />
''AttPntNr'' wählt aus, an welchen Attachpoint das Objekt angehängt werden soll - falls mehrere Attachpoints existieren, wie bspw. bei den Haltestellen-Fahnen für die Linienkärtchen.<br />
<br />
===== ~ to Spline ... =====<br />
<br />
Objekte können ebenfalls an Splines angehängt werden - typisches Beispiel sind Straßenlaternen. Hierzu ist nach Anklicken der Schaltfläche eine Spline anzuklicken. Das Objekt wird nun entlang der Spline bewegt und es kann ganz normal mit ''Enter''/linker Maustaste und ''Esc'' verfahren werden.<br />
<br />
Darüber hinaus ist es möglich, dass mehrere Instanzen des Objekts entlang der Spline platziert werden. Hierzu ist das Intervall (''Distance'') und die Gesamtentfernung (''Range'') einzugeben.<br />
<br />
''Tangential to spline'' ermöglicht es, dass die Objekte auch gemäß der Splineoberfläche geneigt werden, bspw. bei parkenden Autos auf einer steigenden oder überhöhten Straße.<br />
<br />
===== Auto Rot. All =====<br />
<br />
... ermöglicht das zufällige Rotieren sämtlicher Objekte dieses Typs<br />
<br />
===== Parent to... =====<br />
<br />
Es ist ein weiteres Objekt zu markieren, welches dann zum "Elternobjekt" bzgl. der Scriptvariablen wird. Diese Funktion wird insbesondere bei Ampeln benötigt: Jede Ampel wird auf diese Weise mit "ihrer" Kreuzung verknüpft.<br />
<br />
===== Beschriftung / Optionen =====<br />
<br />
Je nach Objekttyp wechselt die Beschriftung der Schaltfläche. In jedem Fall erscheint ein Dialogfeld, mit welchem die Beschriftungen (bei normalen Objekten mit Textfeldern) oder die Optionen (bei speziellen Objekten wie Bushaltestellen) eingestellt werden können.<br />
<br />
== Weltkoordinaten ==<br />
<br />
Bei aktivierten Weltkoordinaten verwendet OMSI die Mercator-Projektion und unterteilt die 360° entlang der West-Ost-Richtung in 2^16 (65536) Teile. Am Äquator (40075016,69m) beträgt die Kantenlänge der Kacheln dementsprechend 611,5m, auf 50° 393,1m und am Pol theoretisch 0m (allerdings ist der Pol mit OMSI nicht erreichbar). Weitere Werte entnehmen Sie bitte der folgenden Tabelle:<br />
<br />
{| class="wikitable" style="font-size:95%;" <br />
|- class="hintergrundfarbe5"<br />
| align="left" |''geograph. Breite''<br />
| align="left" |''Kantenlänge (m)''<br />
|-<br />
| align="left" |0°<br />
| align="left" |611,496<br />
|-<br />
| align="left" |±10°<br />
| align="left" |602,206<br />
|-<br />
| align="left" |±20°<br />
| align="left" |574,618<br />
|-<br />
| align="left" |±30°<br />
| align="left" |529,571<br />
|-<br />
| align="left" |±40°<br />
| align="left" |468,433<br />
|-<br />
| align="left" |±50°<br />
| align="left" |393,062<br />
|-<br />
| align="left" |±60°<br />
| align="left" |305,748<br />
|-<br />
| align="left" |±70°<br />
| align="left" |209,144<br />
|}<br />
<br />
[[Kategorie:Nachschlagewerk für Addon-Entwickler]]</div>Marcel Kuhnthttp://wiki.omnibussimulator.de/omsiwikineu.de/index.php?title=Editor_-_%C3%9Cberblick&diff=912Editor - Überblick2014-03-06T09:22:54Z<p>Marcel Kuhnt: /* Object Properties */</p>
<hr />
<div>''Hinweis: Dieser Artikel wurde noch nicht ins Englische übersetzt!''<br />
<br />
''OMSI-Version: 1.0 - 2.0''<br />
<br />
Dieser Artikel liefert einen Überblick über alle Funktionen des OMSI-Mapeditors, geht dabei auch ins Detail, liefert aber keine einzelne Themen fokussierenden Tutorials zu einzelnen Themen.<br />
<br />
Da der Editor noch nicht fehlerfrei arbeitet und einige Funktionen (noch) nicht implementiert sind, werden auch nicht alle Kontrollelemente beschrieben.<br />
<br />
== Starten des Editors ==<br />
<br />
Um den Editor erreichen zu können, ist eine Verknüpfung z.B. auf dem Desktop zu kopieren. Dann ist darauf mit rechts zu klicken und "Eigenschaften" auszuwählen. Der Pfad im Feld "Ziel" ist um den Parameter ''-editor'' zu ergänzen. Diese Verknüpfung dient fortan dem Starten des Mapeditors.<br />
<br />
== Begriffe ==<br />
<br />
{| class="wikitable" style="font-size:95%;" <br />
|- class="hintergrundfarbe5"<br />
| align="left" |''Begriff (engl.)''<br />
| align="left" |''Begriff (dt.)''<br />
| align="left" |''Beschreibung''<br />
|-<br />
| align="left" |Tile<br />
| align="left" |Kachel<br />
| align="left" |Die Karte besteht aus zahlreichen quadratischen Kacheln. Auf Karten mit klassischen kartesischen Koordinaten haben alle Kacheln eine Kantenlänge von 300m, handelt es sich um eine Weltkoordinaten-Karte, dann schwankt die Kantenlänge in Abhängigkeit von der geographischen Breite (s.u.).<br />
|-<br />
| align="left" |Terrain<br />
| align="left" |Gelände<br />
| align="left" |Üblicherweise wird die engl. Bezeichnung ''Terrain'' gewählt. Beim Terrain handelt es sich um den Untergrund. Es handelt sich hierbei um ein Raster von 60 mal 60 Quadraten, deren Eckpunkte nach Belieben angehoben oder gesenkt werden können, wodurch Berge, Hügel oder Mulden usw. geformt werden können. Außerdem können Splines und Objekte je nach deren Eigenschaften Löcher in das Terrain schneiden. Darüber hinaus kann das Terrain mit farblichen Strukturen versehen werden.<br />
|-<br />
| align="left" |Spline<br />
| align="left" |-<br />
| align="left" |Ein in einer *.spi-Datei gespeichertes Profil wird entlang einer geraden oder gebogenen Linie extrudiert. Auf diese Weise entstehen bspw. Straßen, Gleise und Zäune in OMSI, die direkt im Map-Editor in ihrer Länge und Biegung geformt und zu längeren Verbänden aneinandergehängt werden können.<br />
|-<br />
| align="left" |DEM<br />
| align="left" |DEM<br />
| align="left" |DEM bedeutet "Digital Elevation Mesh" und steht auch stellvertretend für Datensätze, welche reale Geländeformen und -höhen beschreiben.<br />
|}<br />
<br />
== Registerkarten ==<br />
<br />
Die Editorfunktionen werden gruppiert nach den entsprechenden Registerkarten am rechten Rand erläutert.<br />
<br />
=== Tile ===<br />
<br />
==== Create New Tile Here ====<br />
<br />
Sobald der Sichtmittelpunkt auf einen Bereich außerhalb der Karte gesetzt ist, wird dieser Button aktiv und erlaubt die Erweiterung der Karte um eine Kachel an dieser Stelle.<br />
<br />
==== Add Water / Remove Water ====<br />
<br />
Stattet die Kachel mit einer Wasserebene aus. Wasserebenen können auf der Registerkarte "Terrain" in ihrer Höhe verändert werden. Normalerweise liegt das Terrain über der Wasserfläche - sobald das Terrain unter das Wasser taucht, entsteht ein See oder Fluss.<br />
<br />
==== Aerial Download (ab OMSI 2) ====<br />
<br />
Sofern die Karte mit Weltkoordinaten arbeitet, können in diesem Bereich Luftbilder heruntergeladen und angezeigt werden.<br />
<br />
Bereits heruntergeladene Luftbilder werden angezeigt, sobald der Haken "Use tile aerials" gesetzt wird.<br />
<br />
Heruntergeladen werden können Luftbilder, wenn der folgende Eintrag mit einem funktionierenden Download-Link in die Options.cfg eingetragen wird, wobei ~x, ~y und ~z für die drei Koordinaten x, y und Zoom stehen:<br />
<br />
<pre><br />
[Editor_LinkAerial]<br />
http:www.dummy.de&x=~x&y=~y&z=~z<br />
</pre><br />
<br />
Dann fokussiert man die Sicht auf die Kachel, für welche das Luftbild heruntergeladen werden soll, stellt den Schieberegler "Resolution" auf den gewünschten Wert und klickt auf "Dnl. current Tile".<br />
<br />
==== DEM (ab OMSI 2) ====<br />
<br />
Im Bereich DEM können reale Höhendaten importiert werden, sofern die Karte Weltkoordinaten nutzt. Hierfür ist zunächst die zugehörige DLL auszuwählen und der Vorgang mit "Rund curr. Tile" für die aktuell fokussierte Kachel auszuführen.<br />
<br />
Standardmäßig liefert OMSI eine Import-DLL für freie SRTM-Daten mit, welche in *.hgt-Dateien im Ordner \SRTM\Data hinterlegt sein müssen. Die Dateien für das Grad-Quadrat N46 und E7 bzw. N52 E13 ist bereits in OMSI hinterlegt.<br />
<br />
Der DEM-Import für OMSI läuft über DLLs, damit beliebige DEM-Importvarianten frei programmiert werden können (übrigens auch generisch-zufällige, sofern gewünscht!).<br />
<br />
Siehe hierzu: [[DEM-Import-DLLs selbst programmieren]]<br />
<br />
==== Create Roadmap ====<br />
<br />
Eine noch nicht ganz ausgereifte Funktion erlaubt es, eine zweidimensionale Landkarte der Karte zu erstellen, welche im Unterordner "texture\map" der Karte abgespeichert wird: Einerseits kachelweise mit 256 Pixel Kantenlänge, andererseits als Gesamtkarte mit 128 Pixeln Kantenlänge je Kachel.<br />
<br />
==== Convert into x terrain ====<br />
<br />
Mit dieser Funktion kann die aktuell fokussierte Kachel in eine x-Datei exportiert werden - bspw. um ein komplexeres Objekt mit starker Abhängigkeit zum Boden genau erstellen zu können. Allerdings ist zu beachten, dass die exportierte x-Datei noch nicht für den Import in Blender optimiert ist und insbesondere die Koordinaten noch vertauscht sind.<br />
<br />
=== Objects ===<br />
<br />
Der Wechsel auf diese Registerkarte aktiviert die Objektbearbeitung in OMSI.<br />
<br />
==== All Objects on Tile Nr. # ====<br />
<br />
Ganz oben auf der Registerkarte findet sich ein Dropdown-Feld, über welches alle Objekte der aktuellen Kachel ausgewählt werden können. Andernfalls kann ein Objekt auch ausgewählt werden, indem es mit der Maus angeklickt wird. Es wechselt dann seine Farbe auf rot.<br />
<br />
==== Actual Object Types ====<br />
<br />
Die Baumstruktur zeigt alle bisher geladenen Objekttypen an. Wenn man sich auf der Karte bewegt und hierbei weitere Objekttypen auftreten, wird die Struktur entsprechend ergänzt. Es können aber auch weitere, bisher nicht verwendete Objekte hinzugefügt werden:<br />
<br />
''Load....'' ermöglicht es, gezielt ein Objekt auszuwählen, ''Load directory!'' lädt den Inhalt eines ganzen Objektordners.<br />
<br />
Ist ein Objekt ausgewählt (rot), dann wechselt der Objekttyp, sobald man in der Baumstruktur ein anderes Objekt ausgewählt hat. Andernfalls wird lediglich ein Objekttyp vorgewählt, welcher beim Erstellen eines neuen Objektes verwendet wird.<br />
<br />
Ist ''Random'' gesetzt, dann wird beim Neuerstellen eines Objektes nicht das ausgewählte Objekt gewählt, sondern ein zufälliges aus derselben Gruppe. Sehr praktisch ist diese Funktion insbesondere beim Platzieren von zufälligen Bäumen oder Häusern.<br />
<br />
==== Objekte bewegen, rotieren, löschen und neu erstellen ====<br />
<br />
Dies geschieht über folgende Tastenkombinationen:<br />
<br />
'''G''' ''(grab)'' ermöglicht es, das selektierte Objekt zu bewegen. ''Enter'' oder ein Klick mit der linken Maustaste bestätigt den Vorgang, ''Esc'' bricht ihn ab.<br />
<br />
'''R''' erlaubt das Rotieren von Objekten<br />
<br />
'''N''' erstellt ein neues Objekt und wechselt automatisch in den Bewegungs-Modus<br />
<br />
'''Entf''' löscht das selektierte Objekt.<br />
<br />
==== Object Properties ====<br />
<br />
In diesen Feldern können die zahlreichen Eigenschaften der Objekte eingestellt werden. Die Textfelder wechseln nach einer Eingabe automatisch in den Bearbeitungsmodus und färben sich blau. Der Modus kann abgebrochen werden und die neuen Werte verworfen werden, indem auf ''Esc'' gedrückt wird. Sollen die Werte angewendet werden, ist ''Enter'' zu drücken.<br />
<br />
===== x, y, z und rot, pitch und bank =====<br />
<br />
Hier können numerisch exakte Werte für die drei Koordinaten und die Rotation eingegeben werden. ''Pitch'' und ''Bank'' entsprechen den Neigungen ''nicken'' und ''rollen''.<br />
<br />
===== Attach to Object... =====<br />
<br />
Infolge muss ein Objekt angeklickt werden, was über Anknüpfpunkte, auf engl. Attachpoints verfügt. Dann wird das selektierte Objekt an das angeklickte angehängt und folgt diesem bei weiteren Veränderungen.<br />
<br />
''AttPntNr'' wählt aus, an welchen Attachpoint das Objekt angehängt werden soll - falls mehrere Attachpoints existieren, wie bspw. bei den Haltestellen-Fahnen für die Linienkärtchen.<br />
<br />
===== ~ to Spline ... =====<br />
<br />
Objekte können ebenfalls an Splines angehängt werden - typisches Beispiel sind Straßenlaternen. Hierzu ist nach Anklicken der Schaltfläche eine Spline anzuklicken. Das Objekt wird nun entlang der Spline bewegt und es kann ganz normal mit ''Enter''/linker Maustaste und ''Esc'' verfahren werden.<br />
<br />
Darüber hinaus ist es möglich, dass mehrere Instanzen des Objekts entlang der Spline platziert werden. Hierzu ist das Intervall (''Distance'') und die Gesamtentfernung (''Range'') einzugeben.<br />
<br />
''Tangential to spline'' ermöglicht es, dass die Objekte auch gemäß der Splineoberfläche geneigt werden, bspw. bei parkenden Autos auf einer steigenden oder überhöhten Straße.<br />
<br />
===== Auto Rot. All =====<br />
<br />
... ermöglicht das zufällige Rotieren sämtlicher Objekte dieses Typs<br />
<br />
===== Parent to... =====<br />
<br />
Es ist ein weiteres Objekt zu markieren, welches dann zum "Elternobjekt" bzgl. der Scriptvariablen wird. Diese Funktion wird insbesondere bei Ampeln benötigt: Jede Ampel wird auf diese Weise mit "ihrer" Kreuzung verknüpft.<br />
<br />
===== Beschriftung / Optionen =====<br />
<br />
Je nach Objekttyp wechselt die Beschriftung der Schaltfläche. In jedem Fall erscheint ein Dialogfeld, mit welchem die Beschriftungen (bei normalen Objekten mit Textfeldern) oder die Optionen (bei speziellen Objekten wie Bushaltestellen) eingestellt werden können.<br />
<br />
== Weltkoordinaten ==<br />
<br />
Bei aktivierten Weltkoordinaten verwendet OMSI die Mercator-Projektion und unterteilt die 360° entlang der West-Ost-Richtung in 2^16 (65536) Teile. Am Äquator (40075016,69m) beträgt die Kantenlänge der Kacheln dementsprechend 611,5m, auf 50° 393,1m und am Pol theoretisch 0m (allerdings ist der Pol mit OMSI nicht erreichbar). Weitere Werte entnehmen Sie bitte der folgenden Tabelle:<br />
<br />
{| class="wikitable" style="font-size:95%;" <br />
|- class="hintergrundfarbe5"<br />
| align="left" |''geograph. Breite''<br />
| align="left" |''Kantenlänge (m)''<br />
|-<br />
| align="left" |0°<br />
| align="left" |611,496<br />
|-<br />
| align="left" |±10°<br />
| align="left" |602,206<br />
|-<br />
| align="left" |±20°<br />
| align="left" |574,618<br />
|-<br />
| align="left" |±30°<br />
| align="left" |529,571<br />
|-<br />
| align="left" |±40°<br />
| align="left" |468,433<br />
|-<br />
| align="left" |±50°<br />
| align="left" |393,062<br />
|-<br />
| align="left" |±60°<br />
| align="left" |305,748<br />
|-<br />
| align="left" |±70°<br />
| align="left" |209,144<br />
|}<br />
<br />
[[Kategorie:Nachschlagewerk für Addon-Entwickler]]</div>Marcel Kuhnthttp://wiki.omnibussimulator.de/omsiwikineu.de/index.php?title=Editor_-_%C3%9Cberblick&diff=911Editor - Überblick2014-03-05T11:55:18Z<p>Marcel Kuhnt: /* Object Properties */</p>
<hr />
<div>''Hinweis: Dieser Artikel wurde noch nicht ins Englische übersetzt!''<br />
<br />
''OMSI-Version: 1.0 - 2.0''<br />
<br />
Dieser Artikel liefert einen Überblick über alle Funktionen des OMSI-Mapeditors, geht dabei auch ins Detail, liefert aber keine einzelne Themen fokussierenden Tutorials zu einzelnen Themen.<br />
<br />
Da der Editor noch nicht fehlerfrei arbeitet und einige Funktionen (noch) nicht implementiert sind, werden auch nicht alle Kontrollelemente beschrieben.<br />
<br />
== Starten des Editors ==<br />
<br />
Um den Editor erreichen zu können, ist eine Verknüpfung z.B. auf dem Desktop zu kopieren. Dann ist darauf mit rechts zu klicken und "Eigenschaften" auszuwählen. Der Pfad im Feld "Ziel" ist um den Parameter ''-editor'' zu ergänzen. Diese Verknüpfung dient fortan dem Starten des Mapeditors.<br />
<br />
== Begriffe ==<br />
<br />
{| class="wikitable" style="font-size:95%;" <br />
|- class="hintergrundfarbe5"<br />
| align="left" |''Begriff (engl.)''<br />
| align="left" |''Begriff (dt.)''<br />
| align="left" |''Beschreibung''<br />
|-<br />
| align="left" |Tile<br />
| align="left" |Kachel<br />
| align="left" |Die Karte besteht aus zahlreichen quadratischen Kacheln. Auf Karten mit klassischen kartesischen Koordinaten haben alle Kacheln eine Kantenlänge von 300m, handelt es sich um eine Weltkoordinaten-Karte, dann schwankt die Kantenlänge in Abhängigkeit von der geographischen Breite (s.u.).<br />
|-<br />
| align="left" |Terrain<br />
| align="left" |Gelände<br />
| align="left" |Üblicherweise wird die engl. Bezeichnung ''Terrain'' gewählt. Beim Terrain handelt es sich um den Untergrund. Es handelt sich hierbei um ein Raster von 60 mal 60 Quadraten, deren Eckpunkte nach Belieben angehoben oder gesenkt werden können, wodurch Berge, Hügel oder Mulden usw. geformt werden können. Außerdem können Splines und Objekte je nach deren Eigenschaften Löcher in das Terrain schneiden. Darüber hinaus kann das Terrain mit farblichen Strukturen versehen werden.<br />
|-<br />
| align="left" |Spline<br />
| align="left" |-<br />
| align="left" |Ein in einer *.spi-Datei gespeichertes Profil wird entlang einer geraden oder gebogenen Linie extrudiert. Auf diese Weise entstehen bspw. Straßen, Gleise und Zäune in OMSI, die direkt im Map-Editor in ihrer Länge und Biegung geformt und zu längeren Verbänden aneinandergehängt werden können.<br />
|-<br />
| align="left" |DEM<br />
| align="left" |DEM<br />
| align="left" |DEM bedeutet "Digital Elevation Mesh" und steht auch stellvertretend für Datensätze, welche reale Geländeformen und -höhen beschreiben.<br />
|}<br />
<br />
== Registerkarten ==<br />
<br />
Die Editorfunktionen werden gruppiert nach den entsprechenden Registerkarten am rechten Rand erläutert.<br />
<br />
=== Tile ===<br />
<br />
==== Create New Tile Here ====<br />
<br />
Sobald der Sichtmittelpunkt auf einen Bereich außerhalb der Karte gesetzt ist, wird dieser Button aktiv und erlaubt die Erweiterung der Karte um eine Kachel an dieser Stelle.<br />
<br />
==== Add Water / Remove Water ====<br />
<br />
Stattet die Kachel mit einer Wasserebene aus. Wasserebenen können auf der Registerkarte "Terrain" in ihrer Höhe verändert werden. Normalerweise liegt das Terrain über der Wasserfläche - sobald das Terrain unter das Wasser taucht, entsteht ein See oder Fluss.<br />
<br />
==== Aerial Download (ab OMSI 2) ====<br />
<br />
Sofern die Karte mit Weltkoordinaten arbeitet, können in diesem Bereich Luftbilder heruntergeladen und angezeigt werden.<br />
<br />
Bereits heruntergeladene Luftbilder werden angezeigt, sobald der Haken "Use tile aerials" gesetzt wird.<br />
<br />
Heruntergeladen werden können Luftbilder, wenn der folgende Eintrag mit einem funktionierenden Download-Link in die Options.cfg eingetragen wird, wobei ~x, ~y und ~z für die drei Koordinaten x, y und Zoom stehen:<br />
<br />
<pre><br />
[Editor_LinkAerial]<br />
http:www.dummy.de&x=~x&y=~y&z=~z<br />
</pre><br />
<br />
Dann fokussiert man die Sicht auf die Kachel, für welche das Luftbild heruntergeladen werden soll, stellt den Schieberegler "Resolution" auf den gewünschten Wert und klickt auf "Dnl. current Tile".<br />
<br />
==== DEM (ab OMSI 2) ====<br />
<br />
Im Bereich DEM können reale Höhendaten importiert werden, sofern die Karte Weltkoordinaten nutzt. Hierfür ist zunächst die zugehörige DLL auszuwählen und der Vorgang mit "Rund curr. Tile" für die aktuell fokussierte Kachel auszuführen.<br />
<br />
Standardmäßig liefert OMSI eine Import-DLL für freie SRTM-Daten mit, welche in *.hgt-Dateien im Ordner \SRTM\Data hinterlegt sein müssen. Die Dateien für das Grad-Quadrat N46 und E7 bzw. N52 E13 ist bereits in OMSI hinterlegt.<br />
<br />
Der DEM-Import für OMSI läuft über DLLs, damit beliebige DEM-Importvarianten frei programmiert werden können (übrigens auch generisch-zufällige, sofern gewünscht!).<br />
<br />
Siehe hierzu: [[DEM-Import-DLLs selbst programmieren]]<br />
<br />
==== Create Roadmap ====<br />
<br />
Eine noch nicht ganz ausgereifte Funktion erlaubt es, eine zweidimensionale Landkarte der Karte zu erstellen, welche im Unterordner "texture\map" der Karte abgespeichert wird: Einerseits kachelweise mit 256 Pixel Kantenlänge, andererseits als Gesamtkarte mit 128 Pixeln Kantenlänge je Kachel.<br />
<br />
==== Convert into x terrain ====<br />
<br />
Mit dieser Funktion kann die aktuell fokussierte Kachel in eine x-Datei exportiert werden - bspw. um ein komplexeres Objekt mit starker Abhängigkeit zum Boden genau erstellen zu können. Allerdings ist zu beachten, dass die exportierte x-Datei noch nicht für den Import in Blender optimiert ist und insbesondere die Koordinaten noch vertauscht sind.<br />
<br />
=== Objects ===<br />
<br />
Der Wechsel auf diese Registerkarte aktiviert die Objektbearbeitung in OMSI.<br />
<br />
==== All Objects on Tile Nr. # ====<br />
<br />
Ganz oben auf der Registerkarte findet sich ein Dropdown-Feld, über welches alle Objekte der aktuellen Kachel ausgewählt werden können. Andernfalls kann ein Objekt auch ausgewählt werden, indem es mit der Maus angeklickt wird. Es wechselt dann seine Farbe auf rot.<br />
<br />
==== Actual Object Types ====<br />
<br />
Die Baumstruktur zeigt alle bisher geladenen Objekttypen an. Wenn man sich auf der Karte bewegt und hierbei weitere Objekttypen auftreten, wird die Struktur entsprechend ergänzt. Es können aber auch weitere, bisher nicht verwendete Objekte hinzugefügt werden:<br />
<br />
''Load....'' ermöglicht es, gezielt ein Objekt auszuwählen, ''Load directory!'' lädt den Inhalt eines ganzen Objektordners.<br />
<br />
Ist ein Objekt ausgewählt (rot), dann wechselt der Objekttyp, sobald man in der Baumstruktur ein anderes Objekt ausgewählt hat. Andernfalls wird lediglich ein Objekttyp vorgewählt, welcher beim Erstellen eines neuen Objektes verwendet wird.<br />
<br />
Ist ''Random'' gesetzt, dann wird beim Neuerstellen eines Objektes nicht das ausgewählte Objekt gewählt, sondern ein zufälliges aus derselben Gruppe. Sehr praktisch ist diese Funktion insbesondere beim Platzieren von zufälligen Bäumen oder Häusern.<br />
<br />
==== Objekte bewegen, rotieren, löschen und neu erstellen ====<br />
<br />
Dies geschieht über folgende Tastenkombinationen:<br />
<br />
'''G''' ''(grab)'' ermöglicht es, das selektierte Objekt zu bewegen. ''Enter'' oder ein Klick mit der linken Maustaste bestätigt den Vorgang, ''Esc'' bricht ihn ab.<br />
<br />
'''R''' erlaubt das Rotieren von Objekten<br />
<br />
'''N''' erstellt ein neues Objekt und wechselt automatisch in den Bewegungs-Modus<br />
<br />
'''Entf''' löscht das selektierte Objekt.<br />
<br />
==== Object Properties ====<br />
<br />
In diesen Feldern können die zahlreichen Eigenschaften der Objekte eingestellt werden. Die Textfelder wechseln nach einer Eingabe automatisch in den Bearbeitungsmodus und färben sich blau. Der Modus kann abgebrochen werden und die neuen Werte verworfen werden, indem auf ''Enter'' gedrückt wird. Sollen die Werte angewendet werden, ist ''Enter'' zu drücken.<br />
<br />
===== x, y, z und rot, pitch und bank =====<br />
<br />
Hier können numerisch exakte Werte für die drei Koordinaten und die Rotation eingegeben werden. ''Pitch'' und ''Bank'' entsprechen den Neigungen ''nicken'' und ''rollen''.<br />
<br />
===== Attach to Object... =====<br />
<br />
Infolge muss ein Objekt angeklickt werden, was über Anknüpfpunkte, auf engl. Attachpoints verfügt. Dann wird das selektierte Objekt an das angeklickte angehängt und folgt diesem bei weiteren Veränderungen.<br />
<br />
''AttPntNr'' wählt aus, an welchen Attachpoint das Objekt angehängt werden soll - falls mehrere Attachpoints existieren, wie bspw. bei den Haltestellen-Fahnen für die Linienkärtchen.<br />
<br />
===== ~ to Spline ... =====<br />
<br />
Objekte können ebenfalls an Splines angehängt werden - typisches Beispiel sind Straßenlaternen. Hierzu ist nach Anklicken der Schaltfläche eine Spline anzuklicken. Das Objekt wird nun entlang der Spline bewegt und es kann ganz normal mit ''Enter''/linker Maustaste und ''Esc'' verfahren werden.<br />
<br />
Darüber hinaus ist es möglich, dass mehrere Instanzen des Objekts entlang der Spline platziert werden. Hierzu ist das Intervall (''Distance'') und die Gesamtentfernung (''Range'') einzugeben.<br />
<br />
''Tangential to spline'' ermöglicht es, dass die Objekte auch gemäß der Splineoberfläche geneigt werden, bspw. bei parkenden Autos auf einer steigenden oder überhöhten Straße.<br />
<br />
===== Auto Rot. All =====<br />
<br />
... ermöglicht das zufällige Rotieren sämtlicher Objekte dieses Typs<br />
<br />
===== Parent to... =====<br />
<br />
Es ist ein weiteres Objekt zu markieren, welches dann zum "Elternobjekt" bzgl. der Scriptvariablen wird. Diese Funktion wird insbesondere bei Ampeln benötigt: Jede Ampel wird auf diese Weise mit "ihrer" Kreuzung verknüpft.<br />
<br />
===== Beschriftung / Optionen =====<br />
<br />
Je nach Objekttyp wechselt die Beschriftung der Schaltfläche. In jedem Fall erscheint ein Dialogfeld, mit welchem die Beschriftungen (bei normalen Objekten mit Textfeldern) oder die Optionen (bei speziellen Objekten wie Bushaltestellen) eingestellt werden können.<br />
<br />
== Weltkoordinaten ==<br />
<br />
Bei aktivierten Weltkoordinaten verwendet OMSI die Mercator-Projektion und unterteilt die 360° entlang der West-Ost-Richtung in 2^16 (65536) Teile. Am Äquator (40075016,69m) beträgt die Kantenlänge der Kacheln dementsprechend 611,5m, auf 50° 393,1m und am Pol theoretisch 0m (allerdings ist der Pol mit OMSI nicht erreichbar). Weitere Werte entnehmen Sie bitte der folgenden Tabelle:<br />
<br />
{| class="wikitable" style="font-size:95%;" <br />
|- class="hintergrundfarbe5"<br />
| align="left" |''geograph. Breite''<br />
| align="left" |''Kantenlänge (m)''<br />
|-<br />
| align="left" |0°<br />
| align="left" |611,496<br />
|-<br />
| align="left" |±10°<br />
| align="left" |602,206<br />
|-<br />
| align="left" |±20°<br />
| align="left" |574,618<br />
|-<br />
| align="left" |±30°<br />
| align="left" |529,571<br />
|-<br />
| align="left" |±40°<br />
| align="left" |468,433<br />
|-<br />
| align="left" |±50°<br />
| align="left" |393,062<br />
|-<br />
| align="left" |±60°<br />
| align="left" |305,748<br />
|-<br />
| align="left" |±70°<br />
| align="left" |209,144<br />
|}<br />
<br />
[[Kategorie:Nachschlagewerk für Addon-Entwickler]]</div>Marcel Kuhnthttp://wiki.omnibussimulator.de/omsiwikineu.de/index.php?title=Editor_-_%C3%9Cberblick&diff=910Editor - Überblick2014-03-05T11:44:00Z<p>Marcel Kuhnt: /* Object Properties */</p>
<hr />
<div>''Hinweis: Dieser Artikel wurde noch nicht ins Englische übersetzt!''<br />
<br />
''OMSI-Version: 1.0 - 2.0''<br />
<br />
Dieser Artikel liefert einen Überblick über alle Funktionen des OMSI-Mapeditors, geht dabei auch ins Detail, liefert aber keine einzelne Themen fokussierenden Tutorials zu einzelnen Themen.<br />
<br />
Da der Editor noch nicht fehlerfrei arbeitet und einige Funktionen (noch) nicht implementiert sind, werden auch nicht alle Kontrollelemente beschrieben.<br />
<br />
== Starten des Editors ==<br />
<br />
Um den Editor erreichen zu können, ist eine Verknüpfung z.B. auf dem Desktop zu kopieren. Dann ist darauf mit rechts zu klicken und "Eigenschaften" auszuwählen. Der Pfad im Feld "Ziel" ist um den Parameter ''-editor'' zu ergänzen. Diese Verknüpfung dient fortan dem Starten des Mapeditors.<br />
<br />
== Begriffe ==<br />
<br />
{| class="wikitable" style="font-size:95%;" <br />
|- class="hintergrundfarbe5"<br />
| align="left" |''Begriff (engl.)''<br />
| align="left" |''Begriff (dt.)''<br />
| align="left" |''Beschreibung''<br />
|-<br />
| align="left" |Tile<br />
| align="left" |Kachel<br />
| align="left" |Die Karte besteht aus zahlreichen quadratischen Kacheln. Auf Karten mit klassischen kartesischen Koordinaten haben alle Kacheln eine Kantenlänge von 300m, handelt es sich um eine Weltkoordinaten-Karte, dann schwankt die Kantenlänge in Abhängigkeit von der geographischen Breite (s.u.).<br />
|-<br />
| align="left" |Terrain<br />
| align="left" |Gelände<br />
| align="left" |Üblicherweise wird die engl. Bezeichnung ''Terrain'' gewählt. Beim Terrain handelt es sich um den Untergrund. Es handelt sich hierbei um ein Raster von 60 mal 60 Quadraten, deren Eckpunkte nach Belieben angehoben oder gesenkt werden können, wodurch Berge, Hügel oder Mulden usw. geformt werden können. Außerdem können Splines und Objekte je nach deren Eigenschaften Löcher in das Terrain schneiden. Darüber hinaus kann das Terrain mit farblichen Strukturen versehen werden.<br />
|-<br />
| align="left" |Spline<br />
| align="left" |-<br />
| align="left" |Ein in einer *.spi-Datei gespeichertes Profil wird entlang einer geraden oder gebogenen Linie extrudiert. Auf diese Weise entstehen bspw. Straßen, Gleise und Zäune in OMSI, die direkt im Map-Editor in ihrer Länge und Biegung geformt und zu längeren Verbänden aneinandergehängt werden können.<br />
|-<br />
| align="left" |DEM<br />
| align="left" |DEM<br />
| align="left" |DEM bedeutet "Digital Elevation Mesh" und steht auch stellvertretend für Datensätze, welche reale Geländeformen und -höhen beschreiben.<br />
|}<br />
<br />
== Registerkarten ==<br />
<br />
Die Editorfunktionen werden gruppiert nach den entsprechenden Registerkarten am rechten Rand erläutert.<br />
<br />
=== Tile ===<br />
<br />
==== Create New Tile Here ====<br />
<br />
Sobald der Sichtmittelpunkt auf einen Bereich außerhalb der Karte gesetzt ist, wird dieser Button aktiv und erlaubt die Erweiterung der Karte um eine Kachel an dieser Stelle.<br />
<br />
==== Add Water / Remove Water ====<br />
<br />
Stattet die Kachel mit einer Wasserebene aus. Wasserebenen können auf der Registerkarte "Terrain" in ihrer Höhe verändert werden. Normalerweise liegt das Terrain über der Wasserfläche - sobald das Terrain unter das Wasser taucht, entsteht ein See oder Fluss.<br />
<br />
==== Aerial Download (ab OMSI 2) ====<br />
<br />
Sofern die Karte mit Weltkoordinaten arbeitet, können in diesem Bereich Luftbilder heruntergeladen und angezeigt werden.<br />
<br />
Bereits heruntergeladene Luftbilder werden angezeigt, sobald der Haken "Use tile aerials" gesetzt wird.<br />
<br />
Heruntergeladen werden können Luftbilder, wenn der folgende Eintrag mit einem funktionierenden Download-Link in die Options.cfg eingetragen wird, wobei ~x, ~y und ~z für die drei Koordinaten x, y und Zoom stehen:<br />
<br />
<pre><br />
[Editor_LinkAerial]<br />
http:www.dummy.de&x=~x&y=~y&z=~z<br />
</pre><br />
<br />
Dann fokussiert man die Sicht auf die Kachel, für welche das Luftbild heruntergeladen werden soll, stellt den Schieberegler "Resolution" auf den gewünschten Wert und klickt auf "Dnl. current Tile".<br />
<br />
==== DEM (ab OMSI 2) ====<br />
<br />
Im Bereich DEM können reale Höhendaten importiert werden, sofern die Karte Weltkoordinaten nutzt. Hierfür ist zunächst die zugehörige DLL auszuwählen und der Vorgang mit "Rund curr. Tile" für die aktuell fokussierte Kachel auszuführen.<br />
<br />
Standardmäßig liefert OMSI eine Import-DLL für freie SRTM-Daten mit, welche in *.hgt-Dateien im Ordner \SRTM\Data hinterlegt sein müssen. Die Dateien für das Grad-Quadrat N46 und E7 bzw. N52 E13 ist bereits in OMSI hinterlegt.<br />
<br />
Der DEM-Import für OMSI läuft über DLLs, damit beliebige DEM-Importvarianten frei programmiert werden können (übrigens auch generisch-zufällige, sofern gewünscht!).<br />
<br />
Siehe hierzu: [[DEM-Import-DLLs selbst programmieren]]<br />
<br />
==== Create Roadmap ====<br />
<br />
Eine noch nicht ganz ausgereifte Funktion erlaubt es, eine zweidimensionale Landkarte der Karte zu erstellen, welche im Unterordner "texture\map" der Karte abgespeichert wird: Einerseits kachelweise mit 256 Pixel Kantenlänge, andererseits als Gesamtkarte mit 128 Pixeln Kantenlänge je Kachel.<br />
<br />
==== Convert into x terrain ====<br />
<br />
Mit dieser Funktion kann die aktuell fokussierte Kachel in eine x-Datei exportiert werden - bspw. um ein komplexeres Objekt mit starker Abhängigkeit zum Boden genau erstellen zu können. Allerdings ist zu beachten, dass die exportierte x-Datei noch nicht für den Import in Blender optimiert ist und insbesondere die Koordinaten noch vertauscht sind.<br />
<br />
=== Objects ===<br />
<br />
Der Wechsel auf diese Registerkarte aktiviert die Objektbearbeitung in OMSI.<br />
<br />
==== All Objects on Tile Nr. # ====<br />
<br />
Ganz oben auf der Registerkarte findet sich ein Dropdown-Feld, über welches alle Objekte der aktuellen Kachel ausgewählt werden können. Andernfalls kann ein Objekt auch ausgewählt werden, indem es mit der Maus angeklickt wird. Es wechselt dann seine Farbe auf rot.<br />
<br />
==== Actual Object Types ====<br />
<br />
Die Baumstruktur zeigt alle bisher geladenen Objekttypen an. Wenn man sich auf der Karte bewegt und hierbei weitere Objekttypen auftreten, wird die Struktur entsprechend ergänzt. Es können aber auch weitere, bisher nicht verwendete Objekte hinzugefügt werden:<br />
<br />
''Load....'' ermöglicht es, gezielt ein Objekt auszuwählen, ''Load directory!'' lädt den Inhalt eines ganzen Objektordners.<br />
<br />
Ist ein Objekt ausgewählt (rot), dann wechselt der Objekttyp, sobald man in der Baumstruktur ein anderes Objekt ausgewählt hat. Andernfalls wird lediglich ein Objekttyp vorgewählt, welcher beim Erstellen eines neuen Objektes verwendet wird.<br />
<br />
Ist ''Random'' gesetzt, dann wird beim Neuerstellen eines Objektes nicht das ausgewählte Objekt gewählt, sondern ein zufälliges aus derselben Gruppe. Sehr praktisch ist diese Funktion insbesondere beim Platzieren von zufälligen Bäumen oder Häusern.<br />
<br />
==== Objekte bewegen, rotieren, löschen und neu erstellen ====<br />
<br />
Dies geschieht über folgende Tastenkombinationen:<br />
<br />
'''G''' ''(grab)'' ermöglicht es, das selektierte Objekt zu bewegen. ''Enter'' oder ein Klick mit der linken Maustaste bestätigt den Vorgang, ''Esc'' bricht ihn ab.<br />
<br />
'''R''' erlaubt das Rotieren von Objekten<br />
<br />
'''N''' erstellt ein neues Objekt und wechselt automatisch in den Bewegungs-Modus<br />
<br />
'''Entf''' löscht das selektierte Objekt.<br />
<br />
==== Object Properties ====<br />
<br />
In diesen Feldern können die zahlreichen Eigenschaften der Objekte eingestellt werden. Die Textfelder wechseln nach einer Eingabe automatisch in den Bearbeitungsmodus und färben sich blau. Der Modus kann abgebrochen werden und die neuen Werte verworfen werden, indem auf ''Enter'' gedrückt wird. Sollen die Werte angewendet werden, ist ''Enter'' zu drücken.<br />
<br />
===== x, y, z und rot, pitch und bank =====<br />
<br />
Hier können numerisch exakte Werte für die drei Koordinaten und die Rotation eingegeben werden. ''Pitch'' und ''Bank'' entsprechen den Neigungen ''nicken'' und ''rollen''.<br />
<br />
===== Attach to Object... =====<br />
<br />
Infolge muss ein Objekt angeklickt werden, was über Anknüpfpunkte, auf engl. Attachpoints verfügt. Dann wird das selektierte Objekt an das angeklickte angehängt und folgt diesem bei weiteren Veränderungen.<br />
<br />
== Weltkoordinaten ==<br />
<br />
Bei aktivierten Weltkoordinaten verwendet OMSI die Mercator-Projektion und unterteilt die 360° entlang der West-Ost-Richtung in 2^16 (65536) Teile. Am Äquator (40075016,69m) beträgt die Kantenlänge der Kacheln dementsprechend 611,5m, auf 50° 393,1m und am Pol theoretisch 0m (allerdings ist der Pol mit OMSI nicht erreichbar). Weitere Werte entnehmen Sie bitte der folgenden Tabelle:<br />
<br />
{| class="wikitable" style="font-size:95%;" <br />
|- class="hintergrundfarbe5"<br />
| align="left" |''geograph. Breite''<br />
| align="left" |''Kantenlänge (m)''<br />
|-<br />
| align="left" |0°<br />
| align="left" |611,496<br />
|-<br />
| align="left" |±10°<br />
| align="left" |602,206<br />
|-<br />
| align="left" |±20°<br />
| align="left" |574,618<br />
|-<br />
| align="left" |±30°<br />
| align="left" |529,571<br />
|-<br />
| align="left" |±40°<br />
| align="left" |468,433<br />
|-<br />
| align="left" |±50°<br />
| align="left" |393,062<br />
|-<br />
| align="left" |±60°<br />
| align="left" |305,748<br />
|-<br />
| align="left" |±70°<br />
| align="left" |209,144<br />
|}<br />
<br />
[[Kategorie:Nachschlagewerk für Addon-Entwickler]]</div>Marcel Kuhnthttp://wiki.omnibussimulator.de/omsiwikineu.de/index.php?title=Editor_-_%C3%9Cberblick&diff=909Editor - Überblick2014-03-05T11:41:08Z<p>Marcel Kuhnt: /* Object Properties */</p>
<hr />
<div>''Hinweis: Dieser Artikel wurde noch nicht ins Englische übersetzt!''<br />
<br />
''OMSI-Version: 1.0 - 2.0''<br />
<br />
Dieser Artikel liefert einen Überblick über alle Funktionen des OMSI-Mapeditors, geht dabei auch ins Detail, liefert aber keine einzelne Themen fokussierenden Tutorials zu einzelnen Themen.<br />
<br />
Da der Editor noch nicht fehlerfrei arbeitet und einige Funktionen (noch) nicht implementiert sind, werden auch nicht alle Kontrollelemente beschrieben.<br />
<br />
== Starten des Editors ==<br />
<br />
Um den Editor erreichen zu können, ist eine Verknüpfung z.B. auf dem Desktop zu kopieren. Dann ist darauf mit rechts zu klicken und "Eigenschaften" auszuwählen. Der Pfad im Feld "Ziel" ist um den Parameter ''-editor'' zu ergänzen. Diese Verknüpfung dient fortan dem Starten des Mapeditors.<br />
<br />
== Begriffe ==<br />
<br />
{| class="wikitable" style="font-size:95%;" <br />
|- class="hintergrundfarbe5"<br />
| align="left" |''Begriff (engl.)''<br />
| align="left" |''Begriff (dt.)''<br />
| align="left" |''Beschreibung''<br />
|-<br />
| align="left" |Tile<br />
| align="left" |Kachel<br />
| align="left" |Die Karte besteht aus zahlreichen quadratischen Kacheln. Auf Karten mit klassischen kartesischen Koordinaten haben alle Kacheln eine Kantenlänge von 300m, handelt es sich um eine Weltkoordinaten-Karte, dann schwankt die Kantenlänge in Abhängigkeit von der geographischen Breite (s.u.).<br />
|-<br />
| align="left" |Terrain<br />
| align="left" |Gelände<br />
| align="left" |Üblicherweise wird die engl. Bezeichnung ''Terrain'' gewählt. Beim Terrain handelt es sich um den Untergrund. Es handelt sich hierbei um ein Raster von 60 mal 60 Quadraten, deren Eckpunkte nach Belieben angehoben oder gesenkt werden können, wodurch Berge, Hügel oder Mulden usw. geformt werden können. Außerdem können Splines und Objekte je nach deren Eigenschaften Löcher in das Terrain schneiden. Darüber hinaus kann das Terrain mit farblichen Strukturen versehen werden.<br />
|-<br />
| align="left" |Spline<br />
| align="left" |-<br />
| align="left" |Ein in einer *.spi-Datei gespeichertes Profil wird entlang einer geraden oder gebogenen Linie extrudiert. Auf diese Weise entstehen bspw. Straßen, Gleise und Zäune in OMSI, die direkt im Map-Editor in ihrer Länge und Biegung geformt und zu längeren Verbänden aneinandergehängt werden können.<br />
|-<br />
| align="left" |DEM<br />
| align="left" |DEM<br />
| align="left" |DEM bedeutet "Digital Elevation Mesh" und steht auch stellvertretend für Datensätze, welche reale Geländeformen und -höhen beschreiben.<br />
|}<br />
<br />
== Registerkarten ==<br />
<br />
Die Editorfunktionen werden gruppiert nach den entsprechenden Registerkarten am rechten Rand erläutert.<br />
<br />
=== Tile ===<br />
<br />
==== Create New Tile Here ====<br />
<br />
Sobald der Sichtmittelpunkt auf einen Bereich außerhalb der Karte gesetzt ist, wird dieser Button aktiv und erlaubt die Erweiterung der Karte um eine Kachel an dieser Stelle.<br />
<br />
==== Add Water / Remove Water ====<br />
<br />
Stattet die Kachel mit einer Wasserebene aus. Wasserebenen können auf der Registerkarte "Terrain" in ihrer Höhe verändert werden. Normalerweise liegt das Terrain über der Wasserfläche - sobald das Terrain unter das Wasser taucht, entsteht ein See oder Fluss.<br />
<br />
==== Aerial Download (ab OMSI 2) ====<br />
<br />
Sofern die Karte mit Weltkoordinaten arbeitet, können in diesem Bereich Luftbilder heruntergeladen und angezeigt werden.<br />
<br />
Bereits heruntergeladene Luftbilder werden angezeigt, sobald der Haken "Use tile aerials" gesetzt wird.<br />
<br />
Heruntergeladen werden können Luftbilder, wenn der folgende Eintrag mit einem funktionierenden Download-Link in die Options.cfg eingetragen wird, wobei ~x, ~y und ~z für die drei Koordinaten x, y und Zoom stehen:<br />
<br />
<pre><br />
[Editor_LinkAerial]<br />
http:www.dummy.de&x=~x&y=~y&z=~z<br />
</pre><br />
<br />
Dann fokussiert man die Sicht auf die Kachel, für welche das Luftbild heruntergeladen werden soll, stellt den Schieberegler "Resolution" auf den gewünschten Wert und klickt auf "Dnl. current Tile".<br />
<br />
==== DEM (ab OMSI 2) ====<br />
<br />
Im Bereich DEM können reale Höhendaten importiert werden, sofern die Karte Weltkoordinaten nutzt. Hierfür ist zunächst die zugehörige DLL auszuwählen und der Vorgang mit "Rund curr. Tile" für die aktuell fokussierte Kachel auszuführen.<br />
<br />
Standardmäßig liefert OMSI eine Import-DLL für freie SRTM-Daten mit, welche in *.hgt-Dateien im Ordner \SRTM\Data hinterlegt sein müssen. Die Dateien für das Grad-Quadrat N46 und E7 bzw. N52 E13 ist bereits in OMSI hinterlegt.<br />
<br />
Der DEM-Import für OMSI läuft über DLLs, damit beliebige DEM-Importvarianten frei programmiert werden können (übrigens auch generisch-zufällige, sofern gewünscht!).<br />
<br />
Siehe hierzu: [[DEM-Import-DLLs selbst programmieren]]<br />
<br />
==== Create Roadmap ====<br />
<br />
Eine noch nicht ganz ausgereifte Funktion erlaubt es, eine zweidimensionale Landkarte der Karte zu erstellen, welche im Unterordner "texture\map" der Karte abgespeichert wird: Einerseits kachelweise mit 256 Pixel Kantenlänge, andererseits als Gesamtkarte mit 128 Pixeln Kantenlänge je Kachel.<br />
<br />
==== Convert into x terrain ====<br />
<br />
Mit dieser Funktion kann die aktuell fokussierte Kachel in eine x-Datei exportiert werden - bspw. um ein komplexeres Objekt mit starker Abhängigkeit zum Boden genau erstellen zu können. Allerdings ist zu beachten, dass die exportierte x-Datei noch nicht für den Import in Blender optimiert ist und insbesondere die Koordinaten noch vertauscht sind.<br />
<br />
=== Objects ===<br />
<br />
Der Wechsel auf diese Registerkarte aktiviert die Objektbearbeitung in OMSI.<br />
<br />
==== All Objects on Tile Nr. # ====<br />
<br />
Ganz oben auf der Registerkarte findet sich ein Dropdown-Feld, über welches alle Objekte der aktuellen Kachel ausgewählt werden können. Andernfalls kann ein Objekt auch ausgewählt werden, indem es mit der Maus angeklickt wird. Es wechselt dann seine Farbe auf rot.<br />
<br />
==== Actual Object Types ====<br />
<br />
Die Baumstruktur zeigt alle bisher geladenen Objekttypen an. Wenn man sich auf der Karte bewegt und hierbei weitere Objekttypen auftreten, wird die Struktur entsprechend ergänzt. Es können aber auch weitere, bisher nicht verwendete Objekte hinzugefügt werden:<br />
<br />
''Load....'' ermöglicht es, gezielt ein Objekt auszuwählen, ''Load directory!'' lädt den Inhalt eines ganzen Objektordners.<br />
<br />
Ist ein Objekt ausgewählt (rot), dann wechselt der Objekttyp, sobald man in der Baumstruktur ein anderes Objekt ausgewählt hat. Andernfalls wird lediglich ein Objekttyp vorgewählt, welcher beim Erstellen eines neuen Objektes verwendet wird.<br />
<br />
Ist ''Random'' gesetzt, dann wird beim Neuerstellen eines Objektes nicht das ausgewählte Objekt gewählt, sondern ein zufälliges aus derselben Gruppe. Sehr praktisch ist diese Funktion insbesondere beim Platzieren von zufälligen Bäumen oder Häusern.<br />
<br />
==== Objekte bewegen, rotieren, löschen und neu erstellen ====<br />
<br />
Dies geschieht über folgende Tastenkombinationen:<br />
<br />
'''G''' ''(grab)'' ermöglicht es, das selektierte Objekt zu bewegen. ''Enter'' oder ein Klick mit der linken Maustaste bestätigt den Vorgang, ''Esc'' bricht ihn ab.<br />
<br />
'''R''' erlaubt das Rotieren von Objekten<br />
<br />
'''N''' erstellt ein neues Objekt und wechselt automatisch in den Bewegungs-Modus<br />
<br />
'''Entf''' löscht das selektierte Objekt.<br />
<br />
==== Object Properties ====<br />
<br />
In diesen Feldern können die zahlreichen Eigenschaften der Objekte eingestellt werden. Die Textfelder wechseln nach einer Eingabe automatisch in den Bearbeitungsmodus und färben sich blau. Der Modus kann abgebrochen werden und die neuen Werte verworfen werden, indem auf ''Enter'' gedrückt wird. Sollen die Werte angewendet werden, ist ''Enter'' zu drücken.<br />
<br />
===== x, y, z und rot =====<br />
<br />
== Weltkoordinaten ==<br />
<br />
Bei aktivierten Weltkoordinaten verwendet OMSI die Mercator-Projektion und unterteilt die 360° entlang der West-Ost-Richtung in 2^16 (65536) Teile. Am Äquator (40075016,69m) beträgt die Kantenlänge der Kacheln dementsprechend 611,5m, auf 50° 393,1m und am Pol theoretisch 0m (allerdings ist der Pol mit OMSI nicht erreichbar). Weitere Werte entnehmen Sie bitte der folgenden Tabelle:<br />
<br />
{| class="wikitable" style="font-size:95%;" <br />
|- class="hintergrundfarbe5"<br />
| align="left" |''geograph. Breite''<br />
| align="left" |''Kantenlänge (m)''<br />
|-<br />
| align="left" |0°<br />
| align="left" |611,496<br />
|-<br />
| align="left" |±10°<br />
| align="left" |602,206<br />
|-<br />
| align="left" |±20°<br />
| align="left" |574,618<br />
|-<br />
| align="left" |±30°<br />
| align="left" |529,571<br />
|-<br />
| align="left" |±40°<br />
| align="left" |468,433<br />
|-<br />
| align="left" |±50°<br />
| align="left" |393,062<br />
|-<br />
| align="left" |±60°<br />
| align="left" |305,748<br />
|-<br />
| align="left" |±70°<br />
| align="left" |209,144<br />
|}<br />
<br />
[[Kategorie:Nachschlagewerk für Addon-Entwickler]]</div>Marcel Kuhnthttp://wiki.omnibussimulator.de/omsiwikineu.de/index.php?title=Editor_-_%C3%9Cberblick&diff=908Editor - Überblick2014-03-05T11:40:17Z<p>Marcel Kuhnt: </p>
<hr />
<div>''Hinweis: Dieser Artikel wurde noch nicht ins Englische übersetzt!''<br />
<br />
''OMSI-Version: 1.0 - 2.0''<br />
<br />
Dieser Artikel liefert einen Überblick über alle Funktionen des OMSI-Mapeditors, geht dabei auch ins Detail, liefert aber keine einzelne Themen fokussierenden Tutorials zu einzelnen Themen.<br />
<br />
Da der Editor noch nicht fehlerfrei arbeitet und einige Funktionen (noch) nicht implementiert sind, werden auch nicht alle Kontrollelemente beschrieben.<br />
<br />
== Starten des Editors ==<br />
<br />
Um den Editor erreichen zu können, ist eine Verknüpfung z.B. auf dem Desktop zu kopieren. Dann ist darauf mit rechts zu klicken und "Eigenschaften" auszuwählen. Der Pfad im Feld "Ziel" ist um den Parameter ''-editor'' zu ergänzen. Diese Verknüpfung dient fortan dem Starten des Mapeditors.<br />
<br />
== Begriffe ==<br />
<br />
{| class="wikitable" style="font-size:95%;" <br />
|- class="hintergrundfarbe5"<br />
| align="left" |''Begriff (engl.)''<br />
| align="left" |''Begriff (dt.)''<br />
| align="left" |''Beschreibung''<br />
|-<br />
| align="left" |Tile<br />
| align="left" |Kachel<br />
| align="left" |Die Karte besteht aus zahlreichen quadratischen Kacheln. Auf Karten mit klassischen kartesischen Koordinaten haben alle Kacheln eine Kantenlänge von 300m, handelt es sich um eine Weltkoordinaten-Karte, dann schwankt die Kantenlänge in Abhängigkeit von der geographischen Breite (s.u.).<br />
|-<br />
| align="left" |Terrain<br />
| align="left" |Gelände<br />
| align="left" |Üblicherweise wird die engl. Bezeichnung ''Terrain'' gewählt. Beim Terrain handelt es sich um den Untergrund. Es handelt sich hierbei um ein Raster von 60 mal 60 Quadraten, deren Eckpunkte nach Belieben angehoben oder gesenkt werden können, wodurch Berge, Hügel oder Mulden usw. geformt werden können. Außerdem können Splines und Objekte je nach deren Eigenschaften Löcher in das Terrain schneiden. Darüber hinaus kann das Terrain mit farblichen Strukturen versehen werden.<br />
|-<br />
| align="left" |Spline<br />
| align="left" |-<br />
| align="left" |Ein in einer *.spi-Datei gespeichertes Profil wird entlang einer geraden oder gebogenen Linie extrudiert. Auf diese Weise entstehen bspw. Straßen, Gleise und Zäune in OMSI, die direkt im Map-Editor in ihrer Länge und Biegung geformt und zu längeren Verbänden aneinandergehängt werden können.<br />
|-<br />
| align="left" |DEM<br />
| align="left" |DEM<br />
| align="left" |DEM bedeutet "Digital Elevation Mesh" und steht auch stellvertretend für Datensätze, welche reale Geländeformen und -höhen beschreiben.<br />
|}<br />
<br />
== Registerkarten ==<br />
<br />
Die Editorfunktionen werden gruppiert nach den entsprechenden Registerkarten am rechten Rand erläutert.<br />
<br />
=== Tile ===<br />
<br />
==== Create New Tile Here ====<br />
<br />
Sobald der Sichtmittelpunkt auf einen Bereich außerhalb der Karte gesetzt ist, wird dieser Button aktiv und erlaubt die Erweiterung der Karte um eine Kachel an dieser Stelle.<br />
<br />
==== Add Water / Remove Water ====<br />
<br />
Stattet die Kachel mit einer Wasserebene aus. Wasserebenen können auf der Registerkarte "Terrain" in ihrer Höhe verändert werden. Normalerweise liegt das Terrain über der Wasserfläche - sobald das Terrain unter das Wasser taucht, entsteht ein See oder Fluss.<br />
<br />
==== Aerial Download (ab OMSI 2) ====<br />
<br />
Sofern die Karte mit Weltkoordinaten arbeitet, können in diesem Bereich Luftbilder heruntergeladen und angezeigt werden.<br />
<br />
Bereits heruntergeladene Luftbilder werden angezeigt, sobald der Haken "Use tile aerials" gesetzt wird.<br />
<br />
Heruntergeladen werden können Luftbilder, wenn der folgende Eintrag mit einem funktionierenden Download-Link in die Options.cfg eingetragen wird, wobei ~x, ~y und ~z für die drei Koordinaten x, y und Zoom stehen:<br />
<br />
<pre><br />
[Editor_LinkAerial]<br />
http:www.dummy.de&x=~x&y=~y&z=~z<br />
</pre><br />
<br />
Dann fokussiert man die Sicht auf die Kachel, für welche das Luftbild heruntergeladen werden soll, stellt den Schieberegler "Resolution" auf den gewünschten Wert und klickt auf "Dnl. current Tile".<br />
<br />
==== DEM (ab OMSI 2) ====<br />
<br />
Im Bereich DEM können reale Höhendaten importiert werden, sofern die Karte Weltkoordinaten nutzt. Hierfür ist zunächst die zugehörige DLL auszuwählen und der Vorgang mit "Rund curr. Tile" für die aktuell fokussierte Kachel auszuführen.<br />
<br />
Standardmäßig liefert OMSI eine Import-DLL für freie SRTM-Daten mit, welche in *.hgt-Dateien im Ordner \SRTM\Data hinterlegt sein müssen. Die Dateien für das Grad-Quadrat N46 und E7 bzw. N52 E13 ist bereits in OMSI hinterlegt.<br />
<br />
Der DEM-Import für OMSI läuft über DLLs, damit beliebige DEM-Importvarianten frei programmiert werden können (übrigens auch generisch-zufällige, sofern gewünscht!).<br />
<br />
Siehe hierzu: [[DEM-Import-DLLs selbst programmieren]]<br />
<br />
==== Create Roadmap ====<br />
<br />
Eine noch nicht ganz ausgereifte Funktion erlaubt es, eine zweidimensionale Landkarte der Karte zu erstellen, welche im Unterordner "texture\map" der Karte abgespeichert wird: Einerseits kachelweise mit 256 Pixel Kantenlänge, andererseits als Gesamtkarte mit 128 Pixeln Kantenlänge je Kachel.<br />
<br />
==== Convert into x terrain ====<br />
<br />
Mit dieser Funktion kann die aktuell fokussierte Kachel in eine x-Datei exportiert werden - bspw. um ein komplexeres Objekt mit starker Abhängigkeit zum Boden genau erstellen zu können. Allerdings ist zu beachten, dass die exportierte x-Datei noch nicht für den Import in Blender optimiert ist und insbesondere die Koordinaten noch vertauscht sind.<br />
<br />
=== Objects ===<br />
<br />
Der Wechsel auf diese Registerkarte aktiviert die Objektbearbeitung in OMSI.<br />
<br />
==== All Objects on Tile Nr. # ====<br />
<br />
Ganz oben auf der Registerkarte findet sich ein Dropdown-Feld, über welches alle Objekte der aktuellen Kachel ausgewählt werden können. Andernfalls kann ein Objekt auch ausgewählt werden, indem es mit der Maus angeklickt wird. Es wechselt dann seine Farbe auf rot.<br />
<br />
==== Actual Object Types ====<br />
<br />
Die Baumstruktur zeigt alle bisher geladenen Objekttypen an. Wenn man sich auf der Karte bewegt und hierbei weitere Objekttypen auftreten, wird die Struktur entsprechend ergänzt. Es können aber auch weitere, bisher nicht verwendete Objekte hinzugefügt werden:<br />
<br />
''Load....'' ermöglicht es, gezielt ein Objekt auszuwählen, ''Load directory!'' lädt den Inhalt eines ganzen Objektordners.<br />
<br />
Ist ein Objekt ausgewählt (rot), dann wechselt der Objekttyp, sobald man in der Baumstruktur ein anderes Objekt ausgewählt hat. Andernfalls wird lediglich ein Objekttyp vorgewählt, welcher beim Erstellen eines neuen Objektes verwendet wird.<br />
<br />
Ist ''Random'' gesetzt, dann wird beim Neuerstellen eines Objektes nicht das ausgewählte Objekt gewählt, sondern ein zufälliges aus derselben Gruppe. Sehr praktisch ist diese Funktion insbesondere beim Platzieren von zufälligen Bäumen oder Häusern.<br />
<br />
==== Objekte bewegen, rotieren, löschen und neu erstellen ====<br />
<br />
Dies geschieht über folgende Tastenkombinationen:<br />
<br />
'''G''' ''(grab)'' ermöglicht es, das selektierte Objekt zu bewegen. ''Enter'' oder ein Klick mit der linken Maustaste bestätigt den Vorgang, ''Esc'' bricht ihn ab.<br />
<br />
'''R''' erlaubt das Rotieren von Objekten<br />
<br />
'''N''' erstellt ein neues Objekt und wechselt automatisch in den Bewegungs-Modus<br />
<br />
'''Entf''' löscht das selektierte Objekt.<br />
<br />
==== Object Properties ====<br />
<br />
In diesen Feldern können die zahlreichen Eigenschaften der Objekte eingestellt werden. Die Textfelder wechseln nach einer Eingabe automatisch in den Bearbeitungsmodus und färben sich blau. Der Modus kann abgebrochen werden und die neuen Werte verworfen werden, indem auf ''Enter'' gedrückt wird. Sollen die Werte angewendet werden, ist ''Enter'' zu drücken.<br />
<br />
<br />
<br />
== Weltkoordinaten ==<br />
<br />
Bei aktivierten Weltkoordinaten verwendet OMSI die Mercator-Projektion und unterteilt die 360° entlang der West-Ost-Richtung in 2^16 (65536) Teile. Am Äquator (40075016,69m) beträgt die Kantenlänge der Kacheln dementsprechend 611,5m, auf 50° 393,1m und am Pol theoretisch 0m (allerdings ist der Pol mit OMSI nicht erreichbar). Weitere Werte entnehmen Sie bitte der folgenden Tabelle:<br />
<br />
{| class="wikitable" style="font-size:95%;" <br />
|- class="hintergrundfarbe5"<br />
| align="left" |''geograph. Breite''<br />
| align="left" |''Kantenlänge (m)''<br />
|-<br />
| align="left" |0°<br />
| align="left" |611,496<br />
|-<br />
| align="left" |±10°<br />
| align="left" |602,206<br />
|-<br />
| align="left" |±20°<br />
| align="left" |574,618<br />
|-<br />
| align="left" |±30°<br />
| align="left" |529,571<br />
|-<br />
| align="left" |±40°<br />
| align="left" |468,433<br />
|-<br />
| align="left" |±50°<br />
| align="left" |393,062<br />
|-<br />
| align="left" |±60°<br />
| align="left" |305,748<br />
|-<br />
| align="left" |±70°<br />
| align="left" |209,144<br />
|}<br />
<br />
[[Kategorie:Nachschlagewerk für Addon-Entwickler]]</div>Marcel Kuhnthttp://wiki.omnibussimulator.de/omsiwikineu.de/index.php?title=Editor_-_%C3%9Cberblick&diff=907Editor - Überblick2014-03-05T11:32:17Z<p>Marcel Kuhnt: </p>
<hr />
<div>''Hinweis: Dieser Artikel wurde noch nicht ins Englische übersetzt!''<br />
<br />
''OMSI-Version: 1.0 - 2.0''<br />
<br />
Dieser Artikel liefert einen Überblick über alle Funktionen des OMSI-Mapeditors, geht dabei auch ins Detail, liefert aber keine einzelne Themen fokussierenden Tutorials zu einzelnen Themen.<br />
<br />
Da der Editor noch nicht fehlerfrei arbeitet und einige Funktionen (noch) nicht implementiert sind, werden auch nicht alle Kontrollelemente beschrieben.<br />
<br />
== Starten des Editors ==<br />
<br />
Um den Editor erreichen zu können, ist eine Verknüpfung z.B. auf dem Desktop zu kopieren. Dann ist darauf mit rechts zu klicken und "Eigenschaften" auszuwählen. Der Pfad im Feld "Ziel" ist um den Parameter ''-editor'' zu ergänzen. Diese Verknüpfung dient fortan dem Starten des Mapeditors.<br />
<br />
== Begriffe ==<br />
<br />
{| class="wikitable" style="font-size:95%;" <br />
|- class="hintergrundfarbe5"<br />
| align="left" |''Begriff (engl.)''<br />
| align="left" |''Begriff (dt.)''<br />
| align="left" |''Beschreibung''<br />
|-<br />
| align="left" |Tile<br />
| align="left" |Kachel<br />
| align="left" |Die Karte besteht aus zahlreichen quadratischen Kacheln. Auf Karten mit klassischen kartesischen Koordinaten haben alle Kacheln eine Kantenlänge von 300m, handelt es sich um eine Weltkoordinaten-Karte, dann schwankt die Kantenlänge in Abhängigkeit von der geographischen Breite (s.u.).<br />
|-<br />
| align="left" |Terrain<br />
| align="left" |Gelände<br />
| align="left" |Üblicherweise wird die engl. Bezeichnung ''Terrain'' gewählt. Beim Terrain handelt es sich um den Untergrund. Es handelt sich hierbei um ein Raster von 60 mal 60 Quadraten, deren Eckpunkte nach Belieben angehoben oder gesenkt werden können, wodurch Berge, Hügel oder Mulden usw. geformt werden können. Außerdem können Splines und Objekte je nach deren Eigenschaften Löcher in das Terrain schneiden. Darüber hinaus kann das Terrain mit farblichen Strukturen versehen werden.<br />
|-<br />
| align="left" |Spline<br />
| align="left" |-<br />
| align="left" |Ein in einer *.spi-Datei gespeichertes Profil wird entlang einer geraden oder gebogenen Linie extrudiert. Auf diese Weise entstehen bspw. Straßen, Gleise und Zäune in OMSI, die direkt im Map-Editor in ihrer Länge und Biegung geformt und zu längeren Verbänden aneinandergehängt werden können.<br />
|-<br />
| align="left" |DEM<br />
| align="left" |DEM<br />
| align="left" |DEM bedeutet "Digital Elevation Mesh" und steht auch stellvertretend für Datensätze, welche reale Geländeformen und -höhen beschreiben.<br />
|}<br />
<br />
== Registerkarten ==<br />
<br />
Die Editorfunktionen werden gruppiert nach den entsprechenden Registerkarten am rechten Rand erläutert.<br />
<br />
=== Tile ===<br />
<br />
==== Create New Tile Here ====<br />
<br />
Sobald der Sichtmittelpunkt auf einen Bereich außerhalb der Karte gesetzt ist, wird dieser Button aktiv und erlaubt die Erweiterung der Karte um eine Kachel an dieser Stelle.<br />
<br />
==== Add Water / Remove Water ====<br />
<br />
Stattet die Kachel mit einer Wasserebene aus. Wasserebenen können auf der Registerkarte "Terrain" in ihrer Höhe verändert werden. Normalerweise liegt das Terrain über der Wasserfläche - sobald das Terrain unter das Wasser taucht, entsteht ein See oder Fluss.<br />
<br />
==== Aerial Download (ab OMSI 2) ====<br />
<br />
Sofern die Karte mit Weltkoordinaten arbeitet, können in diesem Bereich Luftbilder heruntergeladen und angezeigt werden.<br />
<br />
Bereits heruntergeladene Luftbilder werden angezeigt, sobald der Haken "Use tile aerials" gesetzt wird.<br />
<br />
Heruntergeladen werden können Luftbilder, wenn der folgende Eintrag mit einem funktionierenden Download-Link in die Options.cfg eingetragen wird, wobei ~x, ~y und ~z für die drei Koordinaten x, y und Zoom stehen:<br />
<br />
<pre><br />
[Editor_LinkAerial]<br />
http:www.dummy.de&x=~x&y=~y&z=~z<br />
</pre><br />
<br />
Dann fokussiert man die Sicht auf die Kachel, für welche das Luftbild heruntergeladen werden soll, stellt den Schieberegler "Resolution" auf den gewünschten Wert und klickt auf "Dnl. current Tile".<br />
<br />
==== DEM (ab OMSI 2) ====<br />
<br />
Im Bereich DEM können reale Höhendaten importiert werden, sofern die Karte Weltkoordinaten nutzt. Hierfür ist zunächst die zugehörige DLL auszuwählen und der Vorgang mit "Rund curr. Tile" für die aktuell fokussierte Kachel auszuführen.<br />
<br />
Standardmäßig liefert OMSI eine Import-DLL für freie SRTM-Daten mit, welche in *.hgt-Dateien im Ordner \SRTM\Data hinterlegt sein müssen. Die Dateien für das Grad-Quadrat N46 und E7 bzw. N52 E13 ist bereits in OMSI hinterlegt.<br />
<br />
Der DEM-Import für OMSI läuft über DLLs, damit beliebige DEM-Importvarianten frei programmiert werden können (übrigens auch generisch-zufällige, sofern gewünscht!).<br />
<br />
Siehe hierzu: [[DEM-Import-DLLs selbst programmieren]]<br />
<br />
==== Create Roadmap ====<br />
<br />
Eine noch nicht ganz ausgereifte Funktion erlaubt es, eine zweidimensionale Landkarte der Karte zu erstellen, welche im Unterordner "texture\map" der Karte abgespeichert wird: Einerseits kachelweise mit 256 Pixel Kantenlänge, andererseits als Gesamtkarte mit 128 Pixeln Kantenlänge je Kachel.<br />
<br />
==== Convert into x terrain ====<br />
<br />
Mit dieser Funktion kann die aktuell fokussierte Kachel in eine x-Datei exportiert werden - bspw. um ein komplexeres Objekt mit starker Abhängigkeit zum Boden genau erstellen zu können. Allerdings ist zu beachten, dass die exportierte x-Datei noch nicht für den Import in Blender optimiert ist und insbesondere die Koordinaten noch vertauscht sind.<br />
<br />
=== Objects ===<br />
<br />
Der Wechsel auf diese Registerkarte aktiviert die Objektbearbeitung in OMSI.<br />
<br />
==== All Objects on Tile Nr. # ====<br />
<br />
Ganz oben auf der Registerkarte findet sich ein Dropdown-Feld, über welches alle Objekte der aktuellen Kachel ausgewählt werden können. Andernfalls kann ein Objekt auch ausgewählt werden, indem es mit der Maus angeklickt wird. Es wechselt dann seine Farbe auf rot.<br />
<br />
==== Actual Object Types ====<br />
<br />
Die Baumstruktur zeigt alle bisher geladenen Objekttypen an. Wenn man sich auf der Karte bewegt und hierbei weitere Objekttypen auftreten, wird die Struktur entsprechend ergänzt. Es können aber auch weitere, bisher nicht verwendete Objekte hinzugefügt werden:<br />
<br />
''Load....'' ermöglicht es, gezielt ein Objekt auszuwählen, ''Load directory!'' lädt den Inhalt eines ganzen Objektordners.<br />
<br />
Ist ein Objekt ausgewählt (rot), dann wechselt der Objekttyp, sobald man in der Baumstruktur ein anderes Objekt ausgewählt hat. Andernfalls wird lediglich ein Objekttyp vorgewählt, welcher beim Erstellen eines neuen Objektes verwendet wird.<br />
<br />
==== Objekte bewegen, rotieren, löschen und neu erstellen ====<br />
<br />
Dies geschieht über folgende Tastenkombinationen:<br />
<br />
'''G''' ''(grab)'' ermöglicht es, das selektierte Objekt zu bewegen. Enter oder ein Klick mit der linken Maustaste bestätigt den Vorgang, Esc bricht ihn ab.<br />
<br />
'''R''' erlaubt das Rotieren von Objekten<br />
<br />
'''N''' erstellt ein neues Objekt und wechselt automatisch in den Bewegungs-Modus<br />
<br />
'''Entf''' löscht das selektierte Objekt.<br />
<br />
<br />
== Weltkoordinaten ==<br />
<br />
Bei aktivierten Weltkoordinaten verwendet OMSI die Mercator-Projektion und unterteilt die 360° entlang der West-Ost-Richtung in 2^16 (65536) Teile. Am Äquator (40075016,69m) beträgt die Kantenlänge der Kacheln dementsprechend 611,5m, auf 50° 393,1m und am Pol theoretisch 0m (allerdings ist der Pol mit OMSI nicht erreichbar). Weitere Werte entnehmen Sie bitte der folgenden Tabelle:<br />
<br />
{| class="wikitable" style="font-size:95%;" <br />
|- class="hintergrundfarbe5"<br />
| align="left" |''geograph. Breite''<br />
| align="left" |''Kantenlänge (m)''<br />
|-<br />
| align="left" |0°<br />
| align="left" |611,496<br />
|-<br />
| align="left" |±10°<br />
| align="left" |602,206<br />
|-<br />
| align="left" |±20°<br />
| align="left" |574,618<br />
|-<br />
| align="left" |±30°<br />
| align="left" |529,571<br />
|-<br />
| align="left" |±40°<br />
| align="left" |468,433<br />
|-<br />
| align="left" |±50°<br />
| align="left" |393,062<br />
|-<br />
| align="left" |±60°<br />
| align="left" |305,748<br />
|-<br />
| align="left" |±70°<br />
| align="left" |209,144<br />
|}<br />
<br />
[[Kategorie:Nachschlagewerk für Addon-Entwickler]]</div>Marcel Kuhnthttp://wiki.omnibussimulator.de/omsiwikineu.de/index.php?title=Editor_-_%C3%9Cberblick&diff=906Editor - Überblick2014-03-05T11:14:50Z<p>Marcel Kuhnt: </p>
<hr />
<div>''Hinweis: Dieser Artikel wurde noch nicht ins Englische übersetzt!''<br />
<br />
''OMSI-Version: 1.0 - 2.0''<br />
<br />
Dieser Artikel liefert einen Überblick über alle Funktionen des OMSI-Mapeditors, geht dabei auch ins Detail, liefert aber keine einzelne Themen fokussierenden Tutorials zu einzelnen Themen.<br />
<br />
Da der Editor noch nicht fehlerfrei arbeitet und einige Funktionen (noch) nicht implementiert sind, werden auch nicht alle Kontrollelemente beschrieben.<br />
<br />
== Starten des Editors ==<br />
<br />
Um den Editor erreichen zu können, ist eine Verknüpfung z.B. auf dem Desktop zu kopieren. Dann ist darauf mit rechts zu klicken und "Eigenschaften" auszuwählen. Der Pfad im Feld "Ziel" ist um den Parameter ''-editor'' zu ergänzen. Diese Verknüpfung dient fortan dem Starten des Mapeditors.<br />
<br />
== Begriffe ==<br />
<br />
{| class="wikitable" style="font-size:95%;" <br />
|- class="hintergrundfarbe5"<br />
| align="left" |''Begriff (engl.)''<br />
| align="left" |''Begriff (dt.)''<br />
| align="left" |''Beschreibung''<br />
|-<br />
| align="left" |Tile<br />
| align="left" |Kachel<br />
| align="left" |Die Karte besteht aus zahlreichen quadratischen Kacheln. Auf Karten mit klassischen kartesischen Koordinaten haben alle Kacheln eine Kantenlänge von 300m, handelt es sich um eine Weltkoordinaten-Karte, dann schwankt die Kantenlänge in Abhängigkeit von der geographischen Breite (s.u.).<br />
|-<br />
| align="left" |Terrain<br />
| align="left" |Gelände<br />
| align="left" |Üblicherweise wird die engl. Bezeichnung ''Terrain'' gewählt. Beim Terrain handelt es sich um den Untergrund. Es handelt sich hierbei um ein Raster von 60 mal 60 Quadraten, deren Eckpunkte nach Belieben angehoben oder gesenkt werden können, wodurch Berge, Hügel oder Mulden usw. geformt werden können. Außerdem können Splines und Objekte je nach deren Eigenschaften Löcher in das Terrain schneiden. Darüber hinaus kann das Terrain mit farblichen Strukturen versehen werden.<br />
|-<br />
| align="left" |Spline<br />
| align="left" |-<br />
| align="left" |Ein in einer *.spi-Datei gespeichertes Profil wird entlang einer geraden oder gebogenen Linie extrudiert. Auf diese Weise entstehen bspw. Straßen, Gleise und Zäune in OMSI, die direkt im Map-Editor in ihrer Länge und Biegung geformt und zu längeren Verbänden aneinandergehängt werden können.<br />
|-<br />
| align="left" |DEM<br />
| align="left" |DEM<br />
| align="left" |DEM bedeutet "Digital Elevation Mesh" und steht auch stellvertretend für Datensätze, welche reale Geländeformen und -höhen beschreiben.<br />
|}<br />
<br />
== Registerkarten ==<br />
<br />
Die Editorfunktionen werden gruppiert nach den entsprechenden Registerkarten am rechten Rand erläutert.<br />
<br />
=== Tile ===<br />
<br />
==== Create New Tile Here ====<br />
<br />
Sobald der Sichtmittelpunkt auf einen Bereich außerhalb der Karte gesetzt ist, wird dieser Button aktiv und erlaubt die Erweiterung der Karte um eine Kachel an dieser Stelle.<br />
<br />
==== Add Water / Remove Water ====<br />
<br />
Stattet die Kachel mit einer Wasserebene aus. Wasserebenen können auf der Registerkarte "Terrain" in ihrer Höhe verändert werden. Normalerweise liegt das Terrain über der Wasserfläche - sobald das Terrain unter das Wasser taucht, entsteht ein See oder Fluss.<br />
<br />
==== Aerial Download (ab OMSI 2) ====<br />
<br />
Sofern die Karte mit Weltkoordinaten arbeitet, können in diesem Bereich Luftbilder heruntergeladen und angezeigt werden.<br />
<br />
Bereits heruntergeladene Luftbilder werden angezeigt, sobald der Haken "Use tile aerials" gesetzt wird.<br />
<br />
Heruntergeladen werden können Luftbilder, wenn der folgende Eintrag mit einem funktionierenden Download-Link in die Options.cfg eingetragen wird, wobei ~x, ~y und ~z für die drei Koordinaten x, y und Zoom stehen:<br />
<br />
<pre><br />
[Editor_LinkAerial]<br />
http:www.dummy.de&x=~x&y=~y&z=~z<br />
</pre><br />
<br />
Dann fokussiert man die Sicht auf die Kachel, für welche das Luftbild heruntergeladen werden soll, stellt den Schieberegler "Resolution" auf den gewünschten Wert und klickt auf "Dnl. current Tile".<br />
<br />
==== DEM (ab OMSI 2) ====<br />
<br />
Im Bereich DEM können reale Höhendaten importiert werden, sofern die Karte Weltkoordinaten nutzt. Hierfür ist zunächst die zugehörige DLL auszuwählen und der Vorgang mit "Rund curr. Tile" für die aktuell fokussierte Kachel auszuführen.<br />
<br />
Standardmäßig liefert OMSI eine Import-DLL für freie SRTM-Daten mit, welche in *.hgt-Dateien im Ordner \SRTM\Data hinterlegt sein müssen. Die Dateien für das Grad-Quadrat N46 und E7 bzw. N52 E13 ist bereits in OMSI hinterlegt.<br />
<br />
Der DEM-Import für OMSI läuft über DLLs, damit beliebige DEM-Importvarianten frei programmiert werden können (übrigens auch generisch-zufällige, sofern gewünscht!).<br />
<br />
Siehe hierzu: [[DEM-Import-DLLs selbst programmieren]]<br />
<br />
==== Create Roadmap ====<br />
<br />
Eine noch nicht ganz ausgereifte Funktion erlaubt es, eine zweidimensionale Landkarte der Karte zu erstellen, welche im Unterordner "texture\map" der Karte abgespeichert wird: Einerseits kachelweise mit 256 Pixel Kantenlänge, andererseits als Gesamtkarte mit 128 Pixeln Kantenlänge je Kachel.<br />
<br />
==== Convert into x terrain ====<br />
<br />
Mit dieser Funktion kann die aktuell fokussierte Kachel in eine x-Datei exportiert werden - bspw. um ein komplexeres Objekt mit starker Abhängigkeit zum Boden genau erstellen zu können. Allerdings ist zu beachten, dass die exportierte x-Datei noch nicht für den Import in Blender optimiert ist und insbesondere die Koordinaten noch vertauscht sind.<br />
<br />
== Weltkoordinaten ==<br />
<br />
Bei aktivierten Weltkoordinaten verwendet OMSI die Mercator-Projektion und unterteilt die 360° entlang der West-Ost-Richtung in 2^16 (65536) Teile. Am Äquator (40075016,69m) beträgt die Kantenlänge der Kacheln dementsprechend 611,5m, auf 50° 393,1m und am Pol theoretisch 0m (allerdings ist der Pol mit OMSI nicht erreichbar). Weitere Werte entnehmen Sie bitte der folgenden Tabelle:<br />
<br />
{| class="wikitable" style="font-size:95%;" <br />
|- class="hintergrundfarbe5"<br />
| align="left" |''geograph. Breite''<br />
| align="left" |''Kantenlänge (m)''<br />
|-<br />
| align="left" |0°<br />
| align="left" |611,496<br />
|-<br />
| align="left" |±10°<br />
| align="left" |602,206<br />
|-<br />
| align="left" |±20°<br />
| align="left" |574,618<br />
|-<br />
| align="left" |±30°<br />
| align="left" |529,571<br />
|-<br />
| align="left" |±40°<br />
| align="left" |468,433<br />
|-<br />
| align="left" |±50°<br />
| align="left" |393,062<br />
|-<br />
| align="left" |±60°<br />
| align="left" |305,748<br />
|-<br />
| align="left" |±70°<br />
| align="left" |209,144<br />
|}<br />
<br />
[[Kategorie:Nachschlagewerk für Addon-Entwickler]]</div>Marcel Kuhnthttp://wiki.omnibussimulator.de/omsiwikineu.de/index.php?title=Editor_-_%C3%9Cberblick&diff=905Editor - Überblick2014-03-05T11:06:42Z<p>Marcel Kuhnt: </p>
<hr />
<div>''Hinweis: Dieser Artikel wurde noch nicht ins Englische übersetzt!''<br />
<br />
''OMSI-Version: 1.0 - 2.0''<br />
<br />
Dieser Artikel liefert einen Überblick über alle Funktionen des OMSI-Mapeditors, geht dabei auch ins Detail, liefert aber keine einzelne Themen fokussierenden Tutorials zu einzelnen Themen.<br />
<br />
Da der Editor noch nicht fehlerfrei arbeitet und einige Funktionen (noch) nicht implementiert sind, werden auch nicht alle Kontrollelemente beschrieben.<br />
<br />
== Starten des Editors ==<br />
<br />
Um den Editor erreichen zu können, ist eine Verknüpfung z.B. auf dem Desktop zu kopieren. Dann ist darauf mit rechts zu klicken und "Eigenschaften" auszuwählen. Der Pfad im Feld "Ziel" ist um den Parameter ''-editor'' zu ergänzen. Diese Verknüpfung dient fortan dem Starten des Mapeditors.<br />
<br />
== Begriffe ==<br />
<br />
{| class="wikitable" style="font-size:95%;" <br />
|- class="hintergrundfarbe5"<br />
| align="left" |''Begriff (engl.)''<br />
| align="left" |''Begriff (dt.)''<br />
| align="left" |''Beschreibung''<br />
|-<br />
| align="left" |Tile<br />
| align="left" |Kachel<br />
| align="left" |Die Karte besteht aus zahlreichen quadratischen Kacheln. Auf Karten mit klassischen kartesischen Koordinaten haben alle Kacheln eine Kantenlänge von 300m, handelt es sich um eine Weltkoordinaten-Karte, dann schwankt die Kantenlänge in Abhängigkeit von der geographischen Breite (s.u.).<br />
|-<br />
| align="left" |Terrain<br />
| align="left" |Gelände<br />
| align="left" |Üblicherweise wird die engl. Bezeichnung ''Terrain'' gewählt. Beim Terrain handelt es sich um den Untergrund. Es handelt sich hierbei um ein Raster von 60 mal 60 Quadraten, deren Eckpunkte nach Belieben angehoben oder gesenkt werden können, wodurch Berge, Hügel oder Mulden usw. geformt werden können. Außerdem können Splines und Objekte je nach deren Eigenschaften Löcher in das Terrain schneiden. Darüber hinaus kann das Terrain mit farblichen Strukturen versehen werden.<br />
|-<br />
| align="left" |Spline<br />
| align="left" |-<br />
| align="left" |Ein in einer *.spi-Datei gespeichertes Profil wird entlang einer geraden oder gebogenen Linie extrudiert. Auf diese Weise entstehen bspw. Straßen, Gleise und Zäune in OMSI, die direkt im Map-Editor in ihrer Länge und Biegung geformt und zu längeren Verbänden aneinandergehängt werden können.<br />
|-<br />
| align="left" |DEM<br />
| align="left" |DEM<br />
| align="left" |DEM bedeutet "Digital Elevation Mesh" und steht auch stellvertretend für Datensätze, welche reale Geländeformen und -höhen beschreiben.<br />
|}<br />
<br />
== Registerkarten ==<br />
<br />
Die Editorfunktionen werden gruppiert nach den entsprechenden Registerkarten am rechten Rand erläutert.<br />
<br />
=== Tile ===<br />
<br />
==== Create New Tile Here ====<br />
<br />
Sobald der Sichtmittelpunkt auf einen Bereich außerhalb der Karte gesetzt ist, wird dieser Button aktiv und erlaubt die Erweiterung der Karte um eine Kachel an dieser Stelle.<br />
<br />
==== Add Water / Remove Water ====<br />
<br />
Stattet die Kachel mit einer Wasserebene aus. Wasserebenen können auf der Registerkarte "Terrain" in ihrer Höhe verändert werden. Normalerweise liegt das Terrain über der Wasserfläche - sobald das Terrain unter das Wasser taucht, entsteht ein See oder Fluss.<br />
<br />
==== Aerial Download (ab OMSI 2) ====<br />
<br />
Sofern die Karte mit Weltkoordinaten arbeitet, können in diesem Bereich Luftbilder heruntergeladen und angezeigt werden.<br />
<br />
Bereits heruntergeladene Luftbilder werden angezeigt, sobald der Haken "Use tile aerials" gesetzt wird.<br />
<br />
Heruntergeladen werden können Luftbilder, wenn der folgende Eintrag mit einem funktionierenden Download-Link in die Options.cfg eingetragen wird, wobei ~x, ~y und ~z für die drei Koordinaten x, y und Zoom stehen:<br />
<br />
<pre><br />
[Editor_LinkAerial]<br />
http:www.dummy.de&x=~x&y=~y&z=~z<br />
</pre><br />
<br />
Dann fokussiert man die Sicht auf die Kachel, für welche das Luftbild heruntergeladen werden soll, stellt den Schieberegler "Resolution" auf den gewünschten Wert und klickt auf "Dnl. current Tile".<br />
<br />
==== DEM (ab OMSI 2) ====<br />
<br />
Im Bereich DEM können reale Höhendaten importiert werden, sofern die Karte Weltkoordinaten nutzt. Hierfür ist zunächst die zugehörige DLL auszuwählen und der Vorgang mit "Rund curr. Tile" für die aktuell fokussierte Kachel auszuführen.<br />
<br />
Standardmäßig liefert OMSI eine Import-DLL für freie SRTM-Daten mit, welche in *.hgt-Dateien im Ordner \SRTM\Data hinterlegt sein müssen. Die Dateien für das Grad-Quadrat N46 und E7 bzw. N52 E13 ist bereits in OMSI hinterlegt.<br />
<br />
Der DEM-Import für OMSI läuft über DLLs, damit beliebige DEM-Importvarianten frei programmiert werden können (übrigens auch generisch-zufällige, sofern gewünscht!).<br />
<br />
Siehe hierzu: [[DEM-Import-DLLs selbst programmieren]]<br />
<br />
== Weltkoordinaten ==<br />
<br />
Bei aktivierten Weltkoordinaten verwendet OMSI die Mercator-Projektion und unterteilt die 360° entlang der West-Ost-Richtung in 2^16 (65536) Teile. Am Äquator (40075016,69m) beträgt die Kantenlänge der Kacheln dementsprechend 611,5m, auf 50° 393,1m und am Pol theoretisch 0m (allerdings ist der Pol mit OMSI nicht erreichbar). Weitere Werte entnehmen Sie bitte der folgenden Tabelle:<br />
<br />
{| class="wikitable" style="font-size:95%;" <br />
|- class="hintergrundfarbe5"<br />
| align="left" |''geograph. Breite''<br />
| align="left" |''Kantenlänge (m)''<br />
|-<br />
| align="left" |0°<br />
| align="left" |611,496<br />
|-<br />
| align="left" |±10°<br />
| align="left" |602,206<br />
|-<br />
| align="left" |±20°<br />
| align="left" |574,618<br />
|-<br />
| align="left" |±30°<br />
| align="left" |529,571<br />
|-<br />
| align="left" |±40°<br />
| align="left" |468,433<br />
|-<br />
| align="left" |±50°<br />
| align="left" |393,062<br />
|-<br />
| align="left" |±60°<br />
| align="left" |305,748<br />
|-<br />
| align="left" |±70°<br />
| align="left" |209,144<br />
|}<br />
<br />
[[Kategorie:Nachschlagewerk für Addon-Entwickler]]</div>Marcel Kuhnthttp://wiki.omnibussimulator.de/omsiwikineu.de/index.php?title=Editor_-_%C3%9Cberblick&diff=904Editor - Überblick2014-03-05T10:56:40Z<p>Marcel Kuhnt: /* Registerkarten */</p>
<hr />
<div>''Hinweis: Dieser Artikel wurde noch nicht ins Englische übersetzt!''<br />
<br />
''OMSI-Version: 1.0 - 2.0''<br />
<br />
Dieser Artikel liefert einen Überblick über alle Funktionen des OMSI-Mapeditors, geht dabei auch ins Detail, liefert aber keine einzelne Themen fokussierenden Tutorials zu einzelnen Themen.<br />
<br />
Da der Editor noch nicht fehlerfrei arbeitet und einige Funktionen (noch) nicht implementiert sind, werden auch nicht alle Kontrollelemente beschrieben.<br />
<br />
== Starten des Editors ==<br />
<br />
Um den Editor erreichen zu können, ist eine Verknüpfung z.B. auf dem Desktop zu kopieren. Dann ist darauf mit rechts zu klicken und "Eigenschaften" auszuwählen. Der Pfad im Feld "Ziel" ist um den Parameter ''-editor'' zu ergänzen. Diese Verknüpfung dient fortan dem Starten des Mapeditors.<br />
<br />
== Begriffe ==<br />
<br />
{| class="wikitable" style="font-size:95%;" <br />
|- class="hintergrundfarbe5"<br />
| align="left" |''Begriff (engl.)''<br />
| align="left" |''Begriff (dt.)''<br />
| align="left" |''Beschreibung''<br />
|-<br />
| align="left" |Tile<br />
| align="left" |Kachel<br />
| align="left" |Die Karte besteht aus zahlreichen quadratischen Kacheln. Auf Karten mit klassischen kartesischen Koordinaten haben alle Kacheln eine Kantenlänge von 300m, handelt es sich um eine Weltkoordinaten-Karte, dann schwankt die Kantenlänge in Abhängigkeit von der geographischen Breite (s.u.).<br />
|-<br />
| align="left" |Terrain<br />
| align="left" |Gelände<br />
| align="left" |Üblicherweise wird die engl. Bezeichnung ''Terrain'' gewählt. Beim Terrain handelt es sich um den Untergrund. Es handelt sich hierbei um ein Raster von 60 mal 60 Quadraten, deren Eckpunkte nach Belieben angehoben oder gesenkt werden können, wodurch Berge, Hügel oder Mulden usw. geformt werden können. Außerdem können Splines und Objekte je nach deren Eigenschaften Löcher in das Terrain schneiden. Darüber hinaus kann das Terrain mit farblichen Strukturen versehen werden.<br />
|-<br />
| align="left" |Spline<br />
| align="left" |-<br />
| align="left" |Ein in einer *.spi-Datei gespeichertes Profil wird entlang einer geraden oder gebogenen Linie extrudiert. Auf diese Weise entstehen bspw. Straßen, Gleise und Zäune in OMSI, die direkt im Map-Editor in ihrer Länge und Biegung geformt und zu längeren Verbänden aneinandergehängt werden können.<br />
|}<br />
<br />
== Registerkarten ==<br />
<br />
Die Editorfunktionen werden gruppiert nach den entsprechenden Registerkarten am rechten Rand erläutert.<br />
<br />
=== Tile ===<br />
<br />
==== Create New Tile Here ====<br />
<br />
Sobald der Sichtmittelpunkt auf einen Bereich außerhalb der Karte gesetzt ist, wird dieser Button aktiv und erlaubt die Erweiterung der Karte um eine Kachel an dieser Stelle.<br />
<br />
==== Add Water / Remove Water ====<br />
<br />
Stattet die Kachel mit einer Wasserebene aus. Wasserebenen können auf der Registerkarte "Terrain" in ihrer Höhe verändert werden. Normalerweise liegt das Terrain über der Wasserfläche - sobald das Terrain unter das Wasser taucht, entsteht ein See oder Fluss.<br />
<br />
==== Aerial Download ====<br />
<br />
Sofern die Karte mit Weltkoordinaten arbeitet, können in diesem Bereich Luftbilder heruntergeladen und angezeigt werden.<br />
<br />
Bereits heruntergeladene Luftbilder werden angezeigt, sobald der Haken "Use tile aerials" gesetzt wird.<br />
<br />
Heruntergeladen werden können Luftbilder, wenn der folgende Eintrag mit einem funktionierenden Download-Link in die Options.cfg eingetragen wird, wobei ~x, ~y und ~z für die drei Koordinaten x, y und Zoom stehen:<br />
<br />
<pre><br />
[Editor_LinkAerial]<br />
http:www.dummy.de&x=~x&y=~y&z=~z<br />
</pre><br />
<br />
Dann fokussiert man die Sicht auf die Kachel, für welche das Luftbild heruntergeladen werden soll, stellt den Schieberegler "Resolution" auf den gewünschten Wert und klickt auf "Dnl. current Tile".<br />
<br />
==== DEM ====<br />
<br />
== Weltkoordinaten ==<br />
<br />
Bei aktivierten Weltkoordinaten verwendet OMSI die Mercator-Projektion und unterteilt die 360° entlang der West-Ost-Richtung in 2^16 (65536) Teile. Am Äquator (40075016,69m) beträgt die Kantenlänge der Kacheln dementsprechend 611,5m, auf 50° 393,1m und am Pol theoretisch 0m (allerdings ist der Pol mit OMSI nicht erreichbar). Weitere Werte entnehmen Sie bitte der folgenden Tabelle:<br />
<br />
{| class="wikitable" style="font-size:95%;" <br />
|- class="hintergrundfarbe5"<br />
| align="left" |''geograph. Breite''<br />
| align="left" |''Kantenlänge (m)''<br />
|-<br />
| align="left" |0°<br />
| align="left" |611,496<br />
|-<br />
| align="left" |±10°<br />
| align="left" |602,206<br />
|-<br />
| align="left" |±20°<br />
| align="left" |574,618<br />
|-<br />
| align="left" |±30°<br />
| align="left" |529,571<br />
|-<br />
| align="left" |±40°<br />
| align="left" |468,433<br />
|-<br />
| align="left" |±50°<br />
| align="left" |393,062<br />
|-<br />
| align="left" |±60°<br />
| align="left" |305,748<br />
|-<br />
| align="left" |±70°<br />
| align="left" |209,144<br />
|}<br />
<br />
[[Kategorie:Nachschlagewerk für Addon-Entwickler]]</div>Marcel Kuhnthttp://wiki.omnibussimulator.de/omsiwikineu.de/index.php?title=Editor_-_%C3%9Cberblick&diff=903Editor - Überblick2014-03-05T10:46:31Z<p>Marcel Kuhnt: </p>
<hr />
<div>''Hinweis: Dieser Artikel wurde noch nicht ins Englische übersetzt!''<br />
<br />
''OMSI-Version: 1.0 - 2.0''<br />
<br />
Dieser Artikel liefert einen Überblick über alle Funktionen des OMSI-Mapeditors, geht dabei auch ins Detail, liefert aber keine einzelne Themen fokussierenden Tutorials zu einzelnen Themen.<br />
<br />
Da der Editor noch nicht fehlerfrei arbeitet und einige Funktionen (noch) nicht implementiert sind, werden auch nicht alle Kontrollelemente beschrieben.<br />
<br />
== Starten des Editors ==<br />
<br />
Um den Editor erreichen zu können, ist eine Verknüpfung z.B. auf dem Desktop zu kopieren. Dann ist darauf mit rechts zu klicken und "Eigenschaften" auszuwählen. Der Pfad im Feld "Ziel" ist um den Parameter ''-editor'' zu ergänzen. Diese Verknüpfung dient fortan dem Starten des Mapeditors.<br />
<br />
== Begriffe ==<br />
<br />
{| class="wikitable" style="font-size:95%;" <br />
|- class="hintergrundfarbe5"<br />
| align="left" |''Begriff (engl.)''<br />
| align="left" |''Begriff (dt.)''<br />
| align="left" |''Beschreibung''<br />
|-<br />
| align="left" |Tile<br />
| align="left" |Kachel<br />
| align="left" |Die Karte besteht aus zahlreichen quadratischen Kacheln. Auf Karten mit klassischen kartesischen Koordinaten haben alle Kacheln eine Kantenlänge von 300m, handelt es sich um eine Weltkoordinaten-Karte, dann schwankt die Kantenlänge in Abhängigkeit von der geographischen Breite (s.u.).<br />
|-<br />
| align="left" |Terrain<br />
| align="left" |Gelände<br />
| align="left" |Üblicherweise wird die engl. Bezeichnung ''Terrain'' gewählt. Beim Terrain handelt es sich um den Untergrund. Es handelt sich hierbei um ein Raster von 60 mal 60 Quadraten, deren Eckpunkte nach Belieben angehoben oder gesenkt werden können, wodurch Berge, Hügel oder Mulden usw. geformt werden können. Außerdem können Splines und Objekte je nach deren Eigenschaften Löcher in das Terrain schneiden. Darüber hinaus kann das Terrain mit farblichen Strukturen versehen werden.<br />
|-<br />
| align="left" |Spline<br />
| align="left" |-<br />
| align="left" |Ein in einer *.spi-Datei gespeichertes Profil wird entlang einer geraden oder gebogenen Linie extrudiert. Auf diese Weise entstehen bspw. Straßen, Gleise und Zäune in OMSI, die direkt im Map-Editor in ihrer Länge und Biegung geformt und zu längeren Verbänden aneinandergehängt werden können.<br />
|}<br />
<br />
== Registerkarten ==<br />
<br />
Die Editorfunktionen werden gruppiert nach den entsprechenden Registerkarten am rechten Rand erläutert.<br />
<br />
=== Tile ===<br />
<br />
"Create New Tile Here": Sobald der Sichtmittelpunkt auf einen Bereich außerhalb der Karte gesetzt ist, wird dieser Button aktiv und erlaubt die Erweiterung der Karte um eine Kachel an dieser Stelle.<br />
<br />
=== Add Water / Remove Water ===<br />
<br />
Stattet die Kachel mit einer Wasserebene aus. Wasserebenen können auf der Registerkarte "Terrain" in ihrer Höhe verändert werden. Normalerweise liegt das Terrain über der Wasserfläche - sobald das Terrain unter das Wasser taucht, entsteht ein See oder Fluss.<br />
<br />
=== Aerial Download ===<br />
<br />
Sofern die Karte mit Weltkoordinaten arbeitet, können in diesem Bereich Luftbilder heruntergeladen und angezeigt werden.<br />
<br />
Bereits heruntergeladene Luftbilder werden angezeigt, sobald der Haken "Use tile aerials" gesetzt wird.<br />
<br />
Heruntergeladen werden können Luftbilder, wenn der folgende Eintrag mit einem funktionierenden Download-Link in die Options.cfg eingetragen wird, wobei ~x, ~y und ~z für die drei Koordinaten x, y und Zoom stehen:<br />
<br />
<pre><br />
[Editor_LinkAerial]<br />
http:www.dummy.de&x=~x&y=~y&z=~z<br />
</pre><br />
<br />
Dann fokussiert man die Sicht auf die Kachel, für welche das Luftbild heruntergeladen werden soll, stellt den Schieberegler "Resolution" auf den gewünschten Wert und klickt auf "Dnl. current Tile".<br />
<br />
== Weltkoordinaten ==<br />
<br />
Bei aktivierten Weltkoordinaten verwendet OMSI die Mercator-Projektion und unterteilt die 360° entlang der West-Ost-Richtung in 2^16 (65536) Teile. Am Äquator (40075016,69m) beträgt die Kantenlänge der Kacheln dementsprechend 611,5m, auf 50° 393,1m und am Pol theoretisch 0m (allerdings ist der Pol mit OMSI nicht erreichbar). Weitere Werte entnehmen Sie bitte der folgenden Tabelle:<br />
<br />
{| class="wikitable" style="font-size:95%;" <br />
|- class="hintergrundfarbe5"<br />
| align="left" |''geograph. Breite''<br />
| align="left" |''Kantenlänge (m)''<br />
|-<br />
| align="left" |0°<br />
| align="left" |611,496<br />
|-<br />
| align="left" |±10°<br />
| align="left" |602,206<br />
|-<br />
| align="left" |±20°<br />
| align="left" |574,618<br />
|-<br />
| align="left" |±30°<br />
| align="left" |529,571<br />
|-<br />
| align="left" |±40°<br />
| align="left" |468,433<br />
|-<br />
| align="left" |±50°<br />
| align="left" |393,062<br />
|-<br />
| align="left" |±60°<br />
| align="left" |305,748<br />
|-<br />
| align="left" |±70°<br />
| align="left" |209,144<br />
|}<br />
<br />
[[Kategorie:Nachschlagewerk für Addon-Entwickler]]</div>Marcel Kuhnthttp://wiki.omnibussimulator.de/omsiwikineu.de/index.php?title=Editor_-_%C3%9Cberblick&diff=902Editor - Überblick2014-03-05T10:31:36Z<p>Marcel Kuhnt: </p>
<hr />
<div>''Hinweis: Dieser Artikel wurde noch nicht ins Englische übersetzt!''<br />
<br />
''OMSI-Version: 1.0 - 2.0''<br />
<br />
Dieser Artikel liefert einen Überblick über alle Funktionen des OMSI-Mapeditors, geht dabei auch ins Detail, liefert aber keine einzelne Themen fokussierenden Tutorials zu einzelnen Themen.<br />
<br />
Da der Editor noch nicht fehlerfrei arbeitet und einige Funktionen (noch) nicht implementiert sind, werden auch nicht alle Kontrollelemente beschrieben.<br />
<br />
== Starten des Editors ==<br />
<br />
Um den Editor erreichen zu können, ist eine Verknüpfung z.B. auf dem Desktop zu kopieren. Dann ist darauf mit rechts zu klicken und "Eigenschaften" auszuwählen. Der Pfad im Feld "Ziel" ist um den Parameter ''-editor'' zu ergänzen. Diese Verknüpfung dient fortan dem Starten des Mapeditors.<br />
<br />
== Begriffe ==<br />
<br />
{| class="wikitable" style="font-size:95%;" <br />
|- class="hintergrundfarbe5"<br />
| align="left" |''Begriff (engl.)''<br />
| align="left" |''Begriff (dt.)''<br />
| align="left" |''Beschreibung''<br />
|-<br />
| align="left" |Tile<br />
| align="left" |Kachel<br />
| align="left" |Die Karte besteht aus zahlreichen quadratischen Kacheln. Auf Karten mit klassischen kartesischen Koordinaten haben alle Kacheln eine Kantenlänge von 300m, handelt es sich um eine Weltkoordinaten-Karte, dann schwankt die Kantenlänge in Abhängigkeit von der geographischen Breite (s.u.).<br />
|-<br />
| align="left" |Terrain<br />
| align="left" |Gelände<br />
| align="left" |Üblicherweise wird die engl. Bezeichnung ''Terrain'' gewählt. Beim Terrain handelt es sich um den Untergrund. Es handelt sich hierbei um ein Raster von 60 mal 60 Quadraten, deren Eckpunkte nach Belieben angehoben oder gesenkt werden können, wodurch Berge, Hügel oder Mulden usw. geformt werden können. Außerdem können Splines und Objekte je nach deren Eigenschaften Löcher in das Terrain schneiden. Darüber hinaus kann das Terrain mit farblichen Strukturen versehen werden.<br />
|-<br />
| align="left" |Spline<br />
| align="left" |-<br />
| align="left" |Ein in einer *.spi-Datei gespeichertes Profil wird entlang einer geraden oder gebogenen Linie extrudiert. Auf diese Weise entstehen bspw. Straßen, Gleise und Zäune in OMSI, die direkt im Map-Editor in ihrer Länge und Biegung geformt und zu längeren Verbänden aneinandergehängt werden können.<br />
|}<br />
<br />
== Registerkarten ==<br />
<br />
Die Editorfunktionen werden gruppiert nach den entsprechenden Registerkarten am rechten Rand erläutert.<br />
<br />
=== Tile ===<br />
<br />
"Create New Tile Here": Sobald der Sichtmittelpunkt auf einen Bereich außerhalb der Karte gesetzt ist, wird dieser Button aktiv und erlaubt die Erweiterung der Karte um eine Kachel an dieser Stelle.<br />
<br />
=== Add Water / Remove Water ===<br />
<br />
Stattet die Kachel mit einer Wasserebene aus. Wasserebenen können auf der Registerkarte "Terrain" in ihrer Höhe verändert werden. Das Terrain ist normaler<br />
<br />
== Weltkoordinaten ==<br />
<br />
Bei aktivierten Weltkoordinaten verwendet OMSI die Mercator-Projektion und unterteilt die 360° entlang der West-Ost-Richtung in 2^16 (65536) Teile. Am Äquator (40075016,69m) beträgt die Kantenlänge der Kacheln dementsprechend 611,5m, auf 50° 393,1m und am Pol theoretisch 0m (allerdings ist der Pol mit OMSI nicht erreichbar). Weitere Werte entnehmen Sie bitte der folgenden Tabelle:<br />
<br />
{| class="wikitable" style="font-size:95%;" <br />
|- class="hintergrundfarbe5"<br />
| align="left" |''geograph. Breite''<br />
| align="left" |''Kantenlänge (m)''<br />
|-<br />
| align="left" |0°<br />
| align="left" |611,496<br />
|-<br />
| align="left" |±10°<br />
| align="left" |602,206<br />
|-<br />
| align="left" |±20°<br />
| align="left" |574,618<br />
|-<br />
| align="left" |±30°<br />
| align="left" |529,571<br />
|-<br />
| align="left" |±40°<br />
| align="left" |468,433<br />
|-<br />
| align="left" |±50°<br />
| align="left" |393,062<br />
|-<br />
| align="left" |±60°<br />
| align="left" |305,748<br />
|-<br />
| align="left" |±70°<br />
| align="left" |209,144<br />
|}<br />
<br />
[[Kategorie:Nachschlagewerk für Addon-Entwickler]]</div>Marcel Kuhnthttp://wiki.omnibussimulator.de/omsiwikineu.de/index.php?title=Editor_-_%C3%9Cberblick&diff=901Editor - Überblick2014-03-05T10:31:15Z<p>Marcel Kuhnt: </p>
<hr />
<div>''Hinweis: Dieser Artikel wurde noch nicht ins Englische übersetzt!''<br />
<br />
''OMSI-Version: 1.0 - 2.0''<br />
<br />
Dieser Artikel liefert einen Überblick über alle Funktionen des OMSI-Mapeditors, geht dabei auch ins Detail, liefert aber keine einzelne Themen fokussierenden Tutorials zu einzelnen Themen.<br />
<br />
Da der Editor noch nicht fehlerfrei arbeitet und einige Funktionen (noch) nicht implementiert sind, werden auch nicht alle Kontrollelemente beschrieben.<br />
<br />
== Starten des Editors ==<br />
<br />
Um den Editor erreichen zu können, ist eine Verknüpfung z.B. auf dem Desktop zu kopieren. Dann ist darauf mit rechts zu klicken und "Eigenschaften" auszuwählen. Der Pfad im Feld "Ziel" ist um den Parameter ''-editor'' zu ergänzen. Diese Verknüpfung dient fortan dem Starten des Mapeditors.<br />
<br />
== Begriffe ==<br />
<br />
{| class="wikitable" style="font-size:95%;" <br />
|- class="hintergrundfarbe5"<br />
| align="left" |''Begriff (engl.)''<br />
| align="left" |''Begriff (dt.)''<br />
| align="left" |''Beschreibung''<br />
|-<br />
| align="left" |Tile<br />
| align="left" |Kachel<br />
| align="left" |Die Karte besteht aus zahlreichen quadratischen Kacheln. Auf Karten mit klassischen kartesischen Koordinaten haben alle Kacheln eine Kantenlänge von 300m, handelt es sich um eine Weltkoordinaten-Karte, dann schwankt die Kantenlänge in Abhängigkeit von der geographischen Breite (s.u.).<br />
|-<br />
| align="left" |Terrain<br />
| align="left" |Gelände<br />
| align="left" |Üblicherweise wird die engl. Bezeichnung ''Terrain'' gewählt. Beim Terrain handelt es sich um den Untergrund. Es handelt sich hierbei um ein Raster von 60 mal 60 Quadraten, deren Eckpunkte nach Belieben angehoben oder gesenkt werden können, wodurch Berge, Hügel oder Mulden usw. geformt werden können. Außerdem können Splines und Objekte je nach deren Eigenschaften Löcher in das Terrain schneiden. Darüber hinaus kann das Terrain mit farblichen Strukturen versehen werden.<br />
| align="left" |Spline<br />
| align="left" |-<br />
| align="left" |Ein in einer *.spi-Datei gespeichertes Profil wird entlang einer geraden oder gebogenen Linie extrudiert. Auf diese Weise entstehen bspw. Straßen, Gleise und Zäune in OMSI, die direkt im Map-Editor in ihrer Länge und Biegung geformt und zu längeren Verbänden aneinandergehängt werden können.<br />
|}<br />
<br />
== Registerkarten ==<br />
<br />
Die Editorfunktionen werden gruppiert nach den entsprechenden Registerkarten am rechten Rand erläutert.<br />
<br />
=== Tile ===<br />
<br />
"Create New Tile Here": Sobald der Sichtmittelpunkt auf einen Bereich außerhalb der Karte gesetzt ist, wird dieser Button aktiv und erlaubt die Erweiterung der Karte um eine Kachel an dieser Stelle.<br />
<br />
=== Add Water / Remove Water ===<br />
<br />
Stattet die Kachel mit einer Wasserebene aus. Wasserebenen können auf der Registerkarte "Terrain" in ihrer Höhe verändert werden. Das Terrain ist normaler<br />
<br />
== Weltkoordinaten ==<br />
<br />
Bei aktivierten Weltkoordinaten verwendet OMSI die Mercator-Projektion und unterteilt die 360° entlang der West-Ost-Richtung in 2^16 (65536) Teile. Am Äquator (40075016,69m) beträgt die Kantenlänge der Kacheln dementsprechend 611,5m, auf 50° 393,1m und am Pol theoretisch 0m (allerdings ist der Pol mit OMSI nicht erreichbar). Weitere Werte entnehmen Sie bitte der folgenden Tabelle:<br />
<br />
{| class="wikitable" style="font-size:95%;" <br />
|- class="hintergrundfarbe5"<br />
| align="left" |''geograph. Breite''<br />
| align="left" |''Kantenlänge (m)''<br />
|-<br />
| align="left" |0°<br />
| align="left" |611,496<br />
|-<br />
| align="left" |±10°<br />
| align="left" |602,206<br />
|-<br />
| align="left" |±20°<br />
| align="left" |574,618<br />
|-<br />
| align="left" |±30°<br />
| align="left" |529,571<br />
|-<br />
| align="left" |±40°<br />
| align="left" |468,433<br />
|-<br />
| align="left" |±50°<br />
| align="left" |393,062<br />
|-<br />
| align="left" |±60°<br />
| align="left" |305,748<br />
|-<br />
| align="left" |±70°<br />
| align="left" |209,144<br />
|}<br />
<br />
[[Kategorie:Nachschlagewerk für Addon-Entwickler]]</div>Marcel Kuhnthttp://wiki.omnibussimulator.de/omsiwikineu.de/index.php?title=Editor_-_%C3%9Cberblick&diff=900Editor - Überblick2014-03-05T10:19:11Z<p>Marcel Kuhnt: Die Seite wurde neu angelegt: „''Hinweis: Dieser Artikel wurde noch nicht ins Englische übersetzt!'' ''OMSI-Version: 1.0 - 2.0'' Dieser Artikel liefert einen Überblick über alle Funktionen…“</p>
<hr />
<div>''Hinweis: Dieser Artikel wurde noch nicht ins Englische übersetzt!''<br />
<br />
''OMSI-Version: 1.0 - 2.0''<br />
<br />
Dieser Artikel liefert einen Überblick über alle Funktionen des OMSI-Mapeditors, geht dabei auch ins Detail, liefert aber keine einzelne Themen fokussierenden Tutorials zu einzelnen Themen.<br />
<br />
Da der Editor noch nicht fehlerfrei arbeitet und einige Funktionen (noch) nicht implementiert sind, werden auch nicht alle Kontrollelemente beschrieben.<br />
<br />
== Starten des Editors ==<br />
<br />
Um den Editor erreichen zu können, ist eine Verknüpfung z.B. auf dem Desktop zu kopieren. Dann ist darauf mit rechts zu klicken und "Eigenschaften" auszuwählen. Der Pfad im Feld "Ziel" ist um den Parameter ''-editor'' zu ergänzen. Diese Verknüpfung dient fortan dem Starten des Mapeditors.<br />
<br />
== Begriffe ==<br />
<br />
{| class="wikitable" style="font-size:95%;" <br />
|- class="hintergrundfarbe5"<br />
| align="left" |''Begriff (engl.)''<br />
| align="left" |''Begriff (dt.)''<br />
| align="left" |''Beschreibung''<br />
|-<br />
| align="left" |''Tile''<br />
| align="left" |''Kachel''<br />
| align="left" |''Die Karte besteht aus zahlreichen quadratischen Kacheln. Auf Karten mit klassischen kartesischen Koordinaten haben alle Kacheln eine Kantenlänge von 300m, handelt es sich um eine Weltkoordinaten-Karte, dann schwankt die Kantenlänge in Abhängigkeit von der geographischen Breite (s.u.).<br />
|}<br />
<br />
== Registerkarten ==<br />
<br />
Die Editorfunktionen werden gruppiert nach den entsprechenden Registerkarten am rechten Rand erläutert.<br />
<br />
=== Tile ===<br />
<br />
"Create New Tile Here": Sobald der Sichtmittelpunkt auf einen Bereich außerhalb der Karte gesetzt ist, wird dieser Button aktiv und erlaubt die Erweiterung der Karte um eine Kachel (''Tile'') an dieser Stelle.<br />
<br />
== Weltkoordinaten ==<br />
<br />
Bei aktivierten Weltkoordinaten verwendet OMSI die Mercator-Projektion und unterteilt die 360° entlang der West-Ost-Richtung in 2^16 (65536) Teile. Am Äquator (40075016,69m) beträgt die Kantenlänge der Kacheln dementsprechend 611,5m, auf 50° 393,1m und am Pol theoretisch 0m (allerdings ist der Pol mit OMSI nicht erreichbar). Weitere Werte entnehmen Sie bitte der folgenden Tabelle:<br />
<br />
{| class="wikitable" style="font-size:95%;" <br />
|- class="hintergrundfarbe5"<br />
| align="left" |''geograph. Breite''<br />
| align="left" |''Kantenlänge (m)''<br />
|-<br />
| align="left" |0°<br />
| align="left" |611,496<br />
|-<br />
| align="left" |±10°<br />
| align="left" |602,206<br />
|-<br />
| align="left" |±20°<br />
| align="left" |574,618<br />
|-<br />
| align="left" |±30°<br />
| align="left" |529,571<br />
|-<br />
| align="left" |±40°<br />
| align="left" |468,433<br />
|-<br />
| align="left" |±50°<br />
| align="left" |393,062<br />
|-<br />
| align="left" |±60°<br />
| align="left" |305,748<br />
|-<br />
| align="left" |±70°<br />
| align="left" |209,144<br />
|}<br />
<br />
[[Kategorie:Nachschlagewerk für Addon-Entwickler]]</div>Marcel Kuhnthttp://wiki.omnibussimulator.de/omsiwikineu.de/index.php?title=System-Makros&diff=885System-Makros2014-02-11T18:56:09Z<p>Marcel Kuhnt: </p>
<hr />
<div>''Hinweis: Dieser Artikel wurde noch nicht ins Englische übersetzt!''<br />
<br />
''OMSI-Version: 1.0 - 2.0''<br />
<br />
System-Makros sind spezielle im Hauptprogramm hinterlegte Makros, welche vom Skript mit dem Befehl (M.V.''makroname'') aufgerufen werden. Sie bekleiden verschiedene Funktionen und haben verschiedene Ein- und Ausgabeparameter.<br />
<br />
== Script-Texturen (gültig für Szenerie- und Fahrzeugscripts, ''nur OMSI 2'') ==<br />
<br />
Siehe auch Datei ''program\callbacklist_scripttex.txt''!<br />
<br />
{| class="wikitable" style="font-size:95%;" <br />
|- class="hintergrundfarbe5"<br />
| align="left" |''Makroname''<br />
| align="left" |''Input-Stackwerte''<br />
| align="left" |''Output-Stackwerte''<br />
| align="left" |''Beschreibung''<br />
|-<br />
| align="left" |STNewTex<br />
| align="left" |Stack0: Textur-Index, entspricht [scripttexture]-Reihenfolge in model.cfg<br />
| align="left" |-<br />
| align="left" |Scripttextur initialisieren<br />
|-<br />
| align="left" |STLock<br />
| align="left" |Stack0: Textur-Index<br />
| align="left" |-<br />
| align="left" |Scripttextur "locken", d.h. Lese- und Schreibzugriff erlauben<br />
|-<br />
| align="left" |STUnlock<br />
| align="left" |Stack0: Textur-Index<br />
| align="left" |-<br />
| align="left" |Scripttextur "unlocken", d.h. Lese- und Schreibzugriff zurücknehmen und zum Rendern freigeben<br />
|-<br />
| align="left" |STFilter<br />
| align="left" |Stack0: Textur-Index<br />
| align="left" |-<br />
| align="left" |Mipmaps erzeugen, d.h. Untervarianten in kleineren Auflösungen. Dies passiert üblicherweise nach dem Unlock, keinesfalls jedoch zwischen Lock und Unlock. Geschieht es nicht, kommt es zu Darstellungsfehlern in größeren Entfernungen ("überscharf", flimmern)<br />
|-<br />
| align="left" |STSetColor<br />
| align="left" |Stack4: Textur-Index<br />
<br />
Stack3: Alpha<br />
<br />
Stack2: Rot<br />
<br />
Stack1: Grün<br />
<br />
Stack0: Blau<br />
| align="left" |-<br />
| align="left" |Setzt die Farbe, mit dem weitere Operationen vorgenommen werden sollen<br />
|-<br />
| align="left" |STDrawPixel<br />
| align="left" |Stack2: Textur-Index<br />
<br />
Stack1: X<br />
<br />
Stack0: Y<br />
| align="left" |-<br />
| align="left" |Setzt die Farbe des mit X und Y angegebenen Pixels auf den vorgewählten Farbwert<br />
|-<br />
| align="left" |STDrawRect<br />
| align="left" |Stack4: Textur-Index<br />
<br />
Stack3: X1<br />
<br />
Stack2: Y1<br />
<br />
Stack1: X2<br />
<br />
Stack0: Y2<br />
| align="left" |-<br />
| align="left" |Zeichnet ein ausgefülltes Rechteck in der vorgewählten Farbe zwischen den angegebenen Koordinatenpaaren<br />
|-<br />
| align="left" |STTextOut<br />
| align="left" |Stack5: Textur-Index<br />
<br />
Stack4: X1<br />
<br />
Stack3: Y1<br />
<br />
Stack2: Font-Index<br />
<br />
Stack1: Vollfarbe (oder nicht?)<br />
<br />
Stack0: [http://de.wikipedia.org/wiki/Sperrsatz Sperr-Pixel]<br />
<br />
StringStack0: Zu schreibender Text<br />
| align="left" |-<br />
| align="left" |Schreibt einen Text auf die Textur. Der Font-Index kann mittels ''GetFontIndex'' geholt werden. Vollfarbe gibt an, dass der Text in der aktuell vorgewählten Farbe geschrieben werden soll, andernfalls werden die Symbole in der Farbe der Schriftart geschrieben.<br />
|-<br />
| align="left" |GetFontIndex<br />
| align="left" |StringStack0: Font-Name<br />
| align="left" |Stack0: Font-Index<br />
| align="left" |Zur Verwendung für STTextOut<br />
|-<br />
| align="left" |TextLength<br />
| align="left" |Stack0: Font-Index<br />
<br />
StringStack0: Zu prüfender Text<br />
| align="left" |Stack0: Länge in Pixeln<br />
| align="left" |Berechnet die Länge des übergebenen Textes in der gewählten Schriftart<br />
|-<br />
| align="left" |STReadPixel<br />
| align="left" |StringStack2: Textur-Index<br />
<br />
StringStack1: X<br />
<br />
StringStack0: Y<br />
| align="left" |-<br />
| align="left" |Setzt die vorgewählte Farbe auf die Farbe des angegebenen Pixels<br />
|-<br />
| align="left" |STCopyColor<br />
| align="left" |Stack1: von-Textur-Index<br />
<br />
StringStack0: nach-Textur-Index<br />
| align="left" |-<br />
| align="left" |Die vorgewählte Farbe der "nach"-Textur wird auf die vorgewählte Farbe der "von"-Textur gesetzt<br />
|-<br />
| align="left" |STLoadTex<br />
| align="left" |Stack0: Textur-Index<br />
<br />
StringStack0: Texturname<br />
| align="left" |-<br />
| align="left" |Zeichnet die per Dateiname angegebene Textur auf die Scripttextur<br />
|-<br />
| align="left" |STGetR / G / B / A<br />
| align="left" |Stack0: Textur-Index<br />
| align="left" |Stack0: Farbwert Rot/Grün/Blau/Alpha<br />
| align="left" |Gibt den entsprechenden aktuell vorgewählten Farbwert zurück<br />
|}<br />
<br />
== Szenerieobjekte ==<br />
<br />
Siehe auch Datei ''program\callbacklist_scenobj.txt''!<br />
<br />
{| class="wikitable" style="font-size:95%;" <br />
|- class="hintergrundfarbe5"<br />
| align="left" |''Makroname''<br />
| align="left" |''Input-Stackwerte''<br />
| align="left" |''Output-Stackwerte''<br />
| align="left" |''Beschreibung''<br />
| align="left" |''Beispiel''<br />
|-<br />
| align="left" |GetArrBusLine<br />
| align="left" |Stack0: Index des ankommenden Busses<br />
| align="left" |Stringstack0: Liniennummer des ankommenden Busses<br />
| align="left" |Hierzu muss das Szenerieobjekt per "Parent to..."-Funktion mit einer Bushaltestelle verbunden sein. Dann schreibt diese Funktion in den Stringstack0 die Liniennummer des Busses, welcher in der Reihenfolge der Ankünfte an der durch Index angegebenen Stelle kommt (nullbasiert!)<br />
| align="left" |0 (M.V.GetArrBusLine) liefert die Liniennummer des nächsten Busses, 1 (M.V.GetArrBusLine) die des übernächsten Busses.<br />
|-<br />
| align="left" |GetArrBusTerminus<br />
| align="left" |Stack0: Index des ankommenden Busses<br />
| align="left" |Stringstack0: Ziel des ankommenden Busses<br />
| align="left" |Funktioniert wie ''GetArrBusLine'' und liefert die Endhaltestelle des Busses.<br />
| align="left" |0 (M.V.GetArrBusTerminus) liefert die Endhaltestelle des nächsten Busses, 1 (M.V.GetArrBusTerminus) die des übernächsten Busses.<br />
|-<br />
| align="left" |GetArrBusTimeDiff<br />
| align="left" |Stack0: Index des ankommenden Busses<br />
| align="left" |Stack0: Zeitdauer bis Bus an Haltestelle ankommt<br />
| align="left" |Funktioniert wie ''GetArrBusLine'' und liefert die Zeit (in Sekunden), bis der per Index gewählte Bus an der Haltestelle ankommt.<br />
| align="left" |0 (M.V.GetArrBusTimeDiff) liefert die Ankunftszeitdauer des nächsten Busses, 1 (M.V.GetArrBusTimeDiff) die des übernächsten Busses.<br />
|}<br />
<br />
== Fahrzeuge ==<br />
<br />
Siehe auch Datei ''program\callbacklist_roadvehicle.txt''!<br />
<br />
{| class="wikitable" style="font-size:95%;" <br />
|- class="hintergrundfarbe5"<br />
| align="left" |''Makroname''<br />
| align="left" |''Input-Stackwerte''<br />
| align="left" |''Output-Stackwerte''<br />
| align="left" |''Beschreibung''<br />
| align="left" |''Beispiel''<br />
| align="left" |''ab OMSI-Vs.''<br />
|-<br />
| align="left" |GetRouteIndex<br />
| align="left" |Stack0: Route-Code<br />
| align="left" |Stack0: Route-Index<br />
| align="left" |Sucht in der Hofdatei die zum gegebenen Route-Code gehörigen Route-Index.<br />
| align="left" |-<br />
| align="left" |1.00<br />
|-<br />
| align="left" |GetBusstopString<br />
| align="left" |Stack1: Haltestellen-Index, Stack0: String-Index<br />
| align="left" |Stringstack0: Haltestellen-Stringinhalt<br />
| align="left" |Liefert aus der Hofdatei den stack0'ten String der stack1'ten Haltestelle. Beide Indizes sind [[http://de.wikipedia.org/wiki/Z%C3%A4hlen#Z.C3.A4hlen_ab_0 nullbasiert]].<br />
| align="left" |5 2 (M.V.GetBusstopString) liefert den Inhalt des Strings Nr. 2 der Haltestelle Nr. 5<br />
| align="left" |1.00<br />
|-<br />
| align="left" |GetTerminusString<br />
| align="left" |Stack1: Terminus-Index, Stack0: String-Index<br />
| align="left" |Stringstack0: Endhaltestellen-Stringinhalt<br />
| align="left" |Liefert aus der Hofdatei den stack0'ten String der stack1'ten Endhaltestelle (Terminus). Beide Indizes sind [[http://de.wikipedia.org/wiki/Z%C3%A4hlen#Z.C3.A4hlen_ab_0 nullbasiert]].<br />
| align="left" |7 3 (M.V.GetBusstopString) liefert den Inhalt des Strings Nr. 3 der Endhaltestelle Nr. 7<br />
| align="left" |1.00<br />
|-<br />
| align="left" |GetRouteTerminusIndex<br />
| align="left" |Stack0: Route-Index (nullbasiert)<br />
| align="left" |Stack0: Terminus-Index (nullbasiert)<br />
| align="left" |Liefert den zur vorgegebenen Route zugehörigen Terminus/Endhaltestellen-Index. Über ''GetTerminusString'' kann dann wiederum der Name der Endhaltestelle geholt werden.<br />
| align="left" |-<br />
| align="left" |1.00<br />
|-<br />
| align="left" |GetTerminusIndex<br />
| align="left" |Stack0: Terminus-Code<br />
| align="left" |Stack0: Terminus-Index<br />
| align="left" |Sucht in der Hofdatei die zum gegebenen Terminus-Code gehörigen Terminus-Index.<br />
| align="left" |-<br />
| align="left" |1.00<br />
|-<br />
| align="left" |GetTerminusCode<br />
| align="left" |Stack0: Terminus-Index<br />
| align="left" |Stack0: Terminus-Code<br />
| align="left" |Gibt den in der Hofdatei zum gegebenen Terminus-Index gehörigen Terminus-Code zurück und ist somit die Umkehrfunktion von ''GetTerminusIndex''.<br />
| align="left" |-<br />
| align="left" |1.00<br />
|-<br />
| align="left" |GetBusstopCount<br />
| align="left" |Stack0: Route-Index<br />
| align="left" |Stack0: Haltestellenanzahl<br />
| align="left" |Gibt die Anzahl der Haltestellen der per Index gewählten Route zurück. Da es sich hier um eine Anzahl handelt, ist diese auch nicht nullbasiert - hat die Route also zwei Haltestellen, ist auch das Ergebnis dieser Funktion "2".<br />
| align="left" |-<br />
| align="left" |1.00<br />
|-<br />
| align="left" |GiveChangeCoin<br />
| align="left" |Stack0: Münz-Index<br />
| align="left" |-<br />
| align="left" |Sorgt für das Auswerfen der Münze mit dem Index Stack0, z.B. beim Geldwechsler-Script.<br />
| align="left" |2 (M.V.GiveChangeCoin) wirft die Münze mit dem Index 2 aus.<br />
| align="left" |1.00<br />
|-<br />
| align="left" |GetRouteBusstopIdent<br />
| align="left" |Stack1: Route-Index, Stack0: Route-Busstop-Index<br />
| align="left" |Stringstack0: Ident der Bushaltestelle<br />
| align="left" |Liefert den Ident der Stack0'ten Bushaltestelle in der Route Stack1. Wiederum nullbasierte Indizes.<br />
| align="left" |3 6 (M.V.GetRouteBusstopIdent) liefert also den Index der 6. Bushaltestelle der 3. Route.<br />
| align="left" |1.00<br />
|-<br />
| align="left" |GetBusstopIndex<br />
| align="left" |Stringstack0: Ident der Bushaltestelle<br />
| align="left" |Stack0: Index der Bushaltestelle<br />
| align="left" |Sucht den Index der über den Ident bezeichneten Bushaltestelle.<br />
| align="left" |"Reimerweg" (M.V.GetBusstopIndex) liefert den Index der Haltestelle Reimerweg.<br />
| align="left" |1.00<br />
|-<br />
| align="left" |GetTTBusstopCount<br />
| align="left" |-<br />
| align="left" |Stack0: Anzahl der Haltestellen<br />
| align="left" |Liefert die Anzahl der Haltestellen des aktuellen Fahrplans<br />
| align="left" |-<br />
| align="left" |1.00<br />
|-<br />
| align="left" |GetTTBusstopIndex<br />
| align="left" |-<br />
| align="left" |Stack0: Index der aktuellen Haltestelle<br />
| align="left" |Liefert den Index der aktuellen Haltestelle des aktuellen Fahrplans<br />
| align="left" |-<br />
| align="left" |1.00<br />
|-<br />
| align="left" |GetTTTerminusIndex<br />
| align="left" |-<br />
| align="left" |Stack0: Index der Endhaltestelle<br />
| align="left" |Liefert den Index der Endhaltestelle des aktuellen Fahrplans<br />
| align="left" |-<br />
| align="left" |1.00<br />
|-<br />
| align="left" |GetTTLineString<br />
| align="left" |-<br />
| align="left" |Stringstack0: Liniennummer<br />
| align="left" |Liefert die Liniennummer des aktuellen Fahrplans<br />
| align="left" |-<br />
| align="left" |1.00<br />
|-<br />
| align="left" |GetTTDelay<br />
| align="left" |-<br />
| align="left" |Stack0: Verspätung in Sekunden<br />
| align="left" |Liefert die aktuelle Verspätung gemäß aktivem Fahrplan<br />
| align="left" |-<br />
| align="left" |1.00<br />
|-<br />
| align="left" |GetTTBusstopName<br />
| align="left" |Stack0: Index der Haltestelle im aktuellen Fahrplan<br />
| align="left" |Stringstack0: Name der Haltestelle<br />
| align="left" |Liefert den Namen der Haltestelle, die sich im aktuellen Fahrplan an stack0'ter Stelle befindet<br />
| align="left" |-<br />
| align="left" |1.00<br />
|-<br />
| align="left" |GetTTBusstopDep<br />
| align="left" |Stack0: Index der Haltestelle im aktuellen Fahrplan<br />
| align="left" |STack0: Abfahrtszeit in Sekunden<br />
| align="left" |Liefert die Abfahrtszeit an der Haltestelle, die sich im aktuellen Fahrplan an stack0'ter Stelle befindet<br />
| align="left" |-<br />
| align="left" |1.00<br />
|-<br />
| align="left" |GetTTBusstopArr<br />
| align="left" |Stack0: Index der Haltestelle im aktuellen Fahrplan<br />
| align="left" |STack0: Ankunftszeit in Sekunden<br />
| align="left" |Liefert die Ankunftszeit an der Haltestelle, die sich im aktuellen Fahrplan an stack0'ter Stelle befindet<br />
| align="left" |-<br />
| align="left" |1.00<br />
|-<br />
| align="left" |GetTicketName<br />
| align="left" |Stack0: Ticket-Index<br />
| align="left" |Stringstack0: Ticket-Name<br />
| align="left" |Liefert den Namen der über Index indizierten Fahrkartentype (nullbasiert)<br />
| align="left" |-<br />
| align="left" |1.00<br />
|-<br />
| align="left" |GetTicketValue<br />
| align="left" |Stack0: Ticket-Index<br />
| align="left" |Stack0: Ticket-Preis<br />
| align="left" |Liefert den Preis der über Index indizierten Fahrkartentype (nullbasiert)<br />
| align="left" |-<br />
| align="left" |1.00<br />
|-<br />
| align="left" |GetHumanCountOnPathLink<br />
| align="left" |Stack0: Pathlink-Index<br />
| align="left" |Stack0: Fahrgast-Anzahl<br />
| align="left" |Gibt die Anzahl der Fahrgäste zurück, die sich aktuell auf dem angegebenen Pfadstück befinden<br />
| align="left" |-<br />
| align="left" |1.03<br />
|-<br />
| align="left" |NrSpecRandom<br />
| align="left" |Stack0: Seed<br />
| align="left" |Stack0: Random-Wert<br />
| align="left" |Gibt einen Fahrzeugnummer-spezifischen Zufallswert zurück. Der Clou dabei ist, dass die Kombination Seed und Fahrzeugnummer immer denselben Zufallswert ergibt! Möchte man für ein spezifisches Fahrzeug mehrere verschiedene Zufallswerte (für verschiedene Anwendungszwecke) einsetzen, dann benutzt man einfach unterschiedliche Seed-Werte. Welcher Seed-Wert letztlich genutzt wird, ist (da es ja ein Zufallswert ist) letztlich egal.<br />
| align="left" |-<br />
| align="left" |2.00<br />
|-<br />
| align="left" |GetHeightAbovePoint<br />
| align="left" |Stack2: x<br />
<br />
Stack1: y<br />
<br />
Stack0: z<br />
| align="left" |Stack0: Höhe über Grund<br />
| align="left" |Gibt die Höhe über dem Untergrund (Terrain, Straße oder Gehweg) zurück, gemessen entlang der negativen, lokalen Z-Achse des Fahrzeuges, ausgehend vom durch x, y und z definierten Punkt (lokales Koordinatensystem).<br />
| align="left" |-<br />
| align="left" |2.00<br />
|-<br />
| align="left" |GetDepotStringGlobal<br />
| align="left" |Stack0: String-Index<br />
| align="left" |StringStack0: Global-String aus Hofdatei<br />
| align="left" |Gibt einen String aus der aktuell eingestellten Hofdatei zurück; diese werden in der Hofdatei mit dem Befehl [global_strings] definiert; der String-Index entspricht dann der nullbasierten Position in der Liste.<br />
| align="left" |-<br />
| align="left" |2.00<br />
|}<br />
<br />
[[Kategorie:Nachschlagewerk für Addon-Entwickler]]</div>Marcel Kuhnthttp://wiki.omnibussimulator.de/omsiwikineu.de/index.php?title=System-Makros&diff=884System-Makros2014-02-11T18:55:32Z<p>Marcel Kuhnt: /* Fahrzeuge */</p>
<hr />
<div>''Hinweis: Dieser Artikel wurde noch nicht ins Englische übersetzt!''<br />
<br />
System-Makros sind spezielle im Hauptprogramm hinterlegte Makros, welche vom Skript mit dem Befehl (M.V.''makroname'') aufgerufen werden. Sie bekleiden verschiedene Funktionen und haben verschiedene Ein- und Ausgabeparameter.<br />
<br />
== Script-Texturen (gültig für Szenerie- und Fahrzeugscripts, ''nur OMSI 2'') ==<br />
<br />
Siehe auch Datei ''program\callbacklist_scripttex.txt''!<br />
<br />
{| class="wikitable" style="font-size:95%;" <br />
|- class="hintergrundfarbe5"<br />
| align="left" |''Makroname''<br />
| align="left" |''Input-Stackwerte''<br />
| align="left" |''Output-Stackwerte''<br />
| align="left" |''Beschreibung''<br />
|-<br />
| align="left" |STNewTex<br />
| align="left" |Stack0: Textur-Index, entspricht [scripttexture]-Reihenfolge in model.cfg<br />
| align="left" |-<br />
| align="left" |Scripttextur initialisieren<br />
|-<br />
| align="left" |STLock<br />
| align="left" |Stack0: Textur-Index<br />
| align="left" |-<br />
| align="left" |Scripttextur "locken", d.h. Lese- und Schreibzugriff erlauben<br />
|-<br />
| align="left" |STUnlock<br />
| align="left" |Stack0: Textur-Index<br />
| align="left" |-<br />
| align="left" |Scripttextur "unlocken", d.h. Lese- und Schreibzugriff zurücknehmen und zum Rendern freigeben<br />
|-<br />
| align="left" |STFilter<br />
| align="left" |Stack0: Textur-Index<br />
| align="left" |-<br />
| align="left" |Mipmaps erzeugen, d.h. Untervarianten in kleineren Auflösungen. Dies passiert üblicherweise nach dem Unlock, keinesfalls jedoch zwischen Lock und Unlock. Geschieht es nicht, kommt es zu Darstellungsfehlern in größeren Entfernungen ("überscharf", flimmern)<br />
|-<br />
| align="left" |STSetColor<br />
| align="left" |Stack4: Textur-Index<br />
<br />
Stack3: Alpha<br />
<br />
Stack2: Rot<br />
<br />
Stack1: Grün<br />
<br />
Stack0: Blau<br />
| align="left" |-<br />
| align="left" |Setzt die Farbe, mit dem weitere Operationen vorgenommen werden sollen<br />
|-<br />
| align="left" |STDrawPixel<br />
| align="left" |Stack2: Textur-Index<br />
<br />
Stack1: X<br />
<br />
Stack0: Y<br />
| align="left" |-<br />
| align="left" |Setzt die Farbe des mit X und Y angegebenen Pixels auf den vorgewählten Farbwert<br />
|-<br />
| align="left" |STDrawRect<br />
| align="left" |Stack4: Textur-Index<br />
<br />
Stack3: X1<br />
<br />
Stack2: Y1<br />
<br />
Stack1: X2<br />
<br />
Stack0: Y2<br />
| align="left" |-<br />
| align="left" |Zeichnet ein ausgefülltes Rechteck in der vorgewählten Farbe zwischen den angegebenen Koordinatenpaaren<br />
|-<br />
| align="left" |STTextOut<br />
| align="left" |Stack5: Textur-Index<br />
<br />
Stack4: X1<br />
<br />
Stack3: Y1<br />
<br />
Stack2: Font-Index<br />
<br />
Stack1: Vollfarbe (oder nicht?)<br />
<br />
Stack0: [http://de.wikipedia.org/wiki/Sperrsatz Sperr-Pixel]<br />
<br />
StringStack0: Zu schreibender Text<br />
| align="left" |-<br />
| align="left" |Schreibt einen Text auf die Textur. Der Font-Index kann mittels ''GetFontIndex'' geholt werden. Vollfarbe gibt an, dass der Text in der aktuell vorgewählten Farbe geschrieben werden soll, andernfalls werden die Symbole in der Farbe der Schriftart geschrieben.<br />
|-<br />
| align="left" |GetFontIndex<br />
| align="left" |StringStack0: Font-Name<br />
| align="left" |Stack0: Font-Index<br />
| align="left" |Zur Verwendung für STTextOut<br />
|-<br />
| align="left" |TextLength<br />
| align="left" |Stack0: Font-Index<br />
<br />
StringStack0: Zu prüfender Text<br />
| align="left" |Stack0: Länge in Pixeln<br />
| align="left" |Berechnet die Länge des übergebenen Textes in der gewählten Schriftart<br />
|-<br />
| align="left" |STReadPixel<br />
| align="left" |StringStack2: Textur-Index<br />
<br />
StringStack1: X<br />
<br />
StringStack0: Y<br />
| align="left" |-<br />
| align="left" |Setzt die vorgewählte Farbe auf die Farbe des angegebenen Pixels<br />
|-<br />
| align="left" |STCopyColor<br />
| align="left" |Stack1: von-Textur-Index<br />
<br />
StringStack0: nach-Textur-Index<br />
| align="left" |-<br />
| align="left" |Die vorgewählte Farbe der "nach"-Textur wird auf die vorgewählte Farbe der "von"-Textur gesetzt<br />
|-<br />
| align="left" |STLoadTex<br />
| align="left" |Stack0: Textur-Index<br />
<br />
StringStack0: Texturname<br />
| align="left" |-<br />
| align="left" |Zeichnet die per Dateiname angegebene Textur auf die Scripttextur<br />
|-<br />
| align="left" |STGetR / G / B / A<br />
| align="left" |Stack0: Textur-Index<br />
| align="left" |Stack0: Farbwert Rot/Grün/Blau/Alpha<br />
| align="left" |Gibt den entsprechenden aktuell vorgewählten Farbwert zurück<br />
|}<br />
<br />
== Szenerieobjekte ==<br />
<br />
Siehe auch Datei ''program\callbacklist_scenobj.txt''!<br />
<br />
{| class="wikitable" style="font-size:95%;" <br />
|- class="hintergrundfarbe5"<br />
| align="left" |''Makroname''<br />
| align="left" |''Input-Stackwerte''<br />
| align="left" |''Output-Stackwerte''<br />
| align="left" |''Beschreibung''<br />
| align="left" |''Beispiel''<br />
|-<br />
| align="left" |GetArrBusLine<br />
| align="left" |Stack0: Index des ankommenden Busses<br />
| align="left" |Stringstack0: Liniennummer des ankommenden Busses<br />
| align="left" |Hierzu muss das Szenerieobjekt per "Parent to..."-Funktion mit einer Bushaltestelle verbunden sein. Dann schreibt diese Funktion in den Stringstack0 die Liniennummer des Busses, welcher in der Reihenfolge der Ankünfte an der durch Index angegebenen Stelle kommt (nullbasiert!)<br />
| align="left" |0 (M.V.GetArrBusLine) liefert die Liniennummer des nächsten Busses, 1 (M.V.GetArrBusLine) die des übernächsten Busses.<br />
|-<br />
| align="left" |GetArrBusTerminus<br />
| align="left" |Stack0: Index des ankommenden Busses<br />
| align="left" |Stringstack0: Ziel des ankommenden Busses<br />
| align="left" |Funktioniert wie ''GetArrBusLine'' und liefert die Endhaltestelle des Busses.<br />
| align="left" |0 (M.V.GetArrBusTerminus) liefert die Endhaltestelle des nächsten Busses, 1 (M.V.GetArrBusTerminus) die des übernächsten Busses.<br />
|-<br />
| align="left" |GetArrBusTimeDiff<br />
| align="left" |Stack0: Index des ankommenden Busses<br />
| align="left" |Stack0: Zeitdauer bis Bus an Haltestelle ankommt<br />
| align="left" |Funktioniert wie ''GetArrBusLine'' und liefert die Zeit (in Sekunden), bis der per Index gewählte Bus an der Haltestelle ankommt.<br />
| align="left" |0 (M.V.GetArrBusTimeDiff) liefert die Ankunftszeitdauer des nächsten Busses, 1 (M.V.GetArrBusTimeDiff) die des übernächsten Busses.<br />
|}<br />
<br />
== Fahrzeuge ==<br />
<br />
Siehe auch Datei ''program\callbacklist_roadvehicle.txt''!<br />
<br />
{| class="wikitable" style="font-size:95%;" <br />
|- class="hintergrundfarbe5"<br />
| align="left" |''Makroname''<br />
| align="left" |''Input-Stackwerte''<br />
| align="left" |''Output-Stackwerte''<br />
| align="left" |''Beschreibung''<br />
| align="left" |''Beispiel''<br />
| align="left" |''ab OMSI-Vs.''<br />
|-<br />
| align="left" |GetRouteIndex<br />
| align="left" |Stack0: Route-Code<br />
| align="left" |Stack0: Route-Index<br />
| align="left" |Sucht in der Hofdatei die zum gegebenen Route-Code gehörigen Route-Index.<br />
| align="left" |-<br />
| align="left" |1.00<br />
|-<br />
| align="left" |GetBusstopString<br />
| align="left" |Stack1: Haltestellen-Index, Stack0: String-Index<br />
| align="left" |Stringstack0: Haltestellen-Stringinhalt<br />
| align="left" |Liefert aus der Hofdatei den stack0'ten String der stack1'ten Haltestelle. Beide Indizes sind [[http://de.wikipedia.org/wiki/Z%C3%A4hlen#Z.C3.A4hlen_ab_0 nullbasiert]].<br />
| align="left" |5 2 (M.V.GetBusstopString) liefert den Inhalt des Strings Nr. 2 der Haltestelle Nr. 5<br />
| align="left" |1.00<br />
|-<br />
| align="left" |GetTerminusString<br />
| align="left" |Stack1: Terminus-Index, Stack0: String-Index<br />
| align="left" |Stringstack0: Endhaltestellen-Stringinhalt<br />
| align="left" |Liefert aus der Hofdatei den stack0'ten String der stack1'ten Endhaltestelle (Terminus). Beide Indizes sind [[http://de.wikipedia.org/wiki/Z%C3%A4hlen#Z.C3.A4hlen_ab_0 nullbasiert]].<br />
| align="left" |7 3 (M.V.GetBusstopString) liefert den Inhalt des Strings Nr. 3 der Endhaltestelle Nr. 7<br />
| align="left" |1.00<br />
|-<br />
| align="left" |GetRouteTerminusIndex<br />
| align="left" |Stack0: Route-Index (nullbasiert)<br />
| align="left" |Stack0: Terminus-Index (nullbasiert)<br />
| align="left" |Liefert den zur vorgegebenen Route zugehörigen Terminus/Endhaltestellen-Index. Über ''GetTerminusString'' kann dann wiederum der Name der Endhaltestelle geholt werden.<br />
| align="left" |-<br />
| align="left" |1.00<br />
|-<br />
| align="left" |GetTerminusIndex<br />
| align="left" |Stack0: Terminus-Code<br />
| align="left" |Stack0: Terminus-Index<br />
| align="left" |Sucht in der Hofdatei die zum gegebenen Terminus-Code gehörigen Terminus-Index.<br />
| align="left" |-<br />
| align="left" |1.00<br />
|-<br />
| align="left" |GetTerminusCode<br />
| align="left" |Stack0: Terminus-Index<br />
| align="left" |Stack0: Terminus-Code<br />
| align="left" |Gibt den in der Hofdatei zum gegebenen Terminus-Index gehörigen Terminus-Code zurück und ist somit die Umkehrfunktion von ''GetTerminusIndex''.<br />
| align="left" |-<br />
| align="left" |1.00<br />
|-<br />
| align="left" |GetBusstopCount<br />
| align="left" |Stack0: Route-Index<br />
| align="left" |Stack0: Haltestellenanzahl<br />
| align="left" |Gibt die Anzahl der Haltestellen der per Index gewählten Route zurück. Da es sich hier um eine Anzahl handelt, ist diese auch nicht nullbasiert - hat die Route also zwei Haltestellen, ist auch das Ergebnis dieser Funktion "2".<br />
| align="left" |-<br />
| align="left" |1.00<br />
|-<br />
| align="left" |GiveChangeCoin<br />
| align="left" |Stack0: Münz-Index<br />
| align="left" |-<br />
| align="left" |Sorgt für das Auswerfen der Münze mit dem Index Stack0, z.B. beim Geldwechsler-Script.<br />
| align="left" |2 (M.V.GiveChangeCoin) wirft die Münze mit dem Index 2 aus.<br />
| align="left" |1.00<br />
|-<br />
| align="left" |GetRouteBusstopIdent<br />
| align="left" |Stack1: Route-Index, Stack0: Route-Busstop-Index<br />
| align="left" |Stringstack0: Ident der Bushaltestelle<br />
| align="left" |Liefert den Ident der Stack0'ten Bushaltestelle in der Route Stack1. Wiederum nullbasierte Indizes.<br />
| align="left" |3 6 (M.V.GetRouteBusstopIdent) liefert also den Index der 6. Bushaltestelle der 3. Route.<br />
| align="left" |1.00<br />
|-<br />
| align="left" |GetBusstopIndex<br />
| align="left" |Stringstack0: Ident der Bushaltestelle<br />
| align="left" |Stack0: Index der Bushaltestelle<br />
| align="left" |Sucht den Index der über den Ident bezeichneten Bushaltestelle.<br />
| align="left" |"Reimerweg" (M.V.GetBusstopIndex) liefert den Index der Haltestelle Reimerweg.<br />
| align="left" |1.00<br />
|-<br />
| align="left" |GetTTBusstopCount<br />
| align="left" |-<br />
| align="left" |Stack0: Anzahl der Haltestellen<br />
| align="left" |Liefert die Anzahl der Haltestellen des aktuellen Fahrplans<br />
| align="left" |-<br />
| align="left" |1.00<br />
|-<br />
| align="left" |GetTTBusstopIndex<br />
| align="left" |-<br />
| align="left" |Stack0: Index der aktuellen Haltestelle<br />
| align="left" |Liefert den Index der aktuellen Haltestelle des aktuellen Fahrplans<br />
| align="left" |-<br />
| align="left" |1.00<br />
|-<br />
| align="left" |GetTTTerminusIndex<br />
| align="left" |-<br />
| align="left" |Stack0: Index der Endhaltestelle<br />
| align="left" |Liefert den Index der Endhaltestelle des aktuellen Fahrplans<br />
| align="left" |-<br />
| align="left" |1.00<br />
|-<br />
| align="left" |GetTTLineString<br />
| align="left" |-<br />
| align="left" |Stringstack0: Liniennummer<br />
| align="left" |Liefert die Liniennummer des aktuellen Fahrplans<br />
| align="left" |-<br />
| align="left" |1.00<br />
|-<br />
| align="left" |GetTTDelay<br />
| align="left" |-<br />
| align="left" |Stack0: Verspätung in Sekunden<br />
| align="left" |Liefert die aktuelle Verspätung gemäß aktivem Fahrplan<br />
| align="left" |-<br />
| align="left" |1.00<br />
|-<br />
| align="left" |GetTTBusstopName<br />
| align="left" |Stack0: Index der Haltestelle im aktuellen Fahrplan<br />
| align="left" |Stringstack0: Name der Haltestelle<br />
| align="left" |Liefert den Namen der Haltestelle, die sich im aktuellen Fahrplan an stack0'ter Stelle befindet<br />
| align="left" |-<br />
| align="left" |1.00<br />
|-<br />
| align="left" |GetTTBusstopDep<br />
| align="left" |Stack0: Index der Haltestelle im aktuellen Fahrplan<br />
| align="left" |STack0: Abfahrtszeit in Sekunden<br />
| align="left" |Liefert die Abfahrtszeit an der Haltestelle, die sich im aktuellen Fahrplan an stack0'ter Stelle befindet<br />
| align="left" |-<br />
| align="left" |1.00<br />
|-<br />
| align="left" |GetTTBusstopArr<br />
| align="left" |Stack0: Index der Haltestelle im aktuellen Fahrplan<br />
| align="left" |STack0: Ankunftszeit in Sekunden<br />
| align="left" |Liefert die Ankunftszeit an der Haltestelle, die sich im aktuellen Fahrplan an stack0'ter Stelle befindet<br />
| align="left" |-<br />
| align="left" |1.00<br />
|-<br />
| align="left" |GetTicketName<br />
| align="left" |Stack0: Ticket-Index<br />
| align="left" |Stringstack0: Ticket-Name<br />
| align="left" |Liefert den Namen der über Index indizierten Fahrkartentype (nullbasiert)<br />
| align="left" |-<br />
| align="left" |1.00<br />
|-<br />
| align="left" |GetTicketValue<br />
| align="left" |Stack0: Ticket-Index<br />
| align="left" |Stack0: Ticket-Preis<br />
| align="left" |Liefert den Preis der über Index indizierten Fahrkartentype (nullbasiert)<br />
| align="left" |-<br />
| align="left" |1.00<br />
|-<br />
| align="left" |GetHumanCountOnPathLink<br />
| align="left" |Stack0: Pathlink-Index<br />
| align="left" |Stack0: Fahrgast-Anzahl<br />
| align="left" |Gibt die Anzahl der Fahrgäste zurück, die sich aktuell auf dem angegebenen Pfadstück befinden<br />
| align="left" |-<br />
| align="left" |1.03<br />
|-<br />
| align="left" |NrSpecRandom<br />
| align="left" |Stack0: Seed<br />
| align="left" |Stack0: Random-Wert<br />
| align="left" |Gibt einen Fahrzeugnummer-spezifischen Zufallswert zurück. Der Clou dabei ist, dass die Kombination Seed und Fahrzeugnummer immer denselben Zufallswert ergibt! Möchte man für ein spezifisches Fahrzeug mehrere verschiedene Zufallswerte (für verschiedene Anwendungszwecke) einsetzen, dann benutzt man einfach unterschiedliche Seed-Werte. Welcher Seed-Wert letztlich genutzt wird, ist (da es ja ein Zufallswert ist) letztlich egal.<br />
| align="left" |-<br />
| align="left" |2.00<br />
|-<br />
| align="left" |GetHeightAbovePoint<br />
| align="left" |Stack2: x<br />
<br />
Stack1: y<br />
<br />
Stack0: z<br />
| align="left" |Stack0: Höhe über Grund<br />
| align="left" |Gibt die Höhe über dem Untergrund (Terrain, Straße oder Gehweg) zurück, gemessen entlang der negativen, lokalen Z-Achse des Fahrzeuges, ausgehend vom durch x, y und z definierten Punkt (lokales Koordinatensystem).<br />
| align="left" |-<br />
| align="left" |2.00<br />
|-<br />
| align="left" |GetDepotStringGlobal<br />
| align="left" |Stack0: String-Index<br />
| align="left" |StringStack0: Global-String aus Hofdatei<br />
| align="left" |Gibt einen String aus der aktuell eingestellten Hofdatei zurück; diese werden in der Hofdatei mit dem Befehl [global_strings] definiert; der String-Index entspricht dann der nullbasierten Position in der Liste.<br />
| align="left" |-<br />
| align="left" |2.00<br />
|}<br />
<br />
[[Kategorie:Nachschlagewerk für Addon-Entwickler]]</div>Marcel Kuhnthttp://wiki.omnibussimulator.de/omsiwikineu.de/index.php?title=System-Makros&diff=883System-Makros2014-02-11T18:45:27Z<p>Marcel Kuhnt: /* Fahrzeuge */</p>
<hr />
<div>''Hinweis: Dieser Artikel wurde noch nicht ins Englische übersetzt!''<br />
<br />
System-Makros sind spezielle im Hauptprogramm hinterlegte Makros, welche vom Skript mit dem Befehl (M.V.''makroname'') aufgerufen werden. Sie bekleiden verschiedene Funktionen und haben verschiedene Ein- und Ausgabeparameter.<br />
<br />
== Script-Texturen (gültig für Szenerie- und Fahrzeugscripts, ''nur OMSI 2'') ==<br />
<br />
Siehe auch Datei ''program\callbacklist_scripttex.txt''!<br />
<br />
{| class="wikitable" style="font-size:95%;" <br />
|- class="hintergrundfarbe5"<br />
| align="left" |''Makroname''<br />
| align="left" |''Input-Stackwerte''<br />
| align="left" |''Output-Stackwerte''<br />
| align="left" |''Beschreibung''<br />
|-<br />
| align="left" |STNewTex<br />
| align="left" |Stack0: Textur-Index, entspricht [scripttexture]-Reihenfolge in model.cfg<br />
| align="left" |-<br />
| align="left" |Scripttextur initialisieren<br />
|-<br />
| align="left" |STLock<br />
| align="left" |Stack0: Textur-Index<br />
| align="left" |-<br />
| align="left" |Scripttextur "locken", d.h. Lese- und Schreibzugriff erlauben<br />
|-<br />
| align="left" |STUnlock<br />
| align="left" |Stack0: Textur-Index<br />
| align="left" |-<br />
| align="left" |Scripttextur "unlocken", d.h. Lese- und Schreibzugriff zurücknehmen und zum Rendern freigeben<br />
|-<br />
| align="left" |STFilter<br />
| align="left" |Stack0: Textur-Index<br />
| align="left" |-<br />
| align="left" |Mipmaps erzeugen, d.h. Untervarianten in kleineren Auflösungen. Dies passiert üblicherweise nach dem Unlock, keinesfalls jedoch zwischen Lock und Unlock. Geschieht es nicht, kommt es zu Darstellungsfehlern in größeren Entfernungen ("überscharf", flimmern)<br />
|-<br />
| align="left" |STSetColor<br />
| align="left" |Stack4: Textur-Index<br />
<br />
Stack3: Alpha<br />
<br />
Stack2: Rot<br />
<br />
Stack1: Grün<br />
<br />
Stack0: Blau<br />
| align="left" |-<br />
| align="left" |Setzt die Farbe, mit dem weitere Operationen vorgenommen werden sollen<br />
|-<br />
| align="left" |STDrawPixel<br />
| align="left" |Stack2: Textur-Index<br />
<br />
Stack1: X<br />
<br />
Stack0: Y<br />
| align="left" |-<br />
| align="left" |Setzt die Farbe des mit X und Y angegebenen Pixels auf den vorgewählten Farbwert<br />
|-<br />
| align="left" |STDrawRect<br />
| align="left" |Stack4: Textur-Index<br />
<br />
Stack3: X1<br />
<br />
Stack2: Y1<br />
<br />
Stack1: X2<br />
<br />
Stack0: Y2<br />
| align="left" |-<br />
| align="left" |Zeichnet ein ausgefülltes Rechteck in der vorgewählten Farbe zwischen den angegebenen Koordinatenpaaren<br />
|-<br />
| align="left" |STTextOut<br />
| align="left" |Stack5: Textur-Index<br />
<br />
Stack4: X1<br />
<br />
Stack3: Y1<br />
<br />
Stack2: Font-Index<br />
<br />
Stack1: Vollfarbe (oder nicht?)<br />
<br />
Stack0: [http://de.wikipedia.org/wiki/Sperrsatz Sperr-Pixel]<br />
<br />
StringStack0: Zu schreibender Text<br />
| align="left" |-<br />
| align="left" |Schreibt einen Text auf die Textur. Der Font-Index kann mittels ''GetFontIndex'' geholt werden. Vollfarbe gibt an, dass der Text in der aktuell vorgewählten Farbe geschrieben werden soll, andernfalls werden die Symbole in der Farbe der Schriftart geschrieben.<br />
|-<br />
| align="left" |GetFontIndex<br />
| align="left" |StringStack0: Font-Name<br />
| align="left" |Stack0: Font-Index<br />
| align="left" |Zur Verwendung für STTextOut<br />
|-<br />
| align="left" |TextLength<br />
| align="left" |Stack0: Font-Index<br />
<br />
StringStack0: Zu prüfender Text<br />
| align="left" |Stack0: Länge in Pixeln<br />
| align="left" |Berechnet die Länge des übergebenen Textes in der gewählten Schriftart<br />
|-<br />
| align="left" |STReadPixel<br />
| align="left" |StringStack2: Textur-Index<br />
<br />
StringStack1: X<br />
<br />
StringStack0: Y<br />
| align="left" |-<br />
| align="left" |Setzt die vorgewählte Farbe auf die Farbe des angegebenen Pixels<br />
|-<br />
| align="left" |STCopyColor<br />
| align="left" |Stack1: von-Textur-Index<br />
<br />
StringStack0: nach-Textur-Index<br />
| align="left" |-<br />
| align="left" |Die vorgewählte Farbe der "nach"-Textur wird auf die vorgewählte Farbe der "von"-Textur gesetzt<br />
|-<br />
| align="left" |STLoadTex<br />
| align="left" |Stack0: Textur-Index<br />
<br />
StringStack0: Texturname<br />
| align="left" |-<br />
| align="left" |Zeichnet die per Dateiname angegebene Textur auf die Scripttextur<br />
|-<br />
| align="left" |STGetR / G / B / A<br />
| align="left" |Stack0: Textur-Index<br />
| align="left" |Stack0: Farbwert Rot/Grün/Blau/Alpha<br />
| align="left" |Gibt den entsprechenden aktuell vorgewählten Farbwert zurück<br />
|}<br />
<br />
== Szenerieobjekte ==<br />
<br />
Siehe auch Datei ''program\callbacklist_scenobj.txt''!<br />
<br />
{| class="wikitable" style="font-size:95%;" <br />
|- class="hintergrundfarbe5"<br />
| align="left" |''Makroname''<br />
| align="left" |''Input-Stackwerte''<br />
| align="left" |''Output-Stackwerte''<br />
| align="left" |''Beschreibung''<br />
| align="left" |''Beispiel''<br />
|-<br />
| align="left" |GetArrBusLine<br />
| align="left" |Stack0: Index des ankommenden Busses<br />
| align="left" |Stringstack0: Liniennummer des ankommenden Busses<br />
| align="left" |Hierzu muss das Szenerieobjekt per "Parent to..."-Funktion mit einer Bushaltestelle verbunden sein. Dann schreibt diese Funktion in den Stringstack0 die Liniennummer des Busses, welcher in der Reihenfolge der Ankünfte an der durch Index angegebenen Stelle kommt (nullbasiert!)<br />
| align="left" |0 (M.V.GetArrBusLine) liefert die Liniennummer des nächsten Busses, 1 (M.V.GetArrBusLine) die des übernächsten Busses.<br />
|-<br />
| align="left" |GetArrBusTerminus<br />
| align="left" |Stack0: Index des ankommenden Busses<br />
| align="left" |Stringstack0: Ziel des ankommenden Busses<br />
| align="left" |Funktioniert wie ''GetArrBusLine'' und liefert die Endhaltestelle des Busses.<br />
| align="left" |0 (M.V.GetArrBusTerminus) liefert die Endhaltestelle des nächsten Busses, 1 (M.V.GetArrBusTerminus) die des übernächsten Busses.<br />
|-<br />
| align="left" |GetArrBusTimeDiff<br />
| align="left" |Stack0: Index des ankommenden Busses<br />
| align="left" |Stack0: Zeitdauer bis Bus an Haltestelle ankommt<br />
| align="left" |Funktioniert wie ''GetArrBusLine'' und liefert die Zeit (in Sekunden), bis der per Index gewählte Bus an der Haltestelle ankommt.<br />
| align="left" |0 (M.V.GetArrBusTimeDiff) liefert die Ankunftszeitdauer des nächsten Busses, 1 (M.V.GetArrBusTimeDiff) die des übernächsten Busses.<br />
|}<br />
<br />
== Fahrzeuge ==<br />
<br />
Siehe auch Datei ''program\callbacklist_roadvehicle.txt''!<br />
<br />
{| class="wikitable" style="font-size:95%;" <br />
|- class="hintergrundfarbe5"<br />
| align="left" |''Makroname''<br />
| align="left" |''Input-Stackwerte''<br />
| align="left" |''Output-Stackwerte''<br />
| align="left" |''Beschreibung''<br />
| align="left" |''Beispiel''<br />
| align="left" |''ab OMSI-Vs.''<br />
|-<br />
| align="left" |GetRouteIndex<br />
| align="left" |Stack0: Route-Code<br />
| align="left" |Stack0: Route-Index<br />
| align="left" |Sucht in der Hofdatei die zum gegebenen Route-Code gehörigen Route-Index.<br />
| align="left" |-<br />
| align="left" |1.00<br />
|-<br />
| align="left" |GetBusstopString<br />
| align="left" |Stack1: Haltestellen-Index, Stack0: String-Index<br />
| align="left" |Stringstack0: Haltestellen-Stringinhalt<br />
| align="left" |Liefert aus der Hofdatei den stack0'ten String der stack1'ten Haltestelle. Beide Indizes sind [[http://de.wikipedia.org/wiki/Z%C3%A4hlen#Z.C3.A4hlen_ab_0 nullbasiert]].<br />
| align="left" |5 2 (M.V.GetBusstopString) liefert den Inhalt des Strings Nr. 2 der Haltestelle Nr. 5<br />
| align="left" |1.00<br />
|-<br />
| align="left" |GetTerminusString<br />
| align="left" |Stack1: Terminus-Index, Stack0: String-Index<br />
| align="left" |Stringstack0: Endhaltestellen-Stringinhalt<br />
| align="left" |Liefert aus der Hofdatei den stack0'ten String der stack1'ten Endhaltestelle (Terminus). Beide Indizes sind [[http://de.wikipedia.org/wiki/Z%C3%A4hlen#Z.C3.A4hlen_ab_0 nullbasiert]].<br />
| align="left" |7 3 (M.V.GetBusstopString) liefert den Inhalt des Strings Nr. 3 der Endhaltestelle Nr. 7<br />
| align="left" |1.00<br />
|-<br />
| align="left" |GetRouteTerminusIndex<br />
| align="left" |Stack0: Route-Index (nullbasiert)<br />
| align="left" |Stack0: Terminus-Index (nullbasiert)<br />
| align="left" |Liefert den zur vorgegebenen Route zugehörigen Terminus/Endhaltestellen-Index. Über ''GetTerminusString'' kann dann wiederum der Name der Endhaltestelle geholt werden.<br />
| align="left" |-<br />
| align="left" |1.00<br />
|-<br />
| align="left" |GetTerminusIndex<br />
| align="left" |Stack0: Terminus-Code<br />
| align="left" |Stack0: Terminus-Index<br />
| align="left" |Sucht in der Hofdatei die zum gegebenen Terminus-Code gehörigen Terminus-Index.<br />
| align="left" |-<br />
| align="left" |1.00<br />
|-<br />
| align="left" |GetTerminusCode<br />
| align="left" |Stack0: Terminus-Index<br />
| align="left" |Stack0: Terminus-Code<br />
| align="left" |Gibt den in der Hofdatei zum gegebenen Terminus-Index gehörigen Terminus-Code zurück und ist somit die Umkehrfunktion von ''GetTerminusIndex''.<br />
| align="left" |-<br />
| align="left" |1.00<br />
|-<br />
| align="left" |GetBusstopCount<br />
| align="left" |Stack0: Route-Index<br />
| align="left" |Stack0: Haltestellenanzahl<br />
| align="left" |Gibt die Anzahl der Haltestellen der per Index gewählten Route zurück. Da es sich hier um eine Anzahl handelt, ist diese auch nicht nullbasiert - hat die Route also zwei Haltestellen, ist auch das Ergebnis dieser Funktion "2".<br />
| align="left" |-<br />
| align="left" |1.00<br />
|-<br />
| align="left" |GiveChangeCoin<br />
| align="left" |Stack0: Münz-Index<br />
| align="left" |-<br />
| align="left" |Sorgt für das Auswerfen der Münze mit dem Index Stack0, z.B. beim Geldwechsler-Script.<br />
| align="left" |2 (M.V.GiveChangeCoin) wirft die Münze mit dem Index 2 aus.<br />
| align="left" |1.00<br />
|-<br />
| align="left" |GetRouteBusstopIdent<br />
| align="left" |Stack1: Route-Index, Stack0: Route-Busstop-Index<br />
| align="left" |Stringstack0: Ident der Bushaltestelle<br />
| align="left" |Liefert den Ident der Stack0'ten Bushaltestelle in der Route Stack1. Wiederum nullbasierte Indizes.<br />
| align="left" |3 6 (M.V.GetRouteBusstopIdent) liefert also den Index der 6. Bushaltestelle der 3. Route.<br />
| align="left" |1.00<br />
|-<br />
| align="left" |GetBusstopIndex<br />
| align="left" |Stringstack0: Ident der Bushaltestelle<br />
| align="left" |Stack0: Index der Bushaltestelle<br />
| align="left" |Sucht den Index der über den Ident bezeichneten Bushaltestelle.<br />
| align="left" |"Reimerweg" (M.V.GetBusstopIndex) liefert den Index der Haltestelle Reimerweg.<br />
| align="left" |1.00<br />
|-<br />
| align="left" |GetTTBusstopCount<br />
| align="left" |-<br />
| align="left" |Stack0: Anzahl der Haltestellen<br />
| align="left" |Liefert die Anzahl der Haltestellen des aktuellen Fahrplans<br />
| align="left" |-<br />
| align="left" |1.00<br />
|-<br />
| align="left" |GetTTBusstopIndex<br />
| align="left" |-<br />
| align="left" |Stack0: Index der aktuellen Haltestelle<br />
| align="left" |Liefert den Index der aktuellen Haltestelle des aktuellen Fahrplans<br />
| align="left" |-<br />
| align="left" |1.00<br />
|-<br />
| align="left" |GetTTTerminusIndex<br />
| align="left" |-<br />
| align="left" |Stack0: Index der Endhaltestelle<br />
| align="left" |Liefert den Index der Endhaltestelle des aktuellen Fahrplans<br />
| align="left" |-<br />
| align="left" |1.00<br />
|-<br />
| align="left" |GetTTLineString<br />
| align="left" |-<br />
| align="left" |Stringstack0: Liniennummer<br />
| align="left" |Liefert die Liniennummer des aktuellen Fahrplans<br />
| align="left" |-<br />
| align="left" |1.00<br />
|-<br />
| align="left" |GetTTDelay<br />
| align="left" |-<br />
| align="left" |Stack0: Verspätung in Sekunden<br />
| align="left" |Liefert die aktuelle Verspätung gemäß aktivem Fahrplan<br />
| align="left" |-<br />
| align="left" |1.00<br />
|-<br />
| align="left" |GetTTBusstopName<br />
| align="left" |Stack0: Index der Haltestelle im aktuellen Fahrplan<br />
| align="left" |Stringstack0: Name der Haltestelle<br />
| align="left" |Liefert den Namen der Haltestelle, die sich im aktuellen Fahrplan an stack0'ter Stelle befindet<br />
| align="left" |-<br />
| align="left" |1.00<br />
|-<br />
| align="left" |GetTTBusstopDep<br />
| align="left" |Stack0: Index der Haltestelle im aktuellen Fahrplan<br />
| align="left" |STack0: Abfahrtszeit in Sekunden<br />
| align="left" |Liefert die Abfahrtszeit an der Haltestelle, die sich im aktuellen Fahrplan an stack0'ter Stelle befindet<br />
| align="left" |-<br />
| align="left" |1.00<br />
|-<br />
| align="left" |GetTTBusstopArr<br />
| align="left" |Stack0: Index der Haltestelle im aktuellen Fahrplan<br />
| align="left" |STack0: Ankunftszeit in Sekunden<br />
| align="left" |Liefert die Ankunftszeit an der Haltestelle, die sich im aktuellen Fahrplan an stack0'ter Stelle befindet<br />
| align="left" |-<br />
| align="left" |1.00<br />
|-<br />
| align="left" |GetTicketName<br />
| align="left" |Stack0: Ticket-Index<br />
| align="left" |Stringstack0: Ticket-Name<br />
| align="left" |Liefert den Namen der über Index indizierten Fahrkartentype (nullbasiert)<br />
| align="left" |-<br />
| align="left" |1.00<br />
|-<br />
| align="left" |GetTicketValue<br />
| align="left" |Stack0: Ticket-Index<br />
| align="left" |Stack0: Ticket-Preis<br />
| align="left" |Liefert den Preis der über Index indizierten Fahrkartentype (nullbasiert)<br />
| align="left" |-<br />
| align="left" |1.00<br />
|}<br />
<br />
[[Kategorie:Nachschlagewerk für Addon-Entwickler]]</div>Marcel Kuhnthttp://wiki.omnibussimulator.de/omsiwikineu.de/index.php?title=System-Makros&diff=882System-Makros2014-02-11T18:43:40Z<p>Marcel Kuhnt: /* Script-Texturen (gültig für Szenerie- und Fahrzeugscripts, nur OMSI 2) */</p>
<hr />
<div>''Hinweis: Dieser Artikel wurde noch nicht ins Englische übersetzt!''<br />
<br />
System-Makros sind spezielle im Hauptprogramm hinterlegte Makros, welche vom Skript mit dem Befehl (M.V.''makroname'') aufgerufen werden. Sie bekleiden verschiedene Funktionen und haben verschiedene Ein- und Ausgabeparameter.<br />
<br />
== Script-Texturen (gültig für Szenerie- und Fahrzeugscripts, ''nur OMSI 2'') ==<br />
<br />
Siehe auch Datei ''program\callbacklist_scripttex.txt''!<br />
<br />
{| class="wikitable" style="font-size:95%;" <br />
|- class="hintergrundfarbe5"<br />
| align="left" |''Makroname''<br />
| align="left" |''Input-Stackwerte''<br />
| align="left" |''Output-Stackwerte''<br />
| align="left" |''Beschreibung''<br />
|-<br />
| align="left" |STNewTex<br />
| align="left" |Stack0: Textur-Index, entspricht [scripttexture]-Reihenfolge in model.cfg<br />
| align="left" |-<br />
| align="left" |Scripttextur initialisieren<br />
|-<br />
| align="left" |STLock<br />
| align="left" |Stack0: Textur-Index<br />
| align="left" |-<br />
| align="left" |Scripttextur "locken", d.h. Lese- und Schreibzugriff erlauben<br />
|-<br />
| align="left" |STUnlock<br />
| align="left" |Stack0: Textur-Index<br />
| align="left" |-<br />
| align="left" |Scripttextur "unlocken", d.h. Lese- und Schreibzugriff zurücknehmen und zum Rendern freigeben<br />
|-<br />
| align="left" |STFilter<br />
| align="left" |Stack0: Textur-Index<br />
| align="left" |-<br />
| align="left" |Mipmaps erzeugen, d.h. Untervarianten in kleineren Auflösungen. Dies passiert üblicherweise nach dem Unlock, keinesfalls jedoch zwischen Lock und Unlock. Geschieht es nicht, kommt es zu Darstellungsfehlern in größeren Entfernungen ("überscharf", flimmern)<br />
|-<br />
| align="left" |STSetColor<br />
| align="left" |Stack4: Textur-Index<br />
<br />
Stack3: Alpha<br />
<br />
Stack2: Rot<br />
<br />
Stack1: Grün<br />
<br />
Stack0: Blau<br />
| align="left" |-<br />
| align="left" |Setzt die Farbe, mit dem weitere Operationen vorgenommen werden sollen<br />
|-<br />
| align="left" |STDrawPixel<br />
| align="left" |Stack2: Textur-Index<br />
<br />
Stack1: X<br />
<br />
Stack0: Y<br />
| align="left" |-<br />
| align="left" |Setzt die Farbe des mit X und Y angegebenen Pixels auf den vorgewählten Farbwert<br />
|-<br />
| align="left" |STDrawRect<br />
| align="left" |Stack4: Textur-Index<br />
<br />
Stack3: X1<br />
<br />
Stack2: Y1<br />
<br />
Stack1: X2<br />
<br />
Stack0: Y2<br />
| align="left" |-<br />
| align="left" |Zeichnet ein ausgefülltes Rechteck in der vorgewählten Farbe zwischen den angegebenen Koordinatenpaaren<br />
|-<br />
| align="left" |STTextOut<br />
| align="left" |Stack5: Textur-Index<br />
<br />
Stack4: X1<br />
<br />
Stack3: Y1<br />
<br />
Stack2: Font-Index<br />
<br />
Stack1: Vollfarbe (oder nicht?)<br />
<br />
Stack0: [http://de.wikipedia.org/wiki/Sperrsatz Sperr-Pixel]<br />
<br />
StringStack0: Zu schreibender Text<br />
| align="left" |-<br />
| align="left" |Schreibt einen Text auf die Textur. Der Font-Index kann mittels ''GetFontIndex'' geholt werden. Vollfarbe gibt an, dass der Text in der aktuell vorgewählten Farbe geschrieben werden soll, andernfalls werden die Symbole in der Farbe der Schriftart geschrieben.<br />
|-<br />
| align="left" |GetFontIndex<br />
| align="left" |StringStack0: Font-Name<br />
| align="left" |Stack0: Font-Index<br />
| align="left" |Zur Verwendung für STTextOut<br />
|-<br />
| align="left" |TextLength<br />
| align="left" |Stack0: Font-Index<br />
<br />
StringStack0: Zu prüfender Text<br />
| align="left" |Stack0: Länge in Pixeln<br />
| align="left" |Berechnet die Länge des übergebenen Textes in der gewählten Schriftart<br />
|-<br />
| align="left" |STReadPixel<br />
| align="left" |StringStack2: Textur-Index<br />
<br />
StringStack1: X<br />
<br />
StringStack0: Y<br />
| align="left" |-<br />
| align="left" |Setzt die vorgewählte Farbe auf die Farbe des angegebenen Pixels<br />
|-<br />
| align="left" |STCopyColor<br />
| align="left" |Stack1: von-Textur-Index<br />
<br />
StringStack0: nach-Textur-Index<br />
| align="left" |-<br />
| align="left" |Die vorgewählte Farbe der "nach"-Textur wird auf die vorgewählte Farbe der "von"-Textur gesetzt<br />
|-<br />
| align="left" |STLoadTex<br />
| align="left" |Stack0: Textur-Index<br />
<br />
StringStack0: Texturname<br />
| align="left" |-<br />
| align="left" |Zeichnet die per Dateiname angegebene Textur auf die Scripttextur<br />
|-<br />
| align="left" |STGetR / G / B / A<br />
| align="left" |Stack0: Textur-Index<br />
| align="left" |Stack0: Farbwert Rot/Grün/Blau/Alpha<br />
| align="left" |Gibt den entsprechenden aktuell vorgewählten Farbwert zurück<br />
|}<br />
<br />
== Szenerieobjekte ==<br />
<br />
Siehe auch Datei ''program\callbacklist_scenobj.txt''!<br />
<br />
{| class="wikitable" style="font-size:95%;" <br />
|- class="hintergrundfarbe5"<br />
| align="left" |''Makroname''<br />
| align="left" |''Input-Stackwerte''<br />
| align="left" |''Output-Stackwerte''<br />
| align="left" |''Beschreibung''<br />
| align="left" |''Beispiel''<br />
|-<br />
| align="left" |GetArrBusLine<br />
| align="left" |Stack0: Index des ankommenden Busses<br />
| align="left" |Stringstack0: Liniennummer des ankommenden Busses<br />
| align="left" |Hierzu muss das Szenerieobjekt per "Parent to..."-Funktion mit einer Bushaltestelle verbunden sein. Dann schreibt diese Funktion in den Stringstack0 die Liniennummer des Busses, welcher in der Reihenfolge der Ankünfte an der durch Index angegebenen Stelle kommt (nullbasiert!)<br />
| align="left" |0 (M.V.GetArrBusLine) liefert die Liniennummer des nächsten Busses, 1 (M.V.GetArrBusLine) die des übernächsten Busses.<br />
|-<br />
| align="left" |GetArrBusTerminus<br />
| align="left" |Stack0: Index des ankommenden Busses<br />
| align="left" |Stringstack0: Ziel des ankommenden Busses<br />
| align="left" |Funktioniert wie ''GetArrBusLine'' und liefert die Endhaltestelle des Busses.<br />
| align="left" |0 (M.V.GetArrBusTerminus) liefert die Endhaltestelle des nächsten Busses, 1 (M.V.GetArrBusTerminus) die des übernächsten Busses.<br />
|-<br />
| align="left" |GetArrBusTimeDiff<br />
| align="left" |Stack0: Index des ankommenden Busses<br />
| align="left" |Stack0: Zeitdauer bis Bus an Haltestelle ankommt<br />
| align="left" |Funktioniert wie ''GetArrBusLine'' und liefert die Zeit (in Sekunden), bis der per Index gewählte Bus an der Haltestelle ankommt.<br />
| align="left" |0 (M.V.GetArrBusTimeDiff) liefert die Ankunftszeitdauer des nächsten Busses, 1 (M.V.GetArrBusTimeDiff) die des übernächsten Busses.<br />
|}<br />
<br />
== Fahrzeuge ==<br />
<br />
Siehe auch Datei ''program\callbacklist_roadvehicle.txt''!<br />
<br />
{| class="wikitable" style="font-size:95%;" <br />
|- class="hintergrundfarbe5"<br />
| align="left" |''Makroname''<br />
| align="left" |''Input-Stackwerte''<br />
| align="left" |''Output-Stackwerte''<br />
| align="left" |''Beschreibung''<br />
| align="left" |''Beispiel''<br />
|-<br />
| align="left" |GetRouteIndex<br />
| align="left" |Stack0: Route-Code<br />
| align="left" |Stack0: Route-Index<br />
| align="left" |Sucht in der Hofdatei die zum gegebenen Route-Code gehörigen Route-Index.<br />
| align="left" |-<br />
|-<br />
| align="left" |GetBusstopString<br />
| align="left" |Stack1: Haltestellen-Index, Stack0: String-Index<br />
| align="left" |Stringstack0: Haltestellen-Stringinhalt<br />
| align="left" |Liefert aus der Hofdatei den stack0'ten String der stack1'ten Haltestelle. Beide Indizes sind [[http://de.wikipedia.org/wiki/Z%C3%A4hlen#Z.C3.A4hlen_ab_0 nullbasiert]].<br />
| align="left" |5 2 (M.V.GetBusstopString) liefert den Inhalt des Strings Nr. 2 der Haltestelle Nr. 5<br />
|-<br />
| align="left" |GetTerminusString<br />
| align="left" |Stack1: Terminus-Index, Stack0: String-Index<br />
| align="left" |Stringstack0: Endhaltestellen-Stringinhalt<br />
| align="left" |Liefert aus der Hofdatei den stack0'ten String der stack1'ten Endhaltestelle (Terminus). Beide Indizes sind [[http://de.wikipedia.org/wiki/Z%C3%A4hlen#Z.C3.A4hlen_ab_0 nullbasiert]].<br />
| align="left" |7 3 (M.V.GetBusstopString) liefert den Inhalt des Strings Nr. 3 der Endhaltestelle Nr. 7<br />
|-<br />
| align="left" |GetRouteTerminusIndex<br />
| align="left" |Stack0: Route-Index (nullbasiert)<br />
| align="left" |Stack0: Terminus-Index (nullbasiert)<br />
| align="left" |Liefert den zur vorgegebenen Route zugehörigen Terminus/Endhaltestellen-Index. Über ''GetTerminusString'' kann dann wiederum der Name der Endhaltestelle geholt werden.<br />
| align="left" |-<br />
|-<br />
| align="left" |GetTerminusIndex<br />
| align="left" |Stack0: Terminus-Code<br />
| align="left" |Stack0: Terminus-Index<br />
| align="left" |Sucht in der Hofdatei die zum gegebenen Terminus-Code gehörigen Terminus-Index.<br />
| align="left" |-<br />
|-<br />
| align="left" |GetTerminusCode<br />
| align="left" |Stack0: Terminus-Index<br />
| align="left" |Stack0: Terminus-Code<br />
| align="left" |Gibt den in der Hofdatei zum gegebenen Terminus-Index gehörigen Terminus-Code zurück und ist somit die Umkehrfunktion von ''GetTerminusIndex''.<br />
| align="left" |-<br />
|-<br />
| align="left" |GetBusstopCount<br />
| align="left" |Stack0: Route-Index<br />
| align="left" |Stack0: Haltestellenanzahl<br />
| align="left" |Gibt die Anzahl der Haltestellen der per Index gewählten Route zurück. Da es sich hier um eine Anzahl handelt, ist diese auch nicht nullbasiert - hat die Route also zwei Haltestellen, ist auch das Ergebnis dieser Funktion "2".<br />
| align="left" |-<br />
|-<br />
| align="left" |GiveChangeCoin<br />
| align="left" |Stack0: Münz-Index<br />
| align="left" |-<br />
| align="left" |Sorgt für das Auswerfen der Münze mit dem Index Stack0, z.B. beim Geldwechsler-Script.<br />
| align="left" |2 (M.V.GiveChangeCoin) wirft die Münze mit dem Index 2 aus.<br />
|-<br />
| align="left" |GetRouteBusstopIdent<br />
| align="left" |Stack1: Route-Index, Stack0: Route-Busstop-Index<br />
| align="left" |Stringstack0: Ident der Bushaltestelle<br />
| align="left" |Liefert den Ident der Stack0'ten Bushaltestelle in der Route Stack1. Wiederum nullbasierte Indizes.<br />
| align="left" |3 6 (M.V.GetRouteBusstopIdent) liefert also den Index der 6. Bushaltestelle der 3. Route.<br />
|-<br />
| align="left" |GetBusstopIndex<br />
| align="left" |Stringstack0: Ident der Bushaltestelle<br />
| align="left" |Stack0: Index der Bushaltestelle<br />
| align="left" |Sucht den Index der über den Ident bezeichneten Bushaltestelle.<br />
| align="left" |"Reimerweg" (M.V.GetBusstopIndex) liefert den Index der Haltestelle Reimerweg.<br />
|-<br />
| align="left" |GetTTBusstopCount<br />
| align="left" |-<br />
| align="left" |Stack0: Anzahl der Haltestellen<br />
| align="left" |Liefert die Anzahl der Haltestellen des aktuellen Fahrplans<br />
| align="left" |-<br />
|-<br />
| align="left" |GetTTBusstopIndex<br />
| align="left" |-<br />
| align="left" |Stack0: Index der aktuellen Haltestelle<br />
| align="left" |Liefert den Index der aktuellen Haltestelle des aktuellen Fahrplans<br />
| align="left" |-<br />
|-<br />
| align="left" |GetTTTerminusIndex<br />
| align="left" |-<br />
| align="left" |Stack0: Index der Endhaltestelle<br />
| align="left" |Liefert den Index der Endhaltestelle des aktuellen Fahrplans<br />
| align="left" |-<br />
|-<br />
| align="left" |GetTTLineString<br />
| align="left" |-<br />
| align="left" |Stringstack0: Liniennummer<br />
| align="left" |Liefert die Liniennummer des aktuellen Fahrplans<br />
| align="left" |-<br />
|-<br />
| align="left" |GetTTDelay<br />
| align="left" |-<br />
| align="left" |Stack0: Verspätung in Sekunden<br />
| align="left" |Liefert die aktuelle Verspätung gemäß aktivem Fahrplan<br />
| align="left" |-<br />
|-<br />
| align="left" |GetTTBusstopName<br />
| align="left" |Stack0: Index der Haltestelle im aktuellen Fahrplan<br />
| align="left" |Stringstack0: Name der Haltestelle<br />
| align="left" |Liefert den Namen der Haltestelle, die sich im aktuellen Fahrplan an stack0'ter Stelle befindet<br />
| align="left" |-<br />
|-<br />
| align="left" |GetTTBusstopDep<br />
| align="left" |Stack0: Index der Haltestelle im aktuellen Fahrplan<br />
| align="left" |STack0: Abfahrtszeit in Sekunden<br />
| align="left" |Liefert die Abfahrtszeit an der Haltestelle, die sich im aktuellen Fahrplan an stack0'ter Stelle befindet<br />
| align="left" |-<br />
|-<br />
| align="left" |GetTTBusstopArr<br />
| align="left" |Stack0: Index der Haltestelle im aktuellen Fahrplan<br />
| align="left" |STack0: Ankunftszeit in Sekunden<br />
| align="left" |Liefert die Ankunftszeit an der Haltestelle, die sich im aktuellen Fahrplan an stack0'ter Stelle befindet<br />
| align="left" |-<br />
|-<br />
| align="left" |GetTicketName<br />
| align="left" |Stack0: Ticket-Index<br />
| align="left" |Stringstack0: Ticket-Name<br />
| align="left" |Liefert den Namen der über Index indizierten Fahrkartentype (nullbasiert)<br />
| align="left" |-<br />
|-<br />
| align="left" |GetTicketValue<br />
| align="left" |Stack0: Ticket-Index<br />
| align="left" |Stack0: Ticket-Preis<br />
| align="left" |Liefert den Preis der über Index indizierten Fahrkartentype (nullbasiert)<br />
| align="left" |-<br />
|}<br />
<br />
[[Kategorie:Nachschlagewerk für Addon-Entwickler]]</div>Marcel Kuhnthttp://wiki.omnibussimulator.de/omsiwikineu.de/index.php?title=System-Makros&diff=881System-Makros2014-02-11T17:13:36Z<p>Marcel Kuhnt: /* Script-Texturen (gültig für Szenerie- und Fahrzeugscripts, nur OMSI 2) */</p>
<hr />
<div>''Hinweis: Dieser Artikel wurde noch nicht ins Englische übersetzt!''<br />
<br />
System-Makros sind spezielle im Hauptprogramm hinterlegte Makros, welche vom Skript mit dem Befehl (M.V.''makroname'') aufgerufen werden. Sie bekleiden verschiedene Funktionen und haben verschiedene Ein- und Ausgabeparameter.<br />
<br />
== Script-Texturen (gültig für Szenerie- und Fahrzeugscripts, ''nur OMSI 2'') ==<br />
<br />
Siehe auch Datei ''program\callbacklist_scripttex.txt''!<br />
<br />
{| class="wikitable" style="font-size:95%;" <br />
|- class="hintergrundfarbe5"<br />
| align="left" |''Makroname''<br />
| align="left" |''Input-Stackwerte''<br />
| align="left" |''Output-Stackwerte''<br />
| align="left" |''Beschreibung''<br />
|-<br />
| align="left" |STNewTex<br />
| align="left" |Stack0: Textur-Index, entspricht [scripttexture]-Reihenfolge in model.cfg<br />
| align="left" |-<br />
| align="left" |Scripttextur initialisieren<br />
|-<br />
| align="left" |STLock<br />
| align="left" |Stack0: Textur-Index<br />
| align="left" |-<br />
| align="left" |Scripttextur "locken", d.h. Lese- und Schreibzugriff erlauben<br />
|-<br />
| align="left" |STUnlock<br />
| align="left" |Stack0: Textur-Index<br />
| align="left" |-<br />
| align="left" |Scripttextur "unlocken", d.h. Lese- und Schreibzugriff zurücknehmen und zum Rendern freigeben<br />
|-<br />
| align="left" |STFilter<br />
| align="left" |Stack0: Textur-Index<br />
| align="left" |-<br />
| align="left" |Mipmaps erzeugen, d.h. Untervarianten in kleineren Auflösungen. Dies passiert üblicherweise nach dem Unlock, keinesfalls jedoch zwischen Lock und Unlock. Geschieht es nicht, kommt es zu Darstellungsfehlern in größeren Entfernungen ("überscharf", flimmern)<br />
|-<br />
| align="left" |STSetColor<br />
| align="left" |Stack4: Textur-Index<br />
<br />
Stack3: Alpha<br />
<br />
Stack2: Rot<br />
<br />
Stack1: Grün<br />
<br />
Stack0: Blau<br />
| align="left" |-<br />
| align="left" |Setzt die Farbe, mit dem weitere Operationen vorgenommen werden sollen<br />
|-<br />
| align="left" |STDrawPixel<br />
| align="left" |Stack2: Textur-Index<br />
<br />
Stack1: X<br />
<br />
Stack0: Y<br />
| align="left" |-<br />
| align="left" |Setzt die Farbe des mit X und Y angegebenen Pixels auf den vorgewählten Farbwert<br />
|-<br />
| align="left" |STDrawRect<br />
| align="left" |Stack4: Textur-Index<br />
<br />
Stack3: X1<br />
<br />
Stack2: Y1<br />
<br />
Stack1: X2<br />
<br />
Stack0: Y2<br />
| align="left" |-<br />
| align="left" |Zeichnet ein ausgefülltes Rechteck in der vorgewählten Farbe zwischen den angegebenen Koordinatenpaaren<br />
|-<br />
| align="left" |STTextOut<br />
| align="left" |Stack5: Textur-Index<br />
<br />
Stack4: X1<br />
<br />
Stack3: Y1<br />
<br />
Stack2: Font-Index<br />
<br />
Stack1: Vollfarbe (oder nicht?)<br />
<br />
Stack0: [http://de.wikipedia.org/wiki/Sperrsatz Sperr-Pixel]<br />
<br />
StringStack0: Zu schreibender Text<br />
| align="left" |-<br />
| align="left" |Schreibt einen Text auf die Textur. Der Font-Index kann mittels ''GetFontIndex'' geholt werden. Vollfarbe gibt an, dass der Text in der aktuell vorgewählten Farbe geschrieben werden soll, andernfalls werden die Symbole in der Farbe der Schriftart geschrieben.<br />
|-<br />
| align="left" |GetFontIndex<br />
| align="left" |StringStack0: Font-Name<br />
| align="left" |Stack0: Font-Index<br />
| align="left" |Zur Verwendung für STTextOut<br />
|-<br />
| align="left" |TextLength<br />
| align="left" |Stack0: Font-Index<br />
<br />
StringStack0: Zu prüfender Text<br />
| align="left" |Stack0: Länge in Pixeln<br />
| align="left" |Berechnet die Länge des übergebenen Textes in der gewählten Schriftart<br />
|-<br />
| align="left" |STReadPixel<br />
| align="left" |StringStack0: Font-Name<br />
| align="left" |Stack0: Font-Index<br />
| align="left" |Zur Verwendung für STTextOut<br />
|}<br />
<br />
== Szenerieobjekte ==<br />
<br />
Siehe auch Datei ''program\callbacklist_scenobj.txt''!<br />
<br />
{| class="wikitable" style="font-size:95%;" <br />
|- class="hintergrundfarbe5"<br />
| align="left" |''Makroname''<br />
| align="left" |''Input-Stackwerte''<br />
| align="left" |''Output-Stackwerte''<br />
| align="left" |''Beschreibung''<br />
| align="left" |''Beispiel''<br />
|-<br />
| align="left" |GetArrBusLine<br />
| align="left" |Stack0: Index des ankommenden Busses<br />
| align="left" |Stringstack0: Liniennummer des ankommenden Busses<br />
| align="left" |Hierzu muss das Szenerieobjekt per "Parent to..."-Funktion mit einer Bushaltestelle verbunden sein. Dann schreibt diese Funktion in den Stringstack0 die Liniennummer des Busses, welcher in der Reihenfolge der Ankünfte an der durch Index angegebenen Stelle kommt (nullbasiert!)<br />
| align="left" |0 (M.V.GetArrBusLine) liefert die Liniennummer des nächsten Busses, 1 (M.V.GetArrBusLine) die des übernächsten Busses.<br />
|-<br />
| align="left" |GetArrBusTerminus<br />
| align="left" |Stack0: Index des ankommenden Busses<br />
| align="left" |Stringstack0: Ziel des ankommenden Busses<br />
| align="left" |Funktioniert wie ''GetArrBusLine'' und liefert die Endhaltestelle des Busses.<br />
| align="left" |0 (M.V.GetArrBusTerminus) liefert die Endhaltestelle des nächsten Busses, 1 (M.V.GetArrBusTerminus) die des übernächsten Busses.<br />
|-<br />
| align="left" |GetArrBusTimeDiff<br />
| align="left" |Stack0: Index des ankommenden Busses<br />
| align="left" |Stack0: Zeitdauer bis Bus an Haltestelle ankommt<br />
| align="left" |Funktioniert wie ''GetArrBusLine'' und liefert die Zeit (in Sekunden), bis der per Index gewählte Bus an der Haltestelle ankommt.<br />
| align="left" |0 (M.V.GetArrBusTimeDiff) liefert die Ankunftszeitdauer des nächsten Busses, 1 (M.V.GetArrBusTimeDiff) die des übernächsten Busses.<br />
|}<br />
<br />
== Fahrzeuge ==<br />
<br />
Siehe auch Datei ''program\callbacklist_roadvehicle.txt''!<br />
<br />
{| class="wikitable" style="font-size:95%;" <br />
|- class="hintergrundfarbe5"<br />
| align="left" |''Makroname''<br />
| align="left" |''Input-Stackwerte''<br />
| align="left" |''Output-Stackwerte''<br />
| align="left" |''Beschreibung''<br />
| align="left" |''Beispiel''<br />
|-<br />
| align="left" |GetRouteIndex<br />
| align="left" |Stack0: Route-Code<br />
| align="left" |Stack0: Route-Index<br />
| align="left" |Sucht in der Hofdatei die zum gegebenen Route-Code gehörigen Route-Index.<br />
| align="left" |-<br />
|-<br />
| align="left" |GetBusstopString<br />
| align="left" |Stack1: Haltestellen-Index, Stack0: String-Index<br />
| align="left" |Stringstack0: Haltestellen-Stringinhalt<br />
| align="left" |Liefert aus der Hofdatei den stack0'ten String der stack1'ten Haltestelle. Beide Indizes sind [[http://de.wikipedia.org/wiki/Z%C3%A4hlen#Z.C3.A4hlen_ab_0 nullbasiert]].<br />
| align="left" |5 2 (M.V.GetBusstopString) liefert den Inhalt des Strings Nr. 2 der Haltestelle Nr. 5<br />
|-<br />
| align="left" |GetTerminusString<br />
| align="left" |Stack1: Terminus-Index, Stack0: String-Index<br />
| align="left" |Stringstack0: Endhaltestellen-Stringinhalt<br />
| align="left" |Liefert aus der Hofdatei den stack0'ten String der stack1'ten Endhaltestelle (Terminus). Beide Indizes sind [[http://de.wikipedia.org/wiki/Z%C3%A4hlen#Z.C3.A4hlen_ab_0 nullbasiert]].<br />
| align="left" |7 3 (M.V.GetBusstopString) liefert den Inhalt des Strings Nr. 3 der Endhaltestelle Nr. 7<br />
|-<br />
| align="left" |GetRouteTerminusIndex<br />
| align="left" |Stack0: Route-Index (nullbasiert)<br />
| align="left" |Stack0: Terminus-Index (nullbasiert)<br />
| align="left" |Liefert den zur vorgegebenen Route zugehörigen Terminus/Endhaltestellen-Index. Über ''GetTerminusString'' kann dann wiederum der Name der Endhaltestelle geholt werden.<br />
| align="left" |-<br />
|-<br />
| align="left" |GetTerminusIndex<br />
| align="left" |Stack0: Terminus-Code<br />
| align="left" |Stack0: Terminus-Index<br />
| align="left" |Sucht in der Hofdatei die zum gegebenen Terminus-Code gehörigen Terminus-Index.<br />
| align="left" |-<br />
|-<br />
| align="left" |GetTerminusCode<br />
| align="left" |Stack0: Terminus-Index<br />
| align="left" |Stack0: Terminus-Code<br />
| align="left" |Gibt den in der Hofdatei zum gegebenen Terminus-Index gehörigen Terminus-Code zurück und ist somit die Umkehrfunktion von ''GetTerminusIndex''.<br />
| align="left" |-<br />
|-<br />
| align="left" |GetBusstopCount<br />
| align="left" |Stack0: Route-Index<br />
| align="left" |Stack0: Haltestellenanzahl<br />
| align="left" |Gibt die Anzahl der Haltestellen der per Index gewählten Route zurück. Da es sich hier um eine Anzahl handelt, ist diese auch nicht nullbasiert - hat die Route also zwei Haltestellen, ist auch das Ergebnis dieser Funktion "2".<br />
| align="left" |-<br />
|-<br />
| align="left" |GiveChangeCoin<br />
| align="left" |Stack0: Münz-Index<br />
| align="left" |-<br />
| align="left" |Sorgt für das Auswerfen der Münze mit dem Index Stack0, z.B. beim Geldwechsler-Script.<br />
| align="left" |2 (M.V.GiveChangeCoin) wirft die Münze mit dem Index 2 aus.<br />
|-<br />
| align="left" |GetRouteBusstopIdent<br />
| align="left" |Stack1: Route-Index, Stack0: Route-Busstop-Index<br />
| align="left" |Stringstack0: Ident der Bushaltestelle<br />
| align="left" |Liefert den Ident der Stack0'ten Bushaltestelle in der Route Stack1. Wiederum nullbasierte Indizes.<br />
| align="left" |3 6 (M.V.GetRouteBusstopIdent) liefert also den Index der 6. Bushaltestelle der 3. Route.<br />
|-<br />
| align="left" |GetBusstopIndex<br />
| align="left" |Stringstack0: Ident der Bushaltestelle<br />
| align="left" |Stack0: Index der Bushaltestelle<br />
| align="left" |Sucht den Index der über den Ident bezeichneten Bushaltestelle.<br />
| align="left" |"Reimerweg" (M.V.GetBusstopIndex) liefert den Index der Haltestelle Reimerweg.<br />
|-<br />
| align="left" |GetTTBusstopCount<br />
| align="left" |-<br />
| align="left" |Stack0: Anzahl der Haltestellen<br />
| align="left" |Liefert die Anzahl der Haltestellen des aktuellen Fahrplans<br />
| align="left" |-<br />
|-<br />
| align="left" |GetTTBusstopIndex<br />
| align="left" |-<br />
| align="left" |Stack0: Index der aktuellen Haltestelle<br />
| align="left" |Liefert den Index der aktuellen Haltestelle des aktuellen Fahrplans<br />
| align="left" |-<br />
|-<br />
| align="left" |GetTTTerminusIndex<br />
| align="left" |-<br />
| align="left" |Stack0: Index der Endhaltestelle<br />
| align="left" |Liefert den Index der Endhaltestelle des aktuellen Fahrplans<br />
| align="left" |-<br />
|-<br />
| align="left" |GetTTLineString<br />
| align="left" |-<br />
| align="left" |Stringstack0: Liniennummer<br />
| align="left" |Liefert die Liniennummer des aktuellen Fahrplans<br />
| align="left" |-<br />
|-<br />
| align="left" |GetTTDelay<br />
| align="left" |-<br />
| align="left" |Stack0: Verspätung in Sekunden<br />
| align="left" |Liefert die aktuelle Verspätung gemäß aktivem Fahrplan<br />
| align="left" |-<br />
|-<br />
| align="left" |GetTTBusstopName<br />
| align="left" |Stack0: Index der Haltestelle im aktuellen Fahrplan<br />
| align="left" |Stringstack0: Name der Haltestelle<br />
| align="left" |Liefert den Namen der Haltestelle, die sich im aktuellen Fahrplan an stack0'ter Stelle befindet<br />
| align="left" |-<br />
|-<br />
| align="left" |GetTTBusstopDep<br />
| align="left" |Stack0: Index der Haltestelle im aktuellen Fahrplan<br />
| align="left" |STack0: Abfahrtszeit in Sekunden<br />
| align="left" |Liefert die Abfahrtszeit an der Haltestelle, die sich im aktuellen Fahrplan an stack0'ter Stelle befindet<br />
| align="left" |-<br />
|-<br />
| align="left" |GetTTBusstopArr<br />
| align="left" |Stack0: Index der Haltestelle im aktuellen Fahrplan<br />
| align="left" |STack0: Ankunftszeit in Sekunden<br />
| align="left" |Liefert die Ankunftszeit an der Haltestelle, die sich im aktuellen Fahrplan an stack0'ter Stelle befindet<br />
| align="left" |-<br />
|-<br />
| align="left" |GetTicketName<br />
| align="left" |Stack0: Ticket-Index<br />
| align="left" |Stringstack0: Ticket-Name<br />
| align="left" |Liefert den Namen der über Index indizierten Fahrkartentype (nullbasiert)<br />
| align="left" |-<br />
|-<br />
| align="left" |GetTicketValue<br />
| align="left" |Stack0: Ticket-Index<br />
| align="left" |Stack0: Ticket-Preis<br />
| align="left" |Liefert den Preis der über Index indizierten Fahrkartentype (nullbasiert)<br />
| align="left" |-<br />
|}<br />
<br />
[[Kategorie:Nachschlagewerk für Addon-Entwickler]]</div>Marcel Kuhnthttp://wiki.omnibussimulator.de/omsiwikineu.de/index.php?title=System-Makros&diff=880System-Makros2014-02-11T16:58:19Z<p>Marcel Kuhnt: /* Script-Texturen (gültig für Szenerie- und Fahrzeugscripts, nur OMSI 2) */</p>
<hr />
<div>''Hinweis: Dieser Artikel wurde noch nicht ins Englische übersetzt!''<br />
<br />
System-Makros sind spezielle im Hauptprogramm hinterlegte Makros, welche vom Skript mit dem Befehl (M.V.''makroname'') aufgerufen werden. Sie bekleiden verschiedene Funktionen und haben verschiedene Ein- und Ausgabeparameter.<br />
<br />
== Script-Texturen (gültig für Szenerie- und Fahrzeugscripts, ''nur OMSI 2'') ==<br />
<br />
Siehe auch Datei ''program\callbacklist_scripttex.txt''!<br />
<br />
{| class="wikitable" style="font-size:95%;" <br />
|- class="hintergrundfarbe5"<br />
| align="left" |''Makroname''<br />
| align="left" |''Input-Stackwerte''<br />
| align="left" |''Output-Stackwerte''<br />
| align="left" |''Beschreibung''<br />
|-<br />
| align="left" |STNewTex<br />
| align="left" |Stack0: Textur-Index, entspricht [scripttexture]-Reihenfolge in model.cfg<br />
| align="left" |-<br />
| align="left" |Scripttextur initialisieren<br />
|-<br />
| align="left" |STLock<br />
| align="left" |Stack0: Textur-Index<br />
| align="left" |-<br />
| align="left" |Scripttextur "locken", d.h. Lese- und Schreibzugriff erlauben<br />
|-<br />
| align="left" |STUnlock<br />
| align="left" |Stack0: Textur-Index<br />
| align="left" |-<br />
| align="left" |Scripttextur "unlocken", d.h. Lese- und Schreibzugriff zurücknehmen und zum Rendern freigeben<br />
|-<br />
| align="left" |STFilter<br />
| align="left" |Stack0: Textur-Index<br />
| align="left" |-<br />
| align="left" |Mipmaps erzeugen, d.h. Untervarianten in kleineren Auflösungen. Dies passiert üblicherweise nach dem Unlock, keinesfalls jedoch zwischen Lock und Unlock. Geschieht es nicht, kommt es zu Darstellungsfehlern in größeren Entfernungen ("überscharf", flimmern)<br />
|-<br />
| align="left" |STSetColor<br />
| align="left" |Stack4: Textur-Index<br />
<br />
Stack3: Alpha<br />
<br />
Stack2: Rot<br />
<br />
Stack1: Grün<br />
<br />
Stack0: Blau<br />
| align="left" |-<br />
| align="left" |Setzt die Farbe, mit dem weitere Operationen vorgenommen werden sollen<br />
|-<br />
| align="left" |STDrawPixel<br />
| align="left" |Stack2: Textur-Index<br />
<br />
Stack1: X<br />
<br />
Stack0: Y<br />
| align="left" |-<br />
| align="left" |Setzt die Farbe des mit X und Y angegebenen Pixels auf den vorgewählten Farbwert<br />
|-<br />
| align="left" |STDrawRect<br />
| align="left" |Stack4: Textur-Index<br />
<br />
Stack3: X1<br />
<br />
Stack2: Y1<br />
<br />
Stack1: X2<br />
<br />
Stack0: Y2<br />
| align="left" |-<br />
| align="left" |Zeichnet ein ausgefülltes Rechteck in der vorgewählten Farbe zwischen den angegebenen Koordinatenpaaren<br />
|-<br />
| align="left" |STTextOut<br />
| align="left" |Stack5: Textur-Index<br />
<br />
Stack4: X1<br />
<br />
Stack3: Y1<br />
<br />
Stack2: Fontindex<br />
<br />
Stack1: Vollfarbe (oder nicht?)<br />
<br />
Stack0: [http://de.wikipedia.org/wiki/Sperrsatz Sperr-Pixel]<br />
<br />
StringStack0: Zu schreibender Text<br />
| align="left" |-<br />
| align="left" |Schreibt einen Text auf die Textur. Der Font-Index kann mittels ''GetFontIndex'' geholt werden. Vollfarbe gibt an, dass der Text in der aktuell vorgewählten Farbe geschrieben werden soll, andernfalls werden die Symbole in der Farbe der Schriftart geschrieben.<br />
|}<br />
<br />
== Szenerieobjekte ==<br />
<br />
Siehe auch Datei ''program\callbacklist_scenobj.txt''!<br />
<br />
{| class="wikitable" style="font-size:95%;" <br />
|- class="hintergrundfarbe5"<br />
| align="left" |''Makroname''<br />
| align="left" |''Input-Stackwerte''<br />
| align="left" |''Output-Stackwerte''<br />
| align="left" |''Beschreibung''<br />
| align="left" |''Beispiel''<br />
|-<br />
| align="left" |GetArrBusLine<br />
| align="left" |Stack0: Index des ankommenden Busses<br />
| align="left" |Stringstack0: Liniennummer des ankommenden Busses<br />
| align="left" |Hierzu muss das Szenerieobjekt per "Parent to..."-Funktion mit einer Bushaltestelle verbunden sein. Dann schreibt diese Funktion in den Stringstack0 die Liniennummer des Busses, welcher in der Reihenfolge der Ankünfte an der durch Index angegebenen Stelle kommt (nullbasiert!)<br />
| align="left" |0 (M.V.GetArrBusLine) liefert die Liniennummer des nächsten Busses, 1 (M.V.GetArrBusLine) die des übernächsten Busses.<br />
|-<br />
| align="left" |GetArrBusTerminus<br />
| align="left" |Stack0: Index des ankommenden Busses<br />
| align="left" |Stringstack0: Ziel des ankommenden Busses<br />
| align="left" |Funktioniert wie ''GetArrBusLine'' und liefert die Endhaltestelle des Busses.<br />
| align="left" |0 (M.V.GetArrBusTerminus) liefert die Endhaltestelle des nächsten Busses, 1 (M.V.GetArrBusTerminus) die des übernächsten Busses.<br />
|-<br />
| align="left" |GetArrBusTimeDiff<br />
| align="left" |Stack0: Index des ankommenden Busses<br />
| align="left" |Stack0: Zeitdauer bis Bus an Haltestelle ankommt<br />
| align="left" |Funktioniert wie ''GetArrBusLine'' und liefert die Zeit (in Sekunden), bis der per Index gewählte Bus an der Haltestelle ankommt.<br />
| align="left" |0 (M.V.GetArrBusTimeDiff) liefert die Ankunftszeitdauer des nächsten Busses, 1 (M.V.GetArrBusTimeDiff) die des übernächsten Busses.<br />
|}<br />
<br />
== Fahrzeuge ==<br />
<br />
Siehe auch Datei ''program\callbacklist_roadvehicle.txt''!<br />
<br />
{| class="wikitable" style="font-size:95%;" <br />
|- class="hintergrundfarbe5"<br />
| align="left" |''Makroname''<br />
| align="left" |''Input-Stackwerte''<br />
| align="left" |''Output-Stackwerte''<br />
| align="left" |''Beschreibung''<br />
| align="left" |''Beispiel''<br />
|-<br />
| align="left" |GetRouteIndex<br />
| align="left" |Stack0: Route-Code<br />
| align="left" |Stack0: Route-Index<br />
| align="left" |Sucht in der Hofdatei die zum gegebenen Route-Code gehörigen Route-Index.<br />
| align="left" |-<br />
|-<br />
| align="left" |GetBusstopString<br />
| align="left" |Stack1: Haltestellen-Index, Stack0: String-Index<br />
| align="left" |Stringstack0: Haltestellen-Stringinhalt<br />
| align="left" |Liefert aus der Hofdatei den stack0'ten String der stack1'ten Haltestelle. Beide Indizes sind [[http://de.wikipedia.org/wiki/Z%C3%A4hlen#Z.C3.A4hlen_ab_0 nullbasiert]].<br />
| align="left" |5 2 (M.V.GetBusstopString) liefert den Inhalt des Strings Nr. 2 der Haltestelle Nr. 5<br />
|-<br />
| align="left" |GetTerminusString<br />
| align="left" |Stack1: Terminus-Index, Stack0: String-Index<br />
| align="left" |Stringstack0: Endhaltestellen-Stringinhalt<br />
| align="left" |Liefert aus der Hofdatei den stack0'ten String der stack1'ten Endhaltestelle (Terminus). Beide Indizes sind [[http://de.wikipedia.org/wiki/Z%C3%A4hlen#Z.C3.A4hlen_ab_0 nullbasiert]].<br />
| align="left" |7 3 (M.V.GetBusstopString) liefert den Inhalt des Strings Nr. 3 der Endhaltestelle Nr. 7<br />
|-<br />
| align="left" |GetRouteTerminusIndex<br />
| align="left" |Stack0: Route-Index (nullbasiert)<br />
| align="left" |Stack0: Terminus-Index (nullbasiert)<br />
| align="left" |Liefert den zur vorgegebenen Route zugehörigen Terminus/Endhaltestellen-Index. Über ''GetTerminusString'' kann dann wiederum der Name der Endhaltestelle geholt werden.<br />
| align="left" |-<br />
|-<br />
| align="left" |GetTerminusIndex<br />
| align="left" |Stack0: Terminus-Code<br />
| align="left" |Stack0: Terminus-Index<br />
| align="left" |Sucht in der Hofdatei die zum gegebenen Terminus-Code gehörigen Terminus-Index.<br />
| align="left" |-<br />
|-<br />
| align="left" |GetTerminusCode<br />
| align="left" |Stack0: Terminus-Index<br />
| align="left" |Stack0: Terminus-Code<br />
| align="left" |Gibt den in der Hofdatei zum gegebenen Terminus-Index gehörigen Terminus-Code zurück und ist somit die Umkehrfunktion von ''GetTerminusIndex''.<br />
| align="left" |-<br />
|-<br />
| align="left" |GetBusstopCount<br />
| align="left" |Stack0: Route-Index<br />
| align="left" |Stack0: Haltestellenanzahl<br />
| align="left" |Gibt die Anzahl der Haltestellen der per Index gewählten Route zurück. Da es sich hier um eine Anzahl handelt, ist diese auch nicht nullbasiert - hat die Route also zwei Haltestellen, ist auch das Ergebnis dieser Funktion "2".<br />
| align="left" |-<br />
|-<br />
| align="left" |GiveChangeCoin<br />
| align="left" |Stack0: Münz-Index<br />
| align="left" |-<br />
| align="left" |Sorgt für das Auswerfen der Münze mit dem Index Stack0, z.B. beim Geldwechsler-Script.<br />
| align="left" |2 (M.V.GiveChangeCoin) wirft die Münze mit dem Index 2 aus.<br />
|-<br />
| align="left" |GetRouteBusstopIdent<br />
| align="left" |Stack1: Route-Index, Stack0: Route-Busstop-Index<br />
| align="left" |Stringstack0: Ident der Bushaltestelle<br />
| align="left" |Liefert den Ident der Stack0'ten Bushaltestelle in der Route Stack1. Wiederum nullbasierte Indizes.<br />
| align="left" |3 6 (M.V.GetRouteBusstopIdent) liefert also den Index der 6. Bushaltestelle der 3. Route.<br />
|-<br />
| align="left" |GetBusstopIndex<br />
| align="left" |Stringstack0: Ident der Bushaltestelle<br />
| align="left" |Stack0: Index der Bushaltestelle<br />
| align="left" |Sucht den Index der über den Ident bezeichneten Bushaltestelle.<br />
| align="left" |"Reimerweg" (M.V.GetBusstopIndex) liefert den Index der Haltestelle Reimerweg.<br />
|-<br />
| align="left" |GetTTBusstopCount<br />
| align="left" |-<br />
| align="left" |Stack0: Anzahl der Haltestellen<br />
| align="left" |Liefert die Anzahl der Haltestellen des aktuellen Fahrplans<br />
| align="left" |-<br />
|-<br />
| align="left" |GetTTBusstopIndex<br />
| align="left" |-<br />
| align="left" |Stack0: Index der aktuellen Haltestelle<br />
| align="left" |Liefert den Index der aktuellen Haltestelle des aktuellen Fahrplans<br />
| align="left" |-<br />
|-<br />
| align="left" |GetTTTerminusIndex<br />
| align="left" |-<br />
| align="left" |Stack0: Index der Endhaltestelle<br />
| align="left" |Liefert den Index der Endhaltestelle des aktuellen Fahrplans<br />
| align="left" |-<br />
|-<br />
| align="left" |GetTTLineString<br />
| align="left" |-<br />
| align="left" |Stringstack0: Liniennummer<br />
| align="left" |Liefert die Liniennummer des aktuellen Fahrplans<br />
| align="left" |-<br />
|-<br />
| align="left" |GetTTDelay<br />
| align="left" |-<br />
| align="left" |Stack0: Verspätung in Sekunden<br />
| align="left" |Liefert die aktuelle Verspätung gemäß aktivem Fahrplan<br />
| align="left" |-<br />
|-<br />
| align="left" |GetTTBusstopName<br />
| align="left" |Stack0: Index der Haltestelle im aktuellen Fahrplan<br />
| align="left" |Stringstack0: Name der Haltestelle<br />
| align="left" |Liefert den Namen der Haltestelle, die sich im aktuellen Fahrplan an stack0'ter Stelle befindet<br />
| align="left" |-<br />
|-<br />
| align="left" |GetTTBusstopDep<br />
| align="left" |Stack0: Index der Haltestelle im aktuellen Fahrplan<br />
| align="left" |STack0: Abfahrtszeit in Sekunden<br />
| align="left" |Liefert die Abfahrtszeit an der Haltestelle, die sich im aktuellen Fahrplan an stack0'ter Stelle befindet<br />
| align="left" |-<br />
|-<br />
| align="left" |GetTTBusstopArr<br />
| align="left" |Stack0: Index der Haltestelle im aktuellen Fahrplan<br />
| align="left" |STack0: Ankunftszeit in Sekunden<br />
| align="left" |Liefert die Ankunftszeit an der Haltestelle, die sich im aktuellen Fahrplan an stack0'ter Stelle befindet<br />
| align="left" |-<br />
|-<br />
| align="left" |GetTicketName<br />
| align="left" |Stack0: Ticket-Index<br />
| align="left" |Stringstack0: Ticket-Name<br />
| align="left" |Liefert den Namen der über Index indizierten Fahrkartentype (nullbasiert)<br />
| align="left" |-<br />
|-<br />
| align="left" |GetTicketValue<br />
| align="left" |Stack0: Ticket-Index<br />
| align="left" |Stack0: Ticket-Preis<br />
| align="left" |Liefert den Preis der über Index indizierten Fahrkartentype (nullbasiert)<br />
| align="left" |-<br />
|}<br />
<br />
[[Kategorie:Nachschlagewerk für Addon-Entwickler]]</div>Marcel Kuhnthttp://wiki.omnibussimulator.de/omsiwikineu.de/index.php?title=System-Makros&diff=879System-Makros2014-02-11T16:33:00Z<p>Marcel Kuhnt: </p>
<hr />
<div>''Hinweis: Dieser Artikel wurde noch nicht ins Englische übersetzt!''<br />
<br />
System-Makros sind spezielle im Hauptprogramm hinterlegte Makros, welche vom Skript mit dem Befehl (M.V.''makroname'') aufgerufen werden. Sie bekleiden verschiedene Funktionen und haben verschiedene Ein- und Ausgabeparameter.<br />
<br />
== Script-Texturen (gültig für Szenerie- und Fahrzeugscripts, ''nur OMSI 2'') ==<br />
<br />
Siehe auch Datei ''program\callbacklist_scripttex.txt''!<br />
<br />
{| class="wikitable" style="font-size:95%;" <br />
|- class="hintergrundfarbe5"<br />
| align="left" |''Makroname''<br />
| align="left" |''Input-Stackwerte''<br />
| align="left" |''Output-Stackwerte''<br />
| align="left" |''Beschreibung''<br />
| align="left" |''Beispiel''<br />
|}<br />
<br />
== Szenerieobjekte ==<br />
<br />
Siehe auch Datei ''program\callbacklist_scenobj.txt''!<br />
<br />
{| class="wikitable" style="font-size:95%;" <br />
|- class="hintergrundfarbe5"<br />
| align="left" |''Makroname''<br />
| align="left" |''Input-Stackwerte''<br />
| align="left" |''Output-Stackwerte''<br />
| align="left" |''Beschreibung''<br />
| align="left" |''Beispiel''<br />
|-<br />
| align="left" |GetArrBusLine<br />
| align="left" |Stack0: Index des ankommenden Busses<br />
| align="left" |Stringstack0: Liniennummer des ankommenden Busses<br />
| align="left" |Hierzu muss das Szenerieobjekt per "Parent to..."-Funktion mit einer Bushaltestelle verbunden sein. Dann schreibt diese Funktion in den Stringstack0 die Liniennummer des Busses, welcher in der Reihenfolge der Ankünfte an der durch Index angegebenen Stelle kommt (nullbasiert!)<br />
| align="left" |0 (M.V.GetArrBusLine) liefert die Liniennummer des nächsten Busses, 1 (M.V.GetArrBusLine) die des übernächsten Busses.<br />
|-<br />
| align="left" |GetArrBusTerminus<br />
| align="left" |Stack0: Index des ankommenden Busses<br />
| align="left" |Stringstack0: Ziel des ankommenden Busses<br />
| align="left" |Funktioniert wie ''GetArrBusLine'' und liefert die Endhaltestelle des Busses.<br />
| align="left" |0 (M.V.GetArrBusTerminus) liefert die Endhaltestelle des nächsten Busses, 1 (M.V.GetArrBusTerminus) die des übernächsten Busses.<br />
|-<br />
| align="left" |GetArrBusTimeDiff<br />
| align="left" |Stack0: Index des ankommenden Busses<br />
| align="left" |Stack0: Zeitdauer bis Bus an Haltestelle ankommt<br />
| align="left" |Funktioniert wie ''GetArrBusLine'' und liefert die Zeit (in Sekunden), bis der per Index gewählte Bus an der Haltestelle ankommt.<br />
| align="left" |0 (M.V.GetArrBusTimeDiff) liefert die Ankunftszeitdauer des nächsten Busses, 1 (M.V.GetArrBusTimeDiff) die des übernächsten Busses.<br />
|}<br />
<br />
== Fahrzeuge ==<br />
<br />
Siehe auch Datei ''program\callbacklist_roadvehicle.txt''!<br />
<br />
{| class="wikitable" style="font-size:95%;" <br />
|- class="hintergrundfarbe5"<br />
| align="left" |''Makroname''<br />
| align="left" |''Input-Stackwerte''<br />
| align="left" |''Output-Stackwerte''<br />
| align="left" |''Beschreibung''<br />
| align="left" |''Beispiel''<br />
|-<br />
| align="left" |GetRouteIndex<br />
| align="left" |Stack0: Route-Code<br />
| align="left" |Stack0: Route-Index<br />
| align="left" |Sucht in der Hofdatei die zum gegebenen Route-Code gehörigen Route-Index.<br />
| align="left" |-<br />
|-<br />
| align="left" |GetBusstopString<br />
| align="left" |Stack1: Haltestellen-Index, Stack0: String-Index<br />
| align="left" |Stringstack0: Haltestellen-Stringinhalt<br />
| align="left" |Liefert aus der Hofdatei den stack0'ten String der stack1'ten Haltestelle. Beide Indizes sind [[http://de.wikipedia.org/wiki/Z%C3%A4hlen#Z.C3.A4hlen_ab_0 nullbasiert]].<br />
| align="left" |5 2 (M.V.GetBusstopString) liefert den Inhalt des Strings Nr. 2 der Haltestelle Nr. 5<br />
|-<br />
| align="left" |GetTerminusString<br />
| align="left" |Stack1: Terminus-Index, Stack0: String-Index<br />
| align="left" |Stringstack0: Endhaltestellen-Stringinhalt<br />
| align="left" |Liefert aus der Hofdatei den stack0'ten String der stack1'ten Endhaltestelle (Terminus). Beide Indizes sind [[http://de.wikipedia.org/wiki/Z%C3%A4hlen#Z.C3.A4hlen_ab_0 nullbasiert]].<br />
| align="left" |7 3 (M.V.GetBusstopString) liefert den Inhalt des Strings Nr. 3 der Endhaltestelle Nr. 7<br />
|-<br />
| align="left" |GetRouteTerminusIndex<br />
| align="left" |Stack0: Route-Index (nullbasiert)<br />
| align="left" |Stack0: Terminus-Index (nullbasiert)<br />
| align="left" |Liefert den zur vorgegebenen Route zugehörigen Terminus/Endhaltestellen-Index. Über ''GetTerminusString'' kann dann wiederum der Name der Endhaltestelle geholt werden.<br />
| align="left" |-<br />
|-<br />
| align="left" |GetTerminusIndex<br />
| align="left" |Stack0: Terminus-Code<br />
| align="left" |Stack0: Terminus-Index<br />
| align="left" |Sucht in der Hofdatei die zum gegebenen Terminus-Code gehörigen Terminus-Index.<br />
| align="left" |-<br />
|-<br />
| align="left" |GetTerminusCode<br />
| align="left" |Stack0: Terminus-Index<br />
| align="left" |Stack0: Terminus-Code<br />
| align="left" |Gibt den in der Hofdatei zum gegebenen Terminus-Index gehörigen Terminus-Code zurück und ist somit die Umkehrfunktion von ''GetTerminusIndex''.<br />
| align="left" |-<br />
|-<br />
| align="left" |GetBusstopCount<br />
| align="left" |Stack0: Route-Index<br />
| align="left" |Stack0: Haltestellenanzahl<br />
| align="left" |Gibt die Anzahl der Haltestellen der per Index gewählten Route zurück. Da es sich hier um eine Anzahl handelt, ist diese auch nicht nullbasiert - hat die Route also zwei Haltestellen, ist auch das Ergebnis dieser Funktion "2".<br />
| align="left" |-<br />
|-<br />
| align="left" |GiveChangeCoin<br />
| align="left" |Stack0: Münz-Index<br />
| align="left" |-<br />
| align="left" |Sorgt für das Auswerfen der Münze mit dem Index Stack0, z.B. beim Geldwechsler-Script.<br />
| align="left" |2 (M.V.GiveChangeCoin) wirft die Münze mit dem Index 2 aus.<br />
|-<br />
| align="left" |GetRouteBusstopIdent<br />
| align="left" |Stack1: Route-Index, Stack0: Route-Busstop-Index<br />
| align="left" |Stringstack0: Ident der Bushaltestelle<br />
| align="left" |Liefert den Ident der Stack0'ten Bushaltestelle in der Route Stack1. Wiederum nullbasierte Indizes.<br />
| align="left" |3 6 (M.V.GetRouteBusstopIdent) liefert also den Index der 6. Bushaltestelle der 3. Route.<br />
|-<br />
| align="left" |GetBusstopIndex<br />
| align="left" |Stringstack0: Ident der Bushaltestelle<br />
| align="left" |Stack0: Index der Bushaltestelle<br />
| align="left" |Sucht den Index der über den Ident bezeichneten Bushaltestelle.<br />
| align="left" |"Reimerweg" (M.V.GetBusstopIndex) liefert den Index der Haltestelle Reimerweg.<br />
|-<br />
| align="left" |GetTTBusstopCount<br />
| align="left" |-<br />
| align="left" |Stack0: Anzahl der Haltestellen<br />
| align="left" |Liefert die Anzahl der Haltestellen des aktuellen Fahrplans<br />
| align="left" |-<br />
|-<br />
| align="left" |GetTTBusstopIndex<br />
| align="left" |-<br />
| align="left" |Stack0: Index der aktuellen Haltestelle<br />
| align="left" |Liefert den Index der aktuellen Haltestelle des aktuellen Fahrplans<br />
| align="left" |-<br />
|-<br />
| align="left" |GetTTTerminusIndex<br />
| align="left" |-<br />
| align="left" |Stack0: Index der Endhaltestelle<br />
| align="left" |Liefert den Index der Endhaltestelle des aktuellen Fahrplans<br />
| align="left" |-<br />
|-<br />
| align="left" |GetTTLineString<br />
| align="left" |-<br />
| align="left" |Stringstack0: Liniennummer<br />
| align="left" |Liefert die Liniennummer des aktuellen Fahrplans<br />
| align="left" |-<br />
|-<br />
| align="left" |GetTTDelay<br />
| align="left" |-<br />
| align="left" |Stack0: Verspätung in Sekunden<br />
| align="left" |Liefert die aktuelle Verspätung gemäß aktivem Fahrplan<br />
| align="left" |-<br />
|-<br />
| align="left" |GetTTBusstopName<br />
| align="left" |Stack0: Index der Haltestelle im aktuellen Fahrplan<br />
| align="left" |Stringstack0: Name der Haltestelle<br />
| align="left" |Liefert den Namen der Haltestelle, die sich im aktuellen Fahrplan an stack0'ter Stelle befindet<br />
| align="left" |-<br />
|-<br />
| align="left" |GetTTBusstopDep<br />
| align="left" |Stack0: Index der Haltestelle im aktuellen Fahrplan<br />
| align="left" |STack0: Abfahrtszeit in Sekunden<br />
| align="left" |Liefert die Abfahrtszeit an der Haltestelle, die sich im aktuellen Fahrplan an stack0'ter Stelle befindet<br />
| align="left" |-<br />
|-<br />
| align="left" |GetTTBusstopArr<br />
| align="left" |Stack0: Index der Haltestelle im aktuellen Fahrplan<br />
| align="left" |STack0: Ankunftszeit in Sekunden<br />
| align="left" |Liefert die Ankunftszeit an der Haltestelle, die sich im aktuellen Fahrplan an stack0'ter Stelle befindet<br />
| align="left" |-<br />
|-<br />
| align="left" |GetTicketName<br />
| align="left" |Stack0: Ticket-Index<br />
| align="left" |Stringstack0: Ticket-Name<br />
| align="left" |Liefert den Namen der über Index indizierten Fahrkartentype (nullbasiert)<br />
| align="left" |-<br />
|-<br />
| align="left" |GetTicketValue<br />
| align="left" |Stack0: Ticket-Index<br />
| align="left" |Stack0: Ticket-Preis<br />
| align="left" |Liefert den Preis der über Index indizierten Fahrkartentype (nullbasiert)<br />
| align="left" |-<br />
|}<br />
<br />
[[Kategorie:Nachschlagewerk für Addon-Entwickler]]</div>Marcel Kuhnthttp://wiki.omnibussimulator.de/omsiwikineu.de/index.php?title=System-Trigger&diff=878System-Trigger2014-02-11T16:31:20Z<p>Marcel Kuhnt: </p>
<hr />
<div>''Hinweis: Dieser Artikel wurde noch nicht ins Englische übersetzt!''<br />
<br />
''OMSI-Version: 1.0 - 2.0''<br />
<br />
System-Trigger sind Trigger, welche einen {trigger:''name''}...{end}-Block in einem Fahrzeug- oder Szenerieobjektscript aufruft und dabei nicht durch einen Tastendruck oder ein Maus-Ereignis des Users ausgelöst wird sondern direkt von OMSI.<br />
<br />
{| class="wikitable" style="font-size:95%;" <br />
|- class="hintergrundfarbe5"<br />
| align="left" |''Bezeichnung''<br />
| align="left" |''Beschreibung''<br />
| align="left" |''ab OMSI-Vs.''<br />
|-<br />
| align="left" |collision<br />
| align="left" |Wird für jede Kollision ausgelöst. Zuvor werden die ''coll_~''-Variablen entsprechend gesetzt.<br />
| align="left" |1.00<br />
|-<br />
| align="left" |int_haltewunsch<br />
| align="left" |Hierüber teilen die Fahrgäste dem Bus-Script mit, dass sie aussteigen wollen. Damit die Türen ggf. auch offen bleiben, "drücken" die Fahrgäste normalerweise mehrfach!<br />
| align="left" |1.00<br />
|-<br />
| align="left" |railbond_#<br />
| align="left" |Auslösen der Schienenstoß-Sounds bei Schienenfahrzeugen<br />
| align="left" |1.00<br />
|-<br />
| align="left" |ai_scheduled_settarget<br />
| align="left" |Aufforderung an das Script, die angezeigte Linie und das Zielschild neu einzustellen. Der String für die Linie wird über die Fahrzeug-Variable ''SetLineTo'' vorgegeben, der Index des Ziels in der Hofdatei über ''AI_target_index''.<br />
| align="left" |1.00<br />
|-<br />
| align="left" |ai_scheduled_setbusstop<br />
| align="left" |Aufforderung an das Script, die Haltestelle zu aktualisieren, z.B. für die Innenraumanzeige. Die neue Haltestelle wird dem Script über die Fahrzeug-Variable ''act_busstop'' mitgeteilt.<br />
| align="left" |1.00<br />
|-<br />
| align="left" |malfunction_gettime<br />
| align="left" |Aufforderung an das Script, die Zeitdauer sämtlicher notwendiger Reparaturen zu berechnen (ohne Anfahrtszeit!); das Resultat muss am Ende ganz oben im Stack stehen.<br />
| align="left" |2.00<br />
|-<br />
| align="left" |malfunction_reset<br />
| align="left" |Aufforderung an das Script, sämtliche Reparaturen durchzuführen<br />
| align="left" |2.00<br />
|}<br />
<br />
[[Kategorie:Nachschlagewerk für Addon-Entwickler]]</div>Marcel Kuhnthttp://wiki.omnibussimulator.de/omsiwikineu.de/index.php?title=System-Trigger&diff=877System-Trigger2014-02-11T16:30:08Z<p>Marcel Kuhnt: </p>
<hr />
<div>''Hinweis: Dieser Artikel wurde noch nicht ins Englische übersetzt!''<br />
<br />
System-Trigger sind Trigger, welche einen {trigger:''name''}...{end}-Block in einem Fahrzeug- oder Szenerieobjektscript aufruft und dabei nicht durch einen Tastendruck oder ein Maus-Ereignis des Users ausgelöst wird sondern direkt von OMSI.<br />
<br />
{| class="wikitable" style="font-size:95%;" <br />
|- class="hintergrundfarbe5"<br />
| align="left" |''Bezeichnung''<br />
| align="left" |''Beschreibung''<br />
| align="left" |''ab OMSI-Vs.''<br />
|-<br />
| align="left" |collision<br />
| align="left" |Wird für jede Kollision ausgelöst. Zuvor werden die ''coll_~''-Variablen entsprechend gesetzt.<br />
| align="left" |1.00<br />
|-<br />
| align="left" |int_haltewunsch<br />
| align="left" |Hierüber teilen die Fahrgäste dem Bus-Script mit, dass sie aussteigen wollen. Damit die Türen ggf. auch offen bleiben, "drücken" die Fahrgäste normalerweise mehrfach!<br />
| align="left" |1.00<br />
|-<br />
| align="left" |railbond_#<br />
| align="left" |Auslösen der Schienenstoß-Sounds bei Schienenfahrzeugen<br />
| align="left" |1.00<br />
|-<br />
| align="left" |ai_scheduled_settarget<br />
| align="left" |Aufforderung an das Script, die angezeigte Linie und das Zielschild neu einzustellen. Der String für die Linie wird über die Fahrzeug-Variable ''SetLineTo'' vorgegeben, der Index des Ziels in der Hofdatei über ''AI_target_index''.<br />
| align="left" |1.00<br />
|-<br />
| align="left" |ai_scheduled_setbusstop<br />
| align="left" |Aufforderung an das Script, die Haltestelle zu aktualisieren, z.B. für die Innenraumanzeige. Die neue Haltestelle wird dem Script über die Fahrzeug-Variable ''act_busstop'' mitgeteilt.<br />
| align="left" |1.00<br />
|-<br />
| align="left" |malfunction_gettime<br />
| align="left" |Aufforderung an das Script, die Zeitdauer sämtlicher notwendiger Reparaturen zu berechnen (ohne Anfahrtszeit!); das Resultat muss am Ende ganz oben im Stack stehen.<br />
| align="left" |2.00<br />
|-<br />
| align="left" |malfunction_reset<br />
| align="left" |Aufforderung an das Script, sämtliche Reparaturen durchzuführen<br />
| align="left" |2.00<br />
|}<br />
<br />
[[Kategorie:Nachschlagewerk für Addon-Entwickler]]</div>Marcel Kuhnthttp://wiki.omnibussimulator.de/omsiwikineu.de/index.php?title=System-_und_vordefinierte_lokalen_Variablen&diff=876System- und vordefinierte lokalen Variablen2014-02-11T16:26:07Z<p>Marcel Kuhnt: /* Zahlvariablen */</p>
<hr />
<div>''Hinweis: Dieser Artikel wurde noch nicht ins Englische übersetzt!''<br />
<br />
''OMSI-Version: 1.0 - 2.0''<br />
<br />
Beschreibung der System- und der lokalen [[Scriptsystem#Variablenzugriff|Scriptvariablen]], welche für jedes Objekt vordefiniert werden und im Allgemeinen bestimmte Sonderfunktionen gegenüber frei definierten Scriptvariablen übernehmen.<br />
<br />
== Systemvariablen ==<br />
<br />
Siehe bitte auch Datei ''program\varlist_system.txt''!<br />
<br />
{| class="wikitable" style="font-size:95%;" <br />
|- class="hintergrundfarbe5"<br />
| align="left" |''Variablenname''<br />
| align="left" |''Beschreibung''<br />
| align="left" |''Einheit''<br />
| align="left" |''ab OMSI-Vs.''<br />
|-<br />
| align="left" |Timegap<br />
| align="left" |Zeitschritt seit dem letzten Durchlauf (Frame)<br />
| align="left" |Sekunden<br />
| align="left" |1.00<br />
|-<br />
| align="left" |GetTime<br />
| align="left" |Enthält eine absolute Zeitangabe, die vom Beginn des Ausführens von OMSI zählt<br />
| align="left" |Sekunden<br />
| align="left" |1.00<br />
|-<br />
| align="left" |NoSound<br />
| align="left" |Sounds deaktiviert?<br />
| align="left" |0 = Sounds aktiviert, 1 = Sounds deaktiviert<br />
| align="left" |1.00<br />
|-<br />
| align="left" |Pause<br />
| align="left" |Simulations-Pause aktiv?<br />
| align="left" |0 = Simulation läuft, 1 = Simulation angehalten<br />
| align="left" |1.00<br />
|-<br />
| align="left" |Time<br />
| align="left" |Uhrzeit gerechnet von Mitternacht des aktuellen Tages<br />
| align="left" |Sekunden<br />
| align="left" |1.00<br />
|-<br />
| align="left" |Day<br />
| align="left" |Tag gezählt ab Monatsbeginn<br />
| align="left" |Tage<br />
| align="left" |1.00<br />
|-<br />
| align="left" |Month<br />
| align="left" |Monat<br />
| align="left" |Monate<br />
| align="left" |1.00<br />
|-<br />
| align="left" |Year<br />
| align="left" |Jahr<br />
| align="left" |Jahre<br />
| align="left" |1.00<br />
|-<br />
| align="left" |DayOfYear<br />
| align="left" |Tag gezählt ab Jahresbeginn<br />
| align="left" |Tage<br />
| align="left" |1.00<br />
|-<br />
| align="left" |mouse_x<br />
| align="left" |X-Koordinate des Mauszeigers auf dem Bildschirm<br />
| align="left" |Pixel<br />
| align="left" |1.00<br />
|-<br />
| align="left" |mouse_y<br />
| align="left" |Y-Koordinate des Mauszeigers auf dem Bildschirm<br />
| align="left" |Pixel<br />
| align="left" |1.00<br />
|-<br />
| align="left" |PrecipType<br />
| align="left" |Niederschlagstyp<br />
| align="left" |0 = keiner, 1 = Regen, 2 = Schnee<br />
| align="left" |1.00<br />
|-<br />
| align="left" |PrecipRate<br />
| align="left" |Niederschlagstyp<br />
| align="left" |0 = kein Niederschlag, 1 = maximaler Niederschlag<br />
| align="left" |1.00<br />
|-<br />
| align="left" |coll_pos_x<br />
| align="left" |Position der Kollision, x-Richtung relativ zum Fahrzeugursprung (nur bei Auslösung des Kollisions-Triggers)<br />
| align="left" |Meter<br />
| align="left" |1.00<br />
|-<br />
| align="left" |coll_pos_y<br />
| align="left" |Position der Kollision, y-Richtung relativ zum Fahrzeugursprung (nur bei Auslösung des Kollisions-Triggers)<br />
| align="left" |Meter<br />
| align="left" |1.00<br />
|-<br />
| align="left" |coll_pos_z<br />
| align="left" |Position der Kollision, z-Richtung relativ zum Fahrzeugursprung (nur bei Auslösung des Kollisions-Triggers)<br />
| align="left" |Meter<br />
| align="left" |1.00<br />
|-<br />
| align="left" |coll_energy<br />
| align="left" |Energie der Kollision (nur bei Auslösung des Kollisions-Triggers)<br />
| align="left" |Nm<br />
| align="left" |1.00<br />
|-<br />
| align="left" |Weather_Temperature<br />
| align="left" |Außentemperatur<br />
| align="left" |°C<br />
| align="left" |1.00<br />
|-<br />
| align="left" |Weather_AbsHum<br />
| align="left" |Absolute Luftfeuchtigkeit<br />
| align="left" |g/m³<br />
| align="left" |1.00<br />
|-<br />
| align="left" |AutoClutch<br />
| align="left" |Option "automatische Kupplung" aktiviert<br />
| align="left" |0 = aus, 1 = an<br />
| align="left" |1.03<br />
|-<br />
| align="left" |wearlifespan<br />
| align="left" |''nicht nutzen!''<br />
| align="left" |<br />
| align="left" |2.00<br />
|-<br />
| align="left" |SunAlt<br />
| align="left" |Höhenwinkel der Sonne<br />
| align="left" |°<br />
| align="left" |2.00<br />
|}<br />
<br />
== Vordefinierte lokale Variablen ==<br />
<br />
Seit OMSI 2 gibt es eine neue Form vordefinierter Variablen: Diese tauchen nicht in der ''varlist_*.txt''-Datei im ''program''-Verzeichnis auf und müssen daher so wie "normale" lokale Variablen deklariert werden, sie werden aber dennoch (sofern sie deklariert werden) mit internen Variablen verbunden. Diese Variablen werden "on-demand-vordefinierte Variablen" genannt. Bitte beachten Sie hierzu die neue Spalte!<br />
<br />
=== Szenerieobjekte ===<br />
<br />
Siehe bitte auch Datei ''program\varlist_scenobj.txt''!<br />
<br />
{| class="wikitable" style="font-size:95%;" <br />
|- class="hintergrundfarbe5"<br />
| align="left" |''Variablenname''<br />
| align="left" |''Beschreibung''<br />
| align="left" |''Einheit''<br />
| align="left" |''kein Schreibzugriff''<br />
| align="left" |''ab OMSI-Vs.''<br />
|-<br />
| align="left" |NightLightA<br />
| align="left" |Ist die Nachtbeleuchtung aktiv?<br />
| align="left" |0 = aus, 1 = an<br />
| align="left" |X<br />
| align="left" |1.00<br />
|-<br />
| align="left" |InUse<br />
| align="left" |Ist das Objekt "aktiv"? Die Sporthallen sind bspw. nur an Schultagen vormittags "aktiv", sodass die Soundeffekte an diese Variable gekoppelt werden können - auf diese Weise wird verhindert, dass die Soundeffekte auch in den Ferien oder nachts zu hören sind.<br />
| align="left" |0 = inaktiv, 1 = aktiv<br />
| align="left" |X<br />
| align="left" |1.00<br />
|-<br />
| align="left" |TrafficLightPhase<br />
| align="left" |Hierüber wird Ampelobjekten die anzuzeigende Ampelphase mitgeteilt.<br />
| align="left" |0..2 = rot, 3..5 = rot-gelb, 6..8 = grün, 9..11 = gelb, sonst aus<br />
| align="left" |X<br />
| align="left" |1.00<br />
|-<br />
| align="left" |TrafficLightApproach<br />
| align="left" |Hierüber kann das Script eine Ampelanforderung erkennen und bspw. eine Kennleuchte aktiviert werden.<br />
| align="left" |0 = keine Anforderung, 1 = Anforderung<br />
| align="left" |X<br />
| align="left" |1.00<br />
|-<br />
| align="left" |Colorscheme<br />
| align="left" |(veraltet)<br />
| align="left" |(-)<br />
| align="left" |X<br />
| align="left" |1.00<br />
|-<br />
| align="left" |Signal<br />
| align="left" |Hierüber erhalten Signale ihr anzuzeigendes Signalbild<br />
| align="left" |individuell<br />
| align="left" |X<br />
| align="left" |1.00<br />
|-<br />
| align="left" |NextSignal<br />
| align="left" |Hierüber erhalten Signale mit Vorsignalfunktion das anzuzeigende Signalbild des nächsten Signals<br />
| align="left" |individuell<br />
| align="left" |X<br />
| align="left" |1.00<br />
|-<br />
| align="left" |Refresh_Strings<br />
| align="left" |Diese Variable muss auf "1" gesetzt werden, damit die Text-Texturen aktualisiert werden! Wird nach erfolgreicher Abarbeitung von OMSI auf 0 gesetzt.<br />
| align="left" |-<br />
| align="left" |<br />
| align="left" |1.00<br />
|-<br />
| align="left" |Switch<br />
| align="left" |Mit dieser Variable kann die Weiche, die im Objekt eingebaut ist, gestellt werden. Hierfür muss der Wert der Variable auf den mit [switchdir] angegebenen Wert des gewünschten Pfades gesetzt werden.<br />
| align="left" |-<br />
| align="left" |<br />
| align="left" |2.00<br />
|}<br />
<br />
=== Fahrzeuge ===<br />
<br />
Wichtig: Üblicherweise nutzen Gelenkbusse das [[Scriptshare]]-System, bei welchem sich mehrere Fahrzeuge denselben Variablenspeicher teilen. Hierbei ist zu beachten, dass Räder und Türen '''über alle Fahrzeugteile zählen'''. Beim NG272 bedeutet dies beispielsweise, dass die dritte Tür auch mit PAX_Entry2_Open angesteuert wird.<br />
<br />
==== Zahlvariablen ====<br />
<br />
Siehe bitte auch Datei ''program\varlist_roadvehicle.txt''!<br />
<br />
{| class="wikitable" style="font-size:95%;" <br />
|- class="hintergrundfarbe5"<br />
| align="left" |''Variablenname''<br />
| align="left" |''Beschreibung''<br />
| align="left" |''Einheit''<br />
| align="left" |''kein Schreibzugriff''<br />
| align="left" |''"on demand"''<br />
| align="left" |''ab OMSI-Vs.''<br />
|-<br />
| align="left" |Refresh_Strings<br />
| align="left" |Diese Variable muss auf "1" gesetzt werden, damit die Text-Texturen aktualisiert werden! Wird nach erfolgreicher Abarbeitung von OMSI auf 0 gesetzt.<br />
| align="left" |-<br />
| align="left" |<br />
| align="left" |<br />
| align="left" |1.00<br />
|-<br />
| align="left" |Envir_Brightness<br />
| align="left" |Umgebungshelligkeit in Fahrzeugnähe<br />
| align="left" |0 = dunkel, 1 = hell<br />
| align="left" |X<br />
| align="left" |<br />
| align="left" |1.00<br />
|-<br />
| align="left" |StreetCond<br />
| align="left" |Information über die Oberflächenbedingungen<br />
| align="left" |0: Trocken, 0..1: zunehmende Feuchtigkeit, 1: komplett feucht, 1..2: teilweise Pfützen, 2: Fahrzeug komplett in Pfützen<br />
| align="left" |X<br />
| align="left" |<br />
| align="left" |1.00<br />
|-<br />
| align="left" |Spot_Select<br />
| align="left" |Hierüber kann gesteuert werden, welches fürs Fahrzeug vordefinierte Spotlight aktiv sein soll.<br />
| align="left" |-1: kein Spotlight, 0: Spotlight Nr. 0, 1: Spotlight Nr. 1 usw.<br />
| align="left" |<br />
| align="left" |<br />
| align="left" |1.00<br />
|-<br />
| align="left" |Colorscheme<br />
| align="left" |Index des gewählten Farbschemas/Anstriches<br />
| align="left" |-<br />
| align="left" |X<br />
| align="left" |<br />
| align="left" |1.00<br />
|-<br />
| align="left" |M_Wheel<br />
| align="left" |Hierüber kann das Script ein [http://de.wikipedia.org/wiki/Drehmoment Drehmoment] auf die Räder übertragen. Hierbei die Summe anzugeben, welche auf alle als angetrieben ausgewiesene Achsen wirken <br />
soll.<br />
| align="left" |kNm = 1000 [http://de.wikipedia.org/wiki/Newtonmeter Nm]<br />
| align="left" |<br />
| align="left" |<br />
| align="left" |1.00<br />
|-<br />
| align="left" |n_Wheel<br />
| align="left" |Mittlere Raddrehzahl des Fahrzeuges<br />
| align="left" |Umdrehungen pro Minute<br />
| align="left" |X<br />
| align="left" |<br />
| align="left" |1.00<br />
|-<br />
| align="left" |Throttle<br />
| align="left" |Stellung des Gaspedals<br />
| align="left" |0..1<br />
| align="left" |X<br />
| align="left" |<br />
| align="left" |1.00<br />
|-<br />
| align="left" |Brake<br />
| align="left" |Stellung des Bremspedals<br />
| align="left" |0..1<br />
| align="left" |X<br />
| align="left" |<br />
| align="left" |1.00<br />
|-<br />
| align="left" |Clutch<br />
| align="left" |Stellung des Kupplungspedals<br />
| align="left" |0..1<br />
| align="left" |X<br />
| align="left" |<br />
| align="left" |1.00<br />
|-<br />
| align="left" |Brakeforce<br />
| align="left" |Hierüber kann das Script die Gesamtbremskraft des Fahrzeuges vorgeben, welche auf die Räder wirkt. Sollte nicht gleichzeitig mit ''Axle_Brakeforce...'' verwendet werden.<br />
| align="left" |[http://de.wikipedia.org/wiki/Newton_(Einheit) N]<br />
| align="left" |<br />
| align="left" |<br />
| align="left" |1.00<br />
|-<br />
| align="left" |Velocity<br />
| align="left" |Geschwindigkeit, welche sich über die Raddrehung ergibt, entspricht der Tachoanzeige<br />
| align="left" |[http://de.wikipedia.org/wiki/Km/h km/h]<br />
| align="left" |X<br />
| align="left" |<br />
| align="left" |1.00<br />
|-<br />
| align="left" |Velocity_Ground<br />
| align="left" |Geschwindigkeit, welche direkt relativ zum Grund gemessen wird, berücksichtigt kein Radschleudern oder -blockieren, entspricht der Anzeige auf einem GPS<br />
| align="left" |[http://de.wikipedia.org/wiki/Km/h km/h]<br />
| align="left" |X<br />
| align="left" |<br />
| align="left" |1.00<br />
|-<br />
| align="left" |tank_percent<br />
| align="left" |Tankinhalt, nur für die Anzeige auf der roten Informationsleiste. Die Betankung und Simulation eines leeren Tanks geschieht über einen Trigger bzw. muss im Script programmiert werden.<br />
| align="left" |0..1<br />
| align="left" |<br />
| align="left" |<br />
| align="left" |1.00<br />
|-<br />
| align="left" |kmcounter_km<br />
| align="left" |Stand des Kilometerzählers (nur ganze km)<br />
| align="left" |km<br />
| align="left" |X<br />
| align="left" |<br />
| align="left" |1.00<br />
|-<br />
| align="left" |kmcounter_m<br />
| align="left" |Stand des Kilometerzählers (zusätzliche Meter, läuft stets nur von 0m bis 999m; hinzu kommen die Kilometer von ''kmcounter_km'')<br />
| align="left" |m<br />
| align="left" |X<br />
| align="left" |<br />
| align="left" |1.00<br />
|-<br />
| align="left" |relrange<br />
| align="left" |Zurückgelegte, relative Strecke. Wurde nur testweise für pfadfixierte Fahrzeuge eingeführt. Nicht benutzen!<br />
| align="left" |---<br />
| align="left" |X<br />
| align="left" |<br />
| align="left" |1.00<br />
|-<br />
| align="left" |Driver_Seat_VertTransl<br />
| align="left" |Einfederung des federnden Fahrersitzes<br />
| align="left" |m<br />
| align="left" |X<br />
| align="left" |<br />
| align="left" |1.00<br />
|-<br />
| align="left" |Wheel_Rotation_0_L / ~_R ... ~_3_L / _R<br />
| align="left" |Drehwinkel des jeweiligen Rades, z.B. für die Animation<br />
| align="left" |[http://de.wikipedia.org/wiki/Radiant_(Einheit) rad]<br />
| align="left" |X<br />
| align="left" |<br />
| align="left" |1.00<br />
|-<br />
| align="left" |Wheel_RotationSpeed_0_L / ~_R ... ~_3_L / _R<br />
| align="left" |Drehzahl des jeweiligen Rades<br />
| align="left" |Umdrehungen pro Minute<br />
| align="left" |X<br />
| align="left" |<br />
| align="left" |1.00<br />
|-<br />
| align="left" |Axle_Suspension_0_L / ~_R ... ~_3_L / _R<br />
| align="left" |Einfederungsweg des jeweiligen Rades<br />
| align="left" |m<br />
| align="left" |X<br />
| align="left" |<br />
| align="left" |1.00<br />
|-<br />
| align="left" |Axle_Steering_0_L / ~_R ... ~_3_L / _R<br />
| align="left" |Lenkwinkel des jeweiligen Rades<br />
| align="left" |[http://de.wikipedia.org/wiki/Radiant_(Einheit) rad]<br />
| align="left" |X<br />
| align="left" |<br />
| align="left" |1.00<br />
|-<br />
| align="left" |Axle_Springfactor_0_L / ~_R ... ~_3_L / _R<br />
| align="left" |Faktor, mit dem radweise die Federstärke angepasst werden kann, z.B. um Luftfederungen zu simulieren.<br />
| align="left" |0 = keine, 1 = normale, 2 = doppelte Federkraft<br />
| align="left" |<br />
| align="left" |<br />
| align="left" |1.00<br />
|-<br />
| align="left" |Axle_Brakeforce_0_L / ~_R ... ~_3_L / _R<br />
| align="left" |Ermöglicht Setzen der Bremskraft pro Rad. Sollte nicht gleichzeitig mit ''Brakeforce'' verwendet werden!<br />
| align="left" |[http://de.wikipedia.org/wiki/Newton_(Einheit) N]<br />
| align="left" |<br />
| align="left" |<br />
| align="left" |1.00<br />
|-<br />
| align="left" |Axle_SurfaceID_0_L / ~_R ... ~_3_L / _R<br />
| align="left" |Oberflächenbeschaffenheit unter dem Rad<br />
| align="left" |[[Oberflächen-Codes]]<br />
| align="left" |X<br />
| align="left" |X<br />
| align="left" |2.00<br />
|-<br />
| align="left" |Debug_0 ... _5<br />
| align="left" |Debug-Variablen. Können im Debug-Modus in der Informationsleiste angezeigt werden, um auf diese Weise die Scripts zu testen.<br />
| align="left" |bliebig<br />
| align="left" |<br />
| align="left" |<br />
| align="left" |1.00<br />
|-<br />
| align="left" |A_Trans_X ... _Z<br />
| align="left" |Beschleunigungen im Fahrzeug, die durch die Fahrzeugbewegungen ausgelöst werden (beim Bremsen oder bei Kurvenfahrten usw.)<br />
| align="left" |m/s²<br />
| align="left" |X<br />
| align="left" |<br />
| align="left" |1.00<br />
|-<br />
| align="left" |AI_Blinker_L, ~_R<br />
| align="left" |Linker oder rechter Blinker aktiv<br />
| align="left" |0: aus, 1: ein<br />
| align="left" |(X)*<br />
| align="left" |<br />
| align="left" |1.00<br />
|-<br />
| align="left" |AI_Light<br />
| align="left" |Fahrlicht, Standlicht, Lichthupe<br />
| align="left" |0: Licht aus, 0.5: Standlicht an, 1: Fahrlicht an, 2: Fernlicht/Lichthupe an<br />
| align="left" |(X)*<br />
| align="left" |<br />
| align="left" |1.00<br />
|-<br />
| align="left" |AI_Interiorlight<br />
| align="left" |Innenbeleuchtung. Hierüber erfahren die einsteigenden Fahrgäste auch, ob es im Bus zu dunkel ist (sodass sie meckern dürfen).<br />
| align="left" |0: aus, 1: an<br />
| align="left" |(X)*<br />
| align="left" |<br />
| align="left" |1.00<br />
|-<br />
| align="left" |AI_Brakelight<br />
| align="left" |Nur für KI-Fahrzeuge: Script soll Bremslicht einschalten<br />
| align="left" |0: aus, 1: an<br />
| align="left" |X<br />
| align="left" |<br />
| align="left" |1.00<br />
|-<br />
| align="left" |AI_Engine<br />
| align="left" |Nur für KI-Fahrzeuge: Aufforderung zum Ein- oder Ausschalten des Motors<br />
| align="left" |-1: Motor ausschalten!, 0: egal/nicht-KI, 1: Motor einschalten!<br />
| align="left" |X<br />
| align="left" |<br />
| align="left" |1.00<br />
|-<br />
| align="left" |AI_target_index<br />
| align="left" |Dient der Übergabe des Sollwertes des einzustellenden Zielschildes bei Aufruf des Menüs oder beim Umschildern der KI-Busse. Entspricht der Reihenfolge in der Hof-Datei; erster Eintrag = 0<br />
| align="left" |-<br />
| align="left" |X<br />
| align="left" |<br />
| align="left" |1.00<br />
|-<br />
| align="left" |target_index_int<br />
| align="left" |Über diese Variable setzt das Script, welches Zielschild am Bus zusehen ist und steuert hierüber insbesondere die Fahrgäste. Entspricht wie ''AI_target_index'' dem Index der Reihenfolge in der Hof-Datei.<br />
| align="left" |-<br />
| align="left" |<br />
| align="left" |<br />
| align="left" |1.00<br />
|-<br />
| align="left" |AI_Scheduled_AtStation<br />
| align="left" |Nur KI-Fahrzeuge, bidirektionale Kommunikation: Bei Erreichen einer Station setzt OMSI den Wert auf 1, sodass das Script mitgeteilt bekommt, dass die Türen geöffnet werden sollen. Wenn sich der Bus abfahrbereit machen soll, setzt OMSI den Wert auf -1. Wenn der Bus abfahrbereit ist (Türen geschlossen usw.), dann setzt das Script den Wert auf 0, sodass die KI den Bus weiterfahren lassen kann.<br />
| align="left" |-1: Bus abfahrbereit machen, 0: Bus ist abfahrbereit, 1: Türen freigeben/öffnen<br />
| align="left" |(X)<br />
| align="left" |<br />
| align="left" |1.00<br />
|-<br />
| align="left" |AI_Scheduled_AtStation_Side<br />
| align="left" |Gibt dem Script an, auf welcher Seite die Türen geöffnet werden können/sollen (insbesondere bei Schienenfahrzeugen)<br />
| align="left" |0: rechts, 1: links, 2: beidseitig<br />
| align="left" |X<br />
| align="left" |X<br />
| align="left" |2.00<br />
|-<br />
| align="left" |AI<br />
| align="left" |Hierüber erfährt das Script, ob das Fahrzeug von der AI gesteuert wird.<br />
| align="left" |0: nein, 1: ja<br />
| align="left" |X<br />
| align="left" |<br />
| align="left" |1.00<br />
|-<br />
| align="left" |PAX_Entry0_Open ... ~7_Open<br />
| align="left" |Teilt OMSI mit, ob die jeweiligen Eingänge offen oder geschlossen sind.<br />
| align="left" |0: geschlossen, 1: offen<br />
| align="left" |<br />
| align="left" |<br />
| align="left" |1.00<br />
|-<br />
| align="left" |PAX_Exit0_Open<br />
| align="left" |Teilt OMSI mit, ob die jeweiligen Ausgänge offen oder geschlossen sind.<br />
| align="left" |0: geschlossen, 1: offen<br />
| align="left" |<br />
| align="left" |<br />
| align="left" |1.00<br />
|-<br />
| align="left" |PAX_Entry0_Req ... ~7_Open<br />
| align="left" |Mindestens ein Fahrgast fordert den Einstieg durch diesen Eingang an.<br />
| align="left" |0: keine Anforderung, 1: Anforderung<br />
| align="left" |<br />
| align="left" |<br />
| align="left" |1.03<br />
|-<br />
| align="left" |PAX_Exit0_Req<br />
| align="left" |Mindestens ein Fahrgast fordert den Ausstieg durch diesen Ausgang an ("Haltewunsch").<br />
| align="left" |0: keine Anforderung, 1: Anforderung<br />
| align="left" |<br />
| align="left" |<br />
| align="left" |1.03<br />
|-<br />
| align="left" |GivenTicket<br />
| align="left" |Teilt OMSI mit, ob der ggf. vorhandene Fahrscheinautomat ein Ticket ausgegeben hat.<br />
| align="left" |-1: kein Ticket, 0: Tickettyp 0, 1: Tickettyp 1, ...<br />
| align="left" |<br />
| align="left" |<br />
| align="left" |1.00<br />
|-<br />
| align="left" |humans_count<br />
| align="left" |Anzahl der Fahrgäste im Fahrzeug<br />
| align="left" |-<br />
| align="left" |X<br />
| align="left" |<br />
| align="left" |1.00<br />
|-<br />
| align="left" |FF_Vib_Period<br />
| align="left" |Setzt die Force-Feedback-Vibrationsperiode im Lenkrad<br />
| align="left" |s<br />
| align="left" |<br />
| align="left" |<br />
| align="left" |1.00<br />
|-<br />
| align="left" |FF_Vib_Amp<br />
| align="left" |Setzt die Force-Feedback-Vibrationsamplitude im Lenkrad<br />
| align="left" |0...1<br />
| align="left" |<br />
| align="left" |<br />
| align="left" |1.00<br />
|-<br />
| align="left" |Snd_OutsideVol<br />
| align="left" |Teilt OMSI mit, wie stark der Außensound im Innenraum hörbar ist; verändert sich bspw. wenn eine Tür geöffnet wird.<br />
| align="left" |0: kaum hörbar, 1: wie draußen<br />
| align="left" |<br />
| align="left" |<br />
| align="left" |1.00<br />
|-<br />
| align="left" |Snd_Microphone<br />
| align="left" |Soll das (Hardware-)Mikrofon aktiv sein?<br />
| align="left" |0: aus, 1: an<br />
| align="left" |<br />
| align="left" |<br />
| align="left" |1.00<br />
|-<br />
| align="left" |Snd_Radio<br />
| align="left" |Soll das (Internet-)Radio laufen?<br />
| align="left" |0: aus, 1: an<br />
| align="left" |<br />
| align="left" |<br />
| align="left" |1.00<br />
|-<br />
| align="left" |Cabinair_Temp<br />
| align="left" |Innenraumtemperatur für die Beurteilung durch die Fahrgäste<br />
| align="left" |°C<br />
| align="left" |<br />
| align="left" |<br />
| align="left" |1.00<br />
|-<br />
| align="left" |Cabinair_absHum<br />
| align="left" |[http://de.wikipedia.org/wiki/Luftfeuchtigkeit#Absolute_Luftfeuchtigkeit Absolute Luftfeuchtigkeit] im Innenraum für die Beurteilung durch die Fahrgäste<br />
| align="left" |g/m³<br />
| align="left" |<br />
| align="left" |<br />
| align="left" |1.00<br />
|-<br />
| align="left" |Cabinair_relHum<br />
| align="left" |[http://de.wikipedia.org/wiki/Luftfeuchtigkeit#Relative_Luftfeuchtigkeit Relative Luftfeuchtigkeit] im Innenraum, wird durch OMSI automatisch über die absolute Feuchtigkeit und die Innentemperatur berechnet.<br />
| align="left" |0 = 0%, 1 = 100%<br />
| align="left" |X<br />
| align="left" |<br />
| align="left" |1.00<br />
|-<br />
| align="left" |PrecipRate<br />
| align="left" |Niederschlagsrate<br />
| align="left" |0 = kein, 1 = maximal<br />
| align="left" |X<br />
| align="left" |<br />
| align="left" |1.00<br />
|-<br />
| align="left" |PrecipType<br />
| align="left" |Niederschlagstyp<br />
| align="left" |0 = kein, 1 = Regen, 2 = Schnee<br />
| align="left" |X<br />
| align="left" |<br />
| align="left" |1.00<br />
|-<br />
| align="left" |Dirt_Norm<br />
| align="left" |allgemeiner Verdreckungszustand (Windschutzscheiben können sauberer sein und werden nur vom Script simuliert)<br />
| align="left" |0 = sauber, 1 = total verdreckt<br />
| align="left" |X<br />
| align="left" |<br />
| align="left" |1.00<br />
|-<br />
| align="left" |DirtRate<br />
| align="left" |aktuelle Verdreckungsrate<br />
| align="left" |Verdreckung / s, wobei eine Verdreckung = 1 bedeutet, dass die Verdreckung maximal ist.<br />
| align="left" |X<br />
| align="left" |<br />
| align="left" |1.00<br />
|-<br />
| align="left" |schedule_active<br />
| align="left" |Ist gerade ein Fahrplan aktiv? (Bspw. für Einblendung der Fahrplankarte)<br />
| align="left" |0: nein, 1: ja<br />
| align="left" |X<br />
| align="left" |<br />
| align="left" |1.00<br />
|-<br />
| align="left" |train_frontcoupling<br />
| align="left" |Ist an der vorderen Kupplung etwas angekuppelt? (Eventuell spätere Benutzung zum Abkuppeln)<br />
| align="left" |0: nein, 1: ja<br />
| align="left" |X<br />
| align="left" |<br />
| align="left" |1.00<br />
|-<br />
| align="left" |train_backcoupling<br />
| align="left" |Ist an der hinteren Kupplung etwas angekuppelt? (Eventuell spätere Benutzung zum Abkuppeln)<br />
| align="left" |0: nein, 1: ja<br />
| align="left" |X<br />
| align="left" |<br />
| align="left" |1.00<br />
|-<br />
| align="left" |train_me_reverse<br />
| align="left" |Steht dieses Fahrzeug rückwärts zum gesamten Fahrzeugverband?<br />
| align="left" |0: nein, 1: ja<br />
| align="left" |X<br />
| align="left" |<br />
| align="left" |1.00<br />
|-<br />
| align="left" |TrafficPriority<br />
| align="left" |Diese Variable wird vom Fahrzeug gesetzt, wenn dieses Fahrzeug (z.B. Feuerwehr oder Polizei) im Einsatz ist und Vorrang vor allen anderen Verkehrsteilnehmern genießt.<br />
| align="left" |0: nein, 1: ja<br />
| align="left" |<br />
| align="left" |<br />
| align="left" |2.00<br />
|-<br />
| align="left" |wearlifespan<br />
| align="left" |Faktor, welcher beim Initialisieren von Verschleißteil-Lebensdauern über den Durchschnittswert multipliziert wird. Hierrüber wirkt sich die Einstellung in den Optionen über dem Wartungszustand auf die Lebensdauern aus. <br />
| align="left" |10: sehr gute Wartung, 1: normale Wartung, 0.1: schlechte Wartung, 0.01: sehr schlechte Wartung, 1500000: "unendlich"<br />
| align="left" |X<br />
| align="left" |<br />
| align="left" |2.00<br />
|-<br />
| align="left" |articulation_#_alpha / ~_beta<br />
| align="left" |Winkel, um den das #. Gelenk um die Hochachse (''alpha'') bzw. Querachse (''beta'') geknickt ist<br />
| align="left" |°<br />
| align="left" |X<br />
| align="left" |X<br />
| align="left" |2.00<br />
|-<br />
| align="left" |boogie_#_wheel_at_limit<br />
| align="left" |Wie weit läuft das Drehgestell an der Kante?<br />
| align="left" |0 = genau mittig auf dem Gleis, -1/1: ganz an einer der beiden Kanten - Quietschen ist das Resultat<br />
| align="left" |X<br />
| align="left" |X<br />
| align="left" |2.00<br />
|-<br />
| align="left" |boogie_#_invradius<br />
| align="left" |Welchen inversen Kurvenradius hat die Kurve am Drehgestell?<br />
| align="left" |1/m<br />
| align="left" |X<br />
| align="left" |X<br />
| align="left" |2.00<br />
|-<br />
| align="left" |contactshoe_#_rail_pos_x / ~_y<br />
| align="left" |An welcher Position befindet sich die Stromschiene am Gleis?<br />
| align="left" |m<br />
| align="left" |X<br />
| align="left" |X<br />
| align="left" |2.00<br />
|-<br />
| align="left" |contactshoe_#_rail_index<br />
| align="left" |Index der Stromschiene, -1, falls keine vorhanden ist<br />
| align="left" |index<br />
| align="left" |X<br />
| align="left" |X<br />
| align="left" |2.00<br />
|-<br />
| align="left" |contactshoe_#_volt_rail<br />
| align="left" |Spannung an der Stromschiene<br />
| align="left" |[http://de.wikipedia.org/wiki/Volt V]<br />
| align="left" |X<br />
| align="left" |X<br />
| align="left" |2.00<br />
|-<br />
| align="left" |contactshoe_#_volt_veh<br />
| align="left" |Der durch diese Stromschiene ins Fahrzeug gelangte Spannung<br />
| align="left" |[http://de.wikipedia.org/wiki/Volt V]<br />
| align="left" |X<br />
| align="left" |X<br />
| align="left" |2.00<br />
|-<br />
| align="left" |contactshoe_#_freq<br />
| align="left" |Die Frequenz der an dieser Stromschiene liegenden [http://de.wikipedia.org/wiki/Wechselspannung Spannung]<br />
| align="left" |[http://de.wikipedia.org/wiki/Hertz_(Einheit) Hz], 0: Gleichspannung<br />
| align="left" |X<br />
| align="left" |X<br />
| align="left" |2.00<br />
|}<br />
<br />
<nowiki>*) Bidirektionale KI-Variablen: Handelt es sich um ein Userfahrzeug, kann das Script dem Hauptprogramm mitteilen, wie Licht, Blinker usw. gesetzt wurden. Handelt es sich aber um ein KI-Fahrzeug, teilt OMSI dem Script mit, wie die entsprechenden Zustände gesetzt werden müssen.</nowiki><br />
<br />
==== Stringvariablen ====<br />
<br />
Siehe bitte auch Datei ''program\stringvarlist_roadvehicle.txt''!<br />
<br />
{| class="wikitable" style="font-size:95%;" <br />
|- class="hintergrundfarbe5"<br />
| align="left" |''Variablenname''<br />
| align="left" |''Beschreibung''<br />
| align="left" |''kein Schreibzugriff''<br />
|-<br />
| align="left" |ident<br />
| align="left" |Enthält das Kraftfahrzeugkennzeichen dieses Fahrzeugs (z.B. "B-V 3503")<br />
| align="left" |X<br />
|-<br />
| align="left" |number<br />
| align="left" |Enthält die Fahrzeugnummer (z.B. "3503")<br />
| align="left" |X<br />
|-<br />
| align="left" |act_route<br />
| align="left" |''(keine Verwendung)''<br />
| align="left" |<br />
|-<br />
| align="left" |act_busstop<br />
| align="left" |Wird zusammen mit dem internen Trigger ''ai_scheduled_setbusstop'' verwendet: Enthält dann den Namen der im Fahrplansystem aktiven Haltestelle.<br />
| align="left" |X<br />
|-<br />
| align="left" |SetLineTo<br />
| align="left" |Wird zusammen mit dem internen Trigger ''ai_scheduled_settarget'' verwendet: Enthält die einzustellende Liniennummer (oder Symbol) (bei Verwendung vom Zielschild-Menü oder beim Umschildern von KI-Bussen)<br />
| align="left" |X<br />
|-<br />
| align="left" |yard<br />
| align="left" |Name der Hofdatei des Fahrzeuges, bspw. damit das Scriptsystem den Dateinamen der Zielcode-Tabelle generieren kann.<br />
| align="left" |X<br />
|-<br />
| align="left" |file_schedule<br />
| align="left" |Enthält den Dateinamen der Fahrplan-Bitmap, die zu der von diesem Fahrzeug gefahrenen Strecke gehört.<br />
| align="left" |X<br />
|}<br />
<br />
=== Menschen ===<br />
<br />
Siehe bitte auch Datei ''program\varlist_human.txt''!<br />
<br />
{| class="wikitable" style="font-size:95%;" <br />
|- class="hintergrundfarbe5"<br />
| align="left" |''Variablenname''<br />
| align="left" |''Beschreibung''<br />
| align="left" |''Einheit''<br />
| align="left" |''kein Schreibzugriff''<br />
|-<br />
| align="left" |LastMovedDist<br />
| align="left" |Entfernung, die der Mensch seit dem letzten Durchlauf zurückgelegt hat. Wurde für die alten Animationen gebraucht.<br />
| align="left" |m<br />
| align="left" |X<br />
|-<br />
| align="left" |PAX_State<br />
| align="left" |Zustand des Menschens. Wurde für die alten Animationen gebraucht.<br />
| align="left" |0: stehen, 1: gehen, 2: sitzen<br />
| align="left" |X<br />
|-<br />
| align="left" |HeightOfSeat<br />
| align="left" |Höhe des Sitzes. Diese Eigenschaft wird in der Sitzposition gebraucht, um die Höhe der Füße korrekt gesetzt. Wurde für die alten Animationen gebraucht.<br />
| align="left" |m<br />
| align="left" |X<br />
|-<br />
| align="left" |Colorscheme<br />
| align="left" |Tauschtextur-Index ("Farbschema") des Menschens.<br />
| align="left" |-<br />
| align="left" |X<br />
|}<br />
<br />
[[Kategorie:Nachschlagewerk für Addon-Entwickler]]</div>Marcel Kuhnthttp://wiki.omnibussimulator.de/omsiwikineu.de/index.php?title=System-Trigger&diff=875System-Trigger2014-02-11T16:07:43Z<p>Marcel Kuhnt: </p>
<hr />
<div>''Hinweis: Dieser Artikel wurde noch nicht ins Englische übersetzt!''<br />
<br />
System-Trigger sind Trigger, welche einen {trigger:''name''}...{end}-Block in einem Fahrzeug- oder Szenerieobjektscript aufruft und dabei nicht durch einen Tastendruck oder ein Maus-Ereignis des Users ausgelöst wird sondern direkt von OMSI.<br />
<br />
{| class="wikitable" style="font-size:95%;" <br />
|- class="hintergrundfarbe5"<br />
| align="left" |''Bezeichnung''<br />
| align="left" |''Beschreibung''<br />
| align="left" |''ab OMSI-Vs.''<br />
|-<br />
| align="left" |collision<br />
| align="left" |Wird für jede Kollision ausgelöst. Zuvor werden die ''coll_~''-Variablen entsprechend gesetzt.<br />
| align="left" |1.00<br />
|-<br />
| align="left" |int_haltewunsch<br />
| align="left" |Hierüber teilen die Fahrgäste dem Bus-Script mit, dass sie aussteigen wollen. Damit die Türen ggf. auch offen bleiben, "drücken" die Fahrgäste normalerweise mehrfach!<br />
| align="left" |1.00<br />
|-<br />
| align="left" |railbond_#<br />
| align="left" |Auslösen der Schienenstoß-Sounds bei Schienenfahrzeugen<br />
| align="left" |1.00<br />
|-<br />
| align="left" |ai_scheduled_settarget<br />
| align="left" |Aufforderung an das Script, die angezeigte Linie und das Zielschild neu einzustellen. Der String für die Linie wird über die Fahrzeug-Variable ''SetLineTo'' vorgegeben, der Index des Ziels in der Hofdatei über ''AI_target_index''.<br />
| align="left" |1.00<br />
|-<br />
| align="left" |ai_scheduled_setbusstop<br />
| align="left" |Aufforderung an das Script, die Haltestelle zu aktualisieren, z.B. für die Innenraumanzeige. Die neue Haltestelle wird dem Script über die Fahrzeug-Variable ''act_busstop'' mitgeteilt.<br />
| align="left" |1.00<br />
|}<br />
<br />
[[Kategorie:Nachschlagewerk für Addon-Entwickler]]</div>Marcel Kuhnthttp://wiki.omnibussimulator.de/omsiwikineu.de/index.php?title=System-_und_vordefinierte_lokalen_Variablen&diff=874System- und vordefinierte lokalen Variablen2014-02-11T16:01:44Z<p>Marcel Kuhnt: </p>
<hr />
<div>''Hinweis: Dieser Artikel wurde noch nicht ins Englische übersetzt!''<br />
<br />
''OMSI-Version: 1.0 - 2.0''<br />
<br />
Beschreibung der System- und der lokalen [[Scriptsystem#Variablenzugriff|Scriptvariablen]], welche für jedes Objekt vordefiniert werden und im Allgemeinen bestimmte Sonderfunktionen gegenüber frei definierten Scriptvariablen übernehmen.<br />
<br />
== Systemvariablen ==<br />
<br />
Siehe bitte auch Datei ''program\varlist_system.txt''!<br />
<br />
{| class="wikitable" style="font-size:95%;" <br />
|- class="hintergrundfarbe5"<br />
| align="left" |''Variablenname''<br />
| align="left" |''Beschreibung''<br />
| align="left" |''Einheit''<br />
| align="left" |''ab OMSI-Vs.''<br />
|-<br />
| align="left" |Timegap<br />
| align="left" |Zeitschritt seit dem letzten Durchlauf (Frame)<br />
| align="left" |Sekunden<br />
| align="left" |1.00<br />
|-<br />
| align="left" |GetTime<br />
| align="left" |Enthält eine absolute Zeitangabe, die vom Beginn des Ausführens von OMSI zählt<br />
| align="left" |Sekunden<br />
| align="left" |1.00<br />
|-<br />
| align="left" |NoSound<br />
| align="left" |Sounds deaktiviert?<br />
| align="left" |0 = Sounds aktiviert, 1 = Sounds deaktiviert<br />
| align="left" |1.00<br />
|-<br />
| align="left" |Pause<br />
| align="left" |Simulations-Pause aktiv?<br />
| align="left" |0 = Simulation läuft, 1 = Simulation angehalten<br />
| align="left" |1.00<br />
|-<br />
| align="left" |Time<br />
| align="left" |Uhrzeit gerechnet von Mitternacht des aktuellen Tages<br />
| align="left" |Sekunden<br />
| align="left" |1.00<br />
|-<br />
| align="left" |Day<br />
| align="left" |Tag gezählt ab Monatsbeginn<br />
| align="left" |Tage<br />
| align="left" |1.00<br />
|-<br />
| align="left" |Month<br />
| align="left" |Monat<br />
| align="left" |Monate<br />
| align="left" |1.00<br />
|-<br />
| align="left" |Year<br />
| align="left" |Jahr<br />
| align="left" |Jahre<br />
| align="left" |1.00<br />
|-<br />
| align="left" |DayOfYear<br />
| align="left" |Tag gezählt ab Jahresbeginn<br />
| align="left" |Tage<br />
| align="left" |1.00<br />
|-<br />
| align="left" |mouse_x<br />
| align="left" |X-Koordinate des Mauszeigers auf dem Bildschirm<br />
| align="left" |Pixel<br />
| align="left" |1.00<br />
|-<br />
| align="left" |mouse_y<br />
| align="left" |Y-Koordinate des Mauszeigers auf dem Bildschirm<br />
| align="left" |Pixel<br />
| align="left" |1.00<br />
|-<br />
| align="left" |PrecipType<br />
| align="left" |Niederschlagstyp<br />
| align="left" |0 = keiner, 1 = Regen, 2 = Schnee<br />
| align="left" |1.00<br />
|-<br />
| align="left" |PrecipRate<br />
| align="left" |Niederschlagstyp<br />
| align="left" |0 = kein Niederschlag, 1 = maximaler Niederschlag<br />
| align="left" |1.00<br />
|-<br />
| align="left" |coll_pos_x<br />
| align="left" |Position der Kollision, x-Richtung relativ zum Fahrzeugursprung (nur bei Auslösung des Kollisions-Triggers)<br />
| align="left" |Meter<br />
| align="left" |1.00<br />
|-<br />
| align="left" |coll_pos_y<br />
| align="left" |Position der Kollision, y-Richtung relativ zum Fahrzeugursprung (nur bei Auslösung des Kollisions-Triggers)<br />
| align="left" |Meter<br />
| align="left" |1.00<br />
|-<br />
| align="left" |coll_pos_z<br />
| align="left" |Position der Kollision, z-Richtung relativ zum Fahrzeugursprung (nur bei Auslösung des Kollisions-Triggers)<br />
| align="left" |Meter<br />
| align="left" |1.00<br />
|-<br />
| align="left" |coll_energy<br />
| align="left" |Energie der Kollision (nur bei Auslösung des Kollisions-Triggers)<br />
| align="left" |Nm<br />
| align="left" |1.00<br />
|-<br />
| align="left" |Weather_Temperature<br />
| align="left" |Außentemperatur<br />
| align="left" |°C<br />
| align="left" |1.00<br />
|-<br />
| align="left" |Weather_AbsHum<br />
| align="left" |Absolute Luftfeuchtigkeit<br />
| align="left" |g/m³<br />
| align="left" |1.00<br />
|-<br />
| align="left" |AutoClutch<br />
| align="left" |Option "automatische Kupplung" aktiviert<br />
| align="left" |0 = aus, 1 = an<br />
| align="left" |1.03<br />
|-<br />
| align="left" |wearlifespan<br />
| align="left" |''nicht nutzen!''<br />
| align="left" |<br />
| align="left" |2.00<br />
|-<br />
| align="left" |SunAlt<br />
| align="left" |Höhenwinkel der Sonne<br />
| align="left" |°<br />
| align="left" |2.00<br />
|}<br />
<br />
== Vordefinierte lokale Variablen ==<br />
<br />
Seit OMSI 2 gibt es eine neue Form vordefinierter Variablen: Diese tauchen nicht in der ''varlist_*.txt''-Datei im ''program''-Verzeichnis auf und müssen daher so wie "normale" lokale Variablen deklariert werden, sie werden aber dennoch (sofern sie deklariert werden) mit internen Variablen verbunden. Diese Variablen werden "on-demand-vordefinierte Variablen" genannt. Bitte beachten Sie hierzu die neue Spalte!<br />
<br />
=== Szenerieobjekte ===<br />
<br />
Siehe bitte auch Datei ''program\varlist_scenobj.txt''!<br />
<br />
{| class="wikitable" style="font-size:95%;" <br />
|- class="hintergrundfarbe5"<br />
| align="left" |''Variablenname''<br />
| align="left" |''Beschreibung''<br />
| align="left" |''Einheit''<br />
| align="left" |''kein Schreibzugriff''<br />
| align="left" |''ab OMSI-Vs.''<br />
|-<br />
| align="left" |NightLightA<br />
| align="left" |Ist die Nachtbeleuchtung aktiv?<br />
| align="left" |0 = aus, 1 = an<br />
| align="left" |X<br />
| align="left" |1.00<br />
|-<br />
| align="left" |InUse<br />
| align="left" |Ist das Objekt "aktiv"? Die Sporthallen sind bspw. nur an Schultagen vormittags "aktiv", sodass die Soundeffekte an diese Variable gekoppelt werden können - auf diese Weise wird verhindert, dass die Soundeffekte auch in den Ferien oder nachts zu hören sind.<br />
| align="left" |0 = inaktiv, 1 = aktiv<br />
| align="left" |X<br />
| align="left" |1.00<br />
|-<br />
| align="left" |TrafficLightPhase<br />
| align="left" |Hierüber wird Ampelobjekten die anzuzeigende Ampelphase mitgeteilt.<br />
| align="left" |0..2 = rot, 3..5 = rot-gelb, 6..8 = grün, 9..11 = gelb, sonst aus<br />
| align="left" |X<br />
| align="left" |1.00<br />
|-<br />
| align="left" |TrafficLightApproach<br />
| align="left" |Hierüber kann das Script eine Ampelanforderung erkennen und bspw. eine Kennleuchte aktiviert werden.<br />
| align="left" |0 = keine Anforderung, 1 = Anforderung<br />
| align="left" |X<br />
| align="left" |1.00<br />
|-<br />
| align="left" |Colorscheme<br />
| align="left" |(veraltet)<br />
| align="left" |(-)<br />
| align="left" |X<br />
| align="left" |1.00<br />
|-<br />
| align="left" |Signal<br />
| align="left" |Hierüber erhalten Signale ihr anzuzeigendes Signalbild<br />
| align="left" |individuell<br />
| align="left" |X<br />
| align="left" |1.00<br />
|-<br />
| align="left" |NextSignal<br />
| align="left" |Hierüber erhalten Signale mit Vorsignalfunktion das anzuzeigende Signalbild des nächsten Signals<br />
| align="left" |individuell<br />
| align="left" |X<br />
| align="left" |1.00<br />
|-<br />
| align="left" |Refresh_Strings<br />
| align="left" |Diese Variable muss auf "1" gesetzt werden, damit die Text-Texturen aktualisiert werden! Wird nach erfolgreicher Abarbeitung von OMSI auf 0 gesetzt.<br />
| align="left" |-<br />
| align="left" |<br />
| align="left" |1.00<br />
|-<br />
| align="left" |Switch<br />
| align="left" |Mit dieser Variable kann die Weiche, die im Objekt eingebaut ist, gestellt werden. Hierfür muss der Wert der Variable auf den mit [switchdir] angegebenen Wert des gewünschten Pfades gesetzt werden.<br />
| align="left" |-<br />
| align="left" |<br />
| align="left" |2.00<br />
|}<br />
<br />
=== Fahrzeuge ===<br />
<br />
Wichtig: Üblicherweise nutzen Gelenkbusse das [[Scriptshare]]-System, bei welchem sich mehrere Fahrzeuge denselben Variablenspeicher teilen. Hierbei ist zu beachten, dass Räder und Türen '''über alle Fahrzeugteile zählen'''. Beim NG272 bedeutet dies beispielsweise, dass die dritte Tür auch mit PAX_Entry2_Open angesteuert wird.<br />
<br />
==== Zahlvariablen ====<br />
<br />
Siehe bitte auch Datei ''program\varlist_roadvehicle.txt''!<br />
<br />
{| class="wikitable" style="font-size:95%;" <br />
|- class="hintergrundfarbe5"<br />
| align="left" |''Variablenname''<br />
| align="left" |''Beschreibung''<br />
| align="left" |''Einheit''<br />
| align="left" |''kein Schreibzugriff''<br />
| align="left" |''"on demand"''<br />
| align="left" |''ab OMSI-Vs.''<br />
|-<br />
| align="left" |Refresh_Strings<br />
| align="left" |Diese Variable muss auf "1" gesetzt werden, damit die Text-Texturen aktualisiert werden! Wird nach erfolgreicher Abarbeitung von OMSI auf 0 gesetzt.<br />
| align="left" |-<br />
| align="left" |<br />
| align="left" |<br />
| align="left" |1.00<br />
|-<br />
| align="left" |Envir_Brightness<br />
| align="left" |Umgebungshelligkeit in Fahrzeugnähe<br />
| align="left" |0 = dunkel, 1 = hell<br />
| align="left" |X<br />
| align="left" |<br />
| align="left" |1.00<br />
|-<br />
| align="left" |StreetCond<br />
| align="left" |Information über die Oberflächenbedingungen<br />
| align="left" |0: Trocken, 0..1: zunehmende Feuchtigkeit, 1: komplett feucht, 1..2: teilweise Pfützen, 2: Fahrzeug komplett in Pfützen<br />
| align="left" |X<br />
| align="left" |<br />
| align="left" |1.00<br />
|-<br />
| align="left" |Spot_Select<br />
| align="left" |Hierüber kann gesteuert werden, welches fürs Fahrzeug vordefinierte Spotlight aktiv sein soll.<br />
| align="left" |-1: kein Spotlight, 0: Spotlight Nr. 0, 1: Spotlight Nr. 1 usw.<br />
| align="left" |<br />
| align="left" |<br />
| align="left" |1.00<br />
|-<br />
| align="left" |Colorscheme<br />
| align="left" |Index des gewählten Farbschemas/Anstriches<br />
| align="left" |-<br />
| align="left" |X<br />
| align="left" |<br />
| align="left" |1.00<br />
|-<br />
| align="left" |M_Wheel<br />
| align="left" |Hierüber kann das Script ein [http://de.wikipedia.org/wiki/Drehmoment Drehmoment] auf die Räder übertragen. Hierbei die Summe anzugeben, welche auf alle als angetrieben ausgewiesene Achsen wirken <br />
soll.<br />
| align="left" |kNm = 1000 [http://de.wikipedia.org/wiki/Newtonmeter Nm]<br />
| align="left" |<br />
| align="left" |<br />
| align="left" |1.00<br />
|-<br />
| align="left" |n_Wheel<br />
| align="left" |Mittlere Raddrehzahl des Fahrzeuges<br />
| align="left" |Umdrehungen pro Minute<br />
| align="left" |X<br />
| align="left" |<br />
| align="left" |1.00<br />
|-<br />
| align="left" |Throttle<br />
| align="left" |Stellung des Gaspedals<br />
| align="left" |0..1<br />
| align="left" |X<br />
| align="left" |<br />
| align="left" |1.00<br />
|-<br />
| align="left" |Brake<br />
| align="left" |Stellung des Bremspedals<br />
| align="left" |0..1<br />
| align="left" |X<br />
| align="left" |<br />
| align="left" |1.00<br />
|-<br />
| align="left" |Clutch<br />
| align="left" |Stellung des Kupplungspedals<br />
| align="left" |0..1<br />
| align="left" |X<br />
| align="left" |<br />
| align="left" |1.00<br />
|-<br />
| align="left" |Brakeforce<br />
| align="left" |Hierüber kann das Script die Gesamtbremskraft des Fahrzeuges vorgeben, welche auf die Räder wirkt. Sollte nicht gleichzeitig mit ''Axle_Brakeforce...'' verwendet werden.<br />
| align="left" |[http://de.wikipedia.org/wiki/Newton_(Einheit) N]<br />
| align="left" |<br />
| align="left" |<br />
| align="left" |1.00<br />
|-<br />
| align="left" |Velocity<br />
| align="left" |Geschwindigkeit, welche sich über die Raddrehung ergibt, entspricht der Tachoanzeige<br />
| align="left" |[http://de.wikipedia.org/wiki/Km/h km/h]<br />
| align="left" |X<br />
| align="left" |<br />
| align="left" |1.00<br />
|-<br />
| align="left" |Velocity_Ground<br />
| align="left" |Geschwindigkeit, welche direkt relativ zum Grund gemessen wird, berücksichtigt kein Radschleudern oder -blockieren, entspricht der Anzeige auf einem GPS<br />
| align="left" |[http://de.wikipedia.org/wiki/Km/h km/h]<br />
| align="left" |X<br />
| align="left" |<br />
| align="left" |1.00<br />
|-<br />
| align="left" |tank_percent<br />
| align="left" |Tankinhalt, nur für die Anzeige auf der roten Informationsleiste. Die Betankung und Simulation eines leeren Tanks geschieht über einen Trigger bzw. muss im Script programmiert werden.<br />
| align="left" |0..1<br />
| align="left" |<br />
| align="left" |<br />
| align="left" |1.00<br />
|-<br />
| align="left" |kmcounter_km<br />
| align="left" |Stand des Kilometerzählers (nur ganze km)<br />
| align="left" |km<br />
| align="left" |X<br />
| align="left" |<br />
| align="left" |1.00<br />
|-<br />
| align="left" |kmcounter_m<br />
| align="left" |Stand des Kilometerzählers (zusätzliche Meter, läuft stets nur von 0m bis 999m; hinzu kommen die Kilometer von ''kmcounter_km'')<br />
| align="left" |m<br />
| align="left" |X<br />
| align="left" |<br />
| align="left" |1.00<br />
|-<br />
| align="left" |relrange<br />
| align="left" |Zurückgelegte, relative Strecke. Wurde nur testweise für pfadfixierte Fahrzeuge eingeführt. Nicht benutzen!<br />
| align="left" |---<br />
| align="left" |X<br />
| align="left" |<br />
| align="left" |1.00<br />
|-<br />
| align="left" |Driver_Seat_VertTransl<br />
| align="left" |Einfederung des federnden Fahrersitzes<br />
| align="left" |m<br />
| align="left" |X<br />
| align="left" |<br />
| align="left" |1.00<br />
|-<br />
| align="left" |Wheel_Rotation_0_L / ~_R ... ~_3_L / _R<br />
| align="left" |Drehwinkel des jeweiligen Rades, z.B. für die Animation<br />
| align="left" |[http://de.wikipedia.org/wiki/Radiant_(Einheit) rad]<br />
| align="left" |X<br />
| align="left" |<br />
| align="left" |1.00<br />
|-<br />
| align="left" |Wheel_RotationSpeed_0_L / ~_R ... ~_3_L / _R<br />
| align="left" |Drehzahl des jeweiligen Rades<br />
| align="left" |Umdrehungen pro Minute<br />
| align="left" |X<br />
| align="left" |<br />
| align="left" |1.00<br />
|-<br />
| align="left" |Axle_Suspension_0_L / ~_R ... ~_3_L / _R<br />
| align="left" |Einfederungsweg des jeweiligen Rades<br />
| align="left" |m<br />
| align="left" |X<br />
| align="left" |<br />
| align="left" |1.00<br />
|-<br />
| align="left" |Axle_Steering_0_L / ~_R ... ~_3_L / _R<br />
| align="left" |Lenkwinkel des jeweiligen Rades<br />
| align="left" |[http://de.wikipedia.org/wiki/Radiant_(Einheit) rad]<br />
| align="left" |X<br />
| align="left" |<br />
| align="left" |1.00<br />
|-<br />
| align="left" |Axle_Springfactor_0_L / ~_R ... ~_3_L / _R<br />
| align="left" |Faktor, mit dem radweise die Federstärke angepasst werden kann, z.B. um Luftfederungen zu simulieren.<br />
| align="left" |0 = keine, 1 = normale, 2 = doppelte Federkraft<br />
| align="left" |<br />
| align="left" |<br />
| align="left" |1.00<br />
|-<br />
| align="left" |Axle_Brakeforce_0_L / ~_R ... ~_3_L / _R<br />
| align="left" |Ermöglicht Setzen der Bremskraft pro Rad. Sollte nicht gleichzeitig mit ''Brakeforce'' verwendet werden!<br />
| align="left" |[http://de.wikipedia.org/wiki/Newton_(Einheit) N]<br />
| align="left" |<br />
| align="left" |<br />
| align="left" |1.00<br />
|-<br />
| align="left" |Axle_SurfaceID_0_L / ~_R ... ~_3_L / _R<br />
| align="left" |Oberflächenbeschaffenheit unter dem Rad<br />
| align="left" |[[Oberflächen-Codes]]<br />
| align="left" |X<br />
| align="left" |X<br />
| align="left" |2.00<br />
|-<br />
| align="left" |Debug_0 ... _5<br />
| align="left" |Debug-Variablen. Können im Debug-Modus in der Informationsleiste angezeigt werden, um auf diese Weise die Scripts zu testen.<br />
| align="left" |bliebig<br />
| align="left" |<br />
| align="left" |<br />
| align="left" |1.00<br />
|-<br />
| align="left" |A_Trans_X ... _Z<br />
| align="left" |Beschleunigungen im Fahrzeug, die durch die Fahrzeugbewegungen ausgelöst werden (beim Bremsen oder bei Kurvenfahrten usw.)<br />
| align="left" |m/s²<br />
| align="left" |X<br />
| align="left" |<br />
| align="left" |1.00<br />
|-<br />
| align="left" |AI_Blinker_L, ~_R<br />
| align="left" |Linker oder rechter Blinker aktiv<br />
| align="left" |0: aus, 1: ein<br />
| align="left" |(X)*<br />
| align="left" |<br />
| align="left" |1.00<br />
|-<br />
| align="left" |AI_Light<br />
| align="left" |Fahrlicht, Standlicht, Lichthupe<br />
| align="left" |0: Licht aus, 0.5: Standlicht an, 1: Fahrlicht an, 2: Fernlicht/Lichthupe an<br />
| align="left" |(X)*<br />
| align="left" |<br />
| align="left" |1.00<br />
|-<br />
| align="left" |AI_Interiorlight<br />
| align="left" |Innenbeleuchtung. Hierüber erfahren die einsteigenden Fahrgäste auch, ob es im Bus zu dunkel ist (sodass sie meckern dürfen).<br />
| align="left" |0: aus, 1: an<br />
| align="left" |(X)*<br />
| align="left" |<br />
| align="left" |1.00<br />
|-<br />
| align="left" |AI_Brakelight<br />
| align="left" |Nur für KI-Fahrzeuge: Script soll Bremslicht einschalten<br />
| align="left" |0: aus, 1: an<br />
| align="left" |X<br />
| align="left" |<br />
| align="left" |1.00<br />
|-<br />
| align="left" |AI_Engine<br />
| align="left" |Nur für KI-Fahrzeuge: Aufforderung zum Ein- oder Ausschalten des Motors<br />
| align="left" |-1: Motor ausschalten!, 0: egal/nicht-KI, 1: Motor einschalten!<br />
| align="left" |X<br />
| align="left" |<br />
| align="left" |1.00<br />
|-<br />
| align="left" |AI_target_index<br />
| align="left" |Dient der Übergabe des Sollwertes des einzustellenden Zielschildes bei Aufruf des Menüs oder beim Umschildern der KI-Busse. Entspricht der Reihenfolge in der Hof-Datei; erster Eintrag = 0<br />
| align="left" |-<br />
| align="left" |X<br />
| align="left" |<br />
| align="left" |1.00<br />
|-<br />
| align="left" |target_index_int<br />
| align="left" |Über diese Variable setzt das Script, welches Zielschild am Bus zusehen ist und steuert hierüber insbesondere die Fahrgäste. Entspricht wie ''AI_target_index'' dem Index der Reihenfolge in der Hof-Datei.<br />
| align="left" |-<br />
| align="left" |<br />
| align="left" |<br />
| align="left" |1.00<br />
|-<br />
| align="left" |AI_Scheduled_AtStation<br />
| align="left" |Nur KI-Fahrzeuge, bidirektionale Kommunikation: Bei Erreichen einer Station setzt OMSI den Wert auf 1, sodass das Script mitgeteilt bekommt, dass die Türen geöffnet werden sollen. Wenn sich der Bus abfahrbereit machen soll, setzt OMSI den Wert auf -1. Wenn der Bus abfahrbereit ist (Türen geschlossen usw.), dann setzt das Script den Wert auf 0, sodass die KI den Bus weiterfahren lassen kann.<br />
| align="left" |-1: Bus abfahrbereit machen, 0: Bus ist abfahrbereit, 1: Türen freigeben/öffnen<br />
| align="left" |(X)<br />
| align="left" |<br />
| align="left" |1.00<br />
|-<br />
| align="left" |AI<br />
| align="left" |Hierüber erfährt das Script, ob das Fahrzeug von der AI gesteuert wird.<br />
| align="left" |0: nein, 1: ja<br />
| align="left" |X<br />
| align="left" |<br />
| align="left" |1.00<br />
|-<br />
| align="left" |PAX_Entry0_Open ... ~7_Open<br />
| align="left" |Teilt OMSI mit, ob die jeweiligen Eingänge offen oder geschlossen sind.<br />
| align="left" |0: geschlossen, 1: offen<br />
| align="left" |<br />
| align="left" |<br />
| align="left" |1.00<br />
|-<br />
| align="left" |PAX_Exit0_Open<br />
| align="left" |Teilt OMSI mit, ob die jeweiligen Ausgänge offen oder geschlossen sind.<br />
| align="left" |0: geschlossen, 1: offen<br />
| align="left" |<br />
| align="left" |<br />
| align="left" |1.00<br />
|-<br />
| align="left" |PAX_Entry0_Req ... ~7_Open<br />
| align="left" |Mindestens ein Fahrgast fordert den Einstieg durch diesen Eingang an.<br />
| align="left" |0: keine Anforderung, 1: Anforderung<br />
| align="left" |<br />
| align="left" |<br />
| align="left" |1.03<br />
|-<br />
| align="left" |PAX_Exit0_Req<br />
| align="left" |Mindestens ein Fahrgast fordert den Ausstieg durch diesen Ausgang an ("Haltewunsch").<br />
| align="left" |0: keine Anforderung, 1: Anforderung<br />
| align="left" |<br />
| align="left" |<br />
| align="left" |1.03<br />
|-<br />
| align="left" |GivenTicket<br />
| align="left" |Teilt OMSI mit, ob der ggf. vorhandene Fahrscheinautomat ein Ticket ausgegeben hat.<br />
| align="left" |-1: kein Ticket, 0: Tickettyp 0, 1: Tickettyp 1, ...<br />
| align="left" |<br />
| align="left" |<br />
| align="left" |1.00<br />
|-<br />
| align="left" |humans_count<br />
| align="left" |Anzahl der Fahrgäste im Fahrzeug<br />
| align="left" |-<br />
| align="left" |X<br />
| align="left" |<br />
| align="left" |1.00<br />
|-<br />
| align="left" |FF_Vib_Period<br />
| align="left" |Setzt die Force-Feedback-Vibrationsperiode im Lenkrad<br />
| align="left" |s<br />
| align="left" |<br />
| align="left" |<br />
| align="left" |1.00<br />
|-<br />
| align="left" |FF_Vib_Amp<br />
| align="left" |Setzt die Force-Feedback-Vibrationsamplitude im Lenkrad<br />
| align="left" |0...1<br />
| align="left" |<br />
| align="left" |<br />
| align="left" |1.00<br />
|-<br />
| align="left" |Snd_OutsideVol<br />
| align="left" |Teilt OMSI mit, wie stark der Außensound im Innenraum hörbar ist; verändert sich bspw. wenn eine Tür geöffnet wird.<br />
| align="left" |0: kaum hörbar, 1: wie draußen<br />
| align="left" |<br />
| align="left" |<br />
| align="left" |1.00<br />
|-<br />
| align="left" |Snd_Microphone<br />
| align="left" |Soll das (Hardware-)Mikrofon aktiv sein?<br />
| align="left" |0: aus, 1: an<br />
| align="left" |<br />
| align="left" |<br />
| align="left" |1.00<br />
|-<br />
| align="left" |Snd_Radio<br />
| align="left" |Soll das (Internet-)Radio laufen?<br />
| align="left" |0: aus, 1: an<br />
| align="left" |<br />
| align="left" |<br />
| align="left" |1.00<br />
|-<br />
| align="left" |Cabinair_Temp<br />
| align="left" |Innenraumtemperatur für die Beurteilung durch die Fahrgäste<br />
| align="left" |°C<br />
| align="left" |<br />
| align="left" |<br />
| align="left" |1.00<br />
|-<br />
| align="left" |Cabinair_absHum<br />
| align="left" |[http://de.wikipedia.org/wiki/Luftfeuchtigkeit#Absolute_Luftfeuchtigkeit Absolute Luftfeuchtigkeit] im Innenraum für die Beurteilung durch die Fahrgäste<br />
| align="left" |g/m³<br />
| align="left" |<br />
| align="left" |<br />
| align="left" |1.00<br />
|-<br />
| align="left" |Cabinair_relHum<br />
| align="left" |[http://de.wikipedia.org/wiki/Luftfeuchtigkeit#Relative_Luftfeuchtigkeit Relative Luftfeuchtigkeit] im Innenraum, wird durch OMSI automatisch über die absolute Feuchtigkeit und die Innentemperatur berechnet.<br />
| align="left" |0 = 0%, 1 = 100%<br />
| align="left" |X<br />
| align="left" |<br />
| align="left" |1.00<br />
|-<br />
| align="left" |PrecipRate<br />
| align="left" |Niederschlagsrate<br />
| align="left" |0 = kein, 1 = maximal<br />
| align="left" |X<br />
| align="left" |<br />
| align="left" |1.00<br />
|-<br />
| align="left" |PrecipType<br />
| align="left" |Niederschlagstyp<br />
| align="left" |0 = kein, 1 = Regen, 2 = Schnee<br />
| align="left" |X<br />
| align="left" |<br />
| align="left" |1.00<br />
|-<br />
| align="left" |Dirt_Norm<br />
| align="left" |allgemeiner Verdreckungszustand (Windschutzscheiben können sauberer sein und werden nur vom Script simuliert)<br />
| align="left" |0 = sauber, 1 = total verdreckt<br />
| align="left" |X<br />
| align="left" |<br />
| align="left" |1.00<br />
|-<br />
| align="left" |DirtRate<br />
| align="left" |aktuelle Verdreckungsrate<br />
| align="left" |Verdreckung / s, wobei eine Verdreckung = 1 bedeutet, dass die Verdreckung maximal ist.<br />
| align="left" |X<br />
| align="left" |<br />
| align="left" |1.00<br />
|-<br />
| align="left" |schedule_active<br />
| align="left" |Ist gerade ein Fahrplan aktiv? (Bspw. für Einblendung der Fahrplankarte)<br />
| align="left" |0: nein, 1: ja<br />
| align="left" |X<br />
| align="left" |<br />
| align="left" |1.00<br />
|-<br />
| align="left" |train_frontcoupling<br />
| align="left" |Ist an der vorderen Kupplung etwas angekuppelt? (Eventuell spätere Benutzung zum Abkuppeln)<br />
| align="left" |0: nein, 1: ja<br />
| align="left" |X<br />
| align="left" |<br />
| align="left" |1.00<br />
|-<br />
| align="left" |train_backcoupling<br />
| align="left" |Ist an der hinteren Kupplung etwas angekuppelt? (Eventuell spätere Benutzung zum Abkuppeln)<br />
| align="left" |0: nein, 1: ja<br />
| align="left" |X<br />
| align="left" |<br />
| align="left" |1.00<br />
|-<br />
| align="left" |train_me_reverse<br />
| align="left" |Steht dieses Fahrzeug rückwärts zum gesamten Fahrzeugverband?<br />
| align="left" |0: nein, 1: ja<br />
| align="left" |X<br />
| align="left" |<br />
| align="left" |1.00<br />
|-<br />
| align="left" |TrafficPriority<br />
| align="left" |Diese Variable wird vom Fahrzeug gesetzt, wenn dieses Fahrzeug (z.B. Feuerwehr oder Polizei) im Einsatz ist und Vorrang vor allen anderen Verkehrsteilnehmern genießt.<br />
| align="left" |0: nein, 1: ja<br />
| align="left" |<br />
| align="left" |<br />
| align="left" |2.00<br />
|-<br />
| align="left" |wearlifespan<br />
| align="left" |Faktor, welcher beim Initialisieren von Verschleißteil-Lebensdauern über den Durchschnittswert multipliziert wird. Hierrüber wirkt sich die Einstellung in den Optionen über dem Wartungszustand auf die Lebensdauern aus. <br />
| align="left" |10: sehr gute Wartung, 1: normale Wartung, 0.1: schlechte Wartung, 0.01: sehr schlechte Wartung, 1500000: "unendlich"<br />
| align="left" |X<br />
| align="left" |<br />
| align="left" |2.00<br />
|-<br />
| align="left" |articulation_#_alpha / ~_beta<br />
| align="left" |Winkel, um den das #. Gelenk um die Hochachse (''alpha'') bzw. Querachse (''beta'') geknickt ist<br />
| align="left" |°<br />
| align="left" |X<br />
| align="left" |X<br />
| align="left" |2.00<br />
|}<br />
<br />
<nowiki>*) Bidirektionale KI-Variablen: Handelt es sich um ein Userfahrzeug, kann das Script dem Hauptprogramm mitteilen, wie Licht, Blinker usw. gesetzt wurden. Handelt es sich aber um ein KI-Fahrzeug, teilt OMSI dem Script mit, wie die entsprechenden Zustände gesetzt werden müssen.</nowiki><br />
<br />
==== Stringvariablen ====<br />
<br />
Siehe bitte auch Datei ''program\stringvarlist_roadvehicle.txt''!<br />
<br />
{| class="wikitable" style="font-size:95%;" <br />
|- class="hintergrundfarbe5"<br />
| align="left" |''Variablenname''<br />
| align="left" |''Beschreibung''<br />
| align="left" |''kein Schreibzugriff''<br />
|-<br />
| align="left" |ident<br />
| align="left" |Enthält das Kraftfahrzeugkennzeichen dieses Fahrzeugs (z.B. "B-V 3503")<br />
| align="left" |X<br />
|-<br />
| align="left" |number<br />
| align="left" |Enthält die Fahrzeugnummer (z.B. "3503")<br />
| align="left" |X<br />
|-<br />
| align="left" |act_route<br />
| align="left" |''(keine Verwendung)''<br />
| align="left" |<br />
|-<br />
| align="left" |act_busstop<br />
| align="left" |Wird zusammen mit dem internen Trigger ''ai_scheduled_setbusstop'' verwendet: Enthält dann den Namen der im Fahrplansystem aktiven Haltestelle.<br />
| align="left" |X<br />
|-<br />
| align="left" |SetLineTo<br />
| align="left" |Wird zusammen mit dem internen Trigger ''ai_scheduled_settarget'' verwendet: Enthält die einzustellende Liniennummer (oder Symbol) (bei Verwendung vom Zielschild-Menü oder beim Umschildern von KI-Bussen)<br />
| align="left" |X<br />
|-<br />
| align="left" |yard<br />
| align="left" |Name der Hofdatei des Fahrzeuges, bspw. damit das Scriptsystem den Dateinamen der Zielcode-Tabelle generieren kann.<br />
| align="left" |X<br />
|-<br />
| align="left" |file_schedule<br />
| align="left" |Enthält den Dateinamen der Fahrplan-Bitmap, die zu der von diesem Fahrzeug gefahrenen Strecke gehört.<br />
| align="left" |X<br />
|}<br />
<br />
=== Menschen ===<br />
<br />
Siehe bitte auch Datei ''program\varlist_human.txt''!<br />
<br />
{| class="wikitable" style="font-size:95%;" <br />
|- class="hintergrundfarbe5"<br />
| align="left" |''Variablenname''<br />
| align="left" |''Beschreibung''<br />
| align="left" |''Einheit''<br />
| align="left" |''kein Schreibzugriff''<br />
|-<br />
| align="left" |LastMovedDist<br />
| align="left" |Entfernung, die der Mensch seit dem letzten Durchlauf zurückgelegt hat. Wurde für die alten Animationen gebraucht.<br />
| align="left" |m<br />
| align="left" |X<br />
|-<br />
| align="left" |PAX_State<br />
| align="left" |Zustand des Menschens. Wurde für die alten Animationen gebraucht.<br />
| align="left" |0: stehen, 1: gehen, 2: sitzen<br />
| align="left" |X<br />
|-<br />
| align="left" |HeightOfSeat<br />
| align="left" |Höhe des Sitzes. Diese Eigenschaft wird in der Sitzposition gebraucht, um die Höhe der Füße korrekt gesetzt. Wurde für die alten Animationen gebraucht.<br />
| align="left" |m<br />
| align="left" |X<br />
|-<br />
| align="left" |Colorscheme<br />
| align="left" |Tauschtextur-Index ("Farbschema") des Menschens.<br />
| align="left" |-<br />
| align="left" |X<br />
|}<br />
<br />
[[Kategorie:Nachschlagewerk für Addon-Entwickler]]</div>Marcel Kuhnthttp://wiki.omnibussimulator.de/omsiwikineu.de/index.php?title=System-_und_vordefinierte_lokalen_Variablen&diff=873System- und vordefinierte lokalen Variablen2014-02-11T15:59:56Z<p>Marcel Kuhnt: /* Zahlvariablen */</p>
<hr />
<div>''Hinweis: Dieser Artikel wurde noch nicht ins Englische übersetzt!''<br />
<br />
Beschreibung der System- und der lokalen [[Scriptsystem#Variablenzugriff|Scriptvariablen]], welche für jedes Objekt vordefiniert werden und im Allgemeinen bestimmte Sonderfunktionen gegenüber frei definierten Scriptvariablen übernehmen.<br />
<br />
== Systemvariablen ==<br />
<br />
Siehe bitte auch Datei ''program\varlist_system.txt''!<br />
<br />
{| class="wikitable" style="font-size:95%;" <br />
|- class="hintergrundfarbe5"<br />
| align="left" |''Variablenname''<br />
| align="left" |''Beschreibung''<br />
| align="left" |''Einheit''<br />
| align="left" |''ab OMSI-Vs.''<br />
|-<br />
| align="left" |Timegap<br />
| align="left" |Zeitschritt seit dem letzten Durchlauf (Frame)<br />
| align="left" |Sekunden<br />
| align="left" |1.00<br />
|-<br />
| align="left" |GetTime<br />
| align="left" |Enthält eine absolute Zeitangabe, die vom Beginn des Ausführens von OMSI zählt<br />
| align="left" |Sekunden<br />
| align="left" |1.00<br />
|-<br />
| align="left" |NoSound<br />
| align="left" |Sounds deaktiviert?<br />
| align="left" |0 = Sounds aktiviert, 1 = Sounds deaktiviert<br />
| align="left" |1.00<br />
|-<br />
| align="left" |Pause<br />
| align="left" |Simulations-Pause aktiv?<br />
| align="left" |0 = Simulation läuft, 1 = Simulation angehalten<br />
| align="left" |1.00<br />
|-<br />
| align="left" |Time<br />
| align="left" |Uhrzeit gerechnet von Mitternacht des aktuellen Tages<br />
| align="left" |Sekunden<br />
| align="left" |1.00<br />
|-<br />
| align="left" |Day<br />
| align="left" |Tag gezählt ab Monatsbeginn<br />
| align="left" |Tage<br />
| align="left" |1.00<br />
|-<br />
| align="left" |Month<br />
| align="left" |Monat<br />
| align="left" |Monate<br />
| align="left" |1.00<br />
|-<br />
| align="left" |Year<br />
| align="left" |Jahr<br />
| align="left" |Jahre<br />
| align="left" |1.00<br />
|-<br />
| align="left" |DayOfYear<br />
| align="left" |Tag gezählt ab Jahresbeginn<br />
| align="left" |Tage<br />
| align="left" |1.00<br />
|-<br />
| align="left" |mouse_x<br />
| align="left" |X-Koordinate des Mauszeigers auf dem Bildschirm<br />
| align="left" |Pixel<br />
| align="left" |1.00<br />
|-<br />
| align="left" |mouse_y<br />
| align="left" |Y-Koordinate des Mauszeigers auf dem Bildschirm<br />
| align="left" |Pixel<br />
| align="left" |1.00<br />
|-<br />
| align="left" |PrecipType<br />
| align="left" |Niederschlagstyp<br />
| align="left" |0 = keiner, 1 = Regen, 2 = Schnee<br />
| align="left" |1.00<br />
|-<br />
| align="left" |PrecipRate<br />
| align="left" |Niederschlagstyp<br />
| align="left" |0 = kein Niederschlag, 1 = maximaler Niederschlag<br />
| align="left" |1.00<br />
|-<br />
| align="left" |coll_pos_x<br />
| align="left" |Position der Kollision, x-Richtung relativ zum Fahrzeugursprung (nur bei Auslösung des Kollisions-Triggers)<br />
| align="left" |Meter<br />
| align="left" |1.00<br />
|-<br />
| align="left" |coll_pos_y<br />
| align="left" |Position der Kollision, y-Richtung relativ zum Fahrzeugursprung (nur bei Auslösung des Kollisions-Triggers)<br />
| align="left" |Meter<br />
| align="left" |1.00<br />
|-<br />
| align="left" |coll_pos_z<br />
| align="left" |Position der Kollision, z-Richtung relativ zum Fahrzeugursprung (nur bei Auslösung des Kollisions-Triggers)<br />
| align="left" |Meter<br />
| align="left" |1.00<br />
|-<br />
| align="left" |coll_energy<br />
| align="left" |Energie der Kollision (nur bei Auslösung des Kollisions-Triggers)<br />
| align="left" |Nm<br />
| align="left" |1.00<br />
|-<br />
| align="left" |Weather_Temperature<br />
| align="left" |Außentemperatur<br />
| align="left" |°C<br />
| align="left" |1.00<br />
|-<br />
| align="left" |Weather_AbsHum<br />
| align="left" |Absolute Luftfeuchtigkeit<br />
| align="left" |g/m³<br />
| align="left" |1.00<br />
|-<br />
| align="left" |AutoClutch<br />
| align="left" |Option "automatische Kupplung" aktiviert<br />
| align="left" |0 = aus, 1 = an<br />
| align="left" |1.03<br />
|-<br />
| align="left" |wearlifespan<br />
| align="left" |''nicht nutzen!''<br />
| align="left" |<br />
| align="left" |2.00<br />
|-<br />
| align="left" |SunAlt<br />
| align="left" |Höhenwinkel der Sonne<br />
| align="left" |°<br />
| align="left" |2.00<br />
|}<br />
<br />
== Vordefinierte lokale Variablen ==<br />
<br />
Seit OMSI 2 gibt es eine neue Form vordefinierter Variablen: Diese tauchen nicht in der ''varlist_*.txt''-Datei im ''program''-Verzeichnis auf und müssen daher so wie "normale" lokale Variablen deklariert werden, sie werden aber dennoch (sofern sie deklariert werden) mit internen Variablen verbunden. Diese Variablen werden "on-demand-vordefinierte Variablen" genannt. Bitte beachten Sie hierzu die neue Spalte!<br />
<br />
=== Szenerieobjekte ===<br />
<br />
Siehe bitte auch Datei ''program\varlist_scenobj.txt''!<br />
<br />
{| class="wikitable" style="font-size:95%;" <br />
|- class="hintergrundfarbe5"<br />
| align="left" |''Variablenname''<br />
| align="left" |''Beschreibung''<br />
| align="left" |''Einheit''<br />
| align="left" |''kein Schreibzugriff''<br />
| align="left" |''ab OMSI-Vs.''<br />
|-<br />
| align="left" |NightLightA<br />
| align="left" |Ist die Nachtbeleuchtung aktiv?<br />
| align="left" |0 = aus, 1 = an<br />
| align="left" |X<br />
| align="left" |1.00<br />
|-<br />
| align="left" |InUse<br />
| align="left" |Ist das Objekt "aktiv"? Die Sporthallen sind bspw. nur an Schultagen vormittags "aktiv", sodass die Soundeffekte an diese Variable gekoppelt werden können - auf diese Weise wird verhindert, dass die Soundeffekte auch in den Ferien oder nachts zu hören sind.<br />
| align="left" |0 = inaktiv, 1 = aktiv<br />
| align="left" |X<br />
| align="left" |1.00<br />
|-<br />
| align="left" |TrafficLightPhase<br />
| align="left" |Hierüber wird Ampelobjekten die anzuzeigende Ampelphase mitgeteilt.<br />
| align="left" |0..2 = rot, 3..5 = rot-gelb, 6..8 = grün, 9..11 = gelb, sonst aus<br />
| align="left" |X<br />
| align="left" |1.00<br />
|-<br />
| align="left" |TrafficLightApproach<br />
| align="left" |Hierüber kann das Script eine Ampelanforderung erkennen und bspw. eine Kennleuchte aktiviert werden.<br />
| align="left" |0 = keine Anforderung, 1 = Anforderung<br />
| align="left" |X<br />
| align="left" |1.00<br />
|-<br />
| align="left" |Colorscheme<br />
| align="left" |(veraltet)<br />
| align="left" |(-)<br />
| align="left" |X<br />
| align="left" |1.00<br />
|-<br />
| align="left" |Signal<br />
| align="left" |Hierüber erhalten Signale ihr anzuzeigendes Signalbild<br />
| align="left" |individuell<br />
| align="left" |X<br />
| align="left" |1.00<br />
|-<br />
| align="left" |NextSignal<br />
| align="left" |Hierüber erhalten Signale mit Vorsignalfunktion das anzuzeigende Signalbild des nächsten Signals<br />
| align="left" |individuell<br />
| align="left" |X<br />
| align="left" |1.00<br />
|-<br />
| align="left" |Refresh_Strings<br />
| align="left" |Diese Variable muss auf "1" gesetzt werden, damit die Text-Texturen aktualisiert werden! Wird nach erfolgreicher Abarbeitung von OMSI auf 0 gesetzt.<br />
| align="left" |-<br />
| align="left" |<br />
| align="left" |1.00<br />
|-<br />
| align="left" |Switch<br />
| align="left" |Mit dieser Variable kann die Weiche, die im Objekt eingebaut ist, gestellt werden. Hierfür muss der Wert der Variable auf den mit [switchdir] angegebenen Wert des gewünschten Pfades gesetzt werden.<br />
| align="left" |-<br />
| align="left" |<br />
| align="left" |2.00<br />
|}<br />
<br />
=== Fahrzeuge ===<br />
<br />
Wichtig: Üblicherweise nutzen Gelenkbusse das [[Scriptshare]]-System, bei welchem sich mehrere Fahrzeuge denselben Variablenspeicher teilen. Hierbei ist zu beachten, dass Räder und Türen '''über alle Fahrzeugteile zählen'''. Beim NG272 bedeutet dies beispielsweise, dass die dritte Tür auch mit PAX_Entry2_Open angesteuert wird.<br />
<br />
==== Zahlvariablen ====<br />
<br />
Siehe bitte auch Datei ''program\varlist_roadvehicle.txt''!<br />
<br />
{| class="wikitable" style="font-size:95%;" <br />
|- class="hintergrundfarbe5"<br />
| align="left" |''Variablenname''<br />
| align="left" |''Beschreibung''<br />
| align="left" |''Einheit''<br />
| align="left" |''kein Schreibzugriff''<br />
| align="left" |''"on demand"''<br />
| align="left" |''ab OMSI-Vs.''<br />
|-<br />
| align="left" |Refresh_Strings<br />
| align="left" |Diese Variable muss auf "1" gesetzt werden, damit die Text-Texturen aktualisiert werden! Wird nach erfolgreicher Abarbeitung von OMSI auf 0 gesetzt.<br />
| align="left" |-<br />
| align="left" |<br />
| align="left" |<br />
| align="left" |1.00<br />
|-<br />
| align="left" |Envir_Brightness<br />
| align="left" |Umgebungshelligkeit in Fahrzeugnähe<br />
| align="left" |0 = dunkel, 1 = hell<br />
| align="left" |X<br />
| align="left" |<br />
| align="left" |1.00<br />
|-<br />
| align="left" |StreetCond<br />
| align="left" |Information über die Oberflächenbedingungen<br />
| align="left" |0: Trocken, 0..1: zunehmende Feuchtigkeit, 1: komplett feucht, 1..2: teilweise Pfützen, 2: Fahrzeug komplett in Pfützen<br />
| align="left" |X<br />
| align="left" |<br />
| align="left" |1.00<br />
|-<br />
| align="left" |Spot_Select<br />
| align="left" |Hierüber kann gesteuert werden, welches fürs Fahrzeug vordefinierte Spotlight aktiv sein soll.<br />
| align="left" |-1: kein Spotlight, 0: Spotlight Nr. 0, 1: Spotlight Nr. 1 usw.<br />
| align="left" |<br />
| align="left" |<br />
| align="left" |1.00<br />
|-<br />
| align="left" |Colorscheme<br />
| align="left" |Index des gewählten Farbschemas/Anstriches<br />
| align="left" |-<br />
| align="left" |X<br />
| align="left" |<br />
| align="left" |1.00<br />
|-<br />
| align="left" |M_Wheel<br />
| align="left" |Hierüber kann das Script ein [http://de.wikipedia.org/wiki/Drehmoment Drehmoment] auf die Räder übertragen. Hierbei die Summe anzugeben, welche auf alle als angetrieben ausgewiesene Achsen wirken <br />
soll.<br />
| align="left" |kNm = 1000 [http://de.wikipedia.org/wiki/Newtonmeter Nm]<br />
| align="left" |<br />
| align="left" |<br />
| align="left" |1.00<br />
|-<br />
| align="left" |n_Wheel<br />
| align="left" |Mittlere Raddrehzahl des Fahrzeuges<br />
| align="left" |Umdrehungen pro Minute<br />
| align="left" |X<br />
| align="left" |<br />
| align="left" |1.00<br />
|-<br />
| align="left" |Throttle<br />
| align="left" |Stellung des Gaspedals<br />
| align="left" |0..1<br />
| align="left" |X<br />
| align="left" |<br />
| align="left" |1.00<br />
|-<br />
| align="left" |Brake<br />
| align="left" |Stellung des Bremspedals<br />
| align="left" |0..1<br />
| align="left" |X<br />
| align="left" |<br />
| align="left" |1.00<br />
|-<br />
| align="left" |Clutch<br />
| align="left" |Stellung des Kupplungspedals<br />
| align="left" |0..1<br />
| align="left" |X<br />
| align="left" |<br />
| align="left" |1.00<br />
|-<br />
| align="left" |Brakeforce<br />
| align="left" |Hierüber kann das Script die Gesamtbremskraft des Fahrzeuges vorgeben, welche auf die Räder wirkt. Sollte nicht gleichzeitig mit ''Axle_Brakeforce...'' verwendet werden.<br />
| align="left" |[http://de.wikipedia.org/wiki/Newton_(Einheit) N]<br />
| align="left" |<br />
| align="left" |<br />
| align="left" |1.00<br />
|-<br />
| align="left" |Velocity<br />
| align="left" |Geschwindigkeit, welche sich über die Raddrehung ergibt, entspricht der Tachoanzeige<br />
| align="left" |[http://de.wikipedia.org/wiki/Km/h km/h]<br />
| align="left" |X<br />
| align="left" |<br />
| align="left" |1.00<br />
|-<br />
| align="left" |Velocity_Ground<br />
| align="left" |Geschwindigkeit, welche direkt relativ zum Grund gemessen wird, berücksichtigt kein Radschleudern oder -blockieren, entspricht der Anzeige auf einem GPS<br />
| align="left" |[http://de.wikipedia.org/wiki/Km/h km/h]<br />
| align="left" |X<br />
| align="left" |<br />
| align="left" |1.00<br />
|-<br />
| align="left" |tank_percent<br />
| align="left" |Tankinhalt, nur für die Anzeige auf der roten Informationsleiste. Die Betankung und Simulation eines leeren Tanks geschieht über einen Trigger bzw. muss im Script programmiert werden.<br />
| align="left" |0..1<br />
| align="left" |<br />
| align="left" |<br />
| align="left" |1.00<br />
|-<br />
| align="left" |kmcounter_km<br />
| align="left" |Stand des Kilometerzählers (nur ganze km)<br />
| align="left" |km<br />
| align="left" |X<br />
| align="left" |<br />
| align="left" |1.00<br />
|-<br />
| align="left" |kmcounter_m<br />
| align="left" |Stand des Kilometerzählers (zusätzliche Meter, läuft stets nur von 0m bis 999m; hinzu kommen die Kilometer von ''kmcounter_km'')<br />
| align="left" |m<br />
| align="left" |X<br />
| align="left" |<br />
| align="left" |1.00<br />
|-<br />
| align="left" |relrange<br />
| align="left" |Zurückgelegte, relative Strecke. Wurde nur testweise für pfadfixierte Fahrzeuge eingeführt. Nicht benutzen!<br />
| align="left" |---<br />
| align="left" |X<br />
| align="left" |<br />
| align="left" |1.00<br />
|-<br />
| align="left" |Driver_Seat_VertTransl<br />
| align="left" |Einfederung des federnden Fahrersitzes<br />
| align="left" |m<br />
| align="left" |X<br />
| align="left" |<br />
| align="left" |1.00<br />
|-<br />
| align="left" |Wheel_Rotation_0_L / ~_R ... ~_3_L / _R<br />
| align="left" |Drehwinkel des jeweiligen Rades, z.B. für die Animation<br />
| align="left" |[http://de.wikipedia.org/wiki/Radiant_(Einheit) rad]<br />
| align="left" |X<br />
| align="left" |<br />
| align="left" |1.00<br />
|-<br />
| align="left" |Wheel_RotationSpeed_0_L / ~_R ... ~_3_L / _R<br />
| align="left" |Drehzahl des jeweiligen Rades<br />
| align="left" |Umdrehungen pro Minute<br />
| align="left" |X<br />
| align="left" |<br />
| align="left" |1.00<br />
|-<br />
| align="left" |Axle_Suspension_0_L / ~_R ... ~_3_L / _R<br />
| align="left" |Einfederungsweg des jeweiligen Rades<br />
| align="left" |m<br />
| align="left" |X<br />
| align="left" |<br />
| align="left" |1.00<br />
|-<br />
| align="left" |Axle_Steering_0_L / ~_R ... ~_3_L / _R<br />
| align="left" |Lenkwinkel des jeweiligen Rades<br />
| align="left" |[http://de.wikipedia.org/wiki/Radiant_(Einheit) rad]<br />
| align="left" |X<br />
| align="left" |<br />
| align="left" |1.00<br />
|-<br />
| align="left" |Axle_Springfactor_0_L / ~_R ... ~_3_L / _R<br />
| align="left" |Faktor, mit dem radweise die Federstärke angepasst werden kann, z.B. um Luftfederungen zu simulieren.<br />
| align="left" |0 = keine, 1 = normale, 2 = doppelte Federkraft<br />
| align="left" |<br />
| align="left" |<br />
| align="left" |1.00<br />
|-<br />
| align="left" |Axle_Brakeforce_0_L / ~_R ... ~_3_L / _R<br />
| align="left" |Ermöglicht Setzen der Bremskraft pro Rad. Sollte nicht gleichzeitig mit ''Brakeforce'' verwendet werden!<br />
| align="left" |[http://de.wikipedia.org/wiki/Newton_(Einheit) N]<br />
| align="left" |<br />
| align="left" |<br />
| align="left" |1.00<br />
|-<br />
| align="left" |Axle_SurfaceID_0_L / ~_R ... ~_3_L / _R<br />
| align="left" |Oberflächenbeschaffenheit unter dem Rad<br />
| align="left" |[[Oberflächen-Codes]]<br />
| align="left" |X<br />
| align="left" |X<br />
| align="left" |2.00<br />
|-<br />
| align="left" |Debug_0 ... _5<br />
| align="left" |Debug-Variablen. Können im Debug-Modus in der Informationsleiste angezeigt werden, um auf diese Weise die Scripts zu testen.<br />
| align="left" |bliebig<br />
| align="left" |<br />
| align="left" |<br />
| align="left" |1.00<br />
|-<br />
| align="left" |A_Trans_X ... _Z<br />
| align="left" |Beschleunigungen im Fahrzeug, die durch die Fahrzeugbewegungen ausgelöst werden (beim Bremsen oder bei Kurvenfahrten usw.)<br />
| align="left" |m/s²<br />
| align="left" |X<br />
| align="left" |<br />
| align="left" |1.00<br />
|-<br />
| align="left" |AI_Blinker_L, ~_R<br />
| align="left" |Linker oder rechter Blinker aktiv<br />
| align="left" |0: aus, 1: ein<br />
| align="left" |(X)*<br />
| align="left" |<br />
| align="left" |1.00<br />
|-<br />
| align="left" |AI_Light<br />
| align="left" |Fahrlicht, Standlicht, Lichthupe<br />
| align="left" |0: Licht aus, 0.5: Standlicht an, 1: Fahrlicht an, 2: Fernlicht/Lichthupe an<br />
| align="left" |(X)*<br />
| align="left" |<br />
| align="left" |1.00<br />
|-<br />
| align="left" |AI_Interiorlight<br />
| align="left" |Innenbeleuchtung. Hierüber erfahren die einsteigenden Fahrgäste auch, ob es im Bus zu dunkel ist (sodass sie meckern dürfen).<br />
| align="left" |0: aus, 1: an<br />
| align="left" |(X)*<br />
| align="left" |<br />
| align="left" |1.00<br />
|-<br />
| align="left" |AI_Brakelight<br />
| align="left" |Nur für KI-Fahrzeuge: Script soll Bremslicht einschalten<br />
| align="left" |0: aus, 1: an<br />
| align="left" |X<br />
| align="left" |<br />
| align="left" |1.00<br />
|-<br />
| align="left" |AI_Engine<br />
| align="left" |Nur für KI-Fahrzeuge: Aufforderung zum Ein- oder Ausschalten des Motors<br />
| align="left" |-1: Motor ausschalten!, 0: egal/nicht-KI, 1: Motor einschalten!<br />
| align="left" |X<br />
| align="left" |<br />
| align="left" |1.00<br />
|-<br />
| align="left" |AI_target_index<br />
| align="left" |Dient der Übergabe des Sollwertes des einzustellenden Zielschildes bei Aufruf des Menüs oder beim Umschildern der KI-Busse. Entspricht der Reihenfolge in der Hof-Datei; erster Eintrag = 0<br />
| align="left" |-<br />
| align="left" |X<br />
| align="left" |<br />
| align="left" |1.00<br />
|-<br />
| align="left" |target_index_int<br />
| align="left" |Über diese Variable setzt das Script, welches Zielschild am Bus zusehen ist und steuert hierüber insbesondere die Fahrgäste. Entspricht wie ''AI_target_index'' dem Index der Reihenfolge in der Hof-Datei.<br />
| align="left" |-<br />
| align="left" |<br />
| align="left" |<br />
| align="left" |1.00<br />
|-<br />
| align="left" |AI_Scheduled_AtStation<br />
| align="left" |Nur KI-Fahrzeuge, bidirektionale Kommunikation: Bei Erreichen einer Station setzt OMSI den Wert auf 1, sodass das Script mitgeteilt bekommt, dass die Türen geöffnet werden sollen. Wenn sich der Bus abfahrbereit machen soll, setzt OMSI den Wert auf -1. Wenn der Bus abfahrbereit ist (Türen geschlossen usw.), dann setzt das Script den Wert auf 0, sodass die KI den Bus weiterfahren lassen kann.<br />
| align="left" |-1: Bus abfahrbereit machen, 0: Bus ist abfahrbereit, 1: Türen freigeben/öffnen<br />
| align="left" |(X)<br />
| align="left" |<br />
| align="left" |1.00<br />
|-<br />
| align="left" |AI<br />
| align="left" |Hierüber erfährt das Script, ob das Fahrzeug von der AI gesteuert wird.<br />
| align="left" |0: nein, 1: ja<br />
| align="left" |X<br />
| align="left" |<br />
| align="left" |1.00<br />
|-<br />
| align="left" |PAX_Entry0_Open ... ~7_Open<br />
| align="left" |Teilt OMSI mit, ob die jeweiligen Eingänge offen oder geschlossen sind.<br />
| align="left" |0: geschlossen, 1: offen<br />
| align="left" |<br />
| align="left" |<br />
| align="left" |1.00<br />
|-<br />
| align="left" |PAX_Exit0_Open<br />
| align="left" |Teilt OMSI mit, ob die jeweiligen Ausgänge offen oder geschlossen sind.<br />
| align="left" |0: geschlossen, 1: offen<br />
| align="left" |<br />
| align="left" |<br />
| align="left" |1.00<br />
|-<br />
| align="left" |PAX_Entry0_Req ... ~7_Open<br />
| align="left" |Mindestens ein Fahrgast fordert den Einstieg durch diesen Eingang an.<br />
| align="left" |0: keine Anforderung, 1: Anforderung<br />
| align="left" |<br />
| align="left" |<br />
| align="left" |1.03<br />
|-<br />
| align="left" |PAX_Exit0_Req<br />
| align="left" |Mindestens ein Fahrgast fordert den Ausstieg durch diesen Ausgang an ("Haltewunsch").<br />
| align="left" |0: keine Anforderung, 1: Anforderung<br />
| align="left" |<br />
| align="left" |<br />
| align="left" |1.03<br />
|-<br />
| align="left" |GivenTicket<br />
| align="left" |Teilt OMSI mit, ob der ggf. vorhandene Fahrscheinautomat ein Ticket ausgegeben hat.<br />
| align="left" |-1: kein Ticket, 0: Tickettyp 0, 1: Tickettyp 1, ...<br />
| align="left" |<br />
| align="left" |<br />
| align="left" |1.00<br />
|-<br />
| align="left" |humans_count<br />
| align="left" |Anzahl der Fahrgäste im Fahrzeug<br />
| align="left" |-<br />
| align="left" |X<br />
| align="left" |<br />
| align="left" |1.00<br />
|-<br />
| align="left" |FF_Vib_Period<br />
| align="left" |Setzt die Force-Feedback-Vibrationsperiode im Lenkrad<br />
| align="left" |s<br />
| align="left" |<br />
| align="left" |<br />
| align="left" |1.00<br />
|-<br />
| align="left" |FF_Vib_Amp<br />
| align="left" |Setzt die Force-Feedback-Vibrationsamplitude im Lenkrad<br />
| align="left" |0...1<br />
| align="left" |<br />
| align="left" |<br />
| align="left" |1.00<br />
|-<br />
| align="left" |Snd_OutsideVol<br />
| align="left" |Teilt OMSI mit, wie stark der Außensound im Innenraum hörbar ist; verändert sich bspw. wenn eine Tür geöffnet wird.<br />
| align="left" |0: kaum hörbar, 1: wie draußen<br />
| align="left" |<br />
| align="left" |<br />
| align="left" |1.00<br />
|-<br />
| align="left" |Snd_Microphone<br />
| align="left" |Soll das (Hardware-)Mikrofon aktiv sein?<br />
| align="left" |0: aus, 1: an<br />
| align="left" |<br />
| align="left" |<br />
| align="left" |1.00<br />
|-<br />
| align="left" |Snd_Radio<br />
| align="left" |Soll das (Internet-)Radio laufen?<br />
| align="left" |0: aus, 1: an<br />
| align="left" |<br />
| align="left" |<br />
| align="left" |1.00<br />
|-<br />
| align="left" |Cabinair_Temp<br />
| align="left" |Innenraumtemperatur für die Beurteilung durch die Fahrgäste<br />
| align="left" |°C<br />
| align="left" |<br />
| align="left" |<br />
| align="left" |1.00<br />
|-<br />
| align="left" |Cabinair_absHum<br />
| align="left" |[http://de.wikipedia.org/wiki/Luftfeuchtigkeit#Absolute_Luftfeuchtigkeit Absolute Luftfeuchtigkeit] im Innenraum für die Beurteilung durch die Fahrgäste<br />
| align="left" |g/m³<br />
| align="left" |<br />
| align="left" |<br />
| align="left" |1.00<br />
|-<br />
| align="left" |Cabinair_relHum<br />
| align="left" |[http://de.wikipedia.org/wiki/Luftfeuchtigkeit#Relative_Luftfeuchtigkeit Relative Luftfeuchtigkeit] im Innenraum, wird durch OMSI automatisch über die absolute Feuchtigkeit und die Innentemperatur berechnet.<br />
| align="left" |0 = 0%, 1 = 100%<br />
| align="left" |X<br />
| align="left" |<br />
| align="left" |1.00<br />
|-<br />
| align="left" |PrecipRate<br />
| align="left" |Niederschlagsrate<br />
| align="left" |0 = kein, 1 = maximal<br />
| align="left" |X<br />
| align="left" |<br />
| align="left" |1.00<br />
|-<br />
| align="left" |PrecipType<br />
| align="left" |Niederschlagstyp<br />
| align="left" |0 = kein, 1 = Regen, 2 = Schnee<br />
| align="left" |X<br />
| align="left" |<br />
| align="left" |1.00<br />
|-<br />
| align="left" |Dirt_Norm<br />
| align="left" |allgemeiner Verdreckungszustand (Windschutzscheiben können sauberer sein und werden nur vom Script simuliert)<br />
| align="left" |0 = sauber, 1 = total verdreckt<br />
| align="left" |X<br />
| align="left" |<br />
| align="left" |1.00<br />
|-<br />
| align="left" |DirtRate<br />
| align="left" |aktuelle Verdreckungsrate<br />
| align="left" |Verdreckung / s, wobei eine Verdreckung = 1 bedeutet, dass die Verdreckung maximal ist.<br />
| align="left" |X<br />
| align="left" |<br />
| align="left" |1.00<br />
|-<br />
| align="left" |schedule_active<br />
| align="left" |Ist gerade ein Fahrplan aktiv? (Bspw. für Einblendung der Fahrplankarte)<br />
| align="left" |0: nein, 1: ja<br />
| align="left" |X<br />
| align="left" |<br />
| align="left" |1.00<br />
|-<br />
| align="left" |train_frontcoupling<br />
| align="left" |Ist an der vorderen Kupplung etwas angekuppelt? (Eventuell spätere Benutzung zum Abkuppeln)<br />
| align="left" |0: nein, 1: ja<br />
| align="left" |X<br />
| align="left" |<br />
| align="left" |1.00<br />
|-<br />
| align="left" |train_backcoupling<br />
| align="left" |Ist an der hinteren Kupplung etwas angekuppelt? (Eventuell spätere Benutzung zum Abkuppeln)<br />
| align="left" |0: nein, 1: ja<br />
| align="left" |X<br />
| align="left" |<br />
| align="left" |1.00<br />
|-<br />
| align="left" |train_me_reverse<br />
| align="left" |Steht dieses Fahrzeug rückwärts zum gesamten Fahrzeugverband?<br />
| align="left" |0: nein, 1: ja<br />
| align="left" |X<br />
| align="left" |<br />
| align="left" |1.00<br />
|-<br />
| align="left" |TrafficPriority<br />
| align="left" |Diese Variable wird vom Fahrzeug gesetzt, wenn dieses Fahrzeug (z.B. Feuerwehr oder Polizei) im Einsatz ist und Vorrang vor allen anderen Verkehrsteilnehmern genießt.<br />
| align="left" |0: nein, 1: ja<br />
| align="left" |<br />
| align="left" |<br />
| align="left" |2.00<br />
|-<br />
| align="left" |wearlifespan<br />
| align="left" |Faktor, welcher beim Initialisieren von Verschleißteil-Lebensdauern über den Durchschnittswert multipliziert wird. Hierrüber wirkt sich die Einstellung in den Optionen über dem Wartungszustand auf die Lebensdauern aus. <br />
| align="left" |10: sehr gute Wartung, 1: normale Wartung, 0.1: schlechte Wartung, 0.01: sehr schlechte Wartung, 1500000: "unendlich"<br />
| align="left" |X<br />
| align="left" |<br />
| align="left" |2.00<br />
|-<br />
| align="left" |articulation_#_alpha / ~_beta<br />
| align="left" |Winkel, um den das #. Gelenk um die Hochachse (''alpha'') bzw. Querachse (''beta'') geknickt ist<br />
| align="left" |°<br />
| align="left" |X<br />
| align="left" |X<br />
| align="left" |2.00<br />
|}<br />
<br />
<nowiki>*) Bidirektionale KI-Variablen: Handelt es sich um ein Userfahrzeug, kann das Script dem Hauptprogramm mitteilen, wie Licht, Blinker usw. gesetzt wurden. Handelt es sich aber um ein KI-Fahrzeug, teilt OMSI dem Script mit, wie die entsprechenden Zustände gesetzt werden müssen.</nowiki><br />
<br />
==== Stringvariablen ====<br />
<br />
Siehe bitte auch Datei ''program\stringvarlist_roadvehicle.txt''!<br />
<br />
{| class="wikitable" style="font-size:95%;" <br />
|- class="hintergrundfarbe5"<br />
| align="left" |''Variablenname''<br />
| align="left" |''Beschreibung''<br />
| align="left" |''kein Schreibzugriff''<br />
|-<br />
| align="left" |ident<br />
| align="left" |Enthält das Kraftfahrzeugkennzeichen dieses Fahrzeugs (z.B. "B-V 3503")<br />
| align="left" |X<br />
|-<br />
| align="left" |number<br />
| align="left" |Enthält die Fahrzeugnummer (z.B. "3503")<br />
| align="left" |X<br />
|-<br />
| align="left" |act_route<br />
| align="left" |''(keine Verwendung)''<br />
| align="left" |<br />
|-<br />
| align="left" |act_busstop<br />
| align="left" |Wird zusammen mit dem internen Trigger ''ai_scheduled_setbusstop'' verwendet: Enthält dann den Namen der im Fahrplansystem aktiven Haltestelle.<br />
| align="left" |X<br />
|-<br />
| align="left" |SetLineTo<br />
| align="left" |Wird zusammen mit dem internen Trigger ''ai_scheduled_settarget'' verwendet: Enthält die einzustellende Liniennummer (oder Symbol) (bei Verwendung vom Zielschild-Menü oder beim Umschildern von KI-Bussen)<br />
| align="left" |X<br />
|-<br />
| align="left" |yard<br />
| align="left" |Name der Hofdatei des Fahrzeuges, bspw. damit das Scriptsystem den Dateinamen der Zielcode-Tabelle generieren kann.<br />
| align="left" |X<br />
|-<br />
| align="left" |file_schedule<br />
| align="left" |Enthält den Dateinamen der Fahrplan-Bitmap, die zu der von diesem Fahrzeug gefahrenen Strecke gehört.<br />
| align="left" |X<br />
|}<br />
<br />
=== Menschen ===<br />
<br />
Siehe bitte auch Datei ''program\varlist_human.txt''!<br />
<br />
{| class="wikitable" style="font-size:95%;" <br />
|- class="hintergrundfarbe5"<br />
| align="left" |''Variablenname''<br />
| align="left" |''Beschreibung''<br />
| align="left" |''Einheit''<br />
| align="left" |''kein Schreibzugriff''<br />
|-<br />
| align="left" |LastMovedDist<br />
| align="left" |Entfernung, die der Mensch seit dem letzten Durchlauf zurückgelegt hat. Wurde für die alten Animationen gebraucht.<br />
| align="left" |m<br />
| align="left" |X<br />
|-<br />
| align="left" |PAX_State<br />
| align="left" |Zustand des Menschens. Wurde für die alten Animationen gebraucht.<br />
| align="left" |0: stehen, 1: gehen, 2: sitzen<br />
| align="left" |X<br />
|-<br />
| align="left" |HeightOfSeat<br />
| align="left" |Höhe des Sitzes. Diese Eigenschaft wird in der Sitzposition gebraucht, um die Höhe der Füße korrekt gesetzt. Wurde für die alten Animationen gebraucht.<br />
| align="left" |m<br />
| align="left" |X<br />
|-<br />
| align="left" |Colorscheme<br />
| align="left" |Tauschtextur-Index ("Farbschema") des Menschens.<br />
| align="left" |-<br />
| align="left" |X<br />
|}<br />
<br />
[[Kategorie:Nachschlagewerk für Addon-Entwickler]]</div>Marcel Kuhnthttp://wiki.omnibussimulator.de/omsiwikineu.de/index.php?title=System-_und_vordefinierte_lokalen_Variablen&diff=872System- und vordefinierte lokalen Variablen2014-02-11T15:40:25Z<p>Marcel Kuhnt: /* Zahlvariablen */</p>
<hr />
<div>''Hinweis: Dieser Artikel wurde noch nicht ins Englische übersetzt!''<br />
<br />
Beschreibung der System- und der lokalen [[Scriptsystem#Variablenzugriff|Scriptvariablen]], welche für jedes Objekt vordefiniert werden und im Allgemeinen bestimmte Sonderfunktionen gegenüber frei definierten Scriptvariablen übernehmen.<br />
<br />
== Systemvariablen ==<br />
<br />
Siehe bitte auch Datei ''program\varlist_system.txt''!<br />
<br />
{| class="wikitable" style="font-size:95%;" <br />
|- class="hintergrundfarbe5"<br />
| align="left" |''Variablenname''<br />
| align="left" |''Beschreibung''<br />
| align="left" |''Einheit''<br />
| align="left" |''ab OMSI-Vs.''<br />
|-<br />
| align="left" |Timegap<br />
| align="left" |Zeitschritt seit dem letzten Durchlauf (Frame)<br />
| align="left" |Sekunden<br />
| align="left" |1.00<br />
|-<br />
| align="left" |GetTime<br />
| align="left" |Enthält eine absolute Zeitangabe, die vom Beginn des Ausführens von OMSI zählt<br />
| align="left" |Sekunden<br />
| align="left" |1.00<br />
|-<br />
| align="left" |NoSound<br />
| align="left" |Sounds deaktiviert?<br />
| align="left" |0 = Sounds aktiviert, 1 = Sounds deaktiviert<br />
| align="left" |1.00<br />
|-<br />
| align="left" |Pause<br />
| align="left" |Simulations-Pause aktiv?<br />
| align="left" |0 = Simulation läuft, 1 = Simulation angehalten<br />
| align="left" |1.00<br />
|-<br />
| align="left" |Time<br />
| align="left" |Uhrzeit gerechnet von Mitternacht des aktuellen Tages<br />
| align="left" |Sekunden<br />
| align="left" |1.00<br />
|-<br />
| align="left" |Day<br />
| align="left" |Tag gezählt ab Monatsbeginn<br />
| align="left" |Tage<br />
| align="left" |1.00<br />
|-<br />
| align="left" |Month<br />
| align="left" |Monat<br />
| align="left" |Monate<br />
| align="left" |1.00<br />
|-<br />
| align="left" |Year<br />
| align="left" |Jahr<br />
| align="left" |Jahre<br />
| align="left" |1.00<br />
|-<br />
| align="left" |DayOfYear<br />
| align="left" |Tag gezählt ab Jahresbeginn<br />
| align="left" |Tage<br />
| align="left" |1.00<br />
|-<br />
| align="left" |mouse_x<br />
| align="left" |X-Koordinate des Mauszeigers auf dem Bildschirm<br />
| align="left" |Pixel<br />
| align="left" |1.00<br />
|-<br />
| align="left" |mouse_y<br />
| align="left" |Y-Koordinate des Mauszeigers auf dem Bildschirm<br />
| align="left" |Pixel<br />
| align="left" |1.00<br />
|-<br />
| align="left" |PrecipType<br />
| align="left" |Niederschlagstyp<br />
| align="left" |0 = keiner, 1 = Regen, 2 = Schnee<br />
| align="left" |1.00<br />
|-<br />
| align="left" |PrecipRate<br />
| align="left" |Niederschlagstyp<br />
| align="left" |0 = kein Niederschlag, 1 = maximaler Niederschlag<br />
| align="left" |1.00<br />
|-<br />
| align="left" |coll_pos_x<br />
| align="left" |Position der Kollision, x-Richtung relativ zum Fahrzeugursprung (nur bei Auslösung des Kollisions-Triggers)<br />
| align="left" |Meter<br />
| align="left" |1.00<br />
|-<br />
| align="left" |coll_pos_y<br />
| align="left" |Position der Kollision, y-Richtung relativ zum Fahrzeugursprung (nur bei Auslösung des Kollisions-Triggers)<br />
| align="left" |Meter<br />
| align="left" |1.00<br />
|-<br />
| align="left" |coll_pos_z<br />
| align="left" |Position der Kollision, z-Richtung relativ zum Fahrzeugursprung (nur bei Auslösung des Kollisions-Triggers)<br />
| align="left" |Meter<br />
| align="left" |1.00<br />
|-<br />
| align="left" |coll_energy<br />
| align="left" |Energie der Kollision (nur bei Auslösung des Kollisions-Triggers)<br />
| align="left" |Nm<br />
| align="left" |1.00<br />
|-<br />
| align="left" |Weather_Temperature<br />
| align="left" |Außentemperatur<br />
| align="left" |°C<br />
| align="left" |1.00<br />
|-<br />
| align="left" |Weather_AbsHum<br />
| align="left" |Absolute Luftfeuchtigkeit<br />
| align="left" |g/m³<br />
| align="left" |1.00<br />
|-<br />
| align="left" |AutoClutch<br />
| align="left" |Option "automatische Kupplung" aktiviert<br />
| align="left" |0 = aus, 1 = an<br />
| align="left" |1.03<br />
|-<br />
| align="left" |wearlifespan<br />
| align="left" |''nicht nutzen!''<br />
| align="left" |<br />
| align="left" |2.00<br />
|-<br />
| align="left" |SunAlt<br />
| align="left" |Höhenwinkel der Sonne<br />
| align="left" |°<br />
| align="left" |2.00<br />
|}<br />
<br />
== Vordefinierte lokale Variablen ==<br />
<br />
Seit OMSI 2 gibt es eine neue Form vordefinierter Variablen: Diese tauchen nicht in der ''varlist_*.txt''-Datei im ''program''-Verzeichnis auf und müssen daher so wie "normale" lokale Variablen deklariert werden, sie werden aber dennoch (sofern sie deklariert werden) mit internen Variablen verbunden. Diese Variablen werden "on-demand-vordefinierte Variablen" genannt. Bitte beachten Sie hierzu die neue Spalte!<br />
<br />
=== Szenerieobjekte ===<br />
<br />
Siehe bitte auch Datei ''program\varlist_scenobj.txt''!<br />
<br />
{| class="wikitable" style="font-size:95%;" <br />
|- class="hintergrundfarbe5"<br />
| align="left" |''Variablenname''<br />
| align="left" |''Beschreibung''<br />
| align="left" |''Einheit''<br />
| align="left" |''kein Schreibzugriff''<br />
| align="left" |''ab OMSI-Vs.''<br />
|-<br />
| align="left" |NightLightA<br />
| align="left" |Ist die Nachtbeleuchtung aktiv?<br />
| align="left" |0 = aus, 1 = an<br />
| align="left" |X<br />
| align="left" |1.00<br />
|-<br />
| align="left" |InUse<br />
| align="left" |Ist das Objekt "aktiv"? Die Sporthallen sind bspw. nur an Schultagen vormittags "aktiv", sodass die Soundeffekte an diese Variable gekoppelt werden können - auf diese Weise wird verhindert, dass die Soundeffekte auch in den Ferien oder nachts zu hören sind.<br />
| align="left" |0 = inaktiv, 1 = aktiv<br />
| align="left" |X<br />
| align="left" |1.00<br />
|-<br />
| align="left" |TrafficLightPhase<br />
| align="left" |Hierüber wird Ampelobjekten die anzuzeigende Ampelphase mitgeteilt.<br />
| align="left" |0..2 = rot, 3..5 = rot-gelb, 6..8 = grün, 9..11 = gelb, sonst aus<br />
| align="left" |X<br />
| align="left" |1.00<br />
|-<br />
| align="left" |TrafficLightApproach<br />
| align="left" |Hierüber kann das Script eine Ampelanforderung erkennen und bspw. eine Kennleuchte aktiviert werden.<br />
| align="left" |0 = keine Anforderung, 1 = Anforderung<br />
| align="left" |X<br />
| align="left" |1.00<br />
|-<br />
| align="left" |Colorscheme<br />
| align="left" |(veraltet)<br />
| align="left" |(-)<br />
| align="left" |X<br />
| align="left" |1.00<br />
|-<br />
| align="left" |Signal<br />
| align="left" |Hierüber erhalten Signale ihr anzuzeigendes Signalbild<br />
| align="left" |individuell<br />
| align="left" |X<br />
| align="left" |1.00<br />
|-<br />
| align="left" |NextSignal<br />
| align="left" |Hierüber erhalten Signale mit Vorsignalfunktion das anzuzeigende Signalbild des nächsten Signals<br />
| align="left" |individuell<br />
| align="left" |X<br />
| align="left" |1.00<br />
|-<br />
| align="left" |Refresh_Strings<br />
| align="left" |Diese Variable muss auf "1" gesetzt werden, damit die Text-Texturen aktualisiert werden! Wird nach erfolgreicher Abarbeitung von OMSI auf 0 gesetzt.<br />
| align="left" |-<br />
| align="left" |<br />
| align="left" |1.00<br />
|-<br />
| align="left" |Switch<br />
| align="left" |Mit dieser Variable kann die Weiche, die im Objekt eingebaut ist, gestellt werden. Hierfür muss der Wert der Variable auf den mit [switchdir] angegebenen Wert des gewünschten Pfades gesetzt werden.<br />
| align="left" |-<br />
| align="left" |<br />
| align="left" |2.00<br />
|}<br />
<br />
=== Fahrzeuge ===<br />
<br />
Wichtig: Üblicherweise nutzen Gelenkbusse das [[Scriptshare]]-System, bei welchem sich mehrere Fahrzeuge denselben Variablenspeicher teilen. Hierbei ist zu beachten, dass Räder und Türen '''über alle Fahrzeugteile zählen'''. Beim NG272 bedeutet dies beispielsweise, dass die dritte Tür auch mit PAX_Entry2_Open angesteuert wird.<br />
<br />
==== Zahlvariablen ====<br />
<br />
Siehe bitte auch Datei ''program\varlist_roadvehicle.txt''!<br />
<br />
{| class="wikitable" style="font-size:95%;" <br />
|- class="hintergrundfarbe5"<br />
| align="left" |''Variablenname''<br />
| align="left" |''Beschreibung''<br />
| align="left" |''Einheit''<br />
| align="left" |''kein Schreibzugriff''<br />
| align="left" |''"on demand"''<br />
| align="left" |''ab OMSI-Vs.''<br />
|-<br />
| align="left" |Refresh_Strings<br />
| align="left" |Diese Variable muss auf "1" gesetzt werden, damit die Text-Texturen aktualisiert werden! Wird nach erfolgreicher Abarbeitung von OMSI auf 0 gesetzt.<br />
| align="left" |-<br />
| align="left" |<br />
| align="left" |<br />
| align="left" |1.00<br />
|-<br />
| align="left" |Envir_Brightness<br />
| align="left" |Umgebungshelligkeit in Fahrzeugnähe<br />
| align="left" |0 = dunkel, 1 = hell<br />
| align="left" |X<br />
| align="left" |<br />
| align="left" |1.00<br />
|-<br />
| align="left" |StreetCond<br />
| align="left" |Information über die Oberflächenbedingungen<br />
| align="left" |0: Trocken, 0..1: zunehmende Feuchtigkeit, 1: komplett feucht, 1..2: teilweise Pfützen, 2: Fahrzeug komplett in Pfützen<br />
| align="left" |X<br />
| align="left" |<br />
| align="left" |1.00<br />
|-<br />
| align="left" |Spot_Select<br />
| align="left" |Hierüber kann gesteuert werden, welches fürs Fahrzeug vordefinierte Spotlight aktiv sein soll.<br />
| align="left" |-1: kein Spotlight, 0: Spotlight Nr. 0, 1: Spotlight Nr. 1 usw.<br />
| align="left" |<br />
| align="left" |<br />
| align="left" |1.00<br />
|-<br />
| align="left" |Colorscheme<br />
| align="left" |Index des gewählten Farbschemas/Anstriches<br />
| align="left" |-<br />
| align="left" |X<br />
| align="left" |<br />
| align="left" |1.00<br />
|-<br />
| align="left" |M_Wheel<br />
| align="left" |Hierüber kann das Script ein [http://de.wikipedia.org/wiki/Drehmoment Drehmoment] auf die Räder übertragen. Hierbei die Summe anzugeben, welche auf alle als angetrieben ausgewiesene Achsen wirken <br />
soll.<br />
| align="left" |kNm = 1000 [http://de.wikipedia.org/wiki/Newtonmeter Nm]<br />
| align="left" |<br />
| align="left" |<br />
| align="left" |1.00<br />
|-<br />
| align="left" |n_Wheel<br />
| align="left" |Mittlere Raddrehzahl des Fahrzeuges<br />
| align="left" |Umdrehungen pro Minute<br />
| align="left" |X<br />
| align="left" |<br />
| align="left" |1.00<br />
|-<br />
| align="left" |Throttle<br />
| align="left" |Stellung des Gaspedals<br />
| align="left" |0..1<br />
| align="left" |X<br />
| align="left" |<br />
| align="left" |1.00<br />
|-<br />
| align="left" |Brake<br />
| align="left" |Stellung des Bremspedals<br />
| align="left" |0..1<br />
| align="left" |X<br />
| align="left" |<br />
| align="left" |1.00<br />
|-<br />
| align="left" |Clutch<br />
| align="left" |Stellung des Kupplungspedals<br />
| align="left" |0..1<br />
| align="left" |X<br />
| align="left" |<br />
| align="left" |1.00<br />
|-<br />
| align="left" |Brakeforce<br />
| align="left" |Hierüber kann das Script die Gesamtbremskraft des Fahrzeuges vorgeben, welche auf die Räder wirkt. Sollte nicht gleichzeitig mit ''Axle_Brakeforce...'' verwendet werden.<br />
| align="left" |[http://de.wikipedia.org/wiki/Newton_(Einheit) N]<br />
| align="left" |<br />
| align="left" |<br />
| align="left" |1.00<br />
|-<br />
| align="left" |Velocity<br />
| align="left" |Geschwindigkeit, welche sich über die Raddrehung ergibt, entspricht der Tachoanzeige<br />
| align="left" |[http://de.wikipedia.org/wiki/Km/h km/h]<br />
| align="left" |X<br />
| align="left" |<br />
| align="left" |1.00<br />
|-<br />
| align="left" |Velocity_Ground<br />
| align="left" |Geschwindigkeit, welche direkt relativ zum Grund gemessen wird, berücksichtigt kein Radschleudern oder -blockieren, entspricht der Anzeige auf einem GPS<br />
| align="left" |[http://de.wikipedia.org/wiki/Km/h km/h]<br />
| align="left" |X<br />
| align="left" |<br />
| align="left" |1.00<br />
|-<br />
| align="left" |tank_percent<br />
| align="left" |Tankinhalt, nur für die Anzeige auf der roten Informationsleiste. Die Betankung und Simulation eines leeren Tanks geschieht über einen Trigger bzw. muss im Script programmiert werden.<br />
| align="left" |0..1<br />
| align="left" |<br />
| align="left" |<br />
| align="left" |1.00<br />
|-<br />
| align="left" |kmcounter_km<br />
| align="left" |Stand des Kilometerzählers (nur ganze km)<br />
| align="left" |km<br />
| align="left" |X<br />
| align="left" |<br />
| align="left" |1.00<br />
|-<br />
| align="left" |kmcounter_m<br />
| align="left" |Stand des Kilometerzählers (zusätzliche Meter, läuft stets nur von 0m bis 999m; hinzu kommen die Kilometer von ''kmcounter_km'')<br />
| align="left" |m<br />
| align="left" |X<br />
| align="left" |<br />
| align="left" |1.00<br />
|-<br />
| align="left" |relrange<br />
| align="left" |Zurückgelegte, relative Strecke. Wurde nur testweise für pfadfixierte Fahrzeuge eingeführt. Nicht benutzen!<br />
| align="left" |---<br />
| align="left" |X<br />
| align="left" |<br />
| align="left" |1.00<br />
|-<br />
| align="left" |Driver_Seat_VertTransl<br />
| align="left" |Einfederung des federnden Fahrersitzes<br />
| align="left" |m<br />
| align="left" |X<br />
| align="left" |<br />
| align="left" |1.00<br />
|-<br />
| align="left" |Wheel_Rotation_0_L / ~_R ... ~_3_L / _R<br />
| align="left" |Drehwinkel des jeweiligen Rades, z.B. für die Animation<br />
| align="left" |[http://de.wikipedia.org/wiki/Radiant_(Einheit) rad]<br />
| align="left" |X<br />
| align="left" |<br />
| align="left" |1.00<br />
|-<br />
| align="left" |Wheel_RotationSpeed_0_L / ~_R ... ~_3_L / _R<br />
| align="left" |Drehzahl des jeweiligen Rades<br />
| align="left" |Umdrehungen pro Minute<br />
| align="left" |X<br />
| align="left" |<br />
| align="left" |1.00<br />
|-<br />
| align="left" |Axle_Suspension_0_L / ~_R ... ~_3_L / _R<br />
| align="left" |Einfederungsweg des jeweiligen Rades<br />
| align="left" |m<br />
| align="left" |X<br />
| align="left" |<br />
| align="left" |1.00<br />
|-<br />
| align="left" |Axle_Steering_0_L / ~_R ... ~_3_L / _R<br />
| align="left" |Lenkwinkel des jeweiligen Rades<br />
| align="left" |[http://de.wikipedia.org/wiki/Radiant_(Einheit) rad]<br />
| align="left" |X<br />
| align="left" |<br />
| align="left" |1.00<br />
|-<br />
| align="left" |Axle_Springfactor_0_L / ~_R ... ~_3_L / _R<br />
| align="left" |Faktor, mit dem radweise die Federstärke angepasst werden kann, z.B. um Luftfederungen zu simulieren.<br />
| align="left" |0 = keine, 1 = normale, 2 = doppelte Federkraft<br />
| align="left" |<br />
| align="left" |<br />
| align="left" |1.00<br />
|-<br />
| align="left" |Axle_Brakeforce_0_L / ~_R ... ~_3_L / _R<br />
| align="left" |Ermöglicht Setzen der Bremskraft pro Rad. Sollte nicht gleichzeitig mit ''Brakeforce'' verwendet werden!<br />
| align="left" |[http://de.wikipedia.org/wiki/Newton_(Einheit) N]<br />
| align="left" |<br />
| align="left" |<br />
| align="left" |1.00<br />
|-<br />
| align="left" |Debug_0 ... _5<br />
| align="left" |Debug-Variablen. Können im Debug-Modus in der Informationsleiste angezeigt werden, um auf diese Weise die Scripts zu testen.<br />
| align="left" |bliebig<br />
| align="left" |<br />
| align="left" |<br />
| align="left" |1.00<br />
|-<br />
| align="left" |A_Trans_X ... _Z<br />
| align="left" |Beschleunigungen im Fahrzeug, die durch die Fahrzeugbewegungen ausgelöst werden (beim Bremsen oder bei Kurvenfahrten usw.)<br />
| align="left" |m/s²<br />
| align="left" |X<br />
| align="left" |<br />
| align="left" |1.00<br />
|-<br />
| align="left" |AI_Blinker_L, ~_R<br />
| align="left" |Linker oder rechter Blinker aktiv<br />
| align="left" |0: aus, 1: ein<br />
| align="left" |(X)*<br />
| align="left" |<br />
| align="left" |1.00<br />
|-<br />
| align="left" |AI_Light<br />
| align="left" |Fahrlicht, Standlicht, Lichthupe<br />
| align="left" |0: Licht aus, 0.5: Standlicht an, 1: Fahrlicht an, 2: Fernlicht/Lichthupe an<br />
| align="left" |(X)*<br />
| align="left" |<br />
| align="left" |1.00<br />
|-<br />
| align="left" |AI_Interiorlight<br />
| align="left" |Innenbeleuchtung. Hierüber erfahren die einsteigenden Fahrgäste auch, ob es im Bus zu dunkel ist (sodass sie meckern dürfen).<br />
| align="left" |0: aus, 1: an<br />
| align="left" |(X)*<br />
| align="left" |<br />
| align="left" |1.00<br />
|-<br />
| align="left" |AI_Brakelight<br />
| align="left" |Nur für KI-Fahrzeuge: Script soll Bremslicht einschalten<br />
| align="left" |0: aus, 1: an<br />
| align="left" |X<br />
| align="left" |<br />
| align="left" |1.00<br />
|-<br />
| align="left" |AI_Engine<br />
| align="left" |Nur für KI-Fahrzeuge: Aufforderung zum Ein- oder Ausschalten des Motors<br />
| align="left" |-1: Motor ausschalten!, 0: egal/nicht-KI, 1: Motor einschalten!<br />
| align="left" |X<br />
| align="left" |<br />
| align="left" |1.00<br />
|-<br />
| align="left" |AI_target_index<br />
| align="left" |Dient der Übergabe des Sollwertes des einzustellenden Zielschildes bei Aufruf des Menüs oder beim Umschildern der KI-Busse. Entspricht der Reihenfolge in der Hof-Datei; erster Eintrag = 0<br />
| align="left" |-<br />
| align="left" |X<br />
| align="left" |<br />
| align="left" |1.00<br />
|-<br />
| align="left" |target_index_int<br />
| align="left" |Über diese Variable setzt das Script, welches Zielschild am Bus zusehen ist und steuert hierüber insbesondere die Fahrgäste. Entspricht wie ''AI_target_index'' dem Index der Reihenfolge in der Hof-Datei.<br />
| align="left" |-<br />
| align="left" |<br />
| align="left" |<br />
| align="left" |1.00<br />
|-<br />
| align="left" |AI_Scheduled_AtStation<br />
| align="left" |Nur KI-Fahrzeuge, bidirektionale Kommunikation: Bei Erreichen einer Station setzt OMSI den Wert auf 1, sodass das Script mitgeteilt bekommt, dass die Türen geöffnet werden sollen. Wenn sich der Bus abfahrbereit machen soll, setzt OMSI den Wert auf -1. Wenn der Bus abfahrbereit ist (Türen geschlossen usw.), dann setzt das Script den Wert auf 0, sodass die KI den Bus weiterfahren lassen kann.<br />
| align="left" |-1: Bus abfahrbereit machen, 0: Bus ist abfahrbereit, 1: Türen freigeben/öffnen<br />
| align="left" |(X)<br />
| align="left" |<br />
| align="left" |1.00<br />
|-<br />
| align="left" |AI<br />
| align="left" |Hierüber erfährt das Script, ob das Fahrzeug von der AI gesteuert wird.<br />
| align="left" |0: nein, 1: ja<br />
| align="left" |X<br />
| align="left" |<br />
| align="left" |1.00<br />
|-<br />
| align="left" |PAX_Entry0_Open ... ~7_Open<br />
| align="left" |Teilt OMSI mit, ob die jeweiligen Eingänge offen oder geschlossen sind.<br />
| align="left" |0: geschlossen, 1: offen<br />
| align="left" |<br />
| align="left" |<br />
| align="left" |1.00<br />
|-<br />
| align="left" |PAX_Exit0_Open<br />
| align="left" |Teilt OMSI mit, ob die jeweiligen Ausgänge offen oder geschlossen sind.<br />
| align="left" |0: geschlossen, 1: offen<br />
| align="left" |<br />
| align="left" |<br />
| align="left" |1.00<br />
|-<br />
| align="left" |GivenTicket<br />
| align="left" |Teilt OMSI mit, ob der ggf. vorhandene Fahrscheinautomat ein Ticket ausgegeben hat.<br />
| align="left" |-1: kein Ticket, 0: Tickettyp 0, 1: Tickettyp 1, ...<br />
| align="left" |<br />
| align="left" |<br />
| align="left" |1.00<br />
|-<br />
| align="left" |humans_count<br />
| align="left" |Anzahl der Fahrgäste im Fahrzeug<br />
| align="left" |-<br />
| align="left" |X<br />
| align="left" |<br />
| align="left" |1.00<br />
|-<br />
| align="left" |FF_Vib_Period<br />
| align="left" |Setzt die Force-Feedback-Vibrationsperiode im Lenkrad<br />
| align="left" |s<br />
| align="left" |<br />
| align="left" |<br />
| align="left" |1.00<br />
|-<br />
| align="left" |FF_Vib_Amp<br />
| align="left" |Setzt die Force-Feedback-Vibrationsamplitude im Lenkrad<br />
| align="left" |0...1<br />
| align="left" |<br />
| align="left" |<br />
| align="left" |1.00<br />
|-<br />
| align="left" |Snd_OutsideVol<br />
| align="left" |Teilt OMSI mit, wie stark der Außensound im Innenraum hörbar ist; verändert sich bspw. wenn eine Tür geöffnet wird.<br />
| align="left" |0: kaum hörbar, 1: wie draußen<br />
| align="left" |<br />
| align="left" |<br />
| align="left" |1.00<br />
|-<br />
| align="left" |Snd_Microphone<br />
| align="left" |Soll das (Hardware-)Mikrofon aktiv sein?<br />
| align="left" |0: aus, 1: an<br />
| align="left" |<br />
| align="left" |<br />
| align="left" |1.00<br />
|-<br />
| align="left" |Snd_Radio<br />
| align="left" |Soll das (Internet-)Radio laufen?<br />
| align="left" |0: aus, 1: an<br />
| align="left" |<br />
| align="left" |<br />
| align="left" |1.00<br />
|-<br />
| align="left" |Cabinair_Temp<br />
| align="left" |Innenraumtemperatur für die Beurteilung durch die Fahrgäste<br />
| align="left" |°C<br />
| align="left" |<br />
| align="left" |<br />
| align="left" |1.00<br />
|-<br />
| align="left" |Cabinair_absHum<br />
| align="left" |[http://de.wikipedia.org/wiki/Luftfeuchtigkeit#Absolute_Luftfeuchtigkeit Absolute Luftfeuchtigkeit] im Innenraum für die Beurteilung durch die Fahrgäste<br />
| align="left" |g/m³<br />
| align="left" |<br />
| align="left" |<br />
| align="left" |1.00<br />
|-<br />
| align="left" |Cabinair_relHum<br />
| align="left" |[http://de.wikipedia.org/wiki/Luftfeuchtigkeit#Relative_Luftfeuchtigkeit Relative Luftfeuchtigkeit] im Innenraum, wird durch OMSI automatisch über die absolute Feuchtigkeit und die Innentemperatur berechnet.<br />
| align="left" |0 = 0%, 1 = 100%<br />
| align="left" |X<br />
| align="left" |<br />
| align="left" |1.00<br />
|-<br />
| align="left" |PrecipRate<br />
| align="left" |Niederschlagsrate<br />
| align="left" |0 = kein, 1 = maximal<br />
| align="left" |X<br />
| align="left" |<br />
| align="left" |1.00<br />
|-<br />
| align="left" |PrecipType<br />
| align="left" |Niederschlagstyp<br />
| align="left" |0 = kein, 1 = Regen, 2 = Schnee<br />
| align="left" |X<br />
| align="left" |<br />
| align="left" |1.00<br />
|-<br />
| align="left" |Dirt_Norm<br />
| align="left" |allgemeiner Verdreckungszustand (Windschutzscheiben können sauberer sein und werden nur vom Script simuliert)<br />
| align="left" |0 = sauber, 1 = total verdreckt<br />
| align="left" |X<br />
| align="left" |<br />
| align="left" |1.00<br />
|-<br />
| align="left" |DirtRate<br />
| align="left" |aktuelle Verdreckungsrate<br />
| align="left" |Verdreckung / s, wobei eine Verdreckung = 1 bedeutet, dass die Verdreckung maximal ist.<br />
| align="left" |X<br />
| align="left" |<br />
| align="left" |1.00<br />
|-<br />
| align="left" |schedule_active<br />
| align="left" |Ist gerade ein Fahrplan aktiv? (Bspw. für Einblendung der Fahrplankarte)<br />
| align="left" |0: nein, 1: ja<br />
| align="left" |X<br />
| align="left" |<br />
| align="left" |1.00<br />
|-<br />
| align="left" |train_frontcoupling<br />
| align="left" |Ist an der vorderen Kupplung etwas angekuppelt? (Eventuell spätere Benutzung zum Abkuppeln)<br />
| align="left" |0: nein, 1: ja<br />
| align="left" |X<br />
| align="left" |<br />
| align="left" |1.00<br />
|-<br />
| align="left" |train_backcoupling<br />
| align="left" |Ist an der hinteren Kupplung etwas angekuppelt? (Eventuell spätere Benutzung zum Abkuppeln)<br />
| align="left" |0: nein, 1: ja<br />
| align="left" |X<br />
| align="left" |<br />
| align="left" |1.00<br />
|-<br />
| align="left" |train_me_reverse<br />
| align="left" |Steht dieses Fahrzeug rückwärts zum gesamten Fahrzeugverband?<br />
| align="left" |0: nein, 1: ja<br />
| align="left" |X<br />
| align="left" |<br />
| align="left" |1.00<br />
|}<br />
<br />
<nowiki>*) Bidirektionale KI-Variablen: Handelt es sich um ein Userfahrzeug, kann das Script dem Hauptprogramm mitteilen, wie Licht, Blinker usw. gesetzt wurden. Handelt es sich aber um ein KI-Fahrzeug, teilt OMSI dem Script mit, wie die entsprechenden Zustände gesetzt werden müssen.</nowiki><br />
<br />
==== Stringvariablen ====<br />
<br />
Siehe bitte auch Datei ''program\stringvarlist_roadvehicle.txt''!<br />
<br />
{| class="wikitable" style="font-size:95%;" <br />
|- class="hintergrundfarbe5"<br />
| align="left" |''Variablenname''<br />
| align="left" |''Beschreibung''<br />
| align="left" |''kein Schreibzugriff''<br />
|-<br />
| align="left" |ident<br />
| align="left" |Enthält das Kraftfahrzeugkennzeichen dieses Fahrzeugs (z.B. "B-V 3503")<br />
| align="left" |X<br />
|-<br />
| align="left" |number<br />
| align="left" |Enthält die Fahrzeugnummer (z.B. "3503")<br />
| align="left" |X<br />
|-<br />
| align="left" |act_route<br />
| align="left" |''(keine Verwendung)''<br />
| align="left" |<br />
|-<br />
| align="left" |act_busstop<br />
| align="left" |Wird zusammen mit dem internen Trigger ''ai_scheduled_setbusstop'' verwendet: Enthält dann den Namen der im Fahrplansystem aktiven Haltestelle.<br />
| align="left" |X<br />
|-<br />
| align="left" |SetLineTo<br />
| align="left" |Wird zusammen mit dem internen Trigger ''ai_scheduled_settarget'' verwendet: Enthält die einzustellende Liniennummer (oder Symbol) (bei Verwendung vom Zielschild-Menü oder beim Umschildern von KI-Bussen)<br />
| align="left" |X<br />
|-<br />
| align="left" |yard<br />
| align="left" |Name der Hofdatei des Fahrzeuges, bspw. damit das Scriptsystem den Dateinamen der Zielcode-Tabelle generieren kann.<br />
| align="left" |X<br />
|-<br />
| align="left" |file_schedule<br />
| align="left" |Enthält den Dateinamen der Fahrplan-Bitmap, die zu der von diesem Fahrzeug gefahrenen Strecke gehört.<br />
| align="left" |X<br />
|}<br />
<br />
=== Menschen ===<br />
<br />
Siehe bitte auch Datei ''program\varlist_human.txt''!<br />
<br />
{| class="wikitable" style="font-size:95%;" <br />
|- class="hintergrundfarbe5"<br />
| align="left" |''Variablenname''<br />
| align="left" |''Beschreibung''<br />
| align="left" |''Einheit''<br />
| align="left" |''kein Schreibzugriff''<br />
|-<br />
| align="left" |LastMovedDist<br />
| align="left" |Entfernung, die der Mensch seit dem letzten Durchlauf zurückgelegt hat. Wurde für die alten Animationen gebraucht.<br />
| align="left" |m<br />
| align="left" |X<br />
|-<br />
| align="left" |PAX_State<br />
| align="left" |Zustand des Menschens. Wurde für die alten Animationen gebraucht.<br />
| align="left" |0: stehen, 1: gehen, 2: sitzen<br />
| align="left" |X<br />
|-<br />
| align="left" |HeightOfSeat<br />
| align="left" |Höhe des Sitzes. Diese Eigenschaft wird in der Sitzposition gebraucht, um die Höhe der Füße korrekt gesetzt. Wurde für die alten Animationen gebraucht.<br />
| align="left" |m<br />
| align="left" |X<br />
|-<br />
| align="left" |Colorscheme<br />
| align="left" |Tauschtextur-Index ("Farbschema") des Menschens.<br />
| align="left" |-<br />
| align="left" |X<br />
|}<br />
<br />
[[Kategorie:Nachschlagewerk für Addon-Entwickler]]</div>Marcel Kuhnthttp://wiki.omnibussimulator.de/omsiwikineu.de/index.php?title=System-_und_vordefinierte_lokalen_Variablen&diff=871System- und vordefinierte lokalen Variablen2014-02-11T15:37:52Z<p>Marcel Kuhnt: /* Fahrzeuge */</p>
<hr />
<div>''Hinweis: Dieser Artikel wurde noch nicht ins Englische übersetzt!''<br />
<br />
Beschreibung der System- und der lokalen [[Scriptsystem#Variablenzugriff|Scriptvariablen]], welche für jedes Objekt vordefiniert werden und im Allgemeinen bestimmte Sonderfunktionen gegenüber frei definierten Scriptvariablen übernehmen.<br />
<br />
== Systemvariablen ==<br />
<br />
Siehe bitte auch Datei ''program\varlist_system.txt''!<br />
<br />
{| class="wikitable" style="font-size:95%;" <br />
|- class="hintergrundfarbe5"<br />
| align="left" |''Variablenname''<br />
| align="left" |''Beschreibung''<br />
| align="left" |''Einheit''<br />
| align="left" |''ab OMSI-Vs.''<br />
|-<br />
| align="left" |Timegap<br />
| align="left" |Zeitschritt seit dem letzten Durchlauf (Frame)<br />
| align="left" |Sekunden<br />
| align="left" |1.00<br />
|-<br />
| align="left" |GetTime<br />
| align="left" |Enthält eine absolute Zeitangabe, die vom Beginn des Ausführens von OMSI zählt<br />
| align="left" |Sekunden<br />
| align="left" |1.00<br />
|-<br />
| align="left" |NoSound<br />
| align="left" |Sounds deaktiviert?<br />
| align="left" |0 = Sounds aktiviert, 1 = Sounds deaktiviert<br />
| align="left" |1.00<br />
|-<br />
| align="left" |Pause<br />
| align="left" |Simulations-Pause aktiv?<br />
| align="left" |0 = Simulation läuft, 1 = Simulation angehalten<br />
| align="left" |1.00<br />
|-<br />
| align="left" |Time<br />
| align="left" |Uhrzeit gerechnet von Mitternacht des aktuellen Tages<br />
| align="left" |Sekunden<br />
| align="left" |1.00<br />
|-<br />
| align="left" |Day<br />
| align="left" |Tag gezählt ab Monatsbeginn<br />
| align="left" |Tage<br />
| align="left" |1.00<br />
|-<br />
| align="left" |Month<br />
| align="left" |Monat<br />
| align="left" |Monate<br />
| align="left" |1.00<br />
|-<br />
| align="left" |Year<br />
| align="left" |Jahr<br />
| align="left" |Jahre<br />
| align="left" |1.00<br />
|-<br />
| align="left" |DayOfYear<br />
| align="left" |Tag gezählt ab Jahresbeginn<br />
| align="left" |Tage<br />
| align="left" |1.00<br />
|-<br />
| align="left" |mouse_x<br />
| align="left" |X-Koordinate des Mauszeigers auf dem Bildschirm<br />
| align="left" |Pixel<br />
| align="left" |1.00<br />
|-<br />
| align="left" |mouse_y<br />
| align="left" |Y-Koordinate des Mauszeigers auf dem Bildschirm<br />
| align="left" |Pixel<br />
| align="left" |1.00<br />
|-<br />
| align="left" |PrecipType<br />
| align="left" |Niederschlagstyp<br />
| align="left" |0 = keiner, 1 = Regen, 2 = Schnee<br />
| align="left" |1.00<br />
|-<br />
| align="left" |PrecipRate<br />
| align="left" |Niederschlagstyp<br />
| align="left" |0 = kein Niederschlag, 1 = maximaler Niederschlag<br />
| align="left" |1.00<br />
|-<br />
| align="left" |coll_pos_x<br />
| align="left" |Position der Kollision, x-Richtung relativ zum Fahrzeugursprung (nur bei Auslösung des Kollisions-Triggers)<br />
| align="left" |Meter<br />
| align="left" |1.00<br />
|-<br />
| align="left" |coll_pos_y<br />
| align="left" |Position der Kollision, y-Richtung relativ zum Fahrzeugursprung (nur bei Auslösung des Kollisions-Triggers)<br />
| align="left" |Meter<br />
| align="left" |1.00<br />
|-<br />
| align="left" |coll_pos_z<br />
| align="left" |Position der Kollision, z-Richtung relativ zum Fahrzeugursprung (nur bei Auslösung des Kollisions-Triggers)<br />
| align="left" |Meter<br />
| align="left" |1.00<br />
|-<br />
| align="left" |coll_energy<br />
| align="left" |Energie der Kollision (nur bei Auslösung des Kollisions-Triggers)<br />
| align="left" |Nm<br />
| align="left" |1.00<br />
|-<br />
| align="left" |Weather_Temperature<br />
| align="left" |Außentemperatur<br />
| align="left" |°C<br />
| align="left" |1.00<br />
|-<br />
| align="left" |Weather_AbsHum<br />
| align="left" |Absolute Luftfeuchtigkeit<br />
| align="left" |g/m³<br />
| align="left" |1.00<br />
|-<br />
| align="left" |AutoClutch<br />
| align="left" |Option "automatische Kupplung" aktiviert<br />
| align="left" |0 = aus, 1 = an<br />
| align="left" |1.03<br />
|-<br />
| align="left" |wearlifespan<br />
| align="left" |''nicht nutzen!''<br />
| align="left" |<br />
| align="left" |2.00<br />
|-<br />
| align="left" |SunAlt<br />
| align="left" |Höhenwinkel der Sonne<br />
| align="left" |°<br />
| align="left" |2.00<br />
|}<br />
<br />
== Vordefinierte lokale Variablen ==<br />
<br />
Seit OMSI 2 gibt es eine neue Form vordefinierter Variablen: Diese tauchen nicht in der ''varlist_*.txt''-Datei im ''program''-Verzeichnis auf und müssen daher so wie "normale" lokale Variablen deklariert werden, sie werden aber dennoch (sofern sie deklariert werden) mit internen Variablen verbunden. Diese Variablen werden "on-demand-vordefinierte Variablen" genannt. Bitte beachten Sie hierzu die neue Spalte!<br />
<br />
=== Szenerieobjekte ===<br />
<br />
Siehe bitte auch Datei ''program\varlist_scenobj.txt''!<br />
<br />
{| class="wikitable" style="font-size:95%;" <br />
|- class="hintergrundfarbe5"<br />
| align="left" |''Variablenname''<br />
| align="left" |''Beschreibung''<br />
| align="left" |''Einheit''<br />
| align="left" |''kein Schreibzugriff''<br />
| align="left" |''ab OMSI-Vs.''<br />
|-<br />
| align="left" |NightLightA<br />
| align="left" |Ist die Nachtbeleuchtung aktiv?<br />
| align="left" |0 = aus, 1 = an<br />
| align="left" |X<br />
| align="left" |1.00<br />
|-<br />
| align="left" |InUse<br />
| align="left" |Ist das Objekt "aktiv"? Die Sporthallen sind bspw. nur an Schultagen vormittags "aktiv", sodass die Soundeffekte an diese Variable gekoppelt werden können - auf diese Weise wird verhindert, dass die Soundeffekte auch in den Ferien oder nachts zu hören sind.<br />
| align="left" |0 = inaktiv, 1 = aktiv<br />
| align="left" |X<br />
| align="left" |1.00<br />
|-<br />
| align="left" |TrafficLightPhase<br />
| align="left" |Hierüber wird Ampelobjekten die anzuzeigende Ampelphase mitgeteilt.<br />
| align="left" |0..2 = rot, 3..5 = rot-gelb, 6..8 = grün, 9..11 = gelb, sonst aus<br />
| align="left" |X<br />
| align="left" |1.00<br />
|-<br />
| align="left" |TrafficLightApproach<br />
| align="left" |Hierüber kann das Script eine Ampelanforderung erkennen und bspw. eine Kennleuchte aktiviert werden.<br />
| align="left" |0 = keine Anforderung, 1 = Anforderung<br />
| align="left" |X<br />
| align="left" |1.00<br />
|-<br />
| align="left" |Colorscheme<br />
| align="left" |(veraltet)<br />
| align="left" |(-)<br />
| align="left" |X<br />
| align="left" |1.00<br />
|-<br />
| align="left" |Signal<br />
| align="left" |Hierüber erhalten Signale ihr anzuzeigendes Signalbild<br />
| align="left" |individuell<br />
| align="left" |X<br />
| align="left" |1.00<br />
|-<br />
| align="left" |NextSignal<br />
| align="left" |Hierüber erhalten Signale mit Vorsignalfunktion das anzuzeigende Signalbild des nächsten Signals<br />
| align="left" |individuell<br />
| align="left" |X<br />
| align="left" |1.00<br />
|-<br />
| align="left" |Refresh_Strings<br />
| align="left" |Diese Variable muss auf "1" gesetzt werden, damit die Text-Texturen aktualisiert werden! Wird nach erfolgreicher Abarbeitung von OMSI auf 0 gesetzt.<br />
| align="left" |-<br />
| align="left" |<br />
| align="left" |1.00<br />
|-<br />
| align="left" |Switch<br />
| align="left" |Mit dieser Variable kann die Weiche, die im Objekt eingebaut ist, gestellt werden. Hierfür muss der Wert der Variable auf den mit [switchdir] angegebenen Wert des gewünschten Pfades gesetzt werden.<br />
| align="left" |-<br />
| align="left" |<br />
| align="left" |2.00<br />
|}<br />
<br />
=== Fahrzeuge ===<br />
<br />
Wichtig: Üblicherweise nutzen Gelenkbusse das [[Scriptshare]]-System, bei welchem sich mehrere Fahrzeuge denselben Variablenspeicher teilen. Hierbei ist zu beachten, dass Räder und Türen '''über alle Fahrzeugteile zählen'''. Beim NG272 bedeutet dies beispielsweise, dass die dritte Tür auch mit PAX_Entry2_Open angesteuert wird.<br />
<br />
==== Zahlvariablen ====<br />
<br />
Siehe bitte auch Datei ''program\varlist_roadvehicle.txt''!<br />
<br />
{| class="wikitable" style="font-size:95%;" <br />
|- class="hintergrundfarbe5"<br />
| align="left" |''Variablenname''<br />
| align="left" |''Beschreibung''<br />
| align="left" |''Einheit''<br />
| align="left" |''kein Schreibzugriff''<br />
|-<br />
| align="left" |Refresh_Strings<br />
| align="left" |Diese Variable muss auf "1" gesetzt werden, damit die Text-Texturen aktualisiert werden! Wird nach erfolgreicher Abarbeitung von OMSI auf 0 gesetzt.<br />
| align="left" |-<br />
| align="left" |<br />
|-<br />
| align="left" |Envir_Brightness<br />
| align="left" |Umgebungshelligkeit in Fahrzeugnähe<br />
| align="left" |0 = dunkel, 1 = hell<br />
| align="left" |X<br />
|-<br />
| align="left" |StreetCond<br />
| align="left" |Information über die Oberflächenbedingungen<br />
| align="left" |0: Trocken, 0..1: zunehmende Feuchtigkeit, 1: komplett feucht, 1..2: teilweise Pfützen, 2: Fahrzeug komplett in Pfützen<br />
| align="left" |X<br />
|-<br />
| align="left" |Spot_Select<br />
| align="left" |Hierüber kann gesteuert werden, welches fürs Fahrzeug vordefinierte Spotlight aktiv sein soll.<br />
| align="left" |-1: kein Spotlight, 0: Spotlight Nr. 0, 1: Spotlight Nr. 1 usw.<br />
| align="left" |<br />
|-<br />
| align="left" |Colorscheme<br />
| align="left" |Index des gewählten Farbschemas/Anstriches<br />
| align="left" |-<br />
| align="left" |X<br />
|-<br />
| align="left" |M_Wheel<br />
| align="left" |Hierüber kann das Script ein [http://de.wikipedia.org/wiki/Drehmoment Drehmoment] auf die Räder übertragen. Hierbei die Summe anzugeben, welche auf alle als angetrieben ausgewiesene Achsen wirken <br />
soll.<br />
| align="left" |kNm = 1000 [http://de.wikipedia.org/wiki/Newtonmeter Nm]<br />
| align="left" |<br />
|-<br />
| align="left" |n_Wheel<br />
| align="left" |Mittlere Raddrehzahl des Fahrzeuges<br />
| align="left" |Umdrehungen pro Minute<br />
| align="left" |X<br />
|-<br />
| align="left" |Throttle<br />
| align="left" |Stellung des Gaspedals<br />
| align="left" |0..1<br />
| align="left" |X<br />
|-<br />
| align="left" |Brake<br />
| align="left" |Stellung des Bremspedals<br />
| align="left" |0..1<br />
| align="left" |X<br />
|-<br />
| align="left" |Clutch<br />
| align="left" |Stellung des Kupplungspedals<br />
| align="left" |0..1<br />
| align="left" |X<br />
|-<br />
| align="left" |Brakeforce<br />
| align="left" |Hierüber kann das Script die Gesamtbremskraft des Fahrzeuges vorgeben, welche auf die Räder wirkt. Sollte nicht gleichzeitig mit ''Axle_Brakeforce...'' verwendet werden.<br />
| align="left" |[http://de.wikipedia.org/wiki/Newton_(Einheit) N]<br />
| align="left" |<br />
|-<br />
| align="left" |Velocity<br />
| align="left" |Geschwindigkeit, welche sich über die Raddrehung ergibt, entspricht der Tachoanzeige<br />
| align="left" |[http://de.wikipedia.org/wiki/Km/h km/h]<br />
| align="left" |X<br />
|-<br />
| align="left" |Velocity_Ground<br />
| align="left" |Geschwindigkeit, welche direkt relativ zum Grund gemessen wird, berücksichtigt kein Radschleudern oder -blockieren, entspricht der Anzeige auf einem GPS<br />
| align="left" |[http://de.wikipedia.org/wiki/Km/h km/h]<br />
| align="left" |X<br />
|-<br />
| align="left" |tank_percent<br />
| align="left" |Tankinhalt, nur für die Anzeige auf der roten Informationsleiste. Die Betankung und Simulation eines leeren Tanks geschieht über einen Trigger bzw. muss im Script programmiert werden.<br />
| align="left" |0..1<br />
| align="left" |<br />
|-<br />
| align="left" |kmcounter_km<br />
| align="left" |Stand des Kilometerzählers (nur ganze km)<br />
| align="left" |km<br />
| align="left" |X<br />
|-<br />
| align="left" |kmcounter_m<br />
| align="left" |Stand des Kilometerzählers (zusätzliche Meter, läuft stets nur von 0m bis 999m; hinzu kommen die Kilometer von ''kmcounter_km'')<br />
| align="left" |m<br />
| align="left" |X<br />
|-<br />
| align="left" |relrange<br />
| align="left" |Zurückgelegte, relative Strecke. Wurde nur testweise für pfadfixierte Fahrzeuge eingeführt. Nicht benutzen!<br />
| align="left" |---<br />
| align="left" |X<br />
|-<br />
| align="left" |Driver_Seat_VertTransl<br />
| align="left" |Einfederung des federnden Fahrersitzes<br />
| align="left" |m<br />
| align="left" |X<br />
|-<br />
| align="left" |Wheel_Rotation_0_L / ~_R ... ~_3_L / _R<br />
| align="left" |Drehwinkel des jeweiligen Rades, z.B. für die Animation<br />
| align="left" |[http://de.wikipedia.org/wiki/Radiant_(Einheit) rad]<br />
| align="left" |X<br />
|-<br />
| align="left" |Wheel_RotationSpeed_0_L / ~_R ... ~_3_L / _R<br />
| align="left" |Drehzahl des jeweiligen Rades<br />
| align="left" |Umdrehungen pro Minute<br />
| align="left" |X<br />
|-<br />
| align="left" |Axle_Suspension_0_L / ~_R ... ~_3_L / _R<br />
| align="left" |Einfederungsweg des jeweiligen Rades<br />
| align="left" |m<br />
| align="left" |X<br />
|-<br />
| align="left" |Axle_Steering_0_L / ~_R ... ~_3_L / _R<br />
| align="left" |Lenkwinkel des jeweiligen Rades<br />
| align="left" |[http://de.wikipedia.org/wiki/Radiant_(Einheit) rad]<br />
| align="left" |X<br />
|-<br />
| align="left" |Axle_Springfactor_0_L / ~_R ... ~_3_L / _R<br />
| align="left" |Faktor, mit dem radweise die Federstärke angepasst werden kann, z.B. um Luftfederungen zu simulieren.<br />
| align="left" |0 = keine, 1 = normale, 2 = doppelte Federkraft<br />
| align="left" |<br />
|-<br />
| align="left" |Axle_Brakeforce_0_L / ~_R ... ~_3_L / _R<br />
| align="left" |Ermöglicht Setzen der Bremskraft pro Rad. Sollte nicht gleichzeitig mit ''Brakeforce'' verwendet werden!<br />
| align="left" |[http://de.wikipedia.org/wiki/Newton_(Einheit) N]<br />
| align="left" |<br />
|-<br />
| align="left" |Debug_0 ... _5<br />
| align="left" |Debug-Variablen. Können im Debug-Modus in der Informationsleiste angezeigt werden, um auf diese Weise die Scripts zu testen.<br />
| align="left" |bliebig<br />
| align="left" |<br />
|-<br />
| align="left" |A_Trans_X ... _Z<br />
| align="left" |Beschleunigungen im Fahrzeug, die durch die Fahrzeugbewegungen ausgelöst werden (beim Bremsen oder bei Kurvenfahrten usw.)<br />
| align="left" |m/s²<br />
| align="left" |X<br />
|-<br />
| align="left" |AI_Blinker_L, ~_R<br />
| align="left" |Linker oder rechter Blinker aktiv<br />
| align="left" |0: aus, 1: ein<br />
| align="left" |(X)*<br />
|-<br />
| align="left" |AI_Light<br />
| align="left" |Fahrlicht, Standlicht, Lichthupe<br />
| align="left" |0: Licht aus, 0.5: Standlicht an, 1: Fahrlicht an, 2: Fernlicht/Lichthupe an<br />
| align="left" |(X)*<br />
|-<br />
| align="left" |AI_Interiorlight<br />
| align="left" |Innenbeleuchtung. Hierüber erfahren die einsteigenden Fahrgäste auch, ob es im Bus zu dunkel ist (sodass sie meckern dürfen).<br />
| align="left" |0: aus, 1: an<br />
| align="left" |(X)*<br />
|-<br />
| align="left" |AI_Brakelight<br />
| align="left" |Nur für KI-Fahrzeuge: Script soll Bremslicht einschalten<br />
| align="left" |0: aus, 1: an<br />
| align="left" |X<br />
|-<br />
| align="left" |AI_Engine<br />
| align="left" |Nur für KI-Fahrzeuge: Aufforderung zum Ein- oder Ausschalten des Motors<br />
| align="left" |-1: Motor ausschalten!, 0: egal/nicht-KI, 1: Motor einschalten!<br />
| align="left" |X<br />
|-<br />
| align="left" |AI_target_index<br />
| align="left" |Dient der Übergabe des Sollwertes des einzustellenden Zielschildes bei Aufruf des Menüs oder beim Umschildern der KI-Busse. Entspricht der Reihenfolge in der Hof-Datei; erster Eintrag = 0<br />
| align="left" |-<br />
| align="left" |X<br />
|-<br />
| align="left" |target_index_int<br />
| align="left" |Über diese Variable setzt das Script, welches Zielschild am Bus zusehen ist und steuert hierüber insbesondere die Fahrgäste. Entspricht wie ''AI_target_index'' dem Index der Reihenfolge in der Hof-Datei.<br />
| align="left" |-<br />
| align="left" |<br />
|-<br />
| align="left" |AI_Scheduled_AtStation<br />
| align="left" |Nur KI-Fahrzeuge, bidirektionale Kommunikation: Bei Erreichen einer Station setzt OMSI den Wert auf 1, sodass das Script mitgeteilt bekommt, dass die Türen geöffnet werden sollen. Wenn sich der Bus abfahrbereit machen soll, setzt OMSI den Wert auf -1. Wenn der Bus abfahrbereit ist (Türen geschlossen usw.), dann setzt das Script den Wert auf 0, sodass die KI den Bus weiterfahren lassen kann.<br />
| align="left" |-1: Bus abfahrbereit machen, 0: Bus ist abfahrbereit, 1: Türen freigeben/öffnen<br />
| align="left" |(X)<br />
|-<br />
| align="left" |AI<br />
| align="left" |Hierüber erfährt das Script, ob das Fahrzeug von der AI gesteuert wird.<br />
| align="left" |0: nein, 1: ja<br />
| align="left" |X<br />
|-<br />
| align="left" |PAX_Entry0_Open ... ~7_Open<br />
| align="left" |Teilt OMSI mit, ob die jeweiligen Eingänge offen oder geschlossen sind.<br />
| align="left" |0: geschlossen, 1: offen<br />
| align="left" |<br />
|-<br />
| align="left" |PAX_Exit0_Open<br />
| align="left" |Teilt OMSI mit, ob die jeweiligen Ausgänge offen oder geschlossen sind.<br />
| align="left" |0: geschlossen, 1: offen<br />
| align="left" |<br />
|-<br />
| align="left" |GivenTicket<br />
| align="left" |Teilt OMSI mit, ob der ggf. vorhandene Fahrscheinautomat ein Ticket ausgegeben hat.<br />
| align="left" |-1: kein Ticket, 0: Tickettyp 0, 1: Tickettyp 1, ...<br />
| align="left" |<br />
|-<br />
| align="left" |humans_count<br />
| align="left" |Anzahl der Fahrgäste im Fahrzeug<br />
| align="left" |-<br />
| align="left" |X<br />
|-<br />
| align="left" |FF_Vib_Period<br />
| align="left" |Setzt die Force-Feedback-Vibrationsperiode im Lenkrad<br />
| align="left" |s<br />
| align="left" |<br />
|-<br />
| align="left" |FF_Vib_Amp<br />
| align="left" |Setzt die Force-Feedback-Vibrationsamplitude im Lenkrad<br />
| align="left" |0...1<br />
| align="left" |<br />
|-<br />
| align="left" |Snd_OutsideVol<br />
| align="left" |Teilt OMSI mit, wie stark der Außensound im Innenraum hörbar ist; verändert sich bspw. wenn eine Tür geöffnet wird.<br />
| align="left" |0: kaum hörbar, 1: wie draußen<br />
| align="left" |<br />
|-<br />
| align="left" |Snd_Microphone<br />
| align="left" |Soll das (Hardware-)Mikrofon aktiv sein?<br />
| align="left" |0: aus, 1: an<br />
| align="left" |<br />
|-<br />
| align="left" |Snd_Radio<br />
| align="left" |Soll das (Internet-)Radio laufen?<br />
| align="left" |0: aus, 1: an<br />
| align="left" |<br />
|-<br />
| align="left" |Cabinair_Temp<br />
| align="left" |Innenraumtemperatur für die Beurteilung durch die Fahrgäste<br />
| align="left" |°C<br />
| align="left" |<br />
|-<br />
| align="left" |Cabinair_absHum<br />
| align="left" |[http://de.wikipedia.org/wiki/Luftfeuchtigkeit#Absolute_Luftfeuchtigkeit Absolute Luftfeuchtigkeit] im Innenraum für die Beurteilung durch die Fahrgäste<br />
| align="left" |g/m³<br />
| align="left" |<br />
|-<br />
| align="left" |Cabinair_relHum<br />
| align="left" |[http://de.wikipedia.org/wiki/Luftfeuchtigkeit#Relative_Luftfeuchtigkeit Relative Luftfeuchtigkeit] im Innenraum, wird durch OMSI automatisch über die absolute Feuchtigkeit und die Innentemperatur berechnet.<br />
| align="left" |0 = 0%, 1 = 100%<br />
| align="left" |X<br />
|-<br />
| align="left" |PrecipRate<br />
| align="left" |Niederschlagsrate<br />
| align="left" |0 = kein, 1 = maximal<br />
| align="left" |X<br />
|-<br />
| align="left" |PrecipType<br />
| align="left" |Niederschlagstyp<br />
| align="left" |0 = kein, 1 = Regen, 2 = Schnee<br />
| align="left" |X<br />
|-<br />
| align="left" |Dirt_Norm<br />
| align="left" |allgemeiner Verdreckungszustand (Windschutzscheiben können sauberer sein und werden nur vom Script simuliert)<br />
| align="left" |0 = sauber, 1 = total verdreckt<br />
| align="left" |X<br />
|-<br />
| align="left" |DirtRate<br />
| align="left" |aktuelle Verdreckungsrate<br />
| align="left" |Verdreckung / s, wobei eine Verdreckung = 1 bedeutet, dass die Verdreckung maximal ist.<br />
| align="left" |X<br />
|-<br />
| align="left" |schedule_active<br />
| align="left" |Ist gerade ein Fahrplan aktiv? (Bspw. für Einblendung der Fahrplankarte)<br />
| align="left" |0: nein, 1: ja<br />
| align="left" |X<br />
|-<br />
| align="left" |train_frontcoupling<br />
| align="left" |Ist an der vorderen Kupplung etwas angekuppelt? (Eventuell spätere Benutzung zum Abkuppeln)<br />
| align="left" |0: nein, 1: ja<br />
| align="left" |X<br />
|-<br />
| align="left" |train_backcoupling<br />
| align="left" |Ist an der hinteren Kupplung etwas angekuppelt? (Eventuell spätere Benutzung zum Abkuppeln)<br />
| align="left" |0: nein, 1: ja<br />
| align="left" |X<br />
|-<br />
| align="left" |train_me_reverse<br />
| align="left" |Steht dieses Fahrzeug rückwärts zum gesamten Fahrzeugverband?<br />
| align="left" |0: nein, 1: ja<br />
| align="left" |X<br />
|}<br />
<br />
<nowiki>*) Bidirektionale KI-Variablen: Handelt es sich um ein Userfahrzeug, kann das Script dem Hauptprogramm mitteilen, wie Licht, Blinker usw. gesetzt wurden. Handelt es sich aber um ein KI-Fahrzeug, teilt OMSI dem Script mit, wie die entsprechenden Zustände gesetzt werden müssen.</nowiki><br />
<br />
==== Stringvariablen ====<br />
<br />
Siehe bitte auch Datei ''program\stringvarlist_roadvehicle.txt''!<br />
<br />
{| class="wikitable" style="font-size:95%;" <br />
|- class="hintergrundfarbe5"<br />
| align="left" |''Variablenname''<br />
| align="left" |''Beschreibung''<br />
| align="left" |''kein Schreibzugriff''<br />
|-<br />
| align="left" |ident<br />
| align="left" |Enthält das Kraftfahrzeugkennzeichen dieses Fahrzeugs (z.B. "B-V 3503")<br />
| align="left" |X<br />
|-<br />
| align="left" |number<br />
| align="left" |Enthält die Fahrzeugnummer (z.B. "3503")<br />
| align="left" |X<br />
|-<br />
| align="left" |act_route<br />
| align="left" |''(keine Verwendung)''<br />
| align="left" |<br />
|-<br />
| align="left" |act_busstop<br />
| align="left" |Wird zusammen mit dem internen Trigger ''ai_scheduled_setbusstop'' verwendet: Enthält dann den Namen der im Fahrplansystem aktiven Haltestelle.<br />
| align="left" |X<br />
|-<br />
| align="left" |SetLineTo<br />
| align="left" |Wird zusammen mit dem internen Trigger ''ai_scheduled_settarget'' verwendet: Enthält die einzustellende Liniennummer (oder Symbol) (bei Verwendung vom Zielschild-Menü oder beim Umschildern von KI-Bussen)<br />
| align="left" |X<br />
|-<br />
| align="left" |yard<br />
| align="left" |Name der Hofdatei des Fahrzeuges, bspw. damit das Scriptsystem den Dateinamen der Zielcode-Tabelle generieren kann.<br />
| align="left" |X<br />
|-<br />
| align="left" |file_schedule<br />
| align="left" |Enthält den Dateinamen der Fahrplan-Bitmap, die zu der von diesem Fahrzeug gefahrenen Strecke gehört.<br />
| align="left" |X<br />
|}<br />
<br />
=== Menschen ===<br />
<br />
Siehe bitte auch Datei ''program\varlist_human.txt''!<br />
<br />
{| class="wikitable" style="font-size:95%;" <br />
|- class="hintergrundfarbe5"<br />
| align="left" |''Variablenname''<br />
| align="left" |''Beschreibung''<br />
| align="left" |''Einheit''<br />
| align="left" |''kein Schreibzugriff''<br />
|-<br />
| align="left" |LastMovedDist<br />
| align="left" |Entfernung, die der Mensch seit dem letzten Durchlauf zurückgelegt hat. Wurde für die alten Animationen gebraucht.<br />
| align="left" |m<br />
| align="left" |X<br />
|-<br />
| align="left" |PAX_State<br />
| align="left" |Zustand des Menschens. Wurde für die alten Animationen gebraucht.<br />
| align="left" |0: stehen, 1: gehen, 2: sitzen<br />
| align="left" |X<br />
|-<br />
| align="left" |HeightOfSeat<br />
| align="left" |Höhe des Sitzes. Diese Eigenschaft wird in der Sitzposition gebraucht, um die Höhe der Füße korrekt gesetzt. Wurde für die alten Animationen gebraucht.<br />
| align="left" |m<br />
| align="left" |X<br />
|-<br />
| align="left" |Colorscheme<br />
| align="left" |Tauschtextur-Index ("Farbschema") des Menschens.<br />
| align="left" |-<br />
| align="left" |X<br />
|}<br />
<br />
[[Kategorie:Nachschlagewerk für Addon-Entwickler]]</div>Marcel Kuhnthttp://wiki.omnibussimulator.de/omsiwikineu.de/index.php?title=System-_und_vordefinierte_lokalen_Variablen&diff=870System- und vordefinierte lokalen Variablen2014-02-11T15:34:12Z<p>Marcel Kuhnt: /* Szenerieobjekte */</p>
<hr />
<div>''Hinweis: Dieser Artikel wurde noch nicht ins Englische übersetzt!''<br />
<br />
Beschreibung der System- und der lokalen [[Scriptsystem#Variablenzugriff|Scriptvariablen]], welche für jedes Objekt vordefiniert werden und im Allgemeinen bestimmte Sonderfunktionen gegenüber frei definierten Scriptvariablen übernehmen.<br />
<br />
== Systemvariablen ==<br />
<br />
Siehe bitte auch Datei ''program\varlist_system.txt''!<br />
<br />
{| class="wikitable" style="font-size:95%;" <br />
|- class="hintergrundfarbe5"<br />
| align="left" |''Variablenname''<br />
| align="left" |''Beschreibung''<br />
| align="left" |''Einheit''<br />
| align="left" |''ab OMSI-Vs.''<br />
|-<br />
| align="left" |Timegap<br />
| align="left" |Zeitschritt seit dem letzten Durchlauf (Frame)<br />
| align="left" |Sekunden<br />
| align="left" |1.00<br />
|-<br />
| align="left" |GetTime<br />
| align="left" |Enthält eine absolute Zeitangabe, die vom Beginn des Ausführens von OMSI zählt<br />
| align="left" |Sekunden<br />
| align="left" |1.00<br />
|-<br />
| align="left" |NoSound<br />
| align="left" |Sounds deaktiviert?<br />
| align="left" |0 = Sounds aktiviert, 1 = Sounds deaktiviert<br />
| align="left" |1.00<br />
|-<br />
| align="left" |Pause<br />
| align="left" |Simulations-Pause aktiv?<br />
| align="left" |0 = Simulation läuft, 1 = Simulation angehalten<br />
| align="left" |1.00<br />
|-<br />
| align="left" |Time<br />
| align="left" |Uhrzeit gerechnet von Mitternacht des aktuellen Tages<br />
| align="left" |Sekunden<br />
| align="left" |1.00<br />
|-<br />
| align="left" |Day<br />
| align="left" |Tag gezählt ab Monatsbeginn<br />
| align="left" |Tage<br />
| align="left" |1.00<br />
|-<br />
| align="left" |Month<br />
| align="left" |Monat<br />
| align="left" |Monate<br />
| align="left" |1.00<br />
|-<br />
| align="left" |Year<br />
| align="left" |Jahr<br />
| align="left" |Jahre<br />
| align="left" |1.00<br />
|-<br />
| align="left" |DayOfYear<br />
| align="left" |Tag gezählt ab Jahresbeginn<br />
| align="left" |Tage<br />
| align="left" |1.00<br />
|-<br />
| align="left" |mouse_x<br />
| align="left" |X-Koordinate des Mauszeigers auf dem Bildschirm<br />
| align="left" |Pixel<br />
| align="left" |1.00<br />
|-<br />
| align="left" |mouse_y<br />
| align="left" |Y-Koordinate des Mauszeigers auf dem Bildschirm<br />
| align="left" |Pixel<br />
| align="left" |1.00<br />
|-<br />
| align="left" |PrecipType<br />
| align="left" |Niederschlagstyp<br />
| align="left" |0 = keiner, 1 = Regen, 2 = Schnee<br />
| align="left" |1.00<br />
|-<br />
| align="left" |PrecipRate<br />
| align="left" |Niederschlagstyp<br />
| align="left" |0 = kein Niederschlag, 1 = maximaler Niederschlag<br />
| align="left" |1.00<br />
|-<br />
| align="left" |coll_pos_x<br />
| align="left" |Position der Kollision, x-Richtung relativ zum Fahrzeugursprung (nur bei Auslösung des Kollisions-Triggers)<br />
| align="left" |Meter<br />
| align="left" |1.00<br />
|-<br />
| align="left" |coll_pos_y<br />
| align="left" |Position der Kollision, y-Richtung relativ zum Fahrzeugursprung (nur bei Auslösung des Kollisions-Triggers)<br />
| align="left" |Meter<br />
| align="left" |1.00<br />
|-<br />
| align="left" |coll_pos_z<br />
| align="left" |Position der Kollision, z-Richtung relativ zum Fahrzeugursprung (nur bei Auslösung des Kollisions-Triggers)<br />
| align="left" |Meter<br />
| align="left" |1.00<br />
|-<br />
| align="left" |coll_energy<br />
| align="left" |Energie der Kollision (nur bei Auslösung des Kollisions-Triggers)<br />
| align="left" |Nm<br />
| align="left" |1.00<br />
|-<br />
| align="left" |Weather_Temperature<br />
| align="left" |Außentemperatur<br />
| align="left" |°C<br />
| align="left" |1.00<br />
|-<br />
| align="left" |Weather_AbsHum<br />
| align="left" |Absolute Luftfeuchtigkeit<br />
| align="left" |g/m³<br />
| align="left" |1.00<br />
|-<br />
| align="left" |AutoClutch<br />
| align="left" |Option "automatische Kupplung" aktiviert<br />
| align="left" |0 = aus, 1 = an<br />
| align="left" |1.03<br />
|-<br />
| align="left" |wearlifespan<br />
| align="left" |''nicht nutzen!''<br />
| align="left" |<br />
| align="left" |2.00<br />
|-<br />
| align="left" |SunAlt<br />
| align="left" |Höhenwinkel der Sonne<br />
| align="left" |°<br />
| align="left" |2.00<br />
|}<br />
<br />
== Vordefinierte lokale Variablen ==<br />
<br />
Seit OMSI 2 gibt es eine neue Form vordefinierter Variablen: Diese tauchen nicht in der ''varlist_*.txt''-Datei im ''program''-Verzeichnis auf und müssen daher so wie "normale" lokale Variablen deklariert werden, sie werden aber dennoch (sofern sie deklariert werden) mit internen Variablen verbunden. Diese Variablen werden "on-demand-vordefinierte Variablen" genannt. Bitte beachten Sie hierzu die neue Spalte!<br />
<br />
=== Szenerieobjekte ===<br />
<br />
Siehe bitte auch Datei ''program\varlist_scenobj.txt''!<br />
<br />
{| class="wikitable" style="font-size:95%;" <br />
|- class="hintergrundfarbe5"<br />
| align="left" |''Variablenname''<br />
| align="left" |''Beschreibung''<br />
| align="left" |''Einheit''<br />
| align="left" |''kein Schreibzugriff''<br />
| align="left" |''ab OMSI-Vs.''<br />
|-<br />
| align="left" |NightLightA<br />
| align="left" |Ist die Nachtbeleuchtung aktiv?<br />
| align="left" |0 = aus, 1 = an<br />
| align="left" |X<br />
| align="left" |1.00<br />
|-<br />
| align="left" |InUse<br />
| align="left" |Ist das Objekt "aktiv"? Die Sporthallen sind bspw. nur an Schultagen vormittags "aktiv", sodass die Soundeffekte an diese Variable gekoppelt werden können - auf diese Weise wird verhindert, dass die Soundeffekte auch in den Ferien oder nachts zu hören sind.<br />
| align="left" |0 = inaktiv, 1 = aktiv<br />
| align="left" |X<br />
| align="left" |1.00<br />
|-<br />
| align="left" |TrafficLightPhase<br />
| align="left" |Hierüber wird Ampelobjekten die anzuzeigende Ampelphase mitgeteilt.<br />
| align="left" |0..2 = rot, 3..5 = rot-gelb, 6..8 = grün, 9..11 = gelb, sonst aus<br />
| align="left" |X<br />
| align="left" |1.00<br />
|-<br />
| align="left" |TrafficLightApproach<br />
| align="left" |Hierüber kann das Script eine Ampelanforderung erkennen und bspw. eine Kennleuchte aktiviert werden.<br />
| align="left" |0 = keine Anforderung, 1 = Anforderung<br />
| align="left" |X<br />
| align="left" |1.00<br />
|-<br />
| align="left" |Colorscheme<br />
| align="left" |(veraltet)<br />
| align="left" |(-)<br />
| align="left" |X<br />
| align="left" |1.00<br />
|-<br />
| align="left" |Signal<br />
| align="left" |Hierüber erhalten Signale ihr anzuzeigendes Signalbild<br />
| align="left" |individuell<br />
| align="left" |X<br />
| align="left" |1.00<br />
|-<br />
| align="left" |NextSignal<br />
| align="left" |Hierüber erhalten Signale mit Vorsignalfunktion das anzuzeigende Signalbild des nächsten Signals<br />
| align="left" |individuell<br />
| align="left" |X<br />
| align="left" |1.00<br />
|-<br />
| align="left" |Refresh_Strings<br />
| align="left" |Diese Variable muss auf "1" gesetzt werden, damit die Text-Texturen aktualisiert werden! Wird nach erfolgreicher Abarbeitung von OMSI auf 0 gesetzt.<br />
| align="left" |-<br />
| align="left" |<br />
| align="left" |1.00<br />
|-<br />
| align="left" |Switch<br />
| align="left" |Mit dieser Variable kann die Weiche, die im Objekt eingebaut ist, gestellt werden. Hierfür muss der Wert der Variable auf den mit [switchdir] angegebenen Wert des gewünschten Pfades gesetzt werden.<br />
| align="left" |-<br />
| align="left" |<br />
| align="left" |2.00<br />
|}<br />
<br />
=== Fahrzeuge ===<br />
<br />
==== Zahlvariablen ====<br />
<br />
Siehe bitte auch Datei ''program\varlist_roadvehicle.txt''!<br />
<br />
{| class="wikitable" style="font-size:95%;" <br />
|- class="hintergrundfarbe5"<br />
| align="left" |''Variablenname''<br />
| align="left" |''Beschreibung''<br />
| align="left" |''Einheit''<br />
| align="left" |''kein Schreibzugriff''<br />
|-<br />
| align="left" |Refresh_Strings<br />
| align="left" |Diese Variable muss auf "1" gesetzt werden, damit die Text-Texturen aktualisiert werden! Wird nach erfolgreicher Abarbeitung von OMSI auf 0 gesetzt.<br />
| align="left" |-<br />
| align="left" |<br />
|-<br />
| align="left" |Envir_Brightness<br />
| align="left" |Umgebungshelligkeit in Fahrzeugnähe<br />
| align="left" |0 = dunkel, 1 = hell<br />
| align="left" |X<br />
|-<br />
| align="left" |StreetCond<br />
| align="left" |Information über die Oberflächenbedingungen<br />
| align="left" |0: Trocken, 0..1: zunehmende Feuchtigkeit, 1: komplett feucht, 1..2: teilweise Pfützen, 2: Fahrzeug komplett in Pfützen<br />
| align="left" |X<br />
|-<br />
| align="left" |Spot_Select<br />
| align="left" |Hierüber kann gesteuert werden, welches fürs Fahrzeug vordefinierte Spotlight aktiv sein soll.<br />
| align="left" |-1: kein Spotlight, 0: Spotlight Nr. 0, 1: Spotlight Nr. 1 usw.<br />
| align="left" |<br />
|-<br />
| align="left" |Colorscheme<br />
| align="left" |Index des gewählten Farbschemas/Anstriches<br />
| align="left" |-<br />
| align="left" |X<br />
|-<br />
| align="left" |M_Wheel<br />
| align="left" |Hierüber kann das Script ein [http://de.wikipedia.org/wiki/Drehmoment Drehmoment] auf die Räder übertragen. Hierbei die Summe anzugeben, welche auf alle als angetrieben ausgewiesene Achsen wirken <br />
soll.<br />
| align="left" |kNm = 1000 [http://de.wikipedia.org/wiki/Newtonmeter Nm]<br />
| align="left" |<br />
|-<br />
| align="left" |n_Wheel<br />
| align="left" |Mittlere Raddrehzahl des Fahrzeuges<br />
| align="left" |Umdrehungen pro Minute<br />
| align="left" |X<br />
|-<br />
| align="left" |Throttle<br />
| align="left" |Stellung des Gaspedals<br />
| align="left" |0..1<br />
| align="left" |X<br />
|-<br />
| align="left" |Brake<br />
| align="left" |Stellung des Bremspedals<br />
| align="left" |0..1<br />
| align="left" |X<br />
|-<br />
| align="left" |Clutch<br />
| align="left" |Stellung des Kupplungspedals<br />
| align="left" |0..1<br />
| align="left" |X<br />
|-<br />
| align="left" |Brakeforce<br />
| align="left" |Hierüber kann das Script die Gesamtbremskraft des Fahrzeuges vorgeben, welche auf die Räder wirkt. Sollte nicht gleichzeitig mit ''Axle_Brakeforce...'' verwendet werden.<br />
| align="left" |[http://de.wikipedia.org/wiki/Newton_(Einheit) N]<br />
| align="left" |<br />
|-<br />
| align="left" |Velocity<br />
| align="left" |Geschwindigkeit, welche sich über die Raddrehung ergibt, entspricht der Tachoanzeige<br />
| align="left" |[http://de.wikipedia.org/wiki/Km/h km/h]<br />
| align="left" |X<br />
|-<br />
| align="left" |Velocity_Ground<br />
| align="left" |Geschwindigkeit, welche direkt relativ zum Grund gemessen wird, berücksichtigt kein Radschleudern oder -blockieren, entspricht der Anzeige auf einem GPS<br />
| align="left" |[http://de.wikipedia.org/wiki/Km/h km/h]<br />
| align="left" |X<br />
|-<br />
| align="left" |tank_percent<br />
| align="left" |Tankinhalt, nur für die Anzeige auf der roten Informationsleiste. Die Betankung und Simulation eines leeren Tanks geschieht über einen Trigger bzw. muss im Script programmiert werden.<br />
| align="left" |0..1<br />
| align="left" |<br />
|-<br />
| align="left" |kmcounter_km<br />
| align="left" |Stand des Kilometerzählers (nur ganze km)<br />
| align="left" |km<br />
| align="left" |X<br />
|-<br />
| align="left" |kmcounter_m<br />
| align="left" |Stand des Kilometerzählers (zusätzliche Meter, läuft stets nur von 0m bis 999m; hinzu kommen die Kilometer von ''kmcounter_km'')<br />
| align="left" |m<br />
| align="left" |X<br />
|-<br />
| align="left" |relrange<br />
| align="left" |Zurückgelegte, relative Strecke. Wurde nur testweise für pfadfixierte Fahrzeuge eingeführt. Nicht benutzen!<br />
| align="left" |---<br />
| align="left" |X<br />
|-<br />
| align="left" |Driver_Seat_VertTransl<br />
| align="left" |Einfederung des federnden Fahrersitzes<br />
| align="left" |m<br />
| align="left" |X<br />
|-<br />
| align="left" |Wheel_Rotation_0_L / ~_R ... ~_3_L / _R<br />
| align="left" |Drehwinkel des jeweiligen Rades, z.B. für die Animation<br />
| align="left" |[http://de.wikipedia.org/wiki/Radiant_(Einheit) rad]<br />
| align="left" |X<br />
|-<br />
| align="left" |Wheel_RotationSpeed_0_L / ~_R ... ~_3_L / _R<br />
| align="left" |Drehzahl des jeweiligen Rades<br />
| align="left" |Umdrehungen pro Minute<br />
| align="left" |X<br />
|-<br />
| align="left" |Axle_Suspension_0_L / ~_R ... ~_3_L / _R<br />
| align="left" |Einfederungsweg des jeweiligen Rades<br />
| align="left" |m<br />
| align="left" |X<br />
|-<br />
| align="left" |Axle_Steering_0_L / ~_R ... ~_3_L / _R<br />
| align="left" |Lenkwinkel des jeweiligen Rades<br />
| align="left" |[http://de.wikipedia.org/wiki/Radiant_(Einheit) rad]<br />
| align="left" |X<br />
|-<br />
| align="left" |Axle_Springfactor_0_L / ~_R ... ~_3_L / _R<br />
| align="left" |Faktor, mit dem radweise die Federstärke angepasst werden kann, z.B. um Luftfederungen zu simulieren.<br />
| align="left" |0 = keine, 1 = normale, 2 = doppelte Federkraft<br />
| align="left" |<br />
|-<br />
| align="left" |Axle_Brakeforce_0_L / ~_R ... ~_3_L / _R<br />
| align="left" |Ermöglicht Setzen der Bremskraft pro Rad. Sollte nicht gleichzeitig mit ''Brakeforce'' verwendet werden!<br />
| align="left" |[http://de.wikipedia.org/wiki/Newton_(Einheit) N]<br />
| align="left" |<br />
|-<br />
| align="left" |Debug_0 ... _5<br />
| align="left" |Debug-Variablen. Können im Debug-Modus in der Informationsleiste angezeigt werden, um auf diese Weise die Scripts zu testen.<br />
| align="left" |bliebig<br />
| align="left" |<br />
|-<br />
| align="left" |A_Trans_X ... _Z<br />
| align="left" |Beschleunigungen im Fahrzeug, die durch die Fahrzeugbewegungen ausgelöst werden (beim Bremsen oder bei Kurvenfahrten usw.)<br />
| align="left" |m/s²<br />
| align="left" |X<br />
|-<br />
| align="left" |AI_Blinker_L, ~_R<br />
| align="left" |Linker oder rechter Blinker aktiv<br />
| align="left" |0: aus, 1: ein<br />
| align="left" |(X)*<br />
|-<br />
| align="left" |AI_Light<br />
| align="left" |Fahrlicht, Standlicht, Lichthupe<br />
| align="left" |0: Licht aus, 0.5: Standlicht an, 1: Fahrlicht an, 2: Fernlicht/Lichthupe an<br />
| align="left" |(X)*<br />
|-<br />
| align="left" |AI_Interiorlight<br />
| align="left" |Innenbeleuchtung. Hierüber erfahren die einsteigenden Fahrgäste auch, ob es im Bus zu dunkel ist (sodass sie meckern dürfen).<br />
| align="left" |0: aus, 1: an<br />
| align="left" |(X)*<br />
|-<br />
| align="left" |AI_Brakelight<br />
| align="left" |Nur für KI-Fahrzeuge: Script soll Bremslicht einschalten<br />
| align="left" |0: aus, 1: an<br />
| align="left" |X<br />
|-<br />
| align="left" |AI_Engine<br />
| align="left" |Nur für KI-Fahrzeuge: Aufforderung zum Ein- oder Ausschalten des Motors<br />
| align="left" |-1: Motor ausschalten!, 0: egal/nicht-KI, 1: Motor einschalten!<br />
| align="left" |X<br />
|-<br />
| align="left" |AI_target_index<br />
| align="left" |Dient der Übergabe des Sollwertes des einzustellenden Zielschildes bei Aufruf des Menüs oder beim Umschildern der KI-Busse. Entspricht der Reihenfolge in der Hof-Datei; erster Eintrag = 0<br />
| align="left" |-<br />
| align="left" |X<br />
|-<br />
| align="left" |target_index_int<br />
| align="left" |Über diese Variable setzt das Script, welches Zielschild am Bus zusehen ist und steuert hierüber insbesondere die Fahrgäste. Entspricht wie ''AI_target_index'' dem Index der Reihenfolge in der Hof-Datei.<br />
| align="left" |-<br />
| align="left" |<br />
|-<br />
| align="left" |AI_Scheduled_AtStation<br />
| align="left" |Nur KI-Fahrzeuge, bidirektionale Kommunikation: Bei Erreichen einer Station setzt OMSI den Wert auf 1, sodass das Script mitgeteilt bekommt, dass die Türen geöffnet werden sollen. Wenn sich der Bus abfahrbereit machen soll, setzt OMSI den Wert auf -1. Wenn der Bus abfahrbereit ist (Türen geschlossen usw.), dann setzt das Script den Wert auf 0, sodass die KI den Bus weiterfahren lassen kann.<br />
| align="left" |-1: Bus abfahrbereit machen, 0: Bus ist abfahrbereit, 1: Türen freigeben/öffnen<br />
| align="left" |(X)<br />
|-<br />
| align="left" |AI<br />
| align="left" |Hierüber erfährt das Script, ob das Fahrzeug von der AI gesteuert wird.<br />
| align="left" |0: nein, 1: ja<br />
| align="left" |X<br />
|-<br />
| align="left" |PAX_Entry0_Open ... ~7_Open<br />
| align="left" |Teilt OMSI mit, ob die jeweiligen Eingänge offen oder geschlossen sind.<br />
| align="left" |0: geschlossen, 1: offen<br />
| align="left" |<br />
|-<br />
| align="left" |PAX_Exit0_Open<br />
| align="left" |Teilt OMSI mit, ob die jeweiligen Ausgänge offen oder geschlossen sind.<br />
| align="left" |0: geschlossen, 1: offen<br />
| align="left" |<br />
|-<br />
| align="left" |GivenTicket<br />
| align="left" |Teilt OMSI mit, ob der ggf. vorhandene Fahrscheinautomat ein Ticket ausgegeben hat.<br />
| align="left" |-1: kein Ticket, 0: Tickettyp 0, 1: Tickettyp 1, ...<br />
| align="left" |<br />
|-<br />
| align="left" |humans_count<br />
| align="left" |Anzahl der Fahrgäste im Fahrzeug<br />
| align="left" |-<br />
| align="left" |X<br />
|-<br />
| align="left" |FF_Vib_Period<br />
| align="left" |Setzt die Force-Feedback-Vibrationsperiode im Lenkrad<br />
| align="left" |s<br />
| align="left" |<br />
|-<br />
| align="left" |FF_Vib_Amp<br />
| align="left" |Setzt die Force-Feedback-Vibrationsamplitude im Lenkrad<br />
| align="left" |0...1<br />
| align="left" |<br />
|-<br />
| align="left" |Snd_OutsideVol<br />
| align="left" |Teilt OMSI mit, wie stark der Außensound im Innenraum hörbar ist; verändert sich bspw. wenn eine Tür geöffnet wird.<br />
| align="left" |0: kaum hörbar, 1: wie draußen<br />
| align="left" |<br />
|-<br />
| align="left" |Snd_Microphone<br />
| align="left" |Soll das (Hardware-)Mikrofon aktiv sein?<br />
| align="left" |0: aus, 1: an<br />
| align="left" |<br />
|-<br />
| align="left" |Snd_Radio<br />
| align="left" |Soll das (Internet-)Radio laufen?<br />
| align="left" |0: aus, 1: an<br />
| align="left" |<br />
|-<br />
| align="left" |Cabinair_Temp<br />
| align="left" |Innenraumtemperatur für die Beurteilung durch die Fahrgäste<br />
| align="left" |°C<br />
| align="left" |<br />
|-<br />
| align="left" |Cabinair_absHum<br />
| align="left" |[http://de.wikipedia.org/wiki/Luftfeuchtigkeit#Absolute_Luftfeuchtigkeit Absolute Luftfeuchtigkeit] im Innenraum für die Beurteilung durch die Fahrgäste<br />
| align="left" |g/m³<br />
| align="left" |<br />
|-<br />
| align="left" |Cabinair_relHum<br />
| align="left" |[http://de.wikipedia.org/wiki/Luftfeuchtigkeit#Relative_Luftfeuchtigkeit Relative Luftfeuchtigkeit] im Innenraum, wird durch OMSI automatisch über die absolute Feuchtigkeit und die Innentemperatur berechnet.<br />
| align="left" |0 = 0%, 1 = 100%<br />
| align="left" |X<br />
|-<br />
| align="left" |PrecipRate<br />
| align="left" |Niederschlagsrate<br />
| align="left" |0 = kein, 1 = maximal<br />
| align="left" |X<br />
|-<br />
| align="left" |PrecipType<br />
| align="left" |Niederschlagstyp<br />
| align="left" |0 = kein, 1 = Regen, 2 = Schnee<br />
| align="left" |X<br />
|-<br />
| align="left" |Dirt_Norm<br />
| align="left" |allgemeiner Verdreckungszustand (Windschutzscheiben können sauberer sein und werden nur vom Script simuliert)<br />
| align="left" |0 = sauber, 1 = total verdreckt<br />
| align="left" |X<br />
|-<br />
| align="left" |DirtRate<br />
| align="left" |aktuelle Verdreckungsrate<br />
| align="left" |Verdreckung / s, wobei eine Verdreckung = 1 bedeutet, dass die Verdreckung maximal ist.<br />
| align="left" |X<br />
|-<br />
| align="left" |schedule_active<br />
| align="left" |Ist gerade ein Fahrplan aktiv? (Bspw. für Einblendung der Fahrplankarte)<br />
| align="left" |0: nein, 1: ja<br />
| align="left" |X<br />
|-<br />
| align="left" |train_frontcoupling<br />
| align="left" |Ist an der vorderen Kupplung etwas angekuppelt? (Eventuell spätere Benutzung zum Abkuppeln)<br />
| align="left" |0: nein, 1: ja<br />
| align="left" |X<br />
|-<br />
| align="left" |train_backcoupling<br />
| align="left" |Ist an der hinteren Kupplung etwas angekuppelt? (Eventuell spätere Benutzung zum Abkuppeln)<br />
| align="left" |0: nein, 1: ja<br />
| align="left" |X<br />
|-<br />
| align="left" |train_me_reverse<br />
| align="left" |Steht dieses Fahrzeug rückwärts zum gesamten Fahrzeugverband?<br />
| align="left" |0: nein, 1: ja<br />
| align="left" |X<br />
|}<br />
<br />
<nowiki>*) Bidirektionale KI-Variablen: Handelt es sich um ein Userfahrzeug, kann das Script dem Hauptprogramm mitteilen, wie Licht, Blinker usw. gesetzt wurden. Handelt es sich aber um ein KI-Fahrzeug, teilt OMSI dem Script mit, wie die entsprechenden Zustände gesetzt werden müssen.</nowiki><br />
<br />
==== Stringvariablen ====<br />
<br />
Siehe bitte auch Datei ''program\stringvarlist_roadvehicle.txt''!<br />
<br />
{| class="wikitable" style="font-size:95%;" <br />
|- class="hintergrundfarbe5"<br />
| align="left" |''Variablenname''<br />
| align="left" |''Beschreibung''<br />
| align="left" |''kein Schreibzugriff''<br />
|-<br />
| align="left" |ident<br />
| align="left" |Enthält das Kraftfahrzeugkennzeichen dieses Fahrzeugs (z.B. "B-V 3503")<br />
| align="left" |X<br />
|-<br />
| align="left" |number<br />
| align="left" |Enthält die Fahrzeugnummer (z.B. "3503")<br />
| align="left" |X<br />
|-<br />
| align="left" |act_route<br />
| align="left" |''(keine Verwendung)''<br />
| align="left" |<br />
|-<br />
| align="left" |act_busstop<br />
| align="left" |Wird zusammen mit dem internen Trigger ''ai_scheduled_setbusstop'' verwendet: Enthält dann den Namen der im Fahrplansystem aktiven Haltestelle.<br />
| align="left" |X<br />
|-<br />
| align="left" |SetLineTo<br />
| align="left" |Wird zusammen mit dem internen Trigger ''ai_scheduled_settarget'' verwendet: Enthält die einzustellende Liniennummer (oder Symbol) (bei Verwendung vom Zielschild-Menü oder beim Umschildern von KI-Bussen)<br />
| align="left" |X<br />
|-<br />
| align="left" |yard<br />
| align="left" |Name der Hofdatei des Fahrzeuges, bspw. damit das Scriptsystem den Dateinamen der Zielcode-Tabelle generieren kann.<br />
| align="left" |X<br />
|-<br />
| align="left" |file_schedule<br />
| align="left" |Enthält den Dateinamen der Fahrplan-Bitmap, die zu der von diesem Fahrzeug gefahrenen Strecke gehört.<br />
| align="left" |X<br />
|}<br />
<br />
=== Menschen ===<br />
<br />
Siehe bitte auch Datei ''program\varlist_human.txt''!<br />
<br />
{| class="wikitable" style="font-size:95%;" <br />
|- class="hintergrundfarbe5"<br />
| align="left" |''Variablenname''<br />
| align="left" |''Beschreibung''<br />
| align="left" |''Einheit''<br />
| align="left" |''kein Schreibzugriff''<br />
|-<br />
| align="left" |LastMovedDist<br />
| align="left" |Entfernung, die der Mensch seit dem letzten Durchlauf zurückgelegt hat. Wurde für die alten Animationen gebraucht.<br />
| align="left" |m<br />
| align="left" |X<br />
|-<br />
| align="left" |PAX_State<br />
| align="left" |Zustand des Menschens. Wurde für die alten Animationen gebraucht.<br />
| align="left" |0: stehen, 1: gehen, 2: sitzen<br />
| align="left" |X<br />
|-<br />
| align="left" |HeightOfSeat<br />
| align="left" |Höhe des Sitzes. Diese Eigenschaft wird in der Sitzposition gebraucht, um die Höhe der Füße korrekt gesetzt. Wurde für die alten Animationen gebraucht.<br />
| align="left" |m<br />
| align="left" |X<br />
|-<br />
| align="left" |Colorscheme<br />
| align="left" |Tauschtextur-Index ("Farbschema") des Menschens.<br />
| align="left" |-<br />
| align="left" |X<br />
|}<br />
<br />
[[Kategorie:Nachschlagewerk für Addon-Entwickler]]</div>Marcel Kuhnthttp://wiki.omnibussimulator.de/omsiwikineu.de/index.php?title=System-_und_vordefinierte_lokalen_Variablen&diff=869System- und vordefinierte lokalen Variablen2014-02-11T15:27:28Z<p>Marcel Kuhnt: </p>
<hr />
<div>''Hinweis: Dieser Artikel wurde noch nicht ins Englische übersetzt!''<br />
<br />
Beschreibung der System- und der lokalen [[Scriptsystem#Variablenzugriff|Scriptvariablen]], welche für jedes Objekt vordefiniert werden und im Allgemeinen bestimmte Sonderfunktionen gegenüber frei definierten Scriptvariablen übernehmen.<br />
<br />
== Systemvariablen ==<br />
<br />
Siehe bitte auch Datei ''program\varlist_system.txt''!<br />
<br />
{| class="wikitable" style="font-size:95%;" <br />
|- class="hintergrundfarbe5"<br />
| align="left" |''Variablenname''<br />
| align="left" |''Beschreibung''<br />
| align="left" |''Einheit''<br />
| align="left" |''ab OMSI-Vs.''<br />
|-<br />
| align="left" |Timegap<br />
| align="left" |Zeitschritt seit dem letzten Durchlauf (Frame)<br />
| align="left" |Sekunden<br />
| align="left" |1.00<br />
|-<br />
| align="left" |GetTime<br />
| align="left" |Enthält eine absolute Zeitangabe, die vom Beginn des Ausführens von OMSI zählt<br />
| align="left" |Sekunden<br />
| align="left" |1.00<br />
|-<br />
| align="left" |NoSound<br />
| align="left" |Sounds deaktiviert?<br />
| align="left" |0 = Sounds aktiviert, 1 = Sounds deaktiviert<br />
| align="left" |1.00<br />
|-<br />
| align="left" |Pause<br />
| align="left" |Simulations-Pause aktiv?<br />
| align="left" |0 = Simulation läuft, 1 = Simulation angehalten<br />
| align="left" |1.00<br />
|-<br />
| align="left" |Time<br />
| align="left" |Uhrzeit gerechnet von Mitternacht des aktuellen Tages<br />
| align="left" |Sekunden<br />
| align="left" |1.00<br />
|-<br />
| align="left" |Day<br />
| align="left" |Tag gezählt ab Monatsbeginn<br />
| align="left" |Tage<br />
| align="left" |1.00<br />
|-<br />
| align="left" |Month<br />
| align="left" |Monat<br />
| align="left" |Monate<br />
| align="left" |1.00<br />
|-<br />
| align="left" |Year<br />
| align="left" |Jahr<br />
| align="left" |Jahre<br />
| align="left" |1.00<br />
|-<br />
| align="left" |DayOfYear<br />
| align="left" |Tag gezählt ab Jahresbeginn<br />
| align="left" |Tage<br />
| align="left" |1.00<br />
|-<br />
| align="left" |mouse_x<br />
| align="left" |X-Koordinate des Mauszeigers auf dem Bildschirm<br />
| align="left" |Pixel<br />
| align="left" |1.00<br />
|-<br />
| align="left" |mouse_y<br />
| align="left" |Y-Koordinate des Mauszeigers auf dem Bildschirm<br />
| align="left" |Pixel<br />
| align="left" |1.00<br />
|-<br />
| align="left" |PrecipType<br />
| align="left" |Niederschlagstyp<br />
| align="left" |0 = keiner, 1 = Regen, 2 = Schnee<br />
| align="left" |1.00<br />
|-<br />
| align="left" |PrecipRate<br />
| align="left" |Niederschlagstyp<br />
| align="left" |0 = kein Niederschlag, 1 = maximaler Niederschlag<br />
| align="left" |1.00<br />
|-<br />
| align="left" |coll_pos_x<br />
| align="left" |Position der Kollision, x-Richtung relativ zum Fahrzeugursprung (nur bei Auslösung des Kollisions-Triggers)<br />
| align="left" |Meter<br />
| align="left" |1.00<br />
|-<br />
| align="left" |coll_pos_y<br />
| align="left" |Position der Kollision, y-Richtung relativ zum Fahrzeugursprung (nur bei Auslösung des Kollisions-Triggers)<br />
| align="left" |Meter<br />
| align="left" |1.00<br />
|-<br />
| align="left" |coll_pos_z<br />
| align="left" |Position der Kollision, z-Richtung relativ zum Fahrzeugursprung (nur bei Auslösung des Kollisions-Triggers)<br />
| align="left" |Meter<br />
| align="left" |1.00<br />
|-<br />
| align="left" |coll_energy<br />
| align="left" |Energie der Kollision (nur bei Auslösung des Kollisions-Triggers)<br />
| align="left" |Nm<br />
| align="left" |1.00<br />
|-<br />
| align="left" |Weather_Temperature<br />
| align="left" |Außentemperatur<br />
| align="left" |°C<br />
| align="left" |1.00<br />
|-<br />
| align="left" |Weather_AbsHum<br />
| align="left" |Absolute Luftfeuchtigkeit<br />
| align="left" |g/m³<br />
| align="left" |1.00<br />
|-<br />
| align="left" |AutoClutch<br />
| align="left" |Option "automatische Kupplung" aktiviert<br />
| align="left" |0 = aus, 1 = an<br />
| align="left" |1.03<br />
|-<br />
| align="left" |wearlifespan<br />
| align="left" |''nicht nutzen!''<br />
| align="left" |<br />
| align="left" |2.00<br />
|-<br />
| align="left" |SunAlt<br />
| align="left" |Höhenwinkel der Sonne<br />
| align="left" |°<br />
| align="left" |2.00<br />
|}<br />
<br />
== Vordefinierte lokale Variablen ==<br />
<br />
Seit OMSI 2 gibt es eine neue Form vordefinierter Variablen: Diese tauchen nicht in der ''varlist_*.txt''-Datei im ''program''-Verzeichnis auf und müssen daher so wie "normale" lokale Variablen deklariert werden, sie werden aber dennoch (sofern sie deklariert werden) mit internen Variablen verbunden. Diese Variablen werden "on-demand-vordefinierte Variablen" genannt. Bitte beachten Sie hierzu die neue Spalte!<br />
<br />
=== Szenerieobjekte ===<br />
<br />
Siehe bitte auch Datei ''program\varlist_scenobj.txt''!<br />
<br />
{| class="wikitable" style="font-size:95%;" <br />
|- class="hintergrundfarbe5"<br />
| align="left" |''Variablenname''<br />
| align="left" |''Beschreibung''<br />
| align="left" |''Einheit''<br />
| align="left" |''kein Schreibzugriff''<br />
|-<br />
| align="left" |NightLightA<br />
| align="left" |Ist die Nachtbeleuchtung aktiv?<br />
| align="left" |0 = aus, 1 = an<br />
| align="left" |X<br />
|-<br />
| align="left" |InUse<br />
| align="left" |Ist das Objekt "aktiv"? Die Sporthallen sind bspw. nur an Schultagen vormittags "aktiv", sodass die Soundeffekte an diese Variable gekoppelt werden können - auf diese Weise wird verhindert, dass die Soundeffekte auch in den Ferien oder nachts zu hören sind.<br />
| align="left" |0 = inaktiv, 1 = aktiv<br />
| align="left" |X<br />
|-<br />
| align="left" |TrafficLightPhase<br />
| align="left" |Hierüber wird Ampelobjekten die anzuzeigende Ampelphase mitgeteilt.<br />
| align="left" |0..2 = rot, 3..5 = rot-gelb, 6..8 = grün, 9..11 = gelb, sonst aus<br />
| align="left" |X<br />
|-<br />
| align="left" |TrafficLightApproach<br />
| align="left" |Hierüber kann das Script eine Ampelanforderung erkennen und bspw. eine Kennleuchte aktiviert werden.<br />
| align="left" |0 = keine Anforderung, 1 = Anforderung<br />
| align="left" |X<br />
|-<br />
| align="left" |Colorscheme<br />
| align="left" |(veraltet)<br />
| align="left" |(-)<br />
| align="left" |X<br />
|-<br />
| align="left" |Signal<br />
| align="left" |Hierüber erhalten Signale ihr anzuzeigendes Signalbild<br />
| align="left" |individuell<br />
| align="left" |X<br />
|-<br />
| align="left" |NextSignal<br />
| align="left" |Hierüber erhalten Signale mit Vorsignalfunktion das anzuzeigende Signalbild des nächsten Signals<br />
| align="left" |individuell<br />
| align="left" |X<br />
|-<br />
| align="left" |Refresh_Strings<br />
| align="left" |Diese Variable muss auf "1" gesetzt werden, damit die Text-Texturen aktualisiert werden! Wird nach erfolgreicher Abarbeitung von OMSI auf 0 gesetzt.<br />
| align="left" |-<br />
| align="left" |<br />
|}<br />
<br />
=== Fahrzeuge ===<br />
<br />
==== Zahlvariablen ====<br />
<br />
Siehe bitte auch Datei ''program\varlist_roadvehicle.txt''!<br />
<br />
{| class="wikitable" style="font-size:95%;" <br />
|- class="hintergrundfarbe5"<br />
| align="left" |''Variablenname''<br />
| align="left" |''Beschreibung''<br />
| align="left" |''Einheit''<br />
| align="left" |''kein Schreibzugriff''<br />
|-<br />
| align="left" |Refresh_Strings<br />
| align="left" |Diese Variable muss auf "1" gesetzt werden, damit die Text-Texturen aktualisiert werden! Wird nach erfolgreicher Abarbeitung von OMSI auf 0 gesetzt.<br />
| align="left" |-<br />
| align="left" |<br />
|-<br />
| align="left" |Envir_Brightness<br />
| align="left" |Umgebungshelligkeit in Fahrzeugnähe<br />
| align="left" |0 = dunkel, 1 = hell<br />
| align="left" |X<br />
|-<br />
| align="left" |StreetCond<br />
| align="left" |Information über die Oberflächenbedingungen<br />
| align="left" |0: Trocken, 0..1: zunehmende Feuchtigkeit, 1: komplett feucht, 1..2: teilweise Pfützen, 2: Fahrzeug komplett in Pfützen<br />
| align="left" |X<br />
|-<br />
| align="left" |Spot_Select<br />
| align="left" |Hierüber kann gesteuert werden, welches fürs Fahrzeug vordefinierte Spotlight aktiv sein soll.<br />
| align="left" |-1: kein Spotlight, 0: Spotlight Nr. 0, 1: Spotlight Nr. 1 usw.<br />
| align="left" |<br />
|-<br />
| align="left" |Colorscheme<br />
| align="left" |Index des gewählten Farbschemas/Anstriches<br />
| align="left" |-<br />
| align="left" |X<br />
|-<br />
| align="left" |M_Wheel<br />
| align="left" |Hierüber kann das Script ein [http://de.wikipedia.org/wiki/Drehmoment Drehmoment] auf die Räder übertragen. Hierbei die Summe anzugeben, welche auf alle als angetrieben ausgewiesene Achsen wirken <br />
soll.<br />
| align="left" |kNm = 1000 [http://de.wikipedia.org/wiki/Newtonmeter Nm]<br />
| align="left" |<br />
|-<br />
| align="left" |n_Wheel<br />
| align="left" |Mittlere Raddrehzahl des Fahrzeuges<br />
| align="left" |Umdrehungen pro Minute<br />
| align="left" |X<br />
|-<br />
| align="left" |Throttle<br />
| align="left" |Stellung des Gaspedals<br />
| align="left" |0..1<br />
| align="left" |X<br />
|-<br />
| align="left" |Brake<br />
| align="left" |Stellung des Bremspedals<br />
| align="left" |0..1<br />
| align="left" |X<br />
|-<br />
| align="left" |Clutch<br />
| align="left" |Stellung des Kupplungspedals<br />
| align="left" |0..1<br />
| align="left" |X<br />
|-<br />
| align="left" |Brakeforce<br />
| align="left" |Hierüber kann das Script die Gesamtbremskraft des Fahrzeuges vorgeben, welche auf die Räder wirkt. Sollte nicht gleichzeitig mit ''Axle_Brakeforce...'' verwendet werden.<br />
| align="left" |[http://de.wikipedia.org/wiki/Newton_(Einheit) N]<br />
| align="left" |<br />
|-<br />
| align="left" |Velocity<br />
| align="left" |Geschwindigkeit, welche sich über die Raddrehung ergibt, entspricht der Tachoanzeige<br />
| align="left" |[http://de.wikipedia.org/wiki/Km/h km/h]<br />
| align="left" |X<br />
|-<br />
| align="left" |Velocity_Ground<br />
| align="left" |Geschwindigkeit, welche direkt relativ zum Grund gemessen wird, berücksichtigt kein Radschleudern oder -blockieren, entspricht der Anzeige auf einem GPS<br />
| align="left" |[http://de.wikipedia.org/wiki/Km/h km/h]<br />
| align="left" |X<br />
|-<br />
| align="left" |tank_percent<br />
| align="left" |Tankinhalt, nur für die Anzeige auf der roten Informationsleiste. Die Betankung und Simulation eines leeren Tanks geschieht über einen Trigger bzw. muss im Script programmiert werden.<br />
| align="left" |0..1<br />
| align="left" |<br />
|-<br />
| align="left" |kmcounter_km<br />
| align="left" |Stand des Kilometerzählers (nur ganze km)<br />
| align="left" |km<br />
| align="left" |X<br />
|-<br />
| align="left" |kmcounter_m<br />
| align="left" |Stand des Kilometerzählers (zusätzliche Meter, läuft stets nur von 0m bis 999m; hinzu kommen die Kilometer von ''kmcounter_km'')<br />
| align="left" |m<br />
| align="left" |X<br />
|-<br />
| align="left" |relrange<br />
| align="left" |Zurückgelegte, relative Strecke. Wurde nur testweise für pfadfixierte Fahrzeuge eingeführt. Nicht benutzen!<br />
| align="left" |---<br />
| align="left" |X<br />
|-<br />
| align="left" |Driver_Seat_VertTransl<br />
| align="left" |Einfederung des federnden Fahrersitzes<br />
| align="left" |m<br />
| align="left" |X<br />
|-<br />
| align="left" |Wheel_Rotation_0_L / ~_R ... ~_3_L / _R<br />
| align="left" |Drehwinkel des jeweiligen Rades, z.B. für die Animation<br />
| align="left" |[http://de.wikipedia.org/wiki/Radiant_(Einheit) rad]<br />
| align="left" |X<br />
|-<br />
| align="left" |Wheel_RotationSpeed_0_L / ~_R ... ~_3_L / _R<br />
| align="left" |Drehzahl des jeweiligen Rades<br />
| align="left" |Umdrehungen pro Minute<br />
| align="left" |X<br />
|-<br />
| align="left" |Axle_Suspension_0_L / ~_R ... ~_3_L / _R<br />
| align="left" |Einfederungsweg des jeweiligen Rades<br />
| align="left" |m<br />
| align="left" |X<br />
|-<br />
| align="left" |Axle_Steering_0_L / ~_R ... ~_3_L / _R<br />
| align="left" |Lenkwinkel des jeweiligen Rades<br />
| align="left" |[http://de.wikipedia.org/wiki/Radiant_(Einheit) rad]<br />
| align="left" |X<br />
|-<br />
| align="left" |Axle_Springfactor_0_L / ~_R ... ~_3_L / _R<br />
| align="left" |Faktor, mit dem radweise die Federstärke angepasst werden kann, z.B. um Luftfederungen zu simulieren.<br />
| align="left" |0 = keine, 1 = normale, 2 = doppelte Federkraft<br />
| align="left" |<br />
|-<br />
| align="left" |Axle_Brakeforce_0_L / ~_R ... ~_3_L / _R<br />
| align="left" |Ermöglicht Setzen der Bremskraft pro Rad. Sollte nicht gleichzeitig mit ''Brakeforce'' verwendet werden!<br />
| align="left" |[http://de.wikipedia.org/wiki/Newton_(Einheit) N]<br />
| align="left" |<br />
|-<br />
| align="left" |Debug_0 ... _5<br />
| align="left" |Debug-Variablen. Können im Debug-Modus in der Informationsleiste angezeigt werden, um auf diese Weise die Scripts zu testen.<br />
| align="left" |bliebig<br />
| align="left" |<br />
|-<br />
| align="left" |A_Trans_X ... _Z<br />
| align="left" |Beschleunigungen im Fahrzeug, die durch die Fahrzeugbewegungen ausgelöst werden (beim Bremsen oder bei Kurvenfahrten usw.)<br />
| align="left" |m/s²<br />
| align="left" |X<br />
|-<br />
| align="left" |AI_Blinker_L, ~_R<br />
| align="left" |Linker oder rechter Blinker aktiv<br />
| align="left" |0: aus, 1: ein<br />
| align="left" |(X)*<br />
|-<br />
| align="left" |AI_Light<br />
| align="left" |Fahrlicht, Standlicht, Lichthupe<br />
| align="left" |0: Licht aus, 0.5: Standlicht an, 1: Fahrlicht an, 2: Fernlicht/Lichthupe an<br />
| align="left" |(X)*<br />
|-<br />
| align="left" |AI_Interiorlight<br />
| align="left" |Innenbeleuchtung. Hierüber erfahren die einsteigenden Fahrgäste auch, ob es im Bus zu dunkel ist (sodass sie meckern dürfen).<br />
| align="left" |0: aus, 1: an<br />
| align="left" |(X)*<br />
|-<br />
| align="left" |AI_Brakelight<br />
| align="left" |Nur für KI-Fahrzeuge: Script soll Bremslicht einschalten<br />
| align="left" |0: aus, 1: an<br />
| align="left" |X<br />
|-<br />
| align="left" |AI_Engine<br />
| align="left" |Nur für KI-Fahrzeuge: Aufforderung zum Ein- oder Ausschalten des Motors<br />
| align="left" |-1: Motor ausschalten!, 0: egal/nicht-KI, 1: Motor einschalten!<br />
| align="left" |X<br />
|-<br />
| align="left" |AI_target_index<br />
| align="left" |Dient der Übergabe des Sollwertes des einzustellenden Zielschildes bei Aufruf des Menüs oder beim Umschildern der KI-Busse. Entspricht der Reihenfolge in der Hof-Datei; erster Eintrag = 0<br />
| align="left" |-<br />
| align="left" |X<br />
|-<br />
| align="left" |target_index_int<br />
| align="left" |Über diese Variable setzt das Script, welches Zielschild am Bus zusehen ist und steuert hierüber insbesondere die Fahrgäste. Entspricht wie ''AI_target_index'' dem Index der Reihenfolge in der Hof-Datei.<br />
| align="left" |-<br />
| align="left" |<br />
|-<br />
| align="left" |AI_Scheduled_AtStation<br />
| align="left" |Nur KI-Fahrzeuge, bidirektionale Kommunikation: Bei Erreichen einer Station setzt OMSI den Wert auf 1, sodass das Script mitgeteilt bekommt, dass die Türen geöffnet werden sollen. Wenn sich der Bus abfahrbereit machen soll, setzt OMSI den Wert auf -1. Wenn der Bus abfahrbereit ist (Türen geschlossen usw.), dann setzt das Script den Wert auf 0, sodass die KI den Bus weiterfahren lassen kann.<br />
| align="left" |-1: Bus abfahrbereit machen, 0: Bus ist abfahrbereit, 1: Türen freigeben/öffnen<br />
| align="left" |(X)<br />
|-<br />
| align="left" |AI<br />
| align="left" |Hierüber erfährt das Script, ob das Fahrzeug von der AI gesteuert wird.<br />
| align="left" |0: nein, 1: ja<br />
| align="left" |X<br />
|-<br />
| align="left" |PAX_Entry0_Open ... ~7_Open<br />
| align="left" |Teilt OMSI mit, ob die jeweiligen Eingänge offen oder geschlossen sind.<br />
| align="left" |0: geschlossen, 1: offen<br />
| align="left" |<br />
|-<br />
| align="left" |PAX_Exit0_Open<br />
| align="left" |Teilt OMSI mit, ob die jeweiligen Ausgänge offen oder geschlossen sind.<br />
| align="left" |0: geschlossen, 1: offen<br />
| align="left" |<br />
|-<br />
| align="left" |GivenTicket<br />
| align="left" |Teilt OMSI mit, ob der ggf. vorhandene Fahrscheinautomat ein Ticket ausgegeben hat.<br />
| align="left" |-1: kein Ticket, 0: Tickettyp 0, 1: Tickettyp 1, ...<br />
| align="left" |<br />
|-<br />
| align="left" |humans_count<br />
| align="left" |Anzahl der Fahrgäste im Fahrzeug<br />
| align="left" |-<br />
| align="left" |X<br />
|-<br />
| align="left" |FF_Vib_Period<br />
| align="left" |Setzt die Force-Feedback-Vibrationsperiode im Lenkrad<br />
| align="left" |s<br />
| align="left" |<br />
|-<br />
| align="left" |FF_Vib_Amp<br />
| align="left" |Setzt die Force-Feedback-Vibrationsamplitude im Lenkrad<br />
| align="left" |0...1<br />
| align="left" |<br />
|-<br />
| align="left" |Snd_OutsideVol<br />
| align="left" |Teilt OMSI mit, wie stark der Außensound im Innenraum hörbar ist; verändert sich bspw. wenn eine Tür geöffnet wird.<br />
| align="left" |0: kaum hörbar, 1: wie draußen<br />
| align="left" |<br />
|-<br />
| align="left" |Snd_Microphone<br />
| align="left" |Soll das (Hardware-)Mikrofon aktiv sein?<br />
| align="left" |0: aus, 1: an<br />
| align="left" |<br />
|-<br />
| align="left" |Snd_Radio<br />
| align="left" |Soll das (Internet-)Radio laufen?<br />
| align="left" |0: aus, 1: an<br />
| align="left" |<br />
|-<br />
| align="left" |Cabinair_Temp<br />
| align="left" |Innenraumtemperatur für die Beurteilung durch die Fahrgäste<br />
| align="left" |°C<br />
| align="left" |<br />
|-<br />
| align="left" |Cabinair_absHum<br />
| align="left" |[http://de.wikipedia.org/wiki/Luftfeuchtigkeit#Absolute_Luftfeuchtigkeit Absolute Luftfeuchtigkeit] im Innenraum für die Beurteilung durch die Fahrgäste<br />
| align="left" |g/m³<br />
| align="left" |<br />
|-<br />
| align="left" |Cabinair_relHum<br />
| align="left" |[http://de.wikipedia.org/wiki/Luftfeuchtigkeit#Relative_Luftfeuchtigkeit Relative Luftfeuchtigkeit] im Innenraum, wird durch OMSI automatisch über die absolute Feuchtigkeit und die Innentemperatur berechnet.<br />
| align="left" |0 = 0%, 1 = 100%<br />
| align="left" |X<br />
|-<br />
| align="left" |PrecipRate<br />
| align="left" |Niederschlagsrate<br />
| align="left" |0 = kein, 1 = maximal<br />
| align="left" |X<br />
|-<br />
| align="left" |PrecipType<br />
| align="left" |Niederschlagstyp<br />
| align="left" |0 = kein, 1 = Regen, 2 = Schnee<br />
| align="left" |X<br />
|-<br />
| align="left" |Dirt_Norm<br />
| align="left" |allgemeiner Verdreckungszustand (Windschutzscheiben können sauberer sein und werden nur vom Script simuliert)<br />
| align="left" |0 = sauber, 1 = total verdreckt<br />
| align="left" |X<br />
|-<br />
| align="left" |DirtRate<br />
| align="left" |aktuelle Verdreckungsrate<br />
| align="left" |Verdreckung / s, wobei eine Verdreckung = 1 bedeutet, dass die Verdreckung maximal ist.<br />
| align="left" |X<br />
|-<br />
| align="left" |schedule_active<br />
| align="left" |Ist gerade ein Fahrplan aktiv? (Bspw. für Einblendung der Fahrplankarte)<br />
| align="left" |0: nein, 1: ja<br />
| align="left" |X<br />
|-<br />
| align="left" |train_frontcoupling<br />
| align="left" |Ist an der vorderen Kupplung etwas angekuppelt? (Eventuell spätere Benutzung zum Abkuppeln)<br />
| align="left" |0: nein, 1: ja<br />
| align="left" |X<br />
|-<br />
| align="left" |train_backcoupling<br />
| align="left" |Ist an der hinteren Kupplung etwas angekuppelt? (Eventuell spätere Benutzung zum Abkuppeln)<br />
| align="left" |0: nein, 1: ja<br />
| align="left" |X<br />
|-<br />
| align="left" |train_me_reverse<br />
| align="left" |Steht dieses Fahrzeug rückwärts zum gesamten Fahrzeugverband?<br />
| align="left" |0: nein, 1: ja<br />
| align="left" |X<br />
|}<br />
<br />
<nowiki>*) Bidirektionale KI-Variablen: Handelt es sich um ein Userfahrzeug, kann das Script dem Hauptprogramm mitteilen, wie Licht, Blinker usw. gesetzt wurden. Handelt es sich aber um ein KI-Fahrzeug, teilt OMSI dem Script mit, wie die entsprechenden Zustände gesetzt werden müssen.</nowiki><br />
<br />
==== Stringvariablen ====<br />
<br />
Siehe bitte auch Datei ''program\stringvarlist_roadvehicle.txt''!<br />
<br />
{| class="wikitable" style="font-size:95%;" <br />
|- class="hintergrundfarbe5"<br />
| align="left" |''Variablenname''<br />
| align="left" |''Beschreibung''<br />
| align="left" |''kein Schreibzugriff''<br />
|-<br />
| align="left" |ident<br />
| align="left" |Enthält das Kraftfahrzeugkennzeichen dieses Fahrzeugs (z.B. "B-V 3503")<br />
| align="left" |X<br />
|-<br />
| align="left" |number<br />
| align="left" |Enthält die Fahrzeugnummer (z.B. "3503")<br />
| align="left" |X<br />
|-<br />
| align="left" |act_route<br />
| align="left" |''(keine Verwendung)''<br />
| align="left" |<br />
|-<br />
| align="left" |act_busstop<br />
| align="left" |Wird zusammen mit dem internen Trigger ''ai_scheduled_setbusstop'' verwendet: Enthält dann den Namen der im Fahrplansystem aktiven Haltestelle.<br />
| align="left" |X<br />
|-<br />
| align="left" |SetLineTo<br />
| align="left" |Wird zusammen mit dem internen Trigger ''ai_scheduled_settarget'' verwendet: Enthält die einzustellende Liniennummer (oder Symbol) (bei Verwendung vom Zielschild-Menü oder beim Umschildern von KI-Bussen)<br />
| align="left" |X<br />
|-<br />
| align="left" |yard<br />
| align="left" |Name der Hofdatei des Fahrzeuges, bspw. damit das Scriptsystem den Dateinamen der Zielcode-Tabelle generieren kann.<br />
| align="left" |X<br />
|-<br />
| align="left" |file_schedule<br />
| align="left" |Enthält den Dateinamen der Fahrplan-Bitmap, die zu der von diesem Fahrzeug gefahrenen Strecke gehört.<br />
| align="left" |X<br />
|}<br />
<br />
=== Menschen ===<br />
<br />
Siehe bitte auch Datei ''program\varlist_human.txt''!<br />
<br />
{| class="wikitable" style="font-size:95%;" <br />
|- class="hintergrundfarbe5"<br />
| align="left" |''Variablenname''<br />
| align="left" |''Beschreibung''<br />
| align="left" |''Einheit''<br />
| align="left" |''kein Schreibzugriff''<br />
|-<br />
| align="left" |LastMovedDist<br />
| align="left" |Entfernung, die der Mensch seit dem letzten Durchlauf zurückgelegt hat. Wurde für die alten Animationen gebraucht.<br />
| align="left" |m<br />
| align="left" |X<br />
|-<br />
| align="left" |PAX_State<br />
| align="left" |Zustand des Menschens. Wurde für die alten Animationen gebraucht.<br />
| align="left" |0: stehen, 1: gehen, 2: sitzen<br />
| align="left" |X<br />
|-<br />
| align="left" |HeightOfSeat<br />
| align="left" |Höhe des Sitzes. Diese Eigenschaft wird in der Sitzposition gebraucht, um die Höhe der Füße korrekt gesetzt. Wurde für die alten Animationen gebraucht.<br />
| align="left" |m<br />
| align="left" |X<br />
|-<br />
| align="left" |Colorscheme<br />
| align="left" |Tauschtextur-Index ("Farbschema") des Menschens.<br />
| align="left" |-<br />
| align="left" |X<br />
|}<br />
<br />
[[Kategorie:Nachschlagewerk für Addon-Entwickler]]</div>Marcel Kuhnthttp://wiki.omnibussimulator.de/omsiwikineu.de/index.php?title=Scriptsystem&diff=868Scriptsystem2014-02-11T15:26:44Z<p>Marcel Kuhnt: /* Variablenzugriff */</p>
<hr />
<div>''Hinweis: Dieser Artikel wurde noch nicht ins Englische übersetzt!''<br />
<br />
''OMSI-Version: 1.0 - 2.0''<br />
<br />
Das Scriptsystem in OMSI ermöglicht es, dass Szenerieobjekte und vor allem Fahrzeuge mit individuellen Systemen ausgestattet werden können, die über Variablen und Funktionsaufrufe mit dem Hauptprogramm und der Grafik- und Soundengine kommunizieren.<br />
<br />
Der hier beschriebene Stand des Scriptsystems entspricht OMSI Version 1.01.<br />
<br />
== Dateien des Scriptsystems ==<br />
<br />
Das Scriptsystem umfasst folgende Dateien:<br />
<br />
* Scriptdateien mit ausführbarem Code (*.osc)<br />
* Varlist- und Stringvarlist-Dateien im OMSI\program-Verzeichnis zur Definition von Systemdateien und vordefinierten Dateien<br />
* Varlist- und Stringvarlist-Dateien zur Definition von Uservariablen<br />
* Constfile-Dateien zur Definition von Userkonstanten und Funktionstabellen<br />
<br />
Abgesehen von den Dateien zur Definition von Systemvariablen müssen alle benötigten Dateien für jedes Fahrzeug/Szenerieobjekt (im folgenden kurz: Objekt) in dessen [[Konfigurationsdatei]] angemeldet werden.<br />
<br />
Hierfür gibt es die Befehle ''[script]'', ''[varnamelist]'', ''[stringvarnamelist]'' und ''[constfile]''. Der erste Eintrag jedes Befehls ist die Anzahl der Dateien, darauf folgen die entsprechenden Dateinamen (inkl. Pfad relativ zur Konfigurationsdatei. Die Namen der Dateien sind nicht relevant, solange sie korrekt in die Listen eingetragen werden.<br />
<br />
Auf die Funktion der jeweiligen Dateien wird im Laufe der Beschreibung der Scriptsprache eingegangen.<br />
<br />
== Grundlagen der Scriptsprache ==<br />
<br />
Das OMSI-Scriptsystem arbeitet mit der [http://de.wikipedia.org/wiki/Umgekehrte_Polnische_Notation umgekehrten Polnischen Notation]. Hierbei steht der Operator hinter den beiden Operanden; vereinfacht gesagt bedeutet es, dass die Operation " 1 + 2 " stattdessen folgendermaßen notiert wird: " 1 2 + ". Ein komplizierteres Beispiel: " (1 + 2) * (4 + 5) " entspricht " 1 2 + 4 5 + * ".<br />
<br />
Ganz wichtig ist die Tatsache, dass die OMSI-Textdateien und insbesondere die Scriptsprache [http://de.wikipedia.org/wiki/Case_sensitivity Case-Sensitive] ist! D.h. es ist immer auf die Groß- und Kleinschreibung zu achten!<br />
<br />
=== Stack und Register ===<br />
<br />
Bei der Verarbeitung der Scripts verfügt OMSI über einen String-Stack und einen [http://de.wikipedia.org/wiki/Stapelspeicher Stack] für [http://de.wikipedia.org/wiki/Gleitkommazahl Gleitkommazahlen]. Im folgenden ist mit "Stack" immer der Stack für Gleitkommazahlen gemeint, andernfalls wird von "String-Stack" gesprochen.<br />
<br />
Beide Stacks enthält 8 Speicherplätze, welche von 0 bis 7 durchnumeriert sind. Jede Script-Operation kann nun einen oder mehrere neue Werte in einen der Stacks einfügen (push), wobei der neue Wert auf die Position 0 gesetzt wird und alle folgenden Werte "einen Platz aufrücken", oder sie kann einen oder mehrere Werte aus dem Stack herausziehen (pop/pull) oder lediglich auslesen (peek).<br />
<br />
Fürs temporäre Ablegen von Zahlen gibt es zusätzlich acht indizierte Speicherplätze, welche direkt geschrieben oder gelesen werden können, die sich im sogenannten Register befinden - hier gibt es jedoch nur einen Register für die Gleitkommazahlen.<br />
<br />
=== Beispiel-Operationen ===<br />
<br />
Beispiel: Die Operation 1 + 4. Der Code hierfür lautet:<br />
<br />
<pre><br />
1 4 +<br />
</pre><br />
<br />
In der folgenden Tabelle wird demonstriert, wie sich hierbei der Stack verhält:<br />
<br />
<pre><br />
Operation: Stack: 0 1 2 3 4 ...<br />
-----------------------------------------------------------------------------<br />
vorher: 0 0 0 0 0<br />
"1" 1 0 0 0 0<br />
"4" 4 1 0 0 0<br />
"+" 5 0 0 0 0<br />
</pre><br />
<br />
Im Ausgangszustand ist der Stack nur mit Nullen (oder unbekannten/zufälligen Werten) gefüllt. Der Befehl "1" schiebt die Eins in den obersten Stackplatz und schiebt alle weiteren Werte (Nullen) nach hinten. Der Befehl "4" schiebt die Vier auf den 0. Platz und alle folgenden Werte, also insbesondere die Eins auf den jeweils nächsten Platz. Im nächsten Schritt "+" werden die obersten beiden Werte aus dem Stack herausgezogen - also 4 und 1 - und summiert. Das Ergebnis (5) wird wiederum in den Stack geschoben. Die beiden ursprünglichen Zahlen sind im Stack nicht mehr vorhanden.<br />
<br />
Ein zweites Beispiel:<br />
<br />
(1 + 2) * (4 + 5) muss wie bereits erwähnt folgendermaßen notiert werden:<br />
<br />
<pre><br />
1 2 + 4 5 + *<br />
</pre><br />
<br />
Der Stack verhält sich somit folgendermaßen:<br />
<br />
<pre><br />
Operation: Stack: 0 1 2 3 4 ...<br />
-----------------------------------------------------------------------------<br />
vorher: 0 0 0 0 0<br />
"1" 1 0 0 0 0<br />
"2" 2 1 0 0 0<br />
"+" 3 0 0 0 0<br />
"4" 4 3 0 0 0<br />
"5" 5 4 3 0 0<br />
"+" 9 3 0 0 0<br />
"*" 27 0 0 0 0<br />
</pre><br />
<br />
Am Ende befindet sich also das korrekte Ergebnis auf Stackplatz 0!<br />
<br />
=== Gleitkommazahlen und Strings ===<br />
<br />
Das OMSI-Skriptsystem arbeitet ausschließlich mit den Datentypen Gleitkommazahl (einfache Präzision mit Vorzeichen) und String. Beide Datentypen haben getrennte Stacks. Deshalb laufen die Verarbeitung von Gleitkommazahlen und Strings im Allgemeinen unabhängig nebeneinander. Jedoch kann es natürlich vorkommen, dass bestimmte Funktionen z.B. Zahlen in Strings umwandeln und somit gleichzeitig auf beide Teilbereiche zugreifen.<br />
<br />
Auf boolische Variablen wurde verzichtet. Für boolische Werte werden im Allgemeinen die Zahlenwerte 0 und 1 verwendet.<br />
<br />
== Script-Schlüsselwörter ==<br />
<br />
=== Kommentare ===<br />
<br />
Kommentierungen sind nur möglich, indem in der auszukommentierenden Zeile ganz vorne ein Apostroph ['] gesetzt wird:<br />
<br />
<pre><br />
'Ich bin eine Kommentarzeile<br />
'Ich bin KEINE Kommentarzeile!<br />
</pre><br />
<br />
=== Einstiegs- und Ausstiegspunkte, Makros und Trigger ===<br />
<br />
Alle Befehle müssen zwischen einem Einstiegs- und einem Ausstiegspunkt liegen.<br />
<br />
Der Einstiegspunkt wird durch eins der folgenden Schlüsselwörter gekennzeichnet:<br />
<br />
* {frame} Im Laufe jedes Frames ruft OMSI über diesen Einstiegspunkt die frameweise Scriptverarbeitung auf, sofern er vorhanden ist.<br />
* {init} Bei der Initialisierung ruft OMSI über diesen Einstiegspunkt die Script-Initialisierung auf.<br />
* {frame_ai} Hierbei handelt es sich um eine Variante des {frame}-Einstiegspunktes, welcher bei Fahrzeugen dann aufgerufen wird, wenn diese nicht im Fokus des Benutzers stehen, z.B. wenn sie als KI-Fahrzeug unterwegs sind. Ist dieser Einstiegspunkt jedoch nicht vorhanden sondern nur {frame}, dann wird dieser alternativ aufgerufen. Bei Szenerieobjekten kommt dieser Eintrittspunkt nicht zur Anwendung.<br />
* {macro:''name''} Dieser Einstiegspunkt ruft ein Subsektion (Makro) auf, welche '''stets nach dem Aufruf''' definiert werden muss.<br />
* {trigger:''name''} Dieser Einstiegspunkt wird vom Hauptprogramm aufgerufen, wenn der Benutzer die Tastenkombination oder das Maus-Event mit der Bezeichnung ''name'' aufruft - es gibt auch bestimmte Trigger, die direkt vom Hauptprogramm aufgerufen werden, z.B. wenn OMSI bei KI-Bussen die Anzeige wechselt u.Ä.<br />
<br />
{end} ist der universelle Ausstiegspunkt. Er muss stets den Block abschließen, der mit einem der obigen Befehle eröffnet wird.<br />
<br />
==== Makroaufruf ====<br />
<br />
Der Aufruf eines Makros erfolgt über (M.L.''name''). Der Aufruf des Makros muss ''immer'' vor dessen Definition erfolgen. Andernfalls meldet OMSI, dass das Makro nicht gefunden wurde.<br />
<br />
==== Aufteilung des Scripts in mehrere Dateien ====<br />
<br />
Bei einfachen Scripts (z.B. bei reinen KI-Fahrzeugen oder Szenerieobjekten) reicht es im Allgemeinen eine *.sco-Datei zu erstellen, welche über einen {frame}...{end}- und ggf. einen {init}...{end}-Block verfügt.<br />
<br />
Handelt es sich jedoch um ein komplettes Fahrzeugscript, dann empfiehlt es sich für die verschiedenen Subsysteme getrennte Dateien anzulegen. Hierbei sollte folgendermaßen vorgegangen werden:<br />
<br />
* Es gibt ein Hauptscript und die nötigen Subsystemdateien. Die Hauptdatei enthält dabei die {frame}- und {init}-Blöcke, die jedoch nur Makros aufrufen, welche in den Subsystemdateien definiert sind.<br />
* Für jedes Subsystem gibt es eine *.sco-Datei und je nach Bedarf eine eigene Varlist und Constfile mit den zum System gehörenden Variablen. Außerdem werden auch hier die Trigger für die Tastenbefehle einsortiert.<br />
* Die Makros sollten sinnvollerweise folgendermaßen benannt werden: {macro:''subsystem''_frame} und {macro:''subsystem''_init}.<br />
* Damit die Makros vom Hauptscript aufgerufen werden, muss dieses in der Liste der Scripts in der Objekt-Konfigurationsdatei als erstes aufgerufen werden. Die Reihenfolge der Scripts untereinander muss ebenfalls so gewählt werden, dass alle dateiübergreifenden Makroaufrufe stets vor der jeweiligen Makrodefinition stehen.<br />
<br />
Die Einschränkung, dass Makros immer hinter dem Aufruf definiert werden müssen, kann zwar bisweilen hinderlich sein, ist aber ein sehr wirksamer Schutz gegen Zirkelschlüsse und Endlosschleifen.<br />
<br />
==== Trigger ====<br />
<br />
Wie schon geschrieben wurde, kann ein {trigger:''name''}...{end}-Abschnitt durch verschiedene Möglichkeiten aus dem Hauptprogramm heraus aufgerufen werden. Hierzu zählen:<br />
<br />
* Auslösung per Tastatur. Wurde die Tastenkombination mit dem Namen ''tastkomb'' bezeichnet, wird {trigger:tastkomb} aufgerufen, wenn die Taste gedrückt wird und {trigger:tastkomb_off}, wenn die Taste losgelassen wird.<br />
* Auslösung per Maus. Wurde ein Mesh angeklickt mit der [mouseevent]-Bezeichnung ''mouse_ev'', so wird {trigger:mouse_ev} aufgerufen, wenn die Maustaste gedrückt wird, {trigger:mouse_ev_drag}, während die Maustaste gehalten wird und {trigger:mouse_ev_off}, wenn die Maustaste losgelassen wird.<br />
* Außerdem gibt es noch eine Reihe von [[System-Trigger|System-Triggern]].<br />
<br />
=== Operationen ===<br />
<br />
==== Stack-Operationen ====<br />
<br />
{| class="wikitable" style="font-size:95%;" <br />
|- class="hintergrundfarbe5"<br />
| align="left" |%stackdump%<br />
| align="left" |Gibt eine Dialogbox mit dem Gleitkomma-Stackinhalt aus. Sollte deshalb natürlich nur zu Debug-Zwecken eingesetzt werden.<br />
|-<br />
| align="left" |s0, s1, ..., s7<br />
| align="left" |Speichern des aktuellen Stackwertes im durch die Ziffer angegebenen Register. Der Wert verbleibt hierbei im Stack<br />
|-<br />
| align="left" |l0, l1, ..., l7<br />
| align="left" |Laden des entsprechenden Registerwertes und Verschiebung in den Stack. Registerwert bleibt erhalten.<br />
|-<br />
| align="left" |d<br />
| align="left" |Dubliziert den obersten Stackwert; alle weiteren Stackwerte rücken nach hinten.<br />
|-<br />
| align="left" |$msg<br />
| align="left" |Schreibt den obersten String-Stack-Wert in die Debug-Zeile von OMSI - egal, ob es sich um ein User-, KI-Fahrzeug oder Szenerieobjekt handelt.<br />
|-<br />
| align="left" |$d<br />
| align="left" |Dubliziert den Stringstack-Wert analog zu "d".<br />
|}<br />
<br />
==== Logische Operationen ====<br />
<br />
Die logischen Operationen arbeiten nach dem Prinzip 0 = FALSE, alles andere ist TRUE.<br />
<br />
{| class="wikitable" style="font-size:95%;" <br />
|- class="hintergrundfarbe5"<br />
| align="left" |&&<br />
| align="left" |UND, d.h. wenn einer der beiden obersten Stackwerte gleich 0 ist, ist das Ergbnis 0, sonst 1.<br />
|-<br />
| align="left" |<nowiki>||</nowiki><br />
| align="left" |ODER<br />
|-<br />
| align="left" |<nowiki>!</nowiki><br />
| align="left" |Verneinung<br />
|}<br />
<br />
==== Vergleichsoperationen ====<br />
<br />
Die Vergleichsoperationen vergleichen die Werte in den beiden jeweils obersten Stackplätzen und fügen dann je nach Ergebnis eine "1" oder "0" im obersten Stackplatz ein. Die Größer-/Kleinerzeichen stehen dabei entsprechend für der Reihenfolge, in der die Werte zuvor angegeben wurden. Das bedeutet:<br />
<br />
4 2 > ist wahr, weil die intern durchgeführte Operation in diesem Fall "4 > 2" ist.<br />
<br />
{| class="wikitable" style="font-size:95%;" <br />
|- class="hintergrundfarbe5"<br />
| align="left" |=<br />
| align="left" |"1", falls die obersten Stackwerte identisch sind, sonst "0".<br />
|-<br />
| align="left" |<<br />
| align="left" |"1", falls Stackwert 1 kleiner ist als Stackwert 0, sonst "0".<br />
|-<br />
| align="left" |><br />
| align="left" |... größer ist ...<br />
|-<br />
| align="left" |<=<br />
| align="left" |... kleiner als oder gleich ist ...<br />
|-<br />
| align="left" |>=<br />
| align="left" |... größer als oder gleich ist ...<br />
|-<br />
| align="left" |$=<br />
| align="left" |Wie "=" nur für die obersten beiden Stringstack-Plätze.<br />
|-<br />
| align="left" |$<<br />
| align="left" |Kleiner als (String). Die Ungleich-Operationen bei Strings prüfen auf alphabetische Reihenfolge. "A" ist also kleiner als "B".<br />
|-<br />
| align="left" |$><br />
| align="left" |Größer als (String).<br />
|-<br />
| align="left" |$<=<br />
| align="left" |Kleiner oder gleich (String).<br />
|-<br />
| align="left" |$>=<br />
| align="left" |Größer oder gleich (String).<br />
|}<br />
<br />
==== Mathematische Operationen ====<br />
<br />
{| class="wikitable" style="font-size:95%;" <br />
|- class="hintergrundfarbe5"<br />
| align="left" |+<br />
| align="left" |Plus<br />
|-<br />
| align="left" |-<br />
| align="left" |Minus (Stackplatz 1 - Stackplatz 0, also vom Prinzip her wie bei den Größer/Kleiner-Operationen)<br />
|-<br />
| align="left" |*<br />
| align="left" |Mal<br />
|-<br />
| align="left" |/<br />
| align="left" |geteilt (Stackplatz 1 / Stackplatz 0)<br />
|-<br />
| align="left" |%<br />
| align="left" |Rest der Division (folgendermaßen erweitert für Gleitkommazahlen: Stack0 - trunc(Stack1 / Stack0) * Stack1 )<br />
|-<br />
| align="left" |/-/<br />
| align="left" |Vorzeichenwechsel<br />
|-<br />
| align="left" |sin<br />
| align="left" |Sinus<br />
|-<br />
| align="left" |arcsin<br />
| align="left" |Umkehrfunktion zum Sinus ''(ab OMSI2)''<br />
|-<br />
| align="left" |arctan<br />
| align="left" |Umkehrfunktion zum Tangens ''(ab OMSI2)''<br />
|-<br />
| align="left" |min<br />
| align="left" |Wahl des kleineren der beiden obersten Stackwerte<br />
|-<br />
| align="left" |max<br />
| align="left" |Wahl des größeren der beiden obersten Stackwerte<br />
|-<br />
| align="left" |exp<br />
| align="left" |Exponentialfunktion zur Basis e (e^Stack0)<br />
|-<br />
| align="left" |sqrt<br />
| align="left" |Quadratwurzel<br />
|-<br />
| align="left" |sqr<br />
| align="left" |Quadrat<br />
|-<br />
| align="left" |sgn<br />
| align="left" |Rückgabe des Vorzeichens; je nachdem entweder -1, 0 oder 1<br />
|-<br />
| align="left" |pi<br />
| align="left" |Kreiszahl pi<br />
|-<br />
| align="left" |random<br />
| align="left" |ganzzahlige Zufallszahl 0 <= x < Stack0<br />
|-<br />
| align="left" |abs<br />
| align="left" |Rückgabe des Absolutwertes<br />
|-<br />
| align="left" |trunc<br />
| align="left" |Abrunden auf nächste ganze Zahl<br />
|}<br />
<br />
==== String-Operationen ====<br />
<br />
{| class="wikitable" style="font-size:95%;" <br />
|- class="hintergrundfarbe5"<br />
| align="left" |"''bla''"<br />
| align="left" |Einfügen des Strings ''bla'' auf dem obersten String-Stack-Platz<br />
|-<br />
| align="left" |$+<br />
| align="left" |Zusammenfügen zweier Strings. "Omnibus" "simulator" $+ ergibt "Omnibussimulator"<br />
|-<br />
| align="left" |$*<br />
| align="left" |Der oberste Stack-String wird sooft wiederholt, bis die resultierende Zeichenlänger gerade noch kleiner oder gleich des obersten Stackwertes ist. Beispiel: "nu" 6 $* ergibt "nununu"<br />
|-<br />
| align="left" |$length<br />
| align="left" |Gibt die Anzahl der Zeichen des obersten Stack-String zurück in den Stack. <br />
|-<br />
| align="left" |$cutBegin<br />
| align="left" |Schneidet ''stack0'' Zeichen vorne vom obersten Stack-String ab.<br />
|-<br />
| align="left" |$cutEnd<br />
| align="left" |Schneidet ''stack0'' Zeichen hinten vom obersten Stack-String ab.<br />
|-<br />
| align="left" |$SetLengthR<br />
| align="left" |Passt die Länge des obersten Stack-Strings auf ''stack0'' rechtsbündig an, indem am Anfang Zeichen entfernt oder Leerzeichen ergänzt werden.<br />
Achtung: Der Befehl entfernt den Float-Operator nicht vom Stack. Der Wert, auf dessen Länge der String gekürzt wurde, verbleibt also auf Stack0.<br />
|-<br />
| align="left" |$SetLengthC<br />
| align="left" |Passt die Länge des obersten Stack-Strings auf ''stack0'' zentriert an, indem am Anfang und am Ende Zeichen entfernt oder Leerzeichen ergänzt werden ''(ab OMSI2)''.<br />
Achtung: Der Befehl entfernt den Float-Operator nicht vom Stack. Der Wert, auf dessen Länge der String gekürzt wurde, verbleibt also auf Stack0.<br />
|-<br />
| align="left" |$SetLengthL<br />
| align="left" |Passt die Länge des obersten Stack-Strings auf ''stack0'' linksbündig an, indem am Ende Zeichen entfernt oder Leerzeichen ergänzt werden.<br />
Achtung: Der Befehl entfernt den Float-Operator nicht vom Stack. Der Wert, auf dessen Länge der String gekürzt wurde, verbleibt also auf Stack0.<br />
|-<br />
| align="left" |$IntToStr<br />
| align="left" |Rundet ''stack0'' ab und wandelt die resultierende Ganzzahl um in einen String.<br />
|-<br />
| align="left" |$IntToStrEnh<br />
| align="left" |Die erweiterte Version von IntToStr. Hierbei wird der oberste Stack-String verwendet, um das Format der String-Umwandlung zu bestimmen: Das erste Zeichen im String wird zum Auffüllen der fehlenden Zeichen verwendet, die folgenden Zeichen müssen eine Zahl ergeben, die die Stellen angibt. Beispiel: 35 " 5" $IntToStrEnh führt zu " 35" und 123456789 "011" $IntToStrEnh führt zu "00123456789". Falls ein Fehler vorliegt, wird "ERROR" ausgegeben.<br />
|-<br />
| align="left" |$StrToFloat<br />
| align="left" |Wandelt den obersten Stack-String in eine Gleitkommazahl um, falls möglich. Andernfalls wird eine -1 geschrieben.<br />
|-<br />
| align="left" |$RemoveSpaces<br />
| align="left" |Entfernt sämtliche Leerzeichen vor und nach dem eigentlichen String. Aus " Spandau Freudstr " wird "Spandau Freudstr" ''(ab OMSI2)''.<br />
|-<br />
|}<br />
<br />
=== Variablenzugriff ===<br />
<br />
Es wird unterschieden in Systemvariablen und in lokale Variablen. Die Systemvariablen gelten OMSI-weit, die lokalen Variablen werden zum Fahrzeug/Objekt zugehörig gespeichert.<br />
<br />
Bei den lokalen Variablen gibt es stets einen Grundstamm an Variablen, welcher von OMSI vordefiniert werden. Darüber hinaus können beliebig viele Variablen mit Hilfe der Varlist-Dateien ergänzt werden. Außerdem gibt es seit OMSI2 die Variante, dass man die Variable zwar selbst definieren muss, sie dann aber trotzdem mit einem OMSI-Internen Zustand verbunden wird ("on-demand-vordefinierte Variablen").<br />
<br />
{| class="wikitable" style="font-size:95%;" <br />
|- class="hintergrundfarbe5"<br />
| align="left" |(L.S.''varname'')<br />
| align="left" |Lädt die Systemvariable ''varname'' in den obersten Stackplatz<br />
|-<br />
| align="left" |(L.L.''varname'')<br />
| align="left" |Lädt die lokale Variable ''varname'' in den obersten Stackplatz<br />
|-<br />
| align="left" |(L.$.''varname'')<br />
| align="left" |Lädt die lokale String-Variable ''varname'' in den obersten String-Stackplatz<br />
|-<br />
| align="left" |(S.L.''varname'')<br />
| align="left" |Speichert den obersten Stackplatz in die lokale Variable ''varname''<br />
|-<br />
| align="left" |(S.$.''varname'')<br />
| align="left" |Speichert den obersten String-Stackplatz in die lokale String-Variable ''varname''<br />
|}<br />
<br />
Eine detaillierte Beschreibung der einzelnen Systemvariablen und der vordefinierten lokalen Variablen finden Sie hier: [[System- und vordefinierte lokalen Variablen]]<br />
<br />
=== Konstanten und Funktionen ===<br />
<br />
Lokale Konstanten und [http://de.wikipedia.org/w/index.php?title=Datei:Linear_interpolation.svg&filetimestamp=20080226155013 stückweise definierte lineare Funktionen] können in den Konstantendateien (''constfiles'', ''~_constfile.txt'') definiert werden. Der Aufbau jeder Konstantendatei entspricht der der [[Konfigurationsdateien|Konfigurationsdatei]]. Es gibt lediglich drei Schlüsselwörter. Zu beachten ist: Bisher können keine Strings, sondern nur Fließkommazahlen als Konstanten definiert werden.<br />
<br />
[const] definiert eine neue Konstante und gibt ihren Wert an:<br />
<br />
<pre><br />
[const]<br />
name<br />
wert<br />
</pre><br />
<br />
Beispiel:<br />
<br />
<pre><br />
[const]<br />
leistung<br />
200<br />
</pre><br />
<br />
[newcurve] leitet die Definition einer neuen (stückweise linearen) Funktion ein:<br />
<br />
<pre><br />
[newcurve]<br />
name<br />
</pre><br />
<br />
[pnt] fügt der zuvor mit [newcurve] definierten Funktion ein neues x-y-Paar hinzu. Jede Funktion sollte normalerweise über mindestens zwei Paare verfügen. Die Reihenfolge der Paare ''muss'' in x-Richtung aufsteigend sein!<br />
<br />
<pre><br />
[pnt]<br />
x<br />
y<br />
</pre><br />
<br />
Beispiel:<br />
<br />
<pre><br />
[newcurve]<br />
Drehzahl_Drehmoment_Kennlinie<br />
<br />
[pnt]<br />
50<br />
0<br />
<br />
[pnt]<br />
300<br />
400<br />
<br />
[pnt]<br />
1000<br />
600<br />
</pre><br />
<br />
Konstanten werden über den Befehl (C.L.''konstantenname'') in den Stack geladen.<br />
<br />
Funktionen werden über den Befehl (F.L.''funktionsname'') aufgerufen. Dabei wird stets der zuvor auf oberster Stackposition befindliche Wert als x-Parameter übergaben und der resultierende y-Wert der Funktion stattdessen auf dem obersten Stackplatz gespeichert. Bewegt sich der x-Wert außerhalb der Grenzen der durch die [pnt]-Einträge definierten Eckpunkte, wird stets der y-Wert des nächstliegenden Eckpunktes verwendet. Die Funktion wird also vor dem ersten und hinter dem letzten Eckpunkt ins Unendliche waagerecht verlängert.<br />
<br />
=== Sound-Trigger ===<br />
<br />
Soundtrigger sind nicht mit den weiter oben erwähnten Triggern zu verwechseln!<br />
<br />
Sie stellen vielmehr eine Möglichkeit dar, direkt einen gewünschten Sound abzuspielen. Hierbei gibt es zwei Möglichkeiten:<br />
<br />
(T.L.''soundtriggername'') ist ein einfacher Soundtrigger. Der so markierte Sound wird (einmalig) abgespielt.<br />
<br />
(T.F.''soundtriggername'') ist ein Soundtrigger mit Dateiwechselfunktion. Hierbei wird der oberste Stackstring ausgelesen und als Dateiname verwendet, wobei der Dateipfad relativ zum Sound-Ordner des Objektes interpretiert wird.<br />
<br />
Beispiel:<br />
<br />
Angenommen, die Sounddatei lautet "diese.wav" und ist mit dem Trigger ''MeinTrigger'' verknüpft, dann spielt<br />
<br />
(T.L.MeinTrigger)<br />
<br />
die Datei "diese.wav" ab und<br />
<br />
"andere.wav" (T.F.MeinTrigger)<br />
<br />
die Datei "andere.wav". Alternativ zu (T.L.''soundtriggername'') kann beim Befehl (T.F.''soundtriggername'') auch ein "Nullstring" im Stack liegen (also der String: "").<br />
<br />
=== System-Makros ===<br />
<br />
Die bisherigen Methoden erlauben dem Script folgende Kommunikationsmöglichkeiten mit OMSI:<br />
<br />
* Lesen von Werten über System- und vordefinierte lokale Variablen<br />
* Schreiben von Werten über ebendiese<br />
* Empfangen von Tastatur-, Maus- oder Systemtriggern<br />
<br />
Schließlich gibt es noch eine weitere Methode, um mit dem Hauptprogramm zu kommunizieren, die sogenannten System-Makros, gelegentlich auch unpräzise als "Callback-Funktionen" bezeichnet.<br />
<br />
In bestimmten Situationen ist es nötig, dass das Script Werte von OMSI bekommt, die in größeren Datenbanken vorliegen und daher nicht über vordefinierte Variablen übermittelt werden können, z.B. die Inhalte der Hofdatei. Hier kommen nun die System-Makros ins Spiel.<br />
<br />
Diese arbeiten scriptseitig sehr ähnlich wie die lokalen, selbstdefinierten Makros: Der Aufruf (M.V.''macroname'') ruft das System-Makro auf ("V" stand ursprünglich für "Vehicle-Macro", gilt aber genauso auch in Szenerieobjekten), das sich während der Ausführung Werte aus den beiden Stacks holt und/oder in diese schreibt. Eine Aufstellung aller System-Makros findet sich hier: [[System-Makros]]<br />
<br />
=== Bedingungen und Schleifen ===<br />
<br />
Die einzige Steuerung des Programmablaufs ist zur Zeit nur mit der IF-Bedingung möglich.<br />
<br />
==== IF-Bedingung ====<br />
<br />
<pre><br />
'Hier muss eine Bedingung stehen, z.B.:<br />
(L.L.bla) 1 =<br />
{if}<br />
'Dieser Abschnitt wird ausgeführt, wenn bla = 1 ist:<br />
2 3 +<br />
{else}<br />
'Dieser Abschnitt wird andernfalls ausgeführt:<br />
3 4 +<br />
{endif}<br />
(S.L.blub)<br />
{end}<br />
</pre><br />
<br />
Dass erst die Bedingung formuliert wird und dann erst das Schlüsselwort {if} folgt, sollte einleuchten: Zunächst muss an oberster Stelle des Stacks der Wert abgelegt werden und erst dann folgt das Schlüsselwort {if}, welches diesen Wert prüft. Hierbei bedeutet ähnlich wie bei && und || Gleichheit mit Null gleichbedeutend mit ''False'', alle anderen Werte bedeuten ''True''.<br />
<br />
Wenn also im obigen Beispiel ''bla'' den Wert 1 hat, wird ''blub'' auf den Wert 5 gesetzt, andernfalls auf den Wert 7.<br />
<br />
Verschachtelungen der IF-Bedingung dienen als Ersatz für die (nicht vorhandenen) "Else-If"-Konstruktionen:<br />
<br />
<pre><br />
'Hier muss eine Bedingung stehen, z.B.:<br />
(L.L.bla) 1 =<br />
{if}<br />
'Dieser Abschnitt wird ausgeführt, wenn bla = 1 ist:<br />
2 3 +<br />
{else}<br />
(L.L.bla) 5 =<br />
{if}<br />
'Dieser Abschnitt wird ausgeführt, wenn bla = 5 ist:<br />
3 4 +<br />
{else}<br />
'Dieser Abschnitt wird andernfalls ausgeführt:<br />
13<br />
{endif}<br />
{endif}<br />
(S.L.blub)<br />
{end}<br />
</pre><br />
<br />
Hierbei ist insbesondere auf das doppelte {endif} zu achten! Hier gilt:<br />
<br />
* bla = 1 ==> blub = 5<br />
* bla = 5 ==> blub = 7<br />
* sonst ==> blub = 13<br />
<br />
[[Kategorie:Nachschlagewerk für Addon-Entwickler]]</div>Marcel Kuhnthttp://wiki.omnibussimulator.de/omsiwikineu.de/index.php?title=System-_und_vordefinierte_lokalen_Variablen&diff=867System- und vordefinierte lokalen Variablen2014-02-11T15:23:58Z<p>Marcel Kuhnt: /* Systemvariablen */</p>
<hr />
<div>''Hinweis: Dieser Artikel wurde noch nicht ins Englische übersetzt!''<br />
<br />
Beschreibung der System- und der lokalen [[Scriptsystem#Variablenzugriff|Scriptvariablen]], welche für jedes Objekt vordefiniert werden und im Allgemeinen bestimmte Sonderfunktionen gegenüber frei definierten Scriptvariablen übernehmen.<br />
<br />
== Systemvariablen ==<br />
<br />
Siehe bitte auch Datei ''program\varlist_system.txt''!<br />
<br />
{| class="wikitable" style="font-size:95%;" <br />
|- class="hintergrundfarbe5"<br />
| align="left" |''Variablenname''<br />
| align="left" |''Beschreibung''<br />
| align="left" |''Einheit''<br />
| align="left" |''ab OMSI-Vs.''<br />
|-<br />
| align="left" |Timegap<br />
| align="left" |Zeitschritt seit dem letzten Durchlauf (Frame)<br />
| align="left" |Sekunden<br />
| align="left" |1.00<br />
|-<br />
| align="left" |GetTime<br />
| align="left" |Enthält eine absolute Zeitangabe, die vom Beginn des Ausführens von OMSI zählt<br />
| align="left" |Sekunden<br />
| align="left" |1.00<br />
|-<br />
| align="left" |NoSound<br />
| align="left" |Sounds deaktiviert?<br />
| align="left" |0 = Sounds aktiviert, 1 = Sounds deaktiviert<br />
| align="left" |1.00<br />
|-<br />
| align="left" |Pause<br />
| align="left" |Simulations-Pause aktiv?<br />
| align="left" |0 = Simulation läuft, 1 = Simulation angehalten<br />
| align="left" |1.00<br />
|-<br />
| align="left" |Time<br />
| align="left" |Uhrzeit gerechnet von Mitternacht des aktuellen Tages<br />
| align="left" |Sekunden<br />
| align="left" |1.00<br />
|-<br />
| align="left" |Day<br />
| align="left" |Tag gezählt ab Monatsbeginn<br />
| align="left" |Tage<br />
| align="left" |1.00<br />
|-<br />
| align="left" |Month<br />
| align="left" |Monat<br />
| align="left" |Monate<br />
| align="left" |1.00<br />
|-<br />
| align="left" |Year<br />
| align="left" |Jahr<br />
| align="left" |Jahre<br />
| align="left" |1.00<br />
|-<br />
| align="left" |DayOfYear<br />
| align="left" |Tag gezählt ab Jahresbeginn<br />
| align="left" |Tage<br />
| align="left" |1.00<br />
|-<br />
| align="left" |mouse_x<br />
| align="left" |X-Koordinate des Mauszeigers auf dem Bildschirm<br />
| align="left" |Pixel<br />
| align="left" |1.00<br />
|-<br />
| align="left" |mouse_y<br />
| align="left" |Y-Koordinate des Mauszeigers auf dem Bildschirm<br />
| align="left" |Pixel<br />
| align="left" |1.00<br />
|-<br />
| align="left" |PrecipType<br />
| align="left" |Niederschlagstyp<br />
| align="left" |0 = keiner, 1 = Regen, 2 = Schnee<br />
| align="left" |1.00<br />
|-<br />
| align="left" |PrecipRate<br />
| align="left" |Niederschlagstyp<br />
| align="left" |0 = kein Niederschlag, 1 = maximaler Niederschlag<br />
| align="left" |1.00<br />
|-<br />
| align="left" |coll_pos_x<br />
| align="left" |Position der Kollision, x-Richtung relativ zum Fahrzeugursprung (nur bei Auslösung des Kollisions-Triggers)<br />
| align="left" |Meter<br />
| align="left" |1.00<br />
|-<br />
| align="left" |coll_pos_y<br />
| align="left" |Position der Kollision, y-Richtung relativ zum Fahrzeugursprung (nur bei Auslösung des Kollisions-Triggers)<br />
| align="left" |Meter<br />
| align="left" |1.00<br />
|-<br />
| align="left" |coll_pos_z<br />
| align="left" |Position der Kollision, z-Richtung relativ zum Fahrzeugursprung (nur bei Auslösung des Kollisions-Triggers)<br />
| align="left" |Meter<br />
| align="left" |1.00<br />
|-<br />
| align="left" |coll_energy<br />
| align="left" |Energie der Kollision (nur bei Auslösung des Kollisions-Triggers)<br />
| align="left" |Nm<br />
| align="left" |1.00<br />
|-<br />
| align="left" |Weather_Temperature<br />
| align="left" |Außentemperatur<br />
| align="left" |°C<br />
| align="left" |1.00<br />
|-<br />
| align="left" |Weather_AbsHum<br />
| align="left" |Absolute Luftfeuchtigkeit<br />
| align="left" |g/m³<br />
| align="left" |1.00<br />
|-<br />
| align="left" |AutoClutch<br />
| align="left" |Option "automatische Kupplung" aktiviert<br />
| align="left" |0 = aus, 1 = an<br />
| align="left" |1.03<br />
|-<br />
| align="left" |wearlifespan<br />
| align="left" |''nicht nutzen!''<br />
| align="left" |<br />
| align="left" |2.00<br />
|-<br />
| align="left" |SunAlt<br />
| align="left" |Höhenwinkel der Sonne<br />
| align="left" |°<br />
| align="left" |2.00<br />
|}<br />
<br />
== Vordefinierte lokale Variablen ==<br />
<br />
=== Szenerieobjekte ===<br />
<br />
Siehe bitte auch Datei ''program\varlist_scenobj.txt''!<br />
<br />
{| class="wikitable" style="font-size:95%;" <br />
|- class="hintergrundfarbe5"<br />
| align="left" |''Variablenname''<br />
| align="left" |''Beschreibung''<br />
| align="left" |''Einheit''<br />
| align="left" |''kein Schreibzugriff''<br />
|-<br />
| align="left" |NightLightA<br />
| align="left" |Ist die Nachtbeleuchtung aktiv?<br />
| align="left" |0 = aus, 1 = an<br />
| align="left" |X<br />
|-<br />
| align="left" |InUse<br />
| align="left" |Ist das Objekt "aktiv"? Die Sporthallen sind bspw. nur an Schultagen vormittags "aktiv", sodass die Soundeffekte an diese Variable gekoppelt werden können - auf diese Weise wird verhindert, dass die Soundeffekte auch in den Ferien oder nachts zu hören sind.<br />
| align="left" |0 = inaktiv, 1 = aktiv<br />
| align="left" |X<br />
|-<br />
| align="left" |TrafficLightPhase<br />
| align="left" |Hierüber wird Ampelobjekten die anzuzeigende Ampelphase mitgeteilt.<br />
| align="left" |0..2 = rot, 3..5 = rot-gelb, 6..8 = grün, 9..11 = gelb, sonst aus<br />
| align="left" |X<br />
|-<br />
| align="left" |TrafficLightApproach<br />
| align="left" |Hierüber kann das Script eine Ampelanforderung erkennen und bspw. eine Kennleuchte aktiviert werden.<br />
| align="left" |0 = keine Anforderung, 1 = Anforderung<br />
| align="left" |X<br />
|-<br />
| align="left" |Colorscheme<br />
| align="left" |(veraltet)<br />
| align="left" |(-)<br />
| align="left" |X<br />
|-<br />
| align="left" |Signal<br />
| align="left" |Hierüber erhalten Signale ihr anzuzeigendes Signalbild<br />
| align="left" |individuell<br />
| align="left" |X<br />
|-<br />
| align="left" |NextSignal<br />
| align="left" |Hierüber erhalten Signale mit Vorsignalfunktion das anzuzeigende Signalbild des nächsten Signals<br />
| align="left" |individuell<br />
| align="left" |X<br />
|-<br />
| align="left" |Refresh_Strings<br />
| align="left" |Diese Variable muss auf "1" gesetzt werden, damit die Text-Texturen aktualisiert werden! Wird nach erfolgreicher Abarbeitung von OMSI auf 0 gesetzt.<br />
| align="left" |-<br />
| align="left" |<br />
|}<br />
<br />
=== Fahrzeuge ===<br />
<br />
==== Zahlvariablen ====<br />
<br />
Siehe bitte auch Datei ''program\varlist_roadvehicle.txt''!<br />
<br />
{| class="wikitable" style="font-size:95%;" <br />
|- class="hintergrundfarbe5"<br />
| align="left" |''Variablenname''<br />
| align="left" |''Beschreibung''<br />
| align="left" |''Einheit''<br />
| align="left" |''kein Schreibzugriff''<br />
|-<br />
| align="left" |Refresh_Strings<br />
| align="left" |Diese Variable muss auf "1" gesetzt werden, damit die Text-Texturen aktualisiert werden! Wird nach erfolgreicher Abarbeitung von OMSI auf 0 gesetzt.<br />
| align="left" |-<br />
| align="left" |<br />
|-<br />
| align="left" |Envir_Brightness<br />
| align="left" |Umgebungshelligkeit in Fahrzeugnähe<br />
| align="left" |0 = dunkel, 1 = hell<br />
| align="left" |X<br />
|-<br />
| align="left" |StreetCond<br />
| align="left" |Information über die Oberflächenbedingungen<br />
| align="left" |0: Trocken, 0..1: zunehmende Feuchtigkeit, 1: komplett feucht, 1..2: teilweise Pfützen, 2: Fahrzeug komplett in Pfützen<br />
| align="left" |X<br />
|-<br />
| align="left" |Spot_Select<br />
| align="left" |Hierüber kann gesteuert werden, welches fürs Fahrzeug vordefinierte Spotlight aktiv sein soll.<br />
| align="left" |-1: kein Spotlight, 0: Spotlight Nr. 0, 1: Spotlight Nr. 1 usw.<br />
| align="left" |<br />
|-<br />
| align="left" |Colorscheme<br />
| align="left" |Index des gewählten Farbschemas/Anstriches<br />
| align="left" |-<br />
| align="left" |X<br />
|-<br />
| align="left" |M_Wheel<br />
| align="left" |Hierüber kann das Script ein [http://de.wikipedia.org/wiki/Drehmoment Drehmoment] auf die Räder übertragen. Hierbei die Summe anzugeben, welche auf alle als angetrieben ausgewiesene Achsen wirken <br />
soll.<br />
| align="left" |kNm = 1000 [http://de.wikipedia.org/wiki/Newtonmeter Nm]<br />
| align="left" |<br />
|-<br />
| align="left" |n_Wheel<br />
| align="left" |Mittlere Raddrehzahl des Fahrzeuges<br />
| align="left" |Umdrehungen pro Minute<br />
| align="left" |X<br />
|-<br />
| align="left" |Throttle<br />
| align="left" |Stellung des Gaspedals<br />
| align="left" |0..1<br />
| align="left" |X<br />
|-<br />
| align="left" |Brake<br />
| align="left" |Stellung des Bremspedals<br />
| align="left" |0..1<br />
| align="left" |X<br />
|-<br />
| align="left" |Clutch<br />
| align="left" |Stellung des Kupplungspedals<br />
| align="left" |0..1<br />
| align="left" |X<br />
|-<br />
| align="left" |Brakeforce<br />
| align="left" |Hierüber kann das Script die Gesamtbremskraft des Fahrzeuges vorgeben, welche auf die Räder wirkt. Sollte nicht gleichzeitig mit ''Axle_Brakeforce...'' verwendet werden.<br />
| align="left" |[http://de.wikipedia.org/wiki/Newton_(Einheit) N]<br />
| align="left" |<br />
|-<br />
| align="left" |Velocity<br />
| align="left" |Geschwindigkeit, welche sich über die Raddrehung ergibt, entspricht der Tachoanzeige<br />
| align="left" |[http://de.wikipedia.org/wiki/Km/h km/h]<br />
| align="left" |X<br />
|-<br />
| align="left" |Velocity_Ground<br />
| align="left" |Geschwindigkeit, welche direkt relativ zum Grund gemessen wird, berücksichtigt kein Radschleudern oder -blockieren, entspricht der Anzeige auf einem GPS<br />
| align="left" |[http://de.wikipedia.org/wiki/Km/h km/h]<br />
| align="left" |X<br />
|-<br />
| align="left" |tank_percent<br />
| align="left" |Tankinhalt, nur für die Anzeige auf der roten Informationsleiste. Die Betankung und Simulation eines leeren Tanks geschieht über einen Trigger bzw. muss im Script programmiert werden.<br />
| align="left" |0..1<br />
| align="left" |<br />
|-<br />
| align="left" |kmcounter_km<br />
| align="left" |Stand des Kilometerzählers (nur ganze km)<br />
| align="left" |km<br />
| align="left" |X<br />
|-<br />
| align="left" |kmcounter_m<br />
| align="left" |Stand des Kilometerzählers (zusätzliche Meter, läuft stets nur von 0m bis 999m; hinzu kommen die Kilometer von ''kmcounter_km'')<br />
| align="left" |m<br />
| align="left" |X<br />
|-<br />
| align="left" |relrange<br />
| align="left" |Zurückgelegte, relative Strecke. Wurde nur testweise für pfadfixierte Fahrzeuge eingeführt. Nicht benutzen!<br />
| align="left" |---<br />
| align="left" |X<br />
|-<br />
| align="left" |Driver_Seat_VertTransl<br />
| align="left" |Einfederung des federnden Fahrersitzes<br />
| align="left" |m<br />
| align="left" |X<br />
|-<br />
| align="left" |Wheel_Rotation_0_L / ~_R ... ~_3_L / _R<br />
| align="left" |Drehwinkel des jeweiligen Rades, z.B. für die Animation<br />
| align="left" |[http://de.wikipedia.org/wiki/Radiant_(Einheit) rad]<br />
| align="left" |X<br />
|-<br />
| align="left" |Wheel_RotationSpeed_0_L / ~_R ... ~_3_L / _R<br />
| align="left" |Drehzahl des jeweiligen Rades<br />
| align="left" |Umdrehungen pro Minute<br />
| align="left" |X<br />
|-<br />
| align="left" |Axle_Suspension_0_L / ~_R ... ~_3_L / _R<br />
| align="left" |Einfederungsweg des jeweiligen Rades<br />
| align="left" |m<br />
| align="left" |X<br />
|-<br />
| align="left" |Axle_Steering_0_L / ~_R ... ~_3_L / _R<br />
| align="left" |Lenkwinkel des jeweiligen Rades<br />
| align="left" |[http://de.wikipedia.org/wiki/Radiant_(Einheit) rad]<br />
| align="left" |X<br />
|-<br />
| align="left" |Axle_Springfactor_0_L / ~_R ... ~_3_L / _R<br />
| align="left" |Faktor, mit dem radweise die Federstärke angepasst werden kann, z.B. um Luftfederungen zu simulieren.<br />
| align="left" |0 = keine, 1 = normale, 2 = doppelte Federkraft<br />
| align="left" |<br />
|-<br />
| align="left" |Axle_Brakeforce_0_L / ~_R ... ~_3_L / _R<br />
| align="left" |Ermöglicht Setzen der Bremskraft pro Rad. Sollte nicht gleichzeitig mit ''Brakeforce'' verwendet werden!<br />
| align="left" |[http://de.wikipedia.org/wiki/Newton_(Einheit) N]<br />
| align="left" |<br />
|-<br />
| align="left" |Debug_0 ... _5<br />
| align="left" |Debug-Variablen. Können im Debug-Modus in der Informationsleiste angezeigt werden, um auf diese Weise die Scripts zu testen.<br />
| align="left" |bliebig<br />
| align="left" |<br />
|-<br />
| align="left" |A_Trans_X ... _Z<br />
| align="left" |Beschleunigungen im Fahrzeug, die durch die Fahrzeugbewegungen ausgelöst werden (beim Bremsen oder bei Kurvenfahrten usw.)<br />
| align="left" |m/s²<br />
| align="left" |X<br />
|-<br />
| align="left" |AI_Blinker_L, ~_R<br />
| align="left" |Linker oder rechter Blinker aktiv<br />
| align="left" |0: aus, 1: ein<br />
| align="left" |(X)*<br />
|-<br />
| align="left" |AI_Light<br />
| align="left" |Fahrlicht, Standlicht, Lichthupe<br />
| align="left" |0: Licht aus, 0.5: Standlicht an, 1: Fahrlicht an, 2: Fernlicht/Lichthupe an<br />
| align="left" |(X)*<br />
|-<br />
| align="left" |AI_Interiorlight<br />
| align="left" |Innenbeleuchtung. Hierüber erfahren die einsteigenden Fahrgäste auch, ob es im Bus zu dunkel ist (sodass sie meckern dürfen).<br />
| align="left" |0: aus, 1: an<br />
| align="left" |(X)*<br />
|-<br />
| align="left" |AI_Brakelight<br />
| align="left" |Nur für KI-Fahrzeuge: Script soll Bremslicht einschalten<br />
| align="left" |0: aus, 1: an<br />
| align="left" |X<br />
|-<br />
| align="left" |AI_Engine<br />
| align="left" |Nur für KI-Fahrzeuge: Aufforderung zum Ein- oder Ausschalten des Motors<br />
| align="left" |-1: Motor ausschalten!, 0: egal/nicht-KI, 1: Motor einschalten!<br />
| align="left" |X<br />
|-<br />
| align="left" |AI_target_index<br />
| align="left" |Dient der Übergabe des Sollwertes des einzustellenden Zielschildes bei Aufruf des Menüs oder beim Umschildern der KI-Busse. Entspricht der Reihenfolge in der Hof-Datei; erster Eintrag = 0<br />
| align="left" |-<br />
| align="left" |X<br />
|-<br />
| align="left" |target_index_int<br />
| align="left" |Über diese Variable setzt das Script, welches Zielschild am Bus zusehen ist und steuert hierüber insbesondere die Fahrgäste. Entspricht wie ''AI_target_index'' dem Index der Reihenfolge in der Hof-Datei.<br />
| align="left" |-<br />
| align="left" |<br />
|-<br />
| align="left" |AI_Scheduled_AtStation<br />
| align="left" |Nur KI-Fahrzeuge, bidirektionale Kommunikation: Bei Erreichen einer Station setzt OMSI den Wert auf 1, sodass das Script mitgeteilt bekommt, dass die Türen geöffnet werden sollen. Wenn sich der Bus abfahrbereit machen soll, setzt OMSI den Wert auf -1. Wenn der Bus abfahrbereit ist (Türen geschlossen usw.), dann setzt das Script den Wert auf 0, sodass die KI den Bus weiterfahren lassen kann.<br />
| align="left" |-1: Bus abfahrbereit machen, 0: Bus ist abfahrbereit, 1: Türen freigeben/öffnen<br />
| align="left" |(X)<br />
|-<br />
| align="left" |AI<br />
| align="left" |Hierüber erfährt das Script, ob das Fahrzeug von der AI gesteuert wird.<br />
| align="left" |0: nein, 1: ja<br />
| align="left" |X<br />
|-<br />
| align="left" |PAX_Entry0_Open ... ~7_Open<br />
| align="left" |Teilt OMSI mit, ob die jeweiligen Eingänge offen oder geschlossen sind.<br />
| align="left" |0: geschlossen, 1: offen<br />
| align="left" |<br />
|-<br />
| align="left" |PAX_Exit0_Open<br />
| align="left" |Teilt OMSI mit, ob die jeweiligen Ausgänge offen oder geschlossen sind.<br />
| align="left" |0: geschlossen, 1: offen<br />
| align="left" |<br />
|-<br />
| align="left" |GivenTicket<br />
| align="left" |Teilt OMSI mit, ob der ggf. vorhandene Fahrscheinautomat ein Ticket ausgegeben hat.<br />
| align="left" |-1: kein Ticket, 0: Tickettyp 0, 1: Tickettyp 1, ...<br />
| align="left" |<br />
|-<br />
| align="left" |humans_count<br />
| align="left" |Anzahl der Fahrgäste im Fahrzeug<br />
| align="left" |-<br />
| align="left" |X<br />
|-<br />
| align="left" |FF_Vib_Period<br />
| align="left" |Setzt die Force-Feedback-Vibrationsperiode im Lenkrad<br />
| align="left" |s<br />
| align="left" |<br />
|-<br />
| align="left" |FF_Vib_Amp<br />
| align="left" |Setzt die Force-Feedback-Vibrationsamplitude im Lenkrad<br />
| align="left" |0...1<br />
| align="left" |<br />
|-<br />
| align="left" |Snd_OutsideVol<br />
| align="left" |Teilt OMSI mit, wie stark der Außensound im Innenraum hörbar ist; verändert sich bspw. wenn eine Tür geöffnet wird.<br />
| align="left" |0: kaum hörbar, 1: wie draußen<br />
| align="left" |<br />
|-<br />
| align="left" |Snd_Microphone<br />
| align="left" |Soll das (Hardware-)Mikrofon aktiv sein?<br />
| align="left" |0: aus, 1: an<br />
| align="left" |<br />
|-<br />
| align="left" |Snd_Radio<br />
| align="left" |Soll das (Internet-)Radio laufen?<br />
| align="left" |0: aus, 1: an<br />
| align="left" |<br />
|-<br />
| align="left" |Cabinair_Temp<br />
| align="left" |Innenraumtemperatur für die Beurteilung durch die Fahrgäste<br />
| align="left" |°C<br />
| align="left" |<br />
|-<br />
| align="left" |Cabinair_absHum<br />
| align="left" |[http://de.wikipedia.org/wiki/Luftfeuchtigkeit#Absolute_Luftfeuchtigkeit Absolute Luftfeuchtigkeit] im Innenraum für die Beurteilung durch die Fahrgäste<br />
| align="left" |g/m³<br />
| align="left" |<br />
|-<br />
| align="left" |Cabinair_relHum<br />
| align="left" |[http://de.wikipedia.org/wiki/Luftfeuchtigkeit#Relative_Luftfeuchtigkeit Relative Luftfeuchtigkeit] im Innenraum, wird durch OMSI automatisch über die absolute Feuchtigkeit und die Innentemperatur berechnet.<br />
| align="left" |0 = 0%, 1 = 100%<br />
| align="left" |X<br />
|-<br />
| align="left" |PrecipRate<br />
| align="left" |Niederschlagsrate<br />
| align="left" |0 = kein, 1 = maximal<br />
| align="left" |X<br />
|-<br />
| align="left" |PrecipType<br />
| align="left" |Niederschlagstyp<br />
| align="left" |0 = kein, 1 = Regen, 2 = Schnee<br />
| align="left" |X<br />
|-<br />
| align="left" |Dirt_Norm<br />
| align="left" |allgemeiner Verdreckungszustand (Windschutzscheiben können sauberer sein und werden nur vom Script simuliert)<br />
| align="left" |0 = sauber, 1 = total verdreckt<br />
| align="left" |X<br />
|-<br />
| align="left" |DirtRate<br />
| align="left" |aktuelle Verdreckungsrate<br />
| align="left" |Verdreckung / s, wobei eine Verdreckung = 1 bedeutet, dass die Verdreckung maximal ist.<br />
| align="left" |X<br />
|-<br />
| align="left" |schedule_active<br />
| align="left" |Ist gerade ein Fahrplan aktiv? (Bspw. für Einblendung der Fahrplankarte)<br />
| align="left" |0: nein, 1: ja<br />
| align="left" |X<br />
|-<br />
| align="left" |train_frontcoupling<br />
| align="left" |Ist an der vorderen Kupplung etwas angekuppelt? (Eventuell spätere Benutzung zum Abkuppeln)<br />
| align="left" |0: nein, 1: ja<br />
| align="left" |X<br />
|-<br />
| align="left" |train_backcoupling<br />
| align="left" |Ist an der hinteren Kupplung etwas angekuppelt? (Eventuell spätere Benutzung zum Abkuppeln)<br />
| align="left" |0: nein, 1: ja<br />
| align="left" |X<br />
|-<br />
| align="left" |train_me_reverse<br />
| align="left" |Steht dieses Fahrzeug rückwärts zum gesamten Fahrzeugverband?<br />
| align="left" |0: nein, 1: ja<br />
| align="left" |X<br />
|}<br />
<br />
<nowiki>*) Bidirektionale KI-Variablen: Handelt es sich um ein Userfahrzeug, kann das Script dem Hauptprogramm mitteilen, wie Licht, Blinker usw. gesetzt wurden. Handelt es sich aber um ein KI-Fahrzeug, teilt OMSI dem Script mit, wie die entsprechenden Zustände gesetzt werden müssen.</nowiki><br />
<br />
==== Stringvariablen ====<br />
<br />
Siehe bitte auch Datei ''program\stringvarlist_roadvehicle.txt''!<br />
<br />
{| class="wikitable" style="font-size:95%;" <br />
|- class="hintergrundfarbe5"<br />
| align="left" |''Variablenname''<br />
| align="left" |''Beschreibung''<br />
| align="left" |''kein Schreibzugriff''<br />
|-<br />
| align="left" |ident<br />
| align="left" |Enthält das Kraftfahrzeugkennzeichen dieses Fahrzeugs (z.B. "B-V 3503")<br />
| align="left" |X<br />
|-<br />
| align="left" |number<br />
| align="left" |Enthält die Fahrzeugnummer (z.B. "3503")<br />
| align="left" |X<br />
|-<br />
| align="left" |act_route<br />
| align="left" |''(keine Verwendung)''<br />
| align="left" |<br />
|-<br />
| align="left" |act_busstop<br />
| align="left" |Wird zusammen mit dem internen Trigger ''ai_scheduled_setbusstop'' verwendet: Enthält dann den Namen der im Fahrplansystem aktiven Haltestelle.<br />
| align="left" |X<br />
|-<br />
| align="left" |SetLineTo<br />
| align="left" |Wird zusammen mit dem internen Trigger ''ai_scheduled_settarget'' verwendet: Enthält die einzustellende Liniennummer (oder Symbol) (bei Verwendung vom Zielschild-Menü oder beim Umschildern von KI-Bussen)<br />
| align="left" |X<br />
|-<br />
| align="left" |yard<br />
| align="left" |Name der Hofdatei des Fahrzeuges, bspw. damit das Scriptsystem den Dateinamen der Zielcode-Tabelle generieren kann.<br />
| align="left" |X<br />
|-<br />
| align="left" |file_schedule<br />
| align="left" |Enthält den Dateinamen der Fahrplan-Bitmap, die zu der von diesem Fahrzeug gefahrenen Strecke gehört.<br />
| align="left" |X<br />
|}<br />
<br />
=== Menschen ===<br />
<br />
Siehe bitte auch Datei ''program\varlist_human.txt''!<br />
<br />
{| class="wikitable" style="font-size:95%;" <br />
|- class="hintergrundfarbe5"<br />
| align="left" |''Variablenname''<br />
| align="left" |''Beschreibung''<br />
| align="left" |''Einheit''<br />
| align="left" |''kein Schreibzugriff''<br />
|-<br />
| align="left" |LastMovedDist<br />
| align="left" |Entfernung, die der Mensch seit dem letzten Durchlauf zurückgelegt hat. Wurde für die alten Animationen gebraucht.<br />
| align="left" |m<br />
| align="left" |X<br />
|-<br />
| align="left" |PAX_State<br />
| align="left" |Zustand des Menschens. Wurde für die alten Animationen gebraucht.<br />
| align="left" |0: stehen, 1: gehen, 2: sitzen<br />
| align="left" |X<br />
|-<br />
| align="left" |HeightOfSeat<br />
| align="left" |Höhe des Sitzes. Diese Eigenschaft wird in der Sitzposition gebraucht, um die Höhe der Füße korrekt gesetzt. Wurde für die alten Animationen gebraucht.<br />
| align="left" |m<br />
| align="left" |X<br />
|-<br />
| align="left" |Colorscheme<br />
| align="left" |Tauschtextur-Index ("Farbschema") des Menschens.<br />
| align="left" |-<br />
| align="left" |X<br />
|}<br />
<br />
[[Kategorie:Nachschlagewerk für Addon-Entwickler]]</div>Marcel Kuhnthttp://wiki.omnibussimulator.de/omsiwikineu.de/index.php?title=System-_und_vordefinierte_lokalen_Variablen&diff=866System- und vordefinierte lokalen Variablen2014-02-11T15:23:08Z<p>Marcel Kuhnt: /* Systemvariablen */</p>
<hr />
<div>''Hinweis: Dieser Artikel wurde noch nicht ins Englische übersetzt!''<br />
<br />
Beschreibung der System- und der lokalen [[Scriptsystem#Variablenzugriff|Scriptvariablen]], welche für jedes Objekt vordefiniert werden und im Allgemeinen bestimmte Sonderfunktionen gegenüber frei definierten Scriptvariablen übernehmen.<br />
<br />
== Systemvariablen ==<br />
<br />
Siehe bitte auch Datei ''program\varlist_system.txt''!<br />
<br />
{| class="wikitable" style="font-size:95%;" <br />
|- class="hintergrundfarbe5"<br />
| align="left" |''Variablenname''<br />
| align="left" |''Beschreibung''<br />
| align="left" |''Einheit''<br />
| align="left" |''ab OMSI-Vs.''<br />
|-<br />
| align="left" |Timegap<br />
| align="left" |Zeitschritt seit dem letzten Durchlauf (Frame)<br />
| align="left" |Sekunden<br />
| align="left" |1.00<br />
|-<br />
| align="left" |GetTime<br />
| align="left" |Enthält eine absolute Zeitangabe, die vom Beginn des Ausführens von OMSI zählt<br />
| align="left" |Sekunden<br />
| align="left" |1.00<br />
|-<br />
| align="left" |NoSound<br />
| align="left" |Sounds deaktiviert?<br />
| align="left" |0 = Sounds aktiviert, 1 = Sounds deaktiviert<br />
| align="left" |1.00<br />
|-<br />
| align="left" |Pause<br />
| align="left" |Simulations-Pause aktiv?<br />
| align="left" |0 = Simulation läuft, 1 = Simulation angehalten<br />
| align="left" |1.00<br />
|-<br />
| align="left" |Time<br />
| align="left" |Uhrzeit gerechnet von Mitternacht des aktuellen Tages<br />
| align="left" |Sekunden<br />
| align="left" |1.00<br />
|-<br />
| align="left" |Day<br />
| align="left" |Tag gezählt ab Monatsbeginn<br />
| align="left" |Tage<br />
| align="left" |1.00<br />
|-<br />
| align="left" |Month<br />
| align="left" |Monat<br />
| align="left" |Monate<br />
| align="left" |1.00<br />
|-<br />
| align="left" |Year<br />
| align="left" |Jahr<br />
| align="left" |Jahre<br />
| align="left" |1.00<br />
|-<br />
| align="left" |DayOfYear<br />
| align="left" |Tag gezählt ab Jahresbeginn<br />
| align="left" |Tage<br />
| align="left" |1.00<br />
|-<br />
| align="left" |mouse_x<br />
| align="left" |X-Koordinate des Mauszeigers auf dem Bildschirm<br />
| align="left" |Pixel<br />
| align="left" |1.00<br />
|-<br />
| align="left" |mouse_y<br />
| align="left" |Y-Koordinate des Mauszeigers auf dem Bildschirm<br />
| align="left" |Pixel<br />
| align="left" |1.00<br />
|-<br />
| align="left" |PrecipType<br />
| align="left" |Niederschlagstyp<br />
| align="left" |0 = keiner, 1 = Regen, 2 = Schnee<br />
| align="left" |1.00<br />
|-<br />
| align="left" |PrecipRate<br />
| align="left" |Niederschlagstyp<br />
| align="left" |0 = kein Niederschlag, 1 = maximaler Niederschlag<br />
| align="left" |1.00<br />
|-<br />
| align="left" |coll_pos_x<br />
| align="left" |Position der Kollision, x-Richtung relativ zum Fahrzeugursprung (nur bei Auslösung des Kollisions-Triggers)<br />
| align="left" |Meter<br />
| align="left" |1.00<br />
|-<br />
| align="left" |coll_pos_y<br />
| align="left" |Position der Kollision, y-Richtung relativ zum Fahrzeugursprung (nur bei Auslösung des Kollisions-Triggers)<br />
| align="left" |Meter<br />
| align="left" |1.00<br />
|-<br />
| align="left" |coll_pos_z<br />
| align="left" |Position der Kollision, z-Richtung relativ zum Fahrzeugursprung (nur bei Auslösung des Kollisions-Triggers)<br />
| align="left" |Meter<br />
| align="left" |1.00<br />
|-<br />
| align="left" |coll_energy<br />
| align="left" |Energie der Kollision (nur bei Auslösung des Kollisions-Triggers)<br />
| align="left" |Nm<br />
| align="left" |1.00<br />
|-<br />
| align="left" |Weather_Temperature<br />
| align="left" |Außentemperatur<br />
| align="left" |°C<br />
| align="left" |1.00<br />
|-<br />
| align="left" |Weather_AbsHum<br />
| align="left" |Absolute Luftfeuchtigkeit<br />
| align="left" |g/m³<br />
| align="left" |1.00<br />
|-<br />
| align="left" |AutoClutch<br />
| align="left" |Option "automatische Kupplung" aktiviert<br />
| align="left" |0 = aus, 1 = an<br />
| align="left" |1.04<br />
|-<br />
| align="left" |wearlifespan<br />
| align="left" |''nicht nutzen!''<br />
| align="left" |<br />
| align="left" |2.00<br />
|-<br />
| align="left" |SunAlt<br />
| align="left" |Höhenwinkel der Sonne<br />
| align="left" |°<br />
| align="left" |2.00<br />
|}<br />
<br />
== Vordefinierte lokale Variablen ==<br />
<br />
=== Szenerieobjekte ===<br />
<br />
Siehe bitte auch Datei ''program\varlist_scenobj.txt''!<br />
<br />
{| class="wikitable" style="font-size:95%;" <br />
|- class="hintergrundfarbe5"<br />
| align="left" |''Variablenname''<br />
| align="left" |''Beschreibung''<br />
| align="left" |''Einheit''<br />
| align="left" |''kein Schreibzugriff''<br />
|-<br />
| align="left" |NightLightA<br />
| align="left" |Ist die Nachtbeleuchtung aktiv?<br />
| align="left" |0 = aus, 1 = an<br />
| align="left" |X<br />
|-<br />
| align="left" |InUse<br />
| align="left" |Ist das Objekt "aktiv"? Die Sporthallen sind bspw. nur an Schultagen vormittags "aktiv", sodass die Soundeffekte an diese Variable gekoppelt werden können - auf diese Weise wird verhindert, dass die Soundeffekte auch in den Ferien oder nachts zu hören sind.<br />
| align="left" |0 = inaktiv, 1 = aktiv<br />
| align="left" |X<br />
|-<br />
| align="left" |TrafficLightPhase<br />
| align="left" |Hierüber wird Ampelobjekten die anzuzeigende Ampelphase mitgeteilt.<br />
| align="left" |0..2 = rot, 3..5 = rot-gelb, 6..8 = grün, 9..11 = gelb, sonst aus<br />
| align="left" |X<br />
|-<br />
| align="left" |TrafficLightApproach<br />
| align="left" |Hierüber kann das Script eine Ampelanforderung erkennen und bspw. eine Kennleuchte aktiviert werden.<br />
| align="left" |0 = keine Anforderung, 1 = Anforderung<br />
| align="left" |X<br />
|-<br />
| align="left" |Colorscheme<br />
| align="left" |(veraltet)<br />
| align="left" |(-)<br />
| align="left" |X<br />
|-<br />
| align="left" |Signal<br />
| align="left" |Hierüber erhalten Signale ihr anzuzeigendes Signalbild<br />
| align="left" |individuell<br />
| align="left" |X<br />
|-<br />
| align="left" |NextSignal<br />
| align="left" |Hierüber erhalten Signale mit Vorsignalfunktion das anzuzeigende Signalbild des nächsten Signals<br />
| align="left" |individuell<br />
| align="left" |X<br />
|-<br />
| align="left" |Refresh_Strings<br />
| align="left" |Diese Variable muss auf "1" gesetzt werden, damit die Text-Texturen aktualisiert werden! Wird nach erfolgreicher Abarbeitung von OMSI auf 0 gesetzt.<br />
| align="left" |-<br />
| align="left" |<br />
|}<br />
<br />
=== Fahrzeuge ===<br />
<br />
==== Zahlvariablen ====<br />
<br />
Siehe bitte auch Datei ''program\varlist_roadvehicle.txt''!<br />
<br />
{| class="wikitable" style="font-size:95%;" <br />
|- class="hintergrundfarbe5"<br />
| align="left" |''Variablenname''<br />
| align="left" |''Beschreibung''<br />
| align="left" |''Einheit''<br />
| align="left" |''kein Schreibzugriff''<br />
|-<br />
| align="left" |Refresh_Strings<br />
| align="left" |Diese Variable muss auf "1" gesetzt werden, damit die Text-Texturen aktualisiert werden! Wird nach erfolgreicher Abarbeitung von OMSI auf 0 gesetzt.<br />
| align="left" |-<br />
| align="left" |<br />
|-<br />
| align="left" |Envir_Brightness<br />
| align="left" |Umgebungshelligkeit in Fahrzeugnähe<br />
| align="left" |0 = dunkel, 1 = hell<br />
| align="left" |X<br />
|-<br />
| align="left" |StreetCond<br />
| align="left" |Information über die Oberflächenbedingungen<br />
| align="left" |0: Trocken, 0..1: zunehmende Feuchtigkeit, 1: komplett feucht, 1..2: teilweise Pfützen, 2: Fahrzeug komplett in Pfützen<br />
| align="left" |X<br />
|-<br />
| align="left" |Spot_Select<br />
| align="left" |Hierüber kann gesteuert werden, welches fürs Fahrzeug vordefinierte Spotlight aktiv sein soll.<br />
| align="left" |-1: kein Spotlight, 0: Spotlight Nr. 0, 1: Spotlight Nr. 1 usw.<br />
| align="left" |<br />
|-<br />
| align="left" |Colorscheme<br />
| align="left" |Index des gewählten Farbschemas/Anstriches<br />
| align="left" |-<br />
| align="left" |X<br />
|-<br />
| align="left" |M_Wheel<br />
| align="left" |Hierüber kann das Script ein [http://de.wikipedia.org/wiki/Drehmoment Drehmoment] auf die Räder übertragen. Hierbei die Summe anzugeben, welche auf alle als angetrieben ausgewiesene Achsen wirken <br />
soll.<br />
| align="left" |kNm = 1000 [http://de.wikipedia.org/wiki/Newtonmeter Nm]<br />
| align="left" |<br />
|-<br />
| align="left" |n_Wheel<br />
| align="left" |Mittlere Raddrehzahl des Fahrzeuges<br />
| align="left" |Umdrehungen pro Minute<br />
| align="left" |X<br />
|-<br />
| align="left" |Throttle<br />
| align="left" |Stellung des Gaspedals<br />
| align="left" |0..1<br />
| align="left" |X<br />
|-<br />
| align="left" |Brake<br />
| align="left" |Stellung des Bremspedals<br />
| align="left" |0..1<br />
| align="left" |X<br />
|-<br />
| align="left" |Clutch<br />
| align="left" |Stellung des Kupplungspedals<br />
| align="left" |0..1<br />
| align="left" |X<br />
|-<br />
| align="left" |Brakeforce<br />
| align="left" |Hierüber kann das Script die Gesamtbremskraft des Fahrzeuges vorgeben, welche auf die Räder wirkt. Sollte nicht gleichzeitig mit ''Axle_Brakeforce...'' verwendet werden.<br />
| align="left" |[http://de.wikipedia.org/wiki/Newton_(Einheit) N]<br />
| align="left" |<br />
|-<br />
| align="left" |Velocity<br />
| align="left" |Geschwindigkeit, welche sich über die Raddrehung ergibt, entspricht der Tachoanzeige<br />
| align="left" |[http://de.wikipedia.org/wiki/Km/h km/h]<br />
| align="left" |X<br />
|-<br />
| align="left" |Velocity_Ground<br />
| align="left" |Geschwindigkeit, welche direkt relativ zum Grund gemessen wird, berücksichtigt kein Radschleudern oder -blockieren, entspricht der Anzeige auf einem GPS<br />
| align="left" |[http://de.wikipedia.org/wiki/Km/h km/h]<br />
| align="left" |X<br />
|-<br />
| align="left" |tank_percent<br />
| align="left" |Tankinhalt, nur für die Anzeige auf der roten Informationsleiste. Die Betankung und Simulation eines leeren Tanks geschieht über einen Trigger bzw. muss im Script programmiert werden.<br />
| align="left" |0..1<br />
| align="left" |<br />
|-<br />
| align="left" |kmcounter_km<br />
| align="left" |Stand des Kilometerzählers (nur ganze km)<br />
| align="left" |km<br />
| align="left" |X<br />
|-<br />
| align="left" |kmcounter_m<br />
| align="left" |Stand des Kilometerzählers (zusätzliche Meter, läuft stets nur von 0m bis 999m; hinzu kommen die Kilometer von ''kmcounter_km'')<br />
| align="left" |m<br />
| align="left" |X<br />
|-<br />
| align="left" |relrange<br />
| align="left" |Zurückgelegte, relative Strecke. Wurde nur testweise für pfadfixierte Fahrzeuge eingeführt. Nicht benutzen!<br />
| align="left" |---<br />
| align="left" |X<br />
|-<br />
| align="left" |Driver_Seat_VertTransl<br />
| align="left" |Einfederung des federnden Fahrersitzes<br />
| align="left" |m<br />
| align="left" |X<br />
|-<br />
| align="left" |Wheel_Rotation_0_L / ~_R ... ~_3_L / _R<br />
| align="left" |Drehwinkel des jeweiligen Rades, z.B. für die Animation<br />
| align="left" |[http://de.wikipedia.org/wiki/Radiant_(Einheit) rad]<br />
| align="left" |X<br />
|-<br />
| align="left" |Wheel_RotationSpeed_0_L / ~_R ... ~_3_L / _R<br />
| align="left" |Drehzahl des jeweiligen Rades<br />
| align="left" |Umdrehungen pro Minute<br />
| align="left" |X<br />
|-<br />
| align="left" |Axle_Suspension_0_L / ~_R ... ~_3_L / _R<br />
| align="left" |Einfederungsweg des jeweiligen Rades<br />
| align="left" |m<br />
| align="left" |X<br />
|-<br />
| align="left" |Axle_Steering_0_L / ~_R ... ~_3_L / _R<br />
| align="left" |Lenkwinkel des jeweiligen Rades<br />
| align="left" |[http://de.wikipedia.org/wiki/Radiant_(Einheit) rad]<br />
| align="left" |X<br />
|-<br />
| align="left" |Axle_Springfactor_0_L / ~_R ... ~_3_L / _R<br />
| align="left" |Faktor, mit dem radweise die Federstärke angepasst werden kann, z.B. um Luftfederungen zu simulieren.<br />
| align="left" |0 = keine, 1 = normale, 2 = doppelte Federkraft<br />
| align="left" |<br />
|-<br />
| align="left" |Axle_Brakeforce_0_L / ~_R ... ~_3_L / _R<br />
| align="left" |Ermöglicht Setzen der Bremskraft pro Rad. Sollte nicht gleichzeitig mit ''Brakeforce'' verwendet werden!<br />
| align="left" |[http://de.wikipedia.org/wiki/Newton_(Einheit) N]<br />
| align="left" |<br />
|-<br />
| align="left" |Debug_0 ... _5<br />
| align="left" |Debug-Variablen. Können im Debug-Modus in der Informationsleiste angezeigt werden, um auf diese Weise die Scripts zu testen.<br />
| align="left" |bliebig<br />
| align="left" |<br />
|-<br />
| align="left" |A_Trans_X ... _Z<br />
| align="left" |Beschleunigungen im Fahrzeug, die durch die Fahrzeugbewegungen ausgelöst werden (beim Bremsen oder bei Kurvenfahrten usw.)<br />
| align="left" |m/s²<br />
| align="left" |X<br />
|-<br />
| align="left" |AI_Blinker_L, ~_R<br />
| align="left" |Linker oder rechter Blinker aktiv<br />
| align="left" |0: aus, 1: ein<br />
| align="left" |(X)*<br />
|-<br />
| align="left" |AI_Light<br />
| align="left" |Fahrlicht, Standlicht, Lichthupe<br />
| align="left" |0: Licht aus, 0.5: Standlicht an, 1: Fahrlicht an, 2: Fernlicht/Lichthupe an<br />
| align="left" |(X)*<br />
|-<br />
| align="left" |AI_Interiorlight<br />
| align="left" |Innenbeleuchtung. Hierüber erfahren die einsteigenden Fahrgäste auch, ob es im Bus zu dunkel ist (sodass sie meckern dürfen).<br />
| align="left" |0: aus, 1: an<br />
| align="left" |(X)*<br />
|-<br />
| align="left" |AI_Brakelight<br />
| align="left" |Nur für KI-Fahrzeuge: Script soll Bremslicht einschalten<br />
| align="left" |0: aus, 1: an<br />
| align="left" |X<br />
|-<br />
| align="left" |AI_Engine<br />
| align="left" |Nur für KI-Fahrzeuge: Aufforderung zum Ein- oder Ausschalten des Motors<br />
| align="left" |-1: Motor ausschalten!, 0: egal/nicht-KI, 1: Motor einschalten!<br />
| align="left" |X<br />
|-<br />
| align="left" |AI_target_index<br />
| align="left" |Dient der Übergabe des Sollwertes des einzustellenden Zielschildes bei Aufruf des Menüs oder beim Umschildern der KI-Busse. Entspricht der Reihenfolge in der Hof-Datei; erster Eintrag = 0<br />
| align="left" |-<br />
| align="left" |X<br />
|-<br />
| align="left" |target_index_int<br />
| align="left" |Über diese Variable setzt das Script, welches Zielschild am Bus zusehen ist und steuert hierüber insbesondere die Fahrgäste. Entspricht wie ''AI_target_index'' dem Index der Reihenfolge in der Hof-Datei.<br />
| align="left" |-<br />
| align="left" |<br />
|-<br />
| align="left" |AI_Scheduled_AtStation<br />
| align="left" |Nur KI-Fahrzeuge, bidirektionale Kommunikation: Bei Erreichen einer Station setzt OMSI den Wert auf 1, sodass das Script mitgeteilt bekommt, dass die Türen geöffnet werden sollen. Wenn sich der Bus abfahrbereit machen soll, setzt OMSI den Wert auf -1. Wenn der Bus abfahrbereit ist (Türen geschlossen usw.), dann setzt das Script den Wert auf 0, sodass die KI den Bus weiterfahren lassen kann.<br />
| align="left" |-1: Bus abfahrbereit machen, 0: Bus ist abfahrbereit, 1: Türen freigeben/öffnen<br />
| align="left" |(X)<br />
|-<br />
| align="left" |AI<br />
| align="left" |Hierüber erfährt das Script, ob das Fahrzeug von der AI gesteuert wird.<br />
| align="left" |0: nein, 1: ja<br />
| align="left" |X<br />
|-<br />
| align="left" |PAX_Entry0_Open ... ~7_Open<br />
| align="left" |Teilt OMSI mit, ob die jeweiligen Eingänge offen oder geschlossen sind.<br />
| align="left" |0: geschlossen, 1: offen<br />
| align="left" |<br />
|-<br />
| align="left" |PAX_Exit0_Open<br />
| align="left" |Teilt OMSI mit, ob die jeweiligen Ausgänge offen oder geschlossen sind.<br />
| align="left" |0: geschlossen, 1: offen<br />
| align="left" |<br />
|-<br />
| align="left" |GivenTicket<br />
| align="left" |Teilt OMSI mit, ob der ggf. vorhandene Fahrscheinautomat ein Ticket ausgegeben hat.<br />
| align="left" |-1: kein Ticket, 0: Tickettyp 0, 1: Tickettyp 1, ...<br />
| align="left" |<br />
|-<br />
| align="left" |humans_count<br />
| align="left" |Anzahl der Fahrgäste im Fahrzeug<br />
| align="left" |-<br />
| align="left" |X<br />
|-<br />
| align="left" |FF_Vib_Period<br />
| align="left" |Setzt die Force-Feedback-Vibrationsperiode im Lenkrad<br />
| align="left" |s<br />
| align="left" |<br />
|-<br />
| align="left" |FF_Vib_Amp<br />
| align="left" |Setzt die Force-Feedback-Vibrationsamplitude im Lenkrad<br />
| align="left" |0...1<br />
| align="left" |<br />
|-<br />
| align="left" |Snd_OutsideVol<br />
| align="left" |Teilt OMSI mit, wie stark der Außensound im Innenraum hörbar ist; verändert sich bspw. wenn eine Tür geöffnet wird.<br />
| align="left" |0: kaum hörbar, 1: wie draußen<br />
| align="left" |<br />
|-<br />
| align="left" |Snd_Microphone<br />
| align="left" |Soll das (Hardware-)Mikrofon aktiv sein?<br />
| align="left" |0: aus, 1: an<br />
| align="left" |<br />
|-<br />
| align="left" |Snd_Radio<br />
| align="left" |Soll das (Internet-)Radio laufen?<br />
| align="left" |0: aus, 1: an<br />
| align="left" |<br />
|-<br />
| align="left" |Cabinair_Temp<br />
| align="left" |Innenraumtemperatur für die Beurteilung durch die Fahrgäste<br />
| align="left" |°C<br />
| align="left" |<br />
|-<br />
| align="left" |Cabinair_absHum<br />
| align="left" |[http://de.wikipedia.org/wiki/Luftfeuchtigkeit#Absolute_Luftfeuchtigkeit Absolute Luftfeuchtigkeit] im Innenraum für die Beurteilung durch die Fahrgäste<br />
| align="left" |g/m³<br />
| align="left" |<br />
|-<br />
| align="left" |Cabinair_relHum<br />
| align="left" |[http://de.wikipedia.org/wiki/Luftfeuchtigkeit#Relative_Luftfeuchtigkeit Relative Luftfeuchtigkeit] im Innenraum, wird durch OMSI automatisch über die absolute Feuchtigkeit und die Innentemperatur berechnet.<br />
| align="left" |0 = 0%, 1 = 100%<br />
| align="left" |X<br />
|-<br />
| align="left" |PrecipRate<br />
| align="left" |Niederschlagsrate<br />
| align="left" |0 = kein, 1 = maximal<br />
| align="left" |X<br />
|-<br />
| align="left" |PrecipType<br />
| align="left" |Niederschlagstyp<br />
| align="left" |0 = kein, 1 = Regen, 2 = Schnee<br />
| align="left" |X<br />
|-<br />
| align="left" |Dirt_Norm<br />
| align="left" |allgemeiner Verdreckungszustand (Windschutzscheiben können sauberer sein und werden nur vom Script simuliert)<br />
| align="left" |0 = sauber, 1 = total verdreckt<br />
| align="left" |X<br />
|-<br />
| align="left" |DirtRate<br />
| align="left" |aktuelle Verdreckungsrate<br />
| align="left" |Verdreckung / s, wobei eine Verdreckung = 1 bedeutet, dass die Verdreckung maximal ist.<br />
| align="left" |X<br />
|-<br />
| align="left" |schedule_active<br />
| align="left" |Ist gerade ein Fahrplan aktiv? (Bspw. für Einblendung der Fahrplankarte)<br />
| align="left" |0: nein, 1: ja<br />
| align="left" |X<br />
|-<br />
| align="left" |train_frontcoupling<br />
| align="left" |Ist an der vorderen Kupplung etwas angekuppelt? (Eventuell spätere Benutzung zum Abkuppeln)<br />
| align="left" |0: nein, 1: ja<br />
| align="left" |X<br />
|-<br />
| align="left" |train_backcoupling<br />
| align="left" |Ist an der hinteren Kupplung etwas angekuppelt? (Eventuell spätere Benutzung zum Abkuppeln)<br />
| align="left" |0: nein, 1: ja<br />
| align="left" |X<br />
|-<br />
| align="left" |train_me_reverse<br />
| align="left" |Steht dieses Fahrzeug rückwärts zum gesamten Fahrzeugverband?<br />
| align="left" |0: nein, 1: ja<br />
| align="left" |X<br />
|}<br />
<br />
<nowiki>*) Bidirektionale KI-Variablen: Handelt es sich um ein Userfahrzeug, kann das Script dem Hauptprogramm mitteilen, wie Licht, Blinker usw. gesetzt wurden. Handelt es sich aber um ein KI-Fahrzeug, teilt OMSI dem Script mit, wie die entsprechenden Zustände gesetzt werden müssen.</nowiki><br />
<br />
==== Stringvariablen ====<br />
<br />
Siehe bitte auch Datei ''program\stringvarlist_roadvehicle.txt''!<br />
<br />
{| class="wikitable" style="font-size:95%;" <br />
|- class="hintergrundfarbe5"<br />
| align="left" |''Variablenname''<br />
| align="left" |''Beschreibung''<br />
| align="left" |''kein Schreibzugriff''<br />
|-<br />
| align="left" |ident<br />
| align="left" |Enthält das Kraftfahrzeugkennzeichen dieses Fahrzeugs (z.B. "B-V 3503")<br />
| align="left" |X<br />
|-<br />
| align="left" |number<br />
| align="left" |Enthält die Fahrzeugnummer (z.B. "3503")<br />
| align="left" |X<br />
|-<br />
| align="left" |act_route<br />
| align="left" |''(keine Verwendung)''<br />
| align="left" |<br />
|-<br />
| align="left" |act_busstop<br />
| align="left" |Wird zusammen mit dem internen Trigger ''ai_scheduled_setbusstop'' verwendet: Enthält dann den Namen der im Fahrplansystem aktiven Haltestelle.<br />
| align="left" |X<br />
|-<br />
| align="left" |SetLineTo<br />
| align="left" |Wird zusammen mit dem internen Trigger ''ai_scheduled_settarget'' verwendet: Enthält die einzustellende Liniennummer (oder Symbol) (bei Verwendung vom Zielschild-Menü oder beim Umschildern von KI-Bussen)<br />
| align="left" |X<br />
|-<br />
| align="left" |yard<br />
| align="left" |Name der Hofdatei des Fahrzeuges, bspw. damit das Scriptsystem den Dateinamen der Zielcode-Tabelle generieren kann.<br />
| align="left" |X<br />
|-<br />
| align="left" |file_schedule<br />
| align="left" |Enthält den Dateinamen der Fahrplan-Bitmap, die zu der von diesem Fahrzeug gefahrenen Strecke gehört.<br />
| align="left" |X<br />
|}<br />
<br />
=== Menschen ===<br />
<br />
Siehe bitte auch Datei ''program\varlist_human.txt''!<br />
<br />
{| class="wikitable" style="font-size:95%;" <br />
|- class="hintergrundfarbe5"<br />
| align="left" |''Variablenname''<br />
| align="left" |''Beschreibung''<br />
| align="left" |''Einheit''<br />
| align="left" |''kein Schreibzugriff''<br />
|-<br />
| align="left" |LastMovedDist<br />
| align="left" |Entfernung, die der Mensch seit dem letzten Durchlauf zurückgelegt hat. Wurde für die alten Animationen gebraucht.<br />
| align="left" |m<br />
| align="left" |X<br />
|-<br />
| align="left" |PAX_State<br />
| align="left" |Zustand des Menschens. Wurde für die alten Animationen gebraucht.<br />
| align="left" |0: stehen, 1: gehen, 2: sitzen<br />
| align="left" |X<br />
|-<br />
| align="left" |HeightOfSeat<br />
| align="left" |Höhe des Sitzes. Diese Eigenschaft wird in der Sitzposition gebraucht, um die Höhe der Füße korrekt gesetzt. Wurde für die alten Animationen gebraucht.<br />
| align="left" |m<br />
| align="left" |X<br />
|-<br />
| align="left" |Colorscheme<br />
| align="left" |Tauschtextur-Index ("Farbschema") des Menschens.<br />
| align="left" |-<br />
| align="left" |X<br />
|}<br />
<br />
[[Kategorie:Nachschlagewerk für Addon-Entwickler]]</div>Marcel Kuhnthttp://wiki.omnibussimulator.de/omsiwikineu.de/index.php?title=Hauptseite&diff=865Hauptseite2014-02-11T15:15:07Z<p>Marcel Kuhnt: Aktuell in Arbeit</p>
<hr />
<div><font style="font-size:1.2em;"><br />
'''Herzlich willkommen auf der deutschen Version von OMSIWiki!'''<br />
<br />
Hier geht's direkt zu einer der Hauptkategorien:<br />
<br />
* [[FAQs - Häufig gestellte Fragen]]<br />
* [[:Kategorie:Busfahren in OMSI|Busfahren in OMSI]]<br />
* Entwicklung von Addons:<br />
** [[:Kategorie:Nachschlagewerk für Addon-Entwickler|Nachschlagewerk]]<br />
** [[:Kategorie:Tutorials für Addon-Entwickler|Tutorials]]<br />
** [[:Kategorie:Tipps und Tricks für Addon-Entwickler|Tipps und Tricks]]<br />
* [[:Kategorie:Anschlussprojekte|Anschlussprojekte (z.B. Addon-Manager, OAT)]]<br />
* [[:Kategorie:Addon-Präsentationen|Addon-Präsentationen]]<br />
* [[:Kategorie:Hintergrundinformationen|Hintergrundinformationen]]<br />
<br />
* [[:Kategorie:Neuerungen OMSI 2|Neuerungen in OMSI 2]]<br />
<br />
'''Achtung: Vor dem Verfassen eigener Beiträge bitte zuerst die Regeln lesen!''' Weiter unten gibt es noch eine Ultra-Kurzanleitung für Neulinge.<br />
<br />
''Aktuell in Arbeit:''<br />
</font><br />
<br />
* Aktualisieren auf OMSI 2 --[[Benutzer:Marcel Kuhnt|Marcel Kuhnt]] 16:15, 11. Feb. 2014 (MET)<br />
* Umrüsten der [[FAQs - Häufig gestellte Fragen|FAQ]] auf OMSI 2 --[[Benutzer:MarvinK|MarvinK]] 12:27, 6. Jan. 2014 (MET)<br />
<br />
<br />
<br />
<br />
<br />
<br />
----<br />
<br />
== Idee ==<br />
<br />
Wir Entwickler von OMSI haben OMSIWiki eingerichtet, um eine bessere Plattform für alle Arten von Informationen rund um OMSI zu erhalten. Folgende Themengebiete sind von uns vorläufig vorgesehen:<br />
<br />
* Präsentation von Hintergrundinformationen über das Addon-Design von unserer Seite (Objekt- und Fahrzeugbar, Soundengine, Scriptengine usw.)<br />
* Tipps und Tricks oder auch ganze Tutorials von Usern z.B. zum Erstellen von Repaints oder Mapbau würden unsere Kernthemen abrunden. Entweder als Ergänzung unserer oder als weiterreichende Artikel.<br />
* Die Bedienung von OMSI und insbesondere der Busse könnte ein weiterer Themenkomplex sein. Zwar gibt es natürlich ein Handbuch für OMSI, dennoch gibt es vieleicht die eine oder andere Sache, die ausführlicher erklärt werden soll. Hier werden wir uns allerdings etwas zurückhalten.<br />
* Weiterhin könnten hier bewährte Anschlussprojekte zu OMSI präsentiert werden, z.B. OAT oder der Addon-Manager. Höchstwahrscheinlich werden die zugehörigen Artikel dann von den Leitern oder treuesten Fans dieser Projekte geschrieben, wir werden uns hier ebenfalls zurückhalten.<br />
* Ähnlich hierzu haben wir nichts gegen eine hochqualitative Präsentation von komplexen Addons; denkbar wäre hier z.B. die Bedienungsanleitung eines Addon-Busses oder die Beschreibung und Hinweise für die Fahrt durch eine Addon-Karte mit Fahrplänen und/oder Karten. Wo wir hier allerdings die Grenze setzen, steht noch nicht fest. Insbesondere sollen hier keine "Mini-Artikel" entstehen, wo nur ein Screenshot von einem Repaint und ein Download-Link präsentiert wird!<br />
* Selbstverständlich dürfen hier auch gerne Hintergrundinformationen zu unserer Strecke oder unseren Bussen oder aber zu Addons gegeben werden (wie sah Spandau in der Realität 1989 aus? Wie wurde damals in Berlin Bus gefahren?). Es sollte sich aber um abgeschlossene und ernsthaft geschriebene Artikel handeln und es sollte definitiv ein Bezug zu OMSI vorhanden sein! Also keine schnell hingeschriebenen Tagesberichte von irgendeinem Busunternehmen, was keiner kennt und was auch nicht in OMSI mindestens als Addon simuliert werden kann.<br />
<br />
== Regeln ==<br />
<br />
=== Ist das Thema hier erwünscht? ===<br />
<br />
Der Idee von OMSIWiki entsprechend sollte jeder Artikel letztlich in eine der oben genannten Kategorien passen!<br />
<br />
=== "Goldene Regel" ===<br />
<br />
Zunächst die '''"goldene Regel"''': Bevor ein Artikel verfasst oder geändert wird, sollte stets geschaut werden, ob sich an den Regeln etwas geändert hat! Gerade in der Anfangszeit wird es sicher vorkommen, dass sich Regeln ändern oder neue hinzukommen.<br />
<br />
=== Erwünscht ===<br />
<br />
* Wenn ihr einen kleinen oder großen Fehler entdeckt (auch in einem unserer Artikel!), dann darf ihn jeder korrigieren! Aber nur, wenn ihr euch dabei auch sicher seid.<br />
* Ihr findet einen Artikel z.B. im Addon-Handbuch zu trocken? Dann dürft ihr gerne ein kleines Beispiel ergänzen! Von mir weiß ich z.B., dass die Anschauung und Klarheit leidet, wenn ich viele und lange Texte schreibe!<br />
* Ihr findet einen Fachbegriff, der nicht erklärt wird? Wenn es ein bisher nicht erklärter Begriff von OMSI ist, dürft ihr gerne einen Artikel anfertigen und ihn mit dem Fachbegriff verlinken; handelt es sich um einen allgemeinen Fachbegriff, dann reicht meist ein externer Link zu einem entsprechenden Artikel z.B. in der Wikipedia aus.<br />
* Um zu vermeiden, dass euch bereits jemand anderes "dazwischen funkt", obwohl euer Artikel noch gar nicht fertig ist, ergänzt bitte hierzu oben den Hinweis: "''Hinweis: Dieser Artikel befindet sich noch im Aufbau!''". Dadurch wird auch vermieden, dass der unter Umständen erst halbfertige Artikel schon von jemandem übersetzt wird, sodass nach Fertigstellung der deutschen Version die englische noch unvollständig ist.<br />
* Wenn euer Artikel auch ein englischsprachiges Pendant hat, dann verknüpft ihn bitte! Ein Blick ans Ende des Quelltextes ''dieser'' Seite zeigt euch, wie das geht! Hat er jedoch ''kein'' Pendant und muss demnach in der englischen OMSIWiki noch angelegt werden, so wäre ein Hinweis ganz oben nicht schlecht: "''Hinweis: Dieser Artikel wurde noch nicht ins Englische übersetzt!''" oder "''Hinweis: Die englische Version muss noch aktualisiert werden!''"<br />
* Wenn ihr Spaß am Übersetzen habt, dann könnt ihr eine sehr wertvolle Hilfe für OMSIWiki sein! Wenn ihr einen dieser Hinweise entdeckt, scheut euch nicht, den Artikel in die englische OMSIWiki einzupflegen! Ihr solltet danach aber den Original-Autor informieren (damit er die Gelegenheit hat, einmal drüber zu schauen) und dann natürlich die beidseitige Verlinkung mit der deutschen Seite vornehmen und den Hinweis entfernen.<br />
<br />
=== Unerwünscht ===<br />
<br />
* '''Ganz wichtig: Der Name des Artikels muss wohlüberlegt gewählt werden, weil man den nicht mal eben ändern kann! Wer hier grob fahrlässig schlampt, fliegt raus!'''<br />
* Schlechter Schreibstil! Was im Chat normal ist und im Forum zwangsweise geduldet wird, ist hier tabu: Bitte gebt euch etwas Mühe, wenn ihr hier einen Artikel verfasst!<br />
* Werbung für unbekannte, kleine Projekte, Foren, virtuelle Gesellschaften etc. Der Sinn von OMSIWiki ist nicht die Werbung für Projekte! Es soll eine Informationsplattform sein!<br />
<br />
Hier dazu was Passendes zum schmunzeln: [http://meta.wikimedia.org/wiki/Wikipedia_Anti-Regeln Wikipedia-Anti-Regeln]<br />
<br />
=== Absprachen ===<br />
<br />
* Vor Beginn der Arbeit bitte oben bei "Aktuell in Arbeit" eine Zeile mit der geplanten Arbeit und eurer Signatur ergänzen. Nach Fertigstellung diesen wieder entfernen. Sollte jedoch dann gar kein Punkt mehr übrigbleiben, dann ein " * ''Nichts'' " stehen lassen.<br />
* Wenn ihr größere Korrekturen an unseren Artikeln vornehmt, wär es natürlich gut, wenn ihr uns zumindest nachher darüber informiert, damit wir den Überblick behalten.<br />
* Bevor ein neuer Artikel verfasst wird, kann es nicht schaden, kurz eine E-Mail an uns Administratoren zu schicken mit euren Planungen.<br />
* Das Einführen neuer Kategorien hat grundstätzlich in Absprache mit den Administratoren zu geschehen.<br />
<br />
* Beachtet auch die Möglichkeit, mit den Autoren auf der Diskussionsseite zu diskutieren! Wie der "Quellcode" einer Diskussionsseite aussieht, seht ihr hier: [[Diskussion:OMSI_Addon_Tester_(OAT)]]. Und nicht vergessen: Die Signatur könnt ihr automatisch erzeugen mit <nowiki>--~~~~</nowiki>!<br />
<br />
=== Multilingualität ===<br />
<br />
OMSIWiki ist zweisprachig ausgelegt: Englisch und Deutsch. Wie beim großen Vorbild, der Wikipedia, können die Artikel beider Sprachen miteinander verbunden werden. Dies erfolgt auch auf selbem Wege wie bei Wikipedia. Selbstverständlich ist es erstrebenswert, beide Teile der OMSIWiki auf gleichem Stand zu halten - auch wenn das natürlich praktisch nie ganz der Fall sein kann.<br />
<br />
=== Zugriff ===<br />
<br />
Im Gegensatz zur Wikipedia müsst ihr angemeldet sein, um hier Schreibzugriff zu erhalten. Ich denke, dies ist nicht zu viel verlangt und hilft uns eine gewisse Kontrolle über das Verfassen von Artikeln zu behalten.<br />
<br />
== Ultra-Kurzhandbuch ==<br />
<br />
Ein paar Hinweise für Neulinge, die sich davor scheuen, das ganze Handbuch zu lesen. Wie "baut" man einen OMSIWiki-Artikel?<br />
<br />
* Signatur: Gibt's überm Editor-Fenster einen Button, sonst <nowiki>--~~~~</nowiki>.<br />
* Anlegen einer neuen Seite: Nachdem ihr im Forum oder uns Bescheid gegeben habt, gebt ihr den ''wohlüberlegten'' Titel der neuen Seite ins ''Suche''-Feld ein. Es erscheint dann der Vorschlag, ob man diese Seite enlegen möchte? Ein "ja" führt dich dann zum leeren Editorfenster.<br />
* Eine sinnvolle Gliederung kann folgendermaßen erstellt werden:<br />
== Hauptüberschrift ==<br />
=== Subüberschrift ===<br />
==== Sub-Sub-Überschrift ==== usw.<br />
* Aufzählungen wie diese werden folgendermaßen durchgeführt:<br />
* Aufzählungspunkt<br />
* Aufzählungspunkt<br />
** Sub-Aufzählungspunkt<br />
* Ein # statt einem * führt zu numerierten Aufzählungen.<br />
* Fett- und Kursivschreibung wird mittels Apostrophen markiert:<br />
<pre><br />
''Kursiv''<br />
'''Fett'''<br />
</pre><br />
* Die Zuweisung einer Kategorie (im Beispiel der Kategorie "Busfahren in OMSI") erfolgt ganz am Ende des Artikels mit <nowiki>[[Kategorie:Busfahren in OMSI]]</nowiki>.<br />
<br />
Weitere Informationen: [http://meta.wikimedia.org/wiki/Hilfe:Handbuch?uselang=de meta.wikimedia.org/wiki/Hilfe:Handbuch]<br />
<br />
== Historie ==<br />
<br />
* 8. September 2011 - Marcel Kuhnt: Einrichten der deutschen OMSIWiki und Verlinkung mit der englischen.<br />
* 13. September 2011 - Marcel Kuhnt: OMSIWiki öffentlich angekündigt.<br />
<br />
== Links rund ums Thema OMSI ==<br />
<br />
* [http://www.omnibussimulator.de www.omnibussimulator.de] - offizielle Seite von OMSI, dem Omnibussimulator<br />
* [http://www.omnibussimulator.de/forum/ www.omnibussimulator.de/forum/] - offizielles OMSI-Forum<br />
<br />
== Sonstiges ==<br />
<br />
[[Technische Informationen zum MediaWiki]]<br />
<br />
[[en:Main Page]]</div>Marcel Kuhnthttp://wiki.omnibussimulator.de/omsiwikineu.de/index.php?title=Scriptsystem&diff=864Scriptsystem2014-02-11T10:49:56Z<p>Marcel Kuhnt: </p>
<hr />
<div>''Hinweis: Dieser Artikel wurde noch nicht ins Englische übersetzt!''<br />
<br />
''OMSI-Version: 1.0 - 2.0''<br />
<br />
Das Scriptsystem in OMSI ermöglicht es, dass Szenerieobjekte und vor allem Fahrzeuge mit individuellen Systemen ausgestattet werden können, die über Variablen und Funktionsaufrufe mit dem Hauptprogramm und der Grafik- und Soundengine kommunizieren.<br />
<br />
Der hier beschriebene Stand des Scriptsystems entspricht OMSI Version 1.01.<br />
<br />
== Dateien des Scriptsystems ==<br />
<br />
Das Scriptsystem umfasst folgende Dateien:<br />
<br />
* Scriptdateien mit ausführbarem Code (*.osc)<br />
* Varlist- und Stringvarlist-Dateien im OMSI\program-Verzeichnis zur Definition von Systemdateien und vordefinierten Dateien<br />
* Varlist- und Stringvarlist-Dateien zur Definition von Uservariablen<br />
* Constfile-Dateien zur Definition von Userkonstanten und Funktionstabellen<br />
<br />
Abgesehen von den Dateien zur Definition von Systemvariablen müssen alle benötigten Dateien für jedes Fahrzeug/Szenerieobjekt (im folgenden kurz: Objekt) in dessen [[Konfigurationsdatei]] angemeldet werden.<br />
<br />
Hierfür gibt es die Befehle ''[script]'', ''[varnamelist]'', ''[stringvarnamelist]'' und ''[constfile]''. Der erste Eintrag jedes Befehls ist die Anzahl der Dateien, darauf folgen die entsprechenden Dateinamen (inkl. Pfad relativ zur Konfigurationsdatei. Die Namen der Dateien sind nicht relevant, solange sie korrekt in die Listen eingetragen werden.<br />
<br />
Auf die Funktion der jeweiligen Dateien wird im Laufe der Beschreibung der Scriptsprache eingegangen.<br />
<br />
== Grundlagen der Scriptsprache ==<br />
<br />
Das OMSI-Scriptsystem arbeitet mit der [http://de.wikipedia.org/wiki/Umgekehrte_Polnische_Notation umgekehrten Polnischen Notation]. Hierbei steht der Operator hinter den beiden Operanden; vereinfacht gesagt bedeutet es, dass die Operation " 1 + 2 " stattdessen folgendermaßen notiert wird: " 1 2 + ". Ein komplizierteres Beispiel: " (1 + 2) * (4 + 5) " entspricht " 1 2 + 4 5 + * ".<br />
<br />
Ganz wichtig ist die Tatsache, dass die OMSI-Textdateien und insbesondere die Scriptsprache [http://de.wikipedia.org/wiki/Case_sensitivity Case-Sensitive] ist! D.h. es ist immer auf die Groß- und Kleinschreibung zu achten!<br />
<br />
=== Stack und Register ===<br />
<br />
Bei der Verarbeitung der Scripts verfügt OMSI über einen String-Stack und einen [http://de.wikipedia.org/wiki/Stapelspeicher Stack] für [http://de.wikipedia.org/wiki/Gleitkommazahl Gleitkommazahlen]. Im folgenden ist mit "Stack" immer der Stack für Gleitkommazahlen gemeint, andernfalls wird von "String-Stack" gesprochen.<br />
<br />
Beide Stacks enthält 8 Speicherplätze, welche von 0 bis 7 durchnumeriert sind. Jede Script-Operation kann nun einen oder mehrere neue Werte in einen der Stacks einfügen (push), wobei der neue Wert auf die Position 0 gesetzt wird und alle folgenden Werte "einen Platz aufrücken", oder sie kann einen oder mehrere Werte aus dem Stack herausziehen (pop/pull) oder lediglich auslesen (peek).<br />
<br />
Fürs temporäre Ablegen von Zahlen gibt es zusätzlich acht indizierte Speicherplätze, welche direkt geschrieben oder gelesen werden können, die sich im sogenannten Register befinden - hier gibt es jedoch nur einen Register für die Gleitkommazahlen.<br />
<br />
=== Beispiel-Operationen ===<br />
<br />
Beispiel: Die Operation 1 + 4. Der Code hierfür lautet:<br />
<br />
<pre><br />
1 4 +<br />
</pre><br />
<br />
In der folgenden Tabelle wird demonstriert, wie sich hierbei der Stack verhält:<br />
<br />
<pre><br />
Operation: Stack: 0 1 2 3 4 ...<br />
-----------------------------------------------------------------------------<br />
vorher: 0 0 0 0 0<br />
"1" 1 0 0 0 0<br />
"4" 4 1 0 0 0<br />
"+" 5 0 0 0 0<br />
</pre><br />
<br />
Im Ausgangszustand ist der Stack nur mit Nullen (oder unbekannten/zufälligen Werten) gefüllt. Der Befehl "1" schiebt die Eins in den obersten Stackplatz und schiebt alle weiteren Werte (Nullen) nach hinten. Der Befehl "4" schiebt die Vier auf den 0. Platz und alle folgenden Werte, also insbesondere die Eins auf den jeweils nächsten Platz. Im nächsten Schritt "+" werden die obersten beiden Werte aus dem Stack herausgezogen - also 4 und 1 - und summiert. Das Ergebnis (5) wird wiederum in den Stack geschoben. Die beiden ursprünglichen Zahlen sind im Stack nicht mehr vorhanden.<br />
<br />
Ein zweites Beispiel:<br />
<br />
(1 + 2) * (4 + 5) muss wie bereits erwähnt folgendermaßen notiert werden:<br />
<br />
<pre><br />
1 2 + 4 5 + *<br />
</pre><br />
<br />
Der Stack verhält sich somit folgendermaßen:<br />
<br />
<pre><br />
Operation: Stack: 0 1 2 3 4 ...<br />
-----------------------------------------------------------------------------<br />
vorher: 0 0 0 0 0<br />
"1" 1 0 0 0 0<br />
"2" 2 1 0 0 0<br />
"+" 3 0 0 0 0<br />
"4" 4 3 0 0 0<br />
"5" 5 4 3 0 0<br />
"+" 9 3 0 0 0<br />
"*" 27 0 0 0 0<br />
</pre><br />
<br />
Am Ende befindet sich also das korrekte Ergebnis auf Stackplatz 0!<br />
<br />
=== Gleitkommazahlen und Strings ===<br />
<br />
Das OMSI-Skriptsystem arbeitet ausschließlich mit den Datentypen Gleitkommazahl (einfache Präzision mit Vorzeichen) und String. Beide Datentypen haben getrennte Stacks. Deshalb laufen die Verarbeitung von Gleitkommazahlen und Strings im Allgemeinen unabhängig nebeneinander. Jedoch kann es natürlich vorkommen, dass bestimmte Funktionen z.B. Zahlen in Strings umwandeln und somit gleichzeitig auf beide Teilbereiche zugreifen.<br />
<br />
Auf boolische Variablen wurde verzichtet. Für boolische Werte werden im Allgemeinen die Zahlenwerte 0 und 1 verwendet.<br />
<br />
== Script-Schlüsselwörter ==<br />
<br />
=== Kommentare ===<br />
<br />
Kommentierungen sind nur möglich, indem in der auszukommentierenden Zeile ganz vorne ein Apostroph ['] gesetzt wird:<br />
<br />
<pre><br />
'Ich bin eine Kommentarzeile<br />
'Ich bin KEINE Kommentarzeile!<br />
</pre><br />
<br />
=== Einstiegs- und Ausstiegspunkte, Makros und Trigger ===<br />
<br />
Alle Befehle müssen zwischen einem Einstiegs- und einem Ausstiegspunkt liegen.<br />
<br />
Der Einstiegspunkt wird durch eins der folgenden Schlüsselwörter gekennzeichnet:<br />
<br />
* {frame} Im Laufe jedes Frames ruft OMSI über diesen Einstiegspunkt die frameweise Scriptverarbeitung auf, sofern er vorhanden ist.<br />
* {init} Bei der Initialisierung ruft OMSI über diesen Einstiegspunkt die Script-Initialisierung auf.<br />
* {frame_ai} Hierbei handelt es sich um eine Variante des {frame}-Einstiegspunktes, welcher bei Fahrzeugen dann aufgerufen wird, wenn diese nicht im Fokus des Benutzers stehen, z.B. wenn sie als KI-Fahrzeug unterwegs sind. Ist dieser Einstiegspunkt jedoch nicht vorhanden sondern nur {frame}, dann wird dieser alternativ aufgerufen. Bei Szenerieobjekten kommt dieser Eintrittspunkt nicht zur Anwendung.<br />
* {macro:''name''} Dieser Einstiegspunkt ruft ein Subsektion (Makro) auf, welche '''stets nach dem Aufruf''' definiert werden muss.<br />
* {trigger:''name''} Dieser Einstiegspunkt wird vom Hauptprogramm aufgerufen, wenn der Benutzer die Tastenkombination oder das Maus-Event mit der Bezeichnung ''name'' aufruft - es gibt auch bestimmte Trigger, die direkt vom Hauptprogramm aufgerufen werden, z.B. wenn OMSI bei KI-Bussen die Anzeige wechselt u.Ä.<br />
<br />
{end} ist der universelle Ausstiegspunkt. Er muss stets den Block abschließen, der mit einem der obigen Befehle eröffnet wird.<br />
<br />
==== Makroaufruf ====<br />
<br />
Der Aufruf eines Makros erfolgt über (M.L.''name''). Der Aufruf des Makros muss ''immer'' vor dessen Definition erfolgen. Andernfalls meldet OMSI, dass das Makro nicht gefunden wurde.<br />
<br />
==== Aufteilung des Scripts in mehrere Dateien ====<br />
<br />
Bei einfachen Scripts (z.B. bei reinen KI-Fahrzeugen oder Szenerieobjekten) reicht es im Allgemeinen eine *.sco-Datei zu erstellen, welche über einen {frame}...{end}- und ggf. einen {init}...{end}-Block verfügt.<br />
<br />
Handelt es sich jedoch um ein komplettes Fahrzeugscript, dann empfiehlt es sich für die verschiedenen Subsysteme getrennte Dateien anzulegen. Hierbei sollte folgendermaßen vorgegangen werden:<br />
<br />
* Es gibt ein Hauptscript und die nötigen Subsystemdateien. Die Hauptdatei enthält dabei die {frame}- und {init}-Blöcke, die jedoch nur Makros aufrufen, welche in den Subsystemdateien definiert sind.<br />
* Für jedes Subsystem gibt es eine *.sco-Datei und je nach Bedarf eine eigene Varlist und Constfile mit den zum System gehörenden Variablen. Außerdem werden auch hier die Trigger für die Tastenbefehle einsortiert.<br />
* Die Makros sollten sinnvollerweise folgendermaßen benannt werden: {macro:''subsystem''_frame} und {macro:''subsystem''_init}.<br />
* Damit die Makros vom Hauptscript aufgerufen werden, muss dieses in der Liste der Scripts in der Objekt-Konfigurationsdatei als erstes aufgerufen werden. Die Reihenfolge der Scripts untereinander muss ebenfalls so gewählt werden, dass alle dateiübergreifenden Makroaufrufe stets vor der jeweiligen Makrodefinition stehen.<br />
<br />
Die Einschränkung, dass Makros immer hinter dem Aufruf definiert werden müssen, kann zwar bisweilen hinderlich sein, ist aber ein sehr wirksamer Schutz gegen Zirkelschlüsse und Endlosschleifen.<br />
<br />
==== Trigger ====<br />
<br />
Wie schon geschrieben wurde, kann ein {trigger:''name''}...{end}-Abschnitt durch verschiedene Möglichkeiten aus dem Hauptprogramm heraus aufgerufen werden. Hierzu zählen:<br />
<br />
* Auslösung per Tastatur. Wurde die Tastenkombination mit dem Namen ''tastkomb'' bezeichnet, wird {trigger:tastkomb} aufgerufen, wenn die Taste gedrückt wird und {trigger:tastkomb_off}, wenn die Taste losgelassen wird.<br />
* Auslösung per Maus. Wurde ein Mesh angeklickt mit der [mouseevent]-Bezeichnung ''mouse_ev'', so wird {trigger:mouse_ev} aufgerufen, wenn die Maustaste gedrückt wird, {trigger:mouse_ev_drag}, während die Maustaste gehalten wird und {trigger:mouse_ev_off}, wenn die Maustaste losgelassen wird.<br />
* Außerdem gibt es noch eine Reihe von [[System-Trigger|System-Triggern]].<br />
<br />
=== Operationen ===<br />
<br />
==== Stack-Operationen ====<br />
<br />
{| class="wikitable" style="font-size:95%;" <br />
|- class="hintergrundfarbe5"<br />
| align="left" |%stackdump%<br />
| align="left" |Gibt eine Dialogbox mit dem Gleitkomma-Stackinhalt aus. Sollte deshalb natürlich nur zu Debug-Zwecken eingesetzt werden.<br />
|-<br />
| align="left" |s0, s1, ..., s7<br />
| align="left" |Speichern des aktuellen Stackwertes im durch die Ziffer angegebenen Register. Der Wert verbleibt hierbei im Stack<br />
|-<br />
| align="left" |l0, l1, ..., l7<br />
| align="left" |Laden des entsprechenden Registerwertes und Verschiebung in den Stack. Registerwert bleibt erhalten.<br />
|-<br />
| align="left" |d<br />
| align="left" |Dubliziert den obersten Stackwert; alle weiteren Stackwerte rücken nach hinten.<br />
|-<br />
| align="left" |$msg<br />
| align="left" |Schreibt den obersten String-Stack-Wert in die Debug-Zeile von OMSI - egal, ob es sich um ein User-, KI-Fahrzeug oder Szenerieobjekt handelt.<br />
|-<br />
| align="left" |$d<br />
| align="left" |Dubliziert den Stringstack-Wert analog zu "d".<br />
|}<br />
<br />
==== Logische Operationen ====<br />
<br />
Die logischen Operationen arbeiten nach dem Prinzip 0 = FALSE, alles andere ist TRUE.<br />
<br />
{| class="wikitable" style="font-size:95%;" <br />
|- class="hintergrundfarbe5"<br />
| align="left" |&&<br />
| align="left" |UND, d.h. wenn einer der beiden obersten Stackwerte gleich 0 ist, ist das Ergbnis 0, sonst 1.<br />
|-<br />
| align="left" |<nowiki>||</nowiki><br />
| align="left" |ODER<br />
|-<br />
| align="left" |<nowiki>!</nowiki><br />
| align="left" |Verneinung<br />
|}<br />
<br />
==== Vergleichsoperationen ====<br />
<br />
Die Vergleichsoperationen vergleichen die Werte in den beiden jeweils obersten Stackplätzen und fügen dann je nach Ergebnis eine "1" oder "0" im obersten Stackplatz ein. Die Größer-/Kleinerzeichen stehen dabei entsprechend für der Reihenfolge, in der die Werte zuvor angegeben wurden. Das bedeutet:<br />
<br />
4 2 > ist wahr, weil die intern durchgeführte Operation in diesem Fall "4 > 2" ist.<br />
<br />
{| class="wikitable" style="font-size:95%;" <br />
|- class="hintergrundfarbe5"<br />
| align="left" |=<br />
| align="left" |"1", falls die obersten Stackwerte identisch sind, sonst "0".<br />
|-<br />
| align="left" |<<br />
| align="left" |"1", falls Stackwert 1 kleiner ist als Stackwert 0, sonst "0".<br />
|-<br />
| align="left" |><br />
| align="left" |... größer ist ...<br />
|-<br />
| align="left" |<=<br />
| align="left" |... kleiner als oder gleich ist ...<br />
|-<br />
| align="left" |>=<br />
| align="left" |... größer als oder gleich ist ...<br />
|-<br />
| align="left" |$=<br />
| align="left" |Wie "=" nur für die obersten beiden Stringstack-Plätze.<br />
|-<br />
| align="left" |$<<br />
| align="left" |Kleiner als (String). Die Ungleich-Operationen bei Strings prüfen auf alphabetische Reihenfolge. "A" ist also kleiner als "B".<br />
|-<br />
| align="left" |$><br />
| align="left" |Größer als (String).<br />
|-<br />
| align="left" |$<=<br />
| align="left" |Kleiner oder gleich (String).<br />
|-<br />
| align="left" |$>=<br />
| align="left" |Größer oder gleich (String).<br />
|}<br />
<br />
==== Mathematische Operationen ====<br />
<br />
{| class="wikitable" style="font-size:95%;" <br />
|- class="hintergrundfarbe5"<br />
| align="left" |+<br />
| align="left" |Plus<br />
|-<br />
| align="left" |-<br />
| align="left" |Minus (Stackplatz 1 - Stackplatz 0, also vom Prinzip her wie bei den Größer/Kleiner-Operationen)<br />
|-<br />
| align="left" |*<br />
| align="left" |Mal<br />
|-<br />
| align="left" |/<br />
| align="left" |geteilt (Stackplatz 1 / Stackplatz 0)<br />
|-<br />
| align="left" |%<br />
| align="left" |Rest der Division (folgendermaßen erweitert für Gleitkommazahlen: Stack0 - trunc(Stack1 / Stack0) * Stack1 )<br />
|-<br />
| align="left" |/-/<br />
| align="left" |Vorzeichenwechsel<br />
|-<br />
| align="left" |sin<br />
| align="left" |Sinus<br />
|-<br />
| align="left" |arcsin<br />
| align="left" |Umkehrfunktion zum Sinus ''(ab OMSI2)''<br />
|-<br />
| align="left" |arctan<br />
| align="left" |Umkehrfunktion zum Tangens ''(ab OMSI2)''<br />
|-<br />
| align="left" |min<br />
| align="left" |Wahl des kleineren der beiden obersten Stackwerte<br />
|-<br />
| align="left" |max<br />
| align="left" |Wahl des größeren der beiden obersten Stackwerte<br />
|-<br />
| align="left" |exp<br />
| align="left" |Exponentialfunktion zur Basis e (e^Stack0)<br />
|-<br />
| align="left" |sqrt<br />
| align="left" |Quadratwurzel<br />
|-<br />
| align="left" |sqr<br />
| align="left" |Quadrat<br />
|-<br />
| align="left" |sgn<br />
| align="left" |Rückgabe des Vorzeichens; je nachdem entweder -1, 0 oder 1<br />
|-<br />
| align="left" |pi<br />
| align="left" |Kreiszahl pi<br />
|-<br />
| align="left" |random<br />
| align="left" |ganzzahlige Zufallszahl 0 <= x < Stack0<br />
|-<br />
| align="left" |abs<br />
| align="left" |Rückgabe des Absolutwertes<br />
|-<br />
| align="left" |trunc<br />
| align="left" |Abrunden auf nächste ganze Zahl<br />
|}<br />
<br />
==== String-Operationen ====<br />
<br />
{| class="wikitable" style="font-size:95%;" <br />
|- class="hintergrundfarbe5"<br />
| align="left" |"''bla''"<br />
| align="left" |Einfügen des Strings ''bla'' auf dem obersten String-Stack-Platz<br />
|-<br />
| align="left" |$+<br />
| align="left" |Zusammenfügen zweier Strings. "Omnibus" "simulator" $+ ergibt "Omnibussimulator"<br />
|-<br />
| align="left" |$*<br />
| align="left" |Der oberste Stack-String wird sooft wiederholt, bis die resultierende Zeichenlänger gerade noch kleiner oder gleich des obersten Stackwertes ist. Beispiel: "nu" 6 $* ergibt "nununu"<br />
|-<br />
| align="left" |$length<br />
| align="left" |Gibt die Anzahl der Zeichen des obersten Stack-String zurück in den Stack. <br />
|-<br />
| align="left" |$cutBegin<br />
| align="left" |Schneidet ''stack0'' Zeichen vorne vom obersten Stack-String ab.<br />
|-<br />
| align="left" |$cutEnd<br />
| align="left" |Schneidet ''stack0'' Zeichen hinten vom obersten Stack-String ab.<br />
|-<br />
| align="left" |$SetLengthR<br />
| align="left" |Passt die Länge des obersten Stack-Strings auf ''stack0'' rechtsbündig an, indem am Anfang Zeichen entfernt oder Leerzeichen ergänzt werden.<br />
Achtung: Der Befehl entfernt den Float-Operator nicht vom Stack. Der Wert, auf dessen Länge der String gekürzt wurde, verbleibt also auf Stack0.<br />
|-<br />
| align="left" |$SetLengthC<br />
| align="left" |Passt die Länge des obersten Stack-Strings auf ''stack0'' zentriert an, indem am Anfang und am Ende Zeichen entfernt oder Leerzeichen ergänzt werden ''(ab OMSI2)''.<br />
Achtung: Der Befehl entfernt den Float-Operator nicht vom Stack. Der Wert, auf dessen Länge der String gekürzt wurde, verbleibt also auf Stack0.<br />
|-<br />
| align="left" |$SetLengthL<br />
| align="left" |Passt die Länge des obersten Stack-Strings auf ''stack0'' linksbündig an, indem am Ende Zeichen entfernt oder Leerzeichen ergänzt werden.<br />
Achtung: Der Befehl entfernt den Float-Operator nicht vom Stack. Der Wert, auf dessen Länge der String gekürzt wurde, verbleibt also auf Stack0.<br />
|-<br />
| align="left" |$IntToStr<br />
| align="left" |Rundet ''stack0'' ab und wandelt die resultierende Ganzzahl um in einen String.<br />
|-<br />
| align="left" |$IntToStrEnh<br />
| align="left" |Die erweiterte Version von IntToStr. Hierbei wird der oberste Stack-String verwendet, um das Format der String-Umwandlung zu bestimmen: Das erste Zeichen im String wird zum Auffüllen der fehlenden Zeichen verwendet, die folgenden Zeichen müssen eine Zahl ergeben, die die Stellen angibt. Beispiel: 35 " 5" $IntToStrEnh führt zu " 35" und 123456789 "011" $IntToStrEnh führt zu "00123456789". Falls ein Fehler vorliegt, wird "ERROR" ausgegeben.<br />
|-<br />
| align="left" |$StrToFloat<br />
| align="left" |Wandelt den obersten Stack-String in eine Gleitkommazahl um, falls möglich. Andernfalls wird eine -1 geschrieben.<br />
|-<br />
| align="left" |$RemoveSpaces<br />
| align="left" |Entfernt sämtliche Leerzeichen vor und nach dem eigentlichen String. Aus " Spandau Freudstr " wird "Spandau Freudstr" ''(ab OMSI2)''.<br />
|-<br />
|}<br />
<br />
=== Variablenzugriff ===<br />
<br />
Es wird unterschieden in Systemvariablen und in lokale Variablen. Die Systemvariablen gelten OMSI-weit, die lokalen Variablen werden zum Fahrzeug/Objekt zugehörig gespeichert.<br />
<br />
Bei den lokalen Variablen gibt es stets einen Grundstamm an Variablen, welcher von OMSI vordefiniert werden. Darüber hinaus können beliebig viele Variablen mit Hilfe der Varlist-Dateien ergänzt werden. Außerdem gibt es seit OMSI2 die Variante, dass man die Variable zwar selbst definieren muss, sie dann aber trotzdem mit einem OMSI-Internen Zustand verbunden wird ("ondemand-vordefinierte Variablen").<br />
<br />
{| class="wikitable" style="font-size:95%;" <br />
|- class="hintergrundfarbe5"<br />
| align="left" |(L.S.''varname'')<br />
| align="left" |Lädt die Systemvariable ''varname'' in den obersten Stackplatz<br />
|-<br />
| align="left" |(L.L.''varname'')<br />
| align="left" |Lädt die lokale Variable ''varname'' in den obersten Stackplatz<br />
|-<br />
| align="left" |(L.$.''varname'')<br />
| align="left" |Lädt die lokale String-Variable ''varname'' in den obersten String-Stackplatz<br />
|-<br />
| align="left" |(S.L.''varname'')<br />
| align="left" |Speichert den obersten Stackplatz in die lokale Variable ''varname''<br />
|-<br />
| align="left" |(S.$.''varname'')<br />
| align="left" |Speichert den obersten String-Stackplatz in die lokale String-Variable ''varname''<br />
|}<br />
<br />
Eine detaillierte Beschreibung der einzelnen Systemvariablen und der vordefinierten lokalen Variablen finden Sie hier: [[System- und vordefinierte lokalen Variablen]]<br />
<br />
=== Konstanten und Funktionen ===<br />
<br />
Lokale Konstanten und [http://de.wikipedia.org/w/index.php?title=Datei:Linear_interpolation.svg&filetimestamp=20080226155013 stückweise definierte lineare Funktionen] können in den Konstantendateien (''constfiles'', ''~_constfile.txt'') definiert werden. Der Aufbau jeder Konstantendatei entspricht der der [[Konfigurationsdateien|Konfigurationsdatei]]. Es gibt lediglich drei Schlüsselwörter. Zu beachten ist: Bisher können keine Strings, sondern nur Fließkommazahlen als Konstanten definiert werden.<br />
<br />
[const] definiert eine neue Konstante und gibt ihren Wert an:<br />
<br />
<pre><br />
[const]<br />
name<br />
wert<br />
</pre><br />
<br />
Beispiel:<br />
<br />
<pre><br />
[const]<br />
leistung<br />
200<br />
</pre><br />
<br />
[newcurve] leitet die Definition einer neuen (stückweise linearen) Funktion ein:<br />
<br />
<pre><br />
[newcurve]<br />
name<br />
</pre><br />
<br />
[pnt] fügt der zuvor mit [newcurve] definierten Funktion ein neues x-y-Paar hinzu. Jede Funktion sollte normalerweise über mindestens zwei Paare verfügen. Die Reihenfolge der Paare ''muss'' in x-Richtung aufsteigend sein!<br />
<br />
<pre><br />
[pnt]<br />
x<br />
y<br />
</pre><br />
<br />
Beispiel:<br />
<br />
<pre><br />
[newcurve]<br />
Drehzahl_Drehmoment_Kennlinie<br />
<br />
[pnt]<br />
50<br />
0<br />
<br />
[pnt]<br />
300<br />
400<br />
<br />
[pnt]<br />
1000<br />
600<br />
</pre><br />
<br />
Konstanten werden über den Befehl (C.L.''konstantenname'') in den Stack geladen.<br />
<br />
Funktionen werden über den Befehl (F.L.''funktionsname'') aufgerufen. Dabei wird stets der zuvor auf oberster Stackposition befindliche Wert als x-Parameter übergaben und der resultierende y-Wert der Funktion stattdessen auf dem obersten Stackplatz gespeichert. Bewegt sich der x-Wert außerhalb der Grenzen der durch die [pnt]-Einträge definierten Eckpunkte, wird stets der y-Wert des nächstliegenden Eckpunktes verwendet. Die Funktion wird also vor dem ersten und hinter dem letzten Eckpunkt ins Unendliche waagerecht verlängert.<br />
<br />
=== Sound-Trigger ===<br />
<br />
Soundtrigger sind nicht mit den weiter oben erwähnten Triggern zu verwechseln!<br />
<br />
Sie stellen vielmehr eine Möglichkeit dar, direkt einen gewünschten Sound abzuspielen. Hierbei gibt es zwei Möglichkeiten:<br />
<br />
(T.L.''soundtriggername'') ist ein einfacher Soundtrigger. Der so markierte Sound wird (einmalig) abgespielt.<br />
<br />
(T.F.''soundtriggername'') ist ein Soundtrigger mit Dateiwechselfunktion. Hierbei wird der oberste Stackstring ausgelesen und als Dateiname verwendet, wobei der Dateipfad relativ zum Sound-Ordner des Objektes interpretiert wird.<br />
<br />
Beispiel:<br />
<br />
Angenommen, die Sounddatei lautet "diese.wav" und ist mit dem Trigger ''MeinTrigger'' verknüpft, dann spielt<br />
<br />
(T.L.MeinTrigger)<br />
<br />
die Datei "diese.wav" ab und<br />
<br />
"andere.wav" (T.F.MeinTrigger)<br />
<br />
die Datei "andere.wav". Alternativ zu (T.L.''soundtriggername'') kann beim Befehl (T.F.''soundtriggername'') auch ein "Nullstring" im Stack liegen (also der String: "").<br />
<br />
=== System-Makros ===<br />
<br />
Die bisherigen Methoden erlauben dem Script folgende Kommunikationsmöglichkeiten mit OMSI:<br />
<br />
* Lesen von Werten über System- und vordefinierte lokale Variablen<br />
* Schreiben von Werten über ebendiese<br />
* Empfangen von Tastatur-, Maus- oder Systemtriggern<br />
<br />
Schließlich gibt es noch eine weitere Methode, um mit dem Hauptprogramm zu kommunizieren, die sogenannten System-Makros, gelegentlich auch unpräzise als "Callback-Funktionen" bezeichnet.<br />
<br />
In bestimmten Situationen ist es nötig, dass das Script Werte von OMSI bekommt, die in größeren Datenbanken vorliegen und daher nicht über vordefinierte Variablen übermittelt werden können, z.B. die Inhalte der Hofdatei. Hier kommen nun die System-Makros ins Spiel.<br />
<br />
Diese arbeiten scriptseitig sehr ähnlich wie die lokalen, selbstdefinierten Makros: Der Aufruf (M.V.''macroname'') ruft das System-Makro auf ("V" stand ursprünglich für "Vehicle-Macro", gilt aber genauso auch in Szenerieobjekten), das sich während der Ausführung Werte aus den beiden Stacks holt und/oder in diese schreibt. Eine Aufstellung aller System-Makros findet sich hier: [[System-Makros]]<br />
<br />
=== Bedingungen und Schleifen ===<br />
<br />
Die einzige Steuerung des Programmablaufs ist zur Zeit nur mit der IF-Bedingung möglich.<br />
<br />
==== IF-Bedingung ====<br />
<br />
<pre><br />
'Hier muss eine Bedingung stehen, z.B.:<br />
(L.L.bla) 1 =<br />
{if}<br />
'Dieser Abschnitt wird ausgeführt, wenn bla = 1 ist:<br />
2 3 +<br />
{else}<br />
'Dieser Abschnitt wird andernfalls ausgeführt:<br />
3 4 +<br />
{endif}<br />
(S.L.blub)<br />
{end}<br />
</pre><br />
<br />
Dass erst die Bedingung formuliert wird und dann erst das Schlüsselwort {if} folgt, sollte einleuchten: Zunächst muss an oberster Stelle des Stacks der Wert abgelegt werden und erst dann folgt das Schlüsselwort {if}, welches diesen Wert prüft. Hierbei bedeutet ähnlich wie bei && und || Gleichheit mit Null gleichbedeutend mit ''False'', alle anderen Werte bedeuten ''True''.<br />
<br />
Wenn also im obigen Beispiel ''bla'' den Wert 1 hat, wird ''blub'' auf den Wert 5 gesetzt, andernfalls auf den Wert 7.<br />
<br />
Verschachtelungen der IF-Bedingung dienen als Ersatz für die (nicht vorhandenen) "Else-If"-Konstruktionen:<br />
<br />
<pre><br />
'Hier muss eine Bedingung stehen, z.B.:<br />
(L.L.bla) 1 =<br />
{if}<br />
'Dieser Abschnitt wird ausgeführt, wenn bla = 1 ist:<br />
2 3 +<br />
{else}<br />
(L.L.bla) 5 =<br />
{if}<br />
'Dieser Abschnitt wird ausgeführt, wenn bla = 5 ist:<br />
3 4 +<br />
{else}<br />
'Dieser Abschnitt wird andernfalls ausgeführt:<br />
13<br />
{endif}<br />
{endif}<br />
(S.L.blub)<br />
{end}<br />
</pre><br />
<br />
Hierbei ist insbesondere auf das doppelte {endif} zu achten! Hier gilt:<br />
<br />
* bla = 1 ==> blub = 5<br />
* bla = 5 ==> blub = 7<br />
* sonst ==> blub = 13<br />
<br />
[[Kategorie:Nachschlagewerk für Addon-Entwickler]]</div>Marcel Kuhnthttp://wiki.omnibussimulator.de/omsiwikineu.de/index.php?title=Scriptsystem&diff=863Scriptsystem2014-02-11T10:49:18Z<p>Marcel Kuhnt: /* Variablenzugriff */</p>
<hr />
<div>''Hinweis: Dieser Artikel wurde noch nicht ins Englische übersetzt!''<br />
<br />
Das Scriptsystem in OMSI ermöglicht es, dass Szenerieobjekte und vor allem Fahrzeuge mit individuellen Systemen ausgestattet werden können, die über Variablen und Funktionsaufrufe mit dem Hauptprogramm und der Grafik- und Soundengine kommunizieren.<br />
<br />
Der hier beschriebene Stand des Scriptsystems entspricht OMSI Version 1.01.<br />
<br />
== Dateien des Scriptsystems ==<br />
<br />
Das Scriptsystem umfasst folgende Dateien:<br />
<br />
* Scriptdateien mit ausführbarem Code (*.osc)<br />
* Varlist- und Stringvarlist-Dateien im OMSI\program-Verzeichnis zur Definition von Systemdateien und vordefinierten Dateien<br />
* Varlist- und Stringvarlist-Dateien zur Definition von Uservariablen<br />
* Constfile-Dateien zur Definition von Userkonstanten und Funktionstabellen<br />
<br />
Abgesehen von den Dateien zur Definition von Systemvariablen müssen alle benötigten Dateien für jedes Fahrzeug/Szenerieobjekt (im folgenden kurz: Objekt) in dessen [[Konfigurationsdatei]] angemeldet werden.<br />
<br />
Hierfür gibt es die Befehle ''[script]'', ''[varnamelist]'', ''[stringvarnamelist]'' und ''[constfile]''. Der erste Eintrag jedes Befehls ist die Anzahl der Dateien, darauf folgen die entsprechenden Dateinamen (inkl. Pfad relativ zur Konfigurationsdatei. Die Namen der Dateien sind nicht relevant, solange sie korrekt in die Listen eingetragen werden.<br />
<br />
Auf die Funktion der jeweiligen Dateien wird im Laufe der Beschreibung der Scriptsprache eingegangen.<br />
<br />
== Grundlagen der Scriptsprache ==<br />
<br />
Das OMSI-Scriptsystem arbeitet mit der [http://de.wikipedia.org/wiki/Umgekehrte_Polnische_Notation umgekehrten Polnischen Notation]. Hierbei steht der Operator hinter den beiden Operanden; vereinfacht gesagt bedeutet es, dass die Operation " 1 + 2 " stattdessen folgendermaßen notiert wird: " 1 2 + ". Ein komplizierteres Beispiel: " (1 + 2) * (4 + 5) " entspricht " 1 2 + 4 5 + * ".<br />
<br />
Ganz wichtig ist die Tatsache, dass die OMSI-Textdateien und insbesondere die Scriptsprache [http://de.wikipedia.org/wiki/Case_sensitivity Case-Sensitive] ist! D.h. es ist immer auf die Groß- und Kleinschreibung zu achten!<br />
<br />
=== Stack und Register ===<br />
<br />
Bei der Verarbeitung der Scripts verfügt OMSI über einen String-Stack und einen [http://de.wikipedia.org/wiki/Stapelspeicher Stack] für [http://de.wikipedia.org/wiki/Gleitkommazahl Gleitkommazahlen]. Im folgenden ist mit "Stack" immer der Stack für Gleitkommazahlen gemeint, andernfalls wird von "String-Stack" gesprochen.<br />
<br />
Beide Stacks enthält 8 Speicherplätze, welche von 0 bis 7 durchnumeriert sind. Jede Script-Operation kann nun einen oder mehrere neue Werte in einen der Stacks einfügen (push), wobei der neue Wert auf die Position 0 gesetzt wird und alle folgenden Werte "einen Platz aufrücken", oder sie kann einen oder mehrere Werte aus dem Stack herausziehen (pop/pull) oder lediglich auslesen (peek).<br />
<br />
Fürs temporäre Ablegen von Zahlen gibt es zusätzlich acht indizierte Speicherplätze, welche direkt geschrieben oder gelesen werden können, die sich im sogenannten Register befinden - hier gibt es jedoch nur einen Register für die Gleitkommazahlen.<br />
<br />
=== Beispiel-Operationen ===<br />
<br />
Beispiel: Die Operation 1 + 4. Der Code hierfür lautet:<br />
<br />
<pre><br />
1 4 +<br />
</pre><br />
<br />
In der folgenden Tabelle wird demonstriert, wie sich hierbei der Stack verhält:<br />
<br />
<pre><br />
Operation: Stack: 0 1 2 3 4 ...<br />
-----------------------------------------------------------------------------<br />
vorher: 0 0 0 0 0<br />
"1" 1 0 0 0 0<br />
"4" 4 1 0 0 0<br />
"+" 5 0 0 0 0<br />
</pre><br />
<br />
Im Ausgangszustand ist der Stack nur mit Nullen (oder unbekannten/zufälligen Werten) gefüllt. Der Befehl "1" schiebt die Eins in den obersten Stackplatz und schiebt alle weiteren Werte (Nullen) nach hinten. Der Befehl "4" schiebt die Vier auf den 0. Platz und alle folgenden Werte, also insbesondere die Eins auf den jeweils nächsten Platz. Im nächsten Schritt "+" werden die obersten beiden Werte aus dem Stack herausgezogen - also 4 und 1 - und summiert. Das Ergebnis (5) wird wiederum in den Stack geschoben. Die beiden ursprünglichen Zahlen sind im Stack nicht mehr vorhanden.<br />
<br />
Ein zweites Beispiel:<br />
<br />
(1 + 2) * (4 + 5) muss wie bereits erwähnt folgendermaßen notiert werden:<br />
<br />
<pre><br />
1 2 + 4 5 + *<br />
</pre><br />
<br />
Der Stack verhält sich somit folgendermaßen:<br />
<br />
<pre><br />
Operation: Stack: 0 1 2 3 4 ...<br />
-----------------------------------------------------------------------------<br />
vorher: 0 0 0 0 0<br />
"1" 1 0 0 0 0<br />
"2" 2 1 0 0 0<br />
"+" 3 0 0 0 0<br />
"4" 4 3 0 0 0<br />
"5" 5 4 3 0 0<br />
"+" 9 3 0 0 0<br />
"*" 27 0 0 0 0<br />
</pre><br />
<br />
Am Ende befindet sich also das korrekte Ergebnis auf Stackplatz 0!<br />
<br />
=== Gleitkommazahlen und Strings ===<br />
<br />
Das OMSI-Skriptsystem arbeitet ausschließlich mit den Datentypen Gleitkommazahl (einfache Präzision mit Vorzeichen) und String. Beide Datentypen haben getrennte Stacks. Deshalb laufen die Verarbeitung von Gleitkommazahlen und Strings im Allgemeinen unabhängig nebeneinander. Jedoch kann es natürlich vorkommen, dass bestimmte Funktionen z.B. Zahlen in Strings umwandeln und somit gleichzeitig auf beide Teilbereiche zugreifen.<br />
<br />
Auf boolische Variablen wurde verzichtet. Für boolische Werte werden im Allgemeinen die Zahlenwerte 0 und 1 verwendet.<br />
<br />
== Script-Schlüsselwörter ==<br />
<br />
=== Kommentare ===<br />
<br />
Kommentierungen sind nur möglich, indem in der auszukommentierenden Zeile ganz vorne ein Apostroph ['] gesetzt wird:<br />
<br />
<pre><br />
'Ich bin eine Kommentarzeile<br />
'Ich bin KEINE Kommentarzeile!<br />
</pre><br />
<br />
=== Einstiegs- und Ausstiegspunkte, Makros und Trigger ===<br />
<br />
Alle Befehle müssen zwischen einem Einstiegs- und einem Ausstiegspunkt liegen.<br />
<br />
Der Einstiegspunkt wird durch eins der folgenden Schlüsselwörter gekennzeichnet:<br />
<br />
* {frame} Im Laufe jedes Frames ruft OMSI über diesen Einstiegspunkt die frameweise Scriptverarbeitung auf, sofern er vorhanden ist.<br />
* {init} Bei der Initialisierung ruft OMSI über diesen Einstiegspunkt die Script-Initialisierung auf.<br />
* {frame_ai} Hierbei handelt es sich um eine Variante des {frame}-Einstiegspunktes, welcher bei Fahrzeugen dann aufgerufen wird, wenn diese nicht im Fokus des Benutzers stehen, z.B. wenn sie als KI-Fahrzeug unterwegs sind. Ist dieser Einstiegspunkt jedoch nicht vorhanden sondern nur {frame}, dann wird dieser alternativ aufgerufen. Bei Szenerieobjekten kommt dieser Eintrittspunkt nicht zur Anwendung.<br />
* {macro:''name''} Dieser Einstiegspunkt ruft ein Subsektion (Makro) auf, welche '''stets nach dem Aufruf''' definiert werden muss.<br />
* {trigger:''name''} Dieser Einstiegspunkt wird vom Hauptprogramm aufgerufen, wenn der Benutzer die Tastenkombination oder das Maus-Event mit der Bezeichnung ''name'' aufruft - es gibt auch bestimmte Trigger, die direkt vom Hauptprogramm aufgerufen werden, z.B. wenn OMSI bei KI-Bussen die Anzeige wechselt u.Ä.<br />
<br />
{end} ist der universelle Ausstiegspunkt. Er muss stets den Block abschließen, der mit einem der obigen Befehle eröffnet wird.<br />
<br />
==== Makroaufruf ====<br />
<br />
Der Aufruf eines Makros erfolgt über (M.L.''name''). Der Aufruf des Makros muss ''immer'' vor dessen Definition erfolgen. Andernfalls meldet OMSI, dass das Makro nicht gefunden wurde.<br />
<br />
==== Aufteilung des Scripts in mehrere Dateien ====<br />
<br />
Bei einfachen Scripts (z.B. bei reinen KI-Fahrzeugen oder Szenerieobjekten) reicht es im Allgemeinen eine *.sco-Datei zu erstellen, welche über einen {frame}...{end}- und ggf. einen {init}...{end}-Block verfügt.<br />
<br />
Handelt es sich jedoch um ein komplettes Fahrzeugscript, dann empfiehlt es sich für die verschiedenen Subsysteme getrennte Dateien anzulegen. Hierbei sollte folgendermaßen vorgegangen werden:<br />
<br />
* Es gibt ein Hauptscript und die nötigen Subsystemdateien. Die Hauptdatei enthält dabei die {frame}- und {init}-Blöcke, die jedoch nur Makros aufrufen, welche in den Subsystemdateien definiert sind.<br />
* Für jedes Subsystem gibt es eine *.sco-Datei und je nach Bedarf eine eigene Varlist und Constfile mit den zum System gehörenden Variablen. Außerdem werden auch hier die Trigger für die Tastenbefehle einsortiert.<br />
* Die Makros sollten sinnvollerweise folgendermaßen benannt werden: {macro:''subsystem''_frame} und {macro:''subsystem''_init}.<br />
* Damit die Makros vom Hauptscript aufgerufen werden, muss dieses in der Liste der Scripts in der Objekt-Konfigurationsdatei als erstes aufgerufen werden. Die Reihenfolge der Scripts untereinander muss ebenfalls so gewählt werden, dass alle dateiübergreifenden Makroaufrufe stets vor der jeweiligen Makrodefinition stehen.<br />
<br />
Die Einschränkung, dass Makros immer hinter dem Aufruf definiert werden müssen, kann zwar bisweilen hinderlich sein, ist aber ein sehr wirksamer Schutz gegen Zirkelschlüsse und Endlosschleifen.<br />
<br />
==== Trigger ====<br />
<br />
Wie schon geschrieben wurde, kann ein {trigger:''name''}...{end}-Abschnitt durch verschiedene Möglichkeiten aus dem Hauptprogramm heraus aufgerufen werden. Hierzu zählen:<br />
<br />
* Auslösung per Tastatur. Wurde die Tastenkombination mit dem Namen ''tastkomb'' bezeichnet, wird {trigger:tastkomb} aufgerufen, wenn die Taste gedrückt wird und {trigger:tastkomb_off}, wenn die Taste losgelassen wird.<br />
* Auslösung per Maus. Wurde ein Mesh angeklickt mit der [mouseevent]-Bezeichnung ''mouse_ev'', so wird {trigger:mouse_ev} aufgerufen, wenn die Maustaste gedrückt wird, {trigger:mouse_ev_drag}, während die Maustaste gehalten wird und {trigger:mouse_ev_off}, wenn die Maustaste losgelassen wird.<br />
* Außerdem gibt es noch eine Reihe von [[System-Trigger|System-Triggern]].<br />
<br />
=== Operationen ===<br />
<br />
==== Stack-Operationen ====<br />
<br />
{| class="wikitable" style="font-size:95%;" <br />
|- class="hintergrundfarbe5"<br />
| align="left" |%stackdump%<br />
| align="left" |Gibt eine Dialogbox mit dem Gleitkomma-Stackinhalt aus. Sollte deshalb natürlich nur zu Debug-Zwecken eingesetzt werden.<br />
|-<br />
| align="left" |s0, s1, ..., s7<br />
| align="left" |Speichern des aktuellen Stackwertes im durch die Ziffer angegebenen Register. Der Wert verbleibt hierbei im Stack<br />
|-<br />
| align="left" |l0, l1, ..., l7<br />
| align="left" |Laden des entsprechenden Registerwertes und Verschiebung in den Stack. Registerwert bleibt erhalten.<br />
|-<br />
| align="left" |d<br />
| align="left" |Dubliziert den obersten Stackwert; alle weiteren Stackwerte rücken nach hinten.<br />
|-<br />
| align="left" |$msg<br />
| align="left" |Schreibt den obersten String-Stack-Wert in die Debug-Zeile von OMSI - egal, ob es sich um ein User-, KI-Fahrzeug oder Szenerieobjekt handelt.<br />
|-<br />
| align="left" |$d<br />
| align="left" |Dubliziert den Stringstack-Wert analog zu "d".<br />
|}<br />
<br />
==== Logische Operationen ====<br />
<br />
Die logischen Operationen arbeiten nach dem Prinzip 0 = FALSE, alles andere ist TRUE.<br />
<br />
{| class="wikitable" style="font-size:95%;" <br />
|- class="hintergrundfarbe5"<br />
| align="left" |&&<br />
| align="left" |UND, d.h. wenn einer der beiden obersten Stackwerte gleich 0 ist, ist das Ergbnis 0, sonst 1.<br />
|-<br />
| align="left" |<nowiki>||</nowiki><br />
| align="left" |ODER<br />
|-<br />
| align="left" |<nowiki>!</nowiki><br />
| align="left" |Verneinung<br />
|}<br />
<br />
==== Vergleichsoperationen ====<br />
<br />
Die Vergleichsoperationen vergleichen die Werte in den beiden jeweils obersten Stackplätzen und fügen dann je nach Ergebnis eine "1" oder "0" im obersten Stackplatz ein. Die Größer-/Kleinerzeichen stehen dabei entsprechend für der Reihenfolge, in der die Werte zuvor angegeben wurden. Das bedeutet:<br />
<br />
4 2 > ist wahr, weil die intern durchgeführte Operation in diesem Fall "4 > 2" ist.<br />
<br />
{| class="wikitable" style="font-size:95%;" <br />
|- class="hintergrundfarbe5"<br />
| align="left" |=<br />
| align="left" |"1", falls die obersten Stackwerte identisch sind, sonst "0".<br />
|-<br />
| align="left" |<<br />
| align="left" |"1", falls Stackwert 1 kleiner ist als Stackwert 0, sonst "0".<br />
|-<br />
| align="left" |><br />
| align="left" |... größer ist ...<br />
|-<br />
| align="left" |<=<br />
| align="left" |... kleiner als oder gleich ist ...<br />
|-<br />
| align="left" |>=<br />
| align="left" |... größer als oder gleich ist ...<br />
|-<br />
| align="left" |$=<br />
| align="left" |Wie "=" nur für die obersten beiden Stringstack-Plätze.<br />
|-<br />
| align="left" |$<<br />
| align="left" |Kleiner als (String). Die Ungleich-Operationen bei Strings prüfen auf alphabetische Reihenfolge. "A" ist also kleiner als "B".<br />
|-<br />
| align="left" |$><br />
| align="left" |Größer als (String).<br />
|-<br />
| align="left" |$<=<br />
| align="left" |Kleiner oder gleich (String).<br />
|-<br />
| align="left" |$>=<br />
| align="left" |Größer oder gleich (String).<br />
|}<br />
<br />
==== Mathematische Operationen ====<br />
<br />
{| class="wikitable" style="font-size:95%;" <br />
|- class="hintergrundfarbe5"<br />
| align="left" |+<br />
| align="left" |Plus<br />
|-<br />
| align="left" |-<br />
| align="left" |Minus (Stackplatz 1 - Stackplatz 0, also vom Prinzip her wie bei den Größer/Kleiner-Operationen)<br />
|-<br />
| align="left" |*<br />
| align="left" |Mal<br />
|-<br />
| align="left" |/<br />
| align="left" |geteilt (Stackplatz 1 / Stackplatz 0)<br />
|-<br />
| align="left" |%<br />
| align="left" |Rest der Division (folgendermaßen erweitert für Gleitkommazahlen: Stack0 - trunc(Stack1 / Stack0) * Stack1 )<br />
|-<br />
| align="left" |/-/<br />
| align="left" |Vorzeichenwechsel<br />
|-<br />
| align="left" |sin<br />
| align="left" |Sinus<br />
|-<br />
| align="left" |arcsin<br />
| align="left" |Umkehrfunktion zum Sinus ''(ab OMSI2)''<br />
|-<br />
| align="left" |arctan<br />
| align="left" |Umkehrfunktion zum Tangens ''(ab OMSI2)''<br />
|-<br />
| align="left" |min<br />
| align="left" |Wahl des kleineren der beiden obersten Stackwerte<br />
|-<br />
| align="left" |max<br />
| align="left" |Wahl des größeren der beiden obersten Stackwerte<br />
|-<br />
| align="left" |exp<br />
| align="left" |Exponentialfunktion zur Basis e (e^Stack0)<br />
|-<br />
| align="left" |sqrt<br />
| align="left" |Quadratwurzel<br />
|-<br />
| align="left" |sqr<br />
| align="left" |Quadrat<br />
|-<br />
| align="left" |sgn<br />
| align="left" |Rückgabe des Vorzeichens; je nachdem entweder -1, 0 oder 1<br />
|-<br />
| align="left" |pi<br />
| align="left" |Kreiszahl pi<br />
|-<br />
| align="left" |random<br />
| align="left" |ganzzahlige Zufallszahl 0 <= x < Stack0<br />
|-<br />
| align="left" |abs<br />
| align="left" |Rückgabe des Absolutwertes<br />
|-<br />
| align="left" |trunc<br />
| align="left" |Abrunden auf nächste ganze Zahl<br />
|}<br />
<br />
==== String-Operationen ====<br />
<br />
{| class="wikitable" style="font-size:95%;" <br />
|- class="hintergrundfarbe5"<br />
| align="left" |"''bla''"<br />
| align="left" |Einfügen des Strings ''bla'' auf dem obersten String-Stack-Platz<br />
|-<br />
| align="left" |$+<br />
| align="left" |Zusammenfügen zweier Strings. "Omnibus" "simulator" $+ ergibt "Omnibussimulator"<br />
|-<br />
| align="left" |$*<br />
| align="left" |Der oberste Stack-String wird sooft wiederholt, bis die resultierende Zeichenlänger gerade noch kleiner oder gleich des obersten Stackwertes ist. Beispiel: "nu" 6 $* ergibt "nununu"<br />
|-<br />
| align="left" |$length<br />
| align="left" |Gibt die Anzahl der Zeichen des obersten Stack-String zurück in den Stack. <br />
|-<br />
| align="left" |$cutBegin<br />
| align="left" |Schneidet ''stack0'' Zeichen vorne vom obersten Stack-String ab.<br />
|-<br />
| align="left" |$cutEnd<br />
| align="left" |Schneidet ''stack0'' Zeichen hinten vom obersten Stack-String ab.<br />
|-<br />
| align="left" |$SetLengthR<br />
| align="left" |Passt die Länge des obersten Stack-Strings auf ''stack0'' rechtsbündig an, indem am Anfang Zeichen entfernt oder Leerzeichen ergänzt werden.<br />
Achtung: Der Befehl entfernt den Float-Operator nicht vom Stack. Der Wert, auf dessen Länge der String gekürzt wurde, verbleibt also auf Stack0.<br />
|-<br />
| align="left" |$SetLengthC<br />
| align="left" |Passt die Länge des obersten Stack-Strings auf ''stack0'' zentriert an, indem am Anfang und am Ende Zeichen entfernt oder Leerzeichen ergänzt werden ''(ab OMSI2)''.<br />
Achtung: Der Befehl entfernt den Float-Operator nicht vom Stack. Der Wert, auf dessen Länge der String gekürzt wurde, verbleibt also auf Stack0.<br />
|-<br />
| align="left" |$SetLengthL<br />
| align="left" |Passt die Länge des obersten Stack-Strings auf ''stack0'' linksbündig an, indem am Ende Zeichen entfernt oder Leerzeichen ergänzt werden.<br />
Achtung: Der Befehl entfernt den Float-Operator nicht vom Stack. Der Wert, auf dessen Länge der String gekürzt wurde, verbleibt also auf Stack0.<br />
|-<br />
| align="left" |$IntToStr<br />
| align="left" |Rundet ''stack0'' ab und wandelt die resultierende Ganzzahl um in einen String.<br />
|-<br />
| align="left" |$IntToStrEnh<br />
| align="left" |Die erweiterte Version von IntToStr. Hierbei wird der oberste Stack-String verwendet, um das Format der String-Umwandlung zu bestimmen: Das erste Zeichen im String wird zum Auffüllen der fehlenden Zeichen verwendet, die folgenden Zeichen müssen eine Zahl ergeben, die die Stellen angibt. Beispiel: 35 " 5" $IntToStrEnh führt zu " 35" und 123456789 "011" $IntToStrEnh führt zu "00123456789". Falls ein Fehler vorliegt, wird "ERROR" ausgegeben.<br />
|-<br />
| align="left" |$StrToFloat<br />
| align="left" |Wandelt den obersten Stack-String in eine Gleitkommazahl um, falls möglich. Andernfalls wird eine -1 geschrieben.<br />
|-<br />
| align="left" |$RemoveSpaces<br />
| align="left" |Entfernt sämtliche Leerzeichen vor und nach dem eigentlichen String. Aus " Spandau Freudstr " wird "Spandau Freudstr" ''(ab OMSI2)''.<br />
|-<br />
|}<br />
<br />
=== Variablenzugriff ===<br />
<br />
Es wird unterschieden in Systemvariablen und in lokale Variablen. Die Systemvariablen gelten OMSI-weit, die lokalen Variablen werden zum Fahrzeug/Objekt zugehörig gespeichert.<br />
<br />
Bei den lokalen Variablen gibt es stets einen Grundstamm an Variablen, welcher von OMSI vordefiniert werden. Darüber hinaus können beliebig viele Variablen mit Hilfe der Varlist-Dateien ergänzt werden. Außerdem gibt es seit OMSI2 die Variante, dass man die Variable zwar selbst definieren muss, sie dann aber trotzdem mit einem OMSI-Internen Zustand verbunden wird ("ondemand-vordefinierte Variablen").<br />
<br />
{| class="wikitable" style="font-size:95%;" <br />
|- class="hintergrundfarbe5"<br />
| align="left" |(L.S.''varname'')<br />
| align="left" |Lädt die Systemvariable ''varname'' in den obersten Stackplatz<br />
|-<br />
| align="left" |(L.L.''varname'')<br />
| align="left" |Lädt die lokale Variable ''varname'' in den obersten Stackplatz<br />
|-<br />
| align="left" |(L.$.''varname'')<br />
| align="left" |Lädt die lokale String-Variable ''varname'' in den obersten String-Stackplatz<br />
|-<br />
| align="left" |(S.L.''varname'')<br />
| align="left" |Speichert den obersten Stackplatz in die lokale Variable ''varname''<br />
|-<br />
| align="left" |(S.$.''varname'')<br />
| align="left" |Speichert den obersten String-Stackplatz in die lokale String-Variable ''varname''<br />
|}<br />
<br />
Eine detaillierte Beschreibung der einzelnen Systemvariablen und der vordefinierten lokalen Variablen finden Sie hier: [[System- und vordefinierte lokalen Variablen]]<br />
<br />
=== Konstanten und Funktionen ===<br />
<br />
Lokale Konstanten und [http://de.wikipedia.org/w/index.php?title=Datei:Linear_interpolation.svg&filetimestamp=20080226155013 stückweise definierte lineare Funktionen] können in den Konstantendateien (''constfiles'', ''~_constfile.txt'') definiert werden. Der Aufbau jeder Konstantendatei entspricht der der [[Konfigurationsdateien|Konfigurationsdatei]]. Es gibt lediglich drei Schlüsselwörter. Zu beachten ist: Bisher können keine Strings, sondern nur Fließkommazahlen als Konstanten definiert werden.<br />
<br />
[const] definiert eine neue Konstante und gibt ihren Wert an:<br />
<br />
<pre><br />
[const]<br />
name<br />
wert<br />
</pre><br />
<br />
Beispiel:<br />
<br />
<pre><br />
[const]<br />
leistung<br />
200<br />
</pre><br />
<br />
[newcurve] leitet die Definition einer neuen (stückweise linearen) Funktion ein:<br />
<br />
<pre><br />
[newcurve]<br />
name<br />
</pre><br />
<br />
[pnt] fügt der zuvor mit [newcurve] definierten Funktion ein neues x-y-Paar hinzu. Jede Funktion sollte normalerweise über mindestens zwei Paare verfügen. Die Reihenfolge der Paare ''muss'' in x-Richtung aufsteigend sein!<br />
<br />
<pre><br />
[pnt]<br />
x<br />
y<br />
</pre><br />
<br />
Beispiel:<br />
<br />
<pre><br />
[newcurve]<br />
Drehzahl_Drehmoment_Kennlinie<br />
<br />
[pnt]<br />
50<br />
0<br />
<br />
[pnt]<br />
300<br />
400<br />
<br />
[pnt]<br />
1000<br />
600<br />
</pre><br />
<br />
Konstanten werden über den Befehl (C.L.''konstantenname'') in den Stack geladen.<br />
<br />
Funktionen werden über den Befehl (F.L.''funktionsname'') aufgerufen. Dabei wird stets der zuvor auf oberster Stackposition befindliche Wert als x-Parameter übergaben und der resultierende y-Wert der Funktion stattdessen auf dem obersten Stackplatz gespeichert. Bewegt sich der x-Wert außerhalb der Grenzen der durch die [pnt]-Einträge definierten Eckpunkte, wird stets der y-Wert des nächstliegenden Eckpunktes verwendet. Die Funktion wird also vor dem ersten und hinter dem letzten Eckpunkt ins Unendliche waagerecht verlängert.<br />
<br />
=== Sound-Trigger ===<br />
<br />
Soundtrigger sind nicht mit den weiter oben erwähnten Triggern zu verwechseln!<br />
<br />
Sie stellen vielmehr eine Möglichkeit dar, direkt einen gewünschten Sound abzuspielen. Hierbei gibt es zwei Möglichkeiten:<br />
<br />
(T.L.''soundtriggername'') ist ein einfacher Soundtrigger. Der so markierte Sound wird (einmalig) abgespielt.<br />
<br />
(T.F.''soundtriggername'') ist ein Soundtrigger mit Dateiwechselfunktion. Hierbei wird der oberste Stackstring ausgelesen und als Dateiname verwendet, wobei der Dateipfad relativ zum Sound-Ordner des Objektes interpretiert wird.<br />
<br />
Beispiel:<br />
<br />
Angenommen, die Sounddatei lautet "diese.wav" und ist mit dem Trigger ''MeinTrigger'' verknüpft, dann spielt<br />
<br />
(T.L.MeinTrigger)<br />
<br />
die Datei "diese.wav" ab und<br />
<br />
"andere.wav" (T.F.MeinTrigger)<br />
<br />
die Datei "andere.wav". Alternativ zu (T.L.''soundtriggername'') kann beim Befehl (T.F.''soundtriggername'') auch ein "Nullstring" im Stack liegen (also der String: "").<br />
<br />
=== System-Makros ===<br />
<br />
Die bisherigen Methoden erlauben dem Script folgende Kommunikationsmöglichkeiten mit OMSI:<br />
<br />
* Lesen von Werten über System- und vordefinierte lokale Variablen<br />
* Schreiben von Werten über ebendiese<br />
* Empfangen von Tastatur-, Maus- oder Systemtriggern<br />
<br />
Schließlich gibt es noch eine weitere Methode, um mit dem Hauptprogramm zu kommunizieren, die sogenannten System-Makros, gelegentlich auch unpräzise als "Callback-Funktionen" bezeichnet.<br />
<br />
In bestimmten Situationen ist es nötig, dass das Script Werte von OMSI bekommt, die in größeren Datenbanken vorliegen und daher nicht über vordefinierte Variablen übermittelt werden können, z.B. die Inhalte der Hofdatei. Hier kommen nun die System-Makros ins Spiel.<br />
<br />
Diese arbeiten scriptseitig sehr ähnlich wie die lokalen, selbstdefinierten Makros: Der Aufruf (M.V.''macroname'') ruft das System-Makro auf ("V" stand ursprünglich für "Vehicle-Macro", gilt aber genauso auch in Szenerieobjekten), das sich während der Ausführung Werte aus den beiden Stacks holt und/oder in diese schreibt. Eine Aufstellung aller System-Makros findet sich hier: [[System-Makros]]<br />
<br />
=== Bedingungen und Schleifen ===<br />
<br />
Die einzige Steuerung des Programmablaufs ist zur Zeit nur mit der IF-Bedingung möglich.<br />
<br />
==== IF-Bedingung ====<br />
<br />
<pre><br />
'Hier muss eine Bedingung stehen, z.B.:<br />
(L.L.bla) 1 =<br />
{if}<br />
'Dieser Abschnitt wird ausgeführt, wenn bla = 1 ist:<br />
2 3 +<br />
{else}<br />
'Dieser Abschnitt wird andernfalls ausgeführt:<br />
3 4 +<br />
{endif}<br />
(S.L.blub)<br />
{end}<br />
</pre><br />
<br />
Dass erst die Bedingung formuliert wird und dann erst das Schlüsselwort {if} folgt, sollte einleuchten: Zunächst muss an oberster Stelle des Stacks der Wert abgelegt werden und erst dann folgt das Schlüsselwort {if}, welches diesen Wert prüft. Hierbei bedeutet ähnlich wie bei && und || Gleichheit mit Null gleichbedeutend mit ''False'', alle anderen Werte bedeuten ''True''.<br />
<br />
Wenn also im obigen Beispiel ''bla'' den Wert 1 hat, wird ''blub'' auf den Wert 5 gesetzt, andernfalls auf den Wert 7.<br />
<br />
Verschachtelungen der IF-Bedingung dienen als Ersatz für die (nicht vorhandenen) "Else-If"-Konstruktionen:<br />
<br />
<pre><br />
'Hier muss eine Bedingung stehen, z.B.:<br />
(L.L.bla) 1 =<br />
{if}<br />
'Dieser Abschnitt wird ausgeführt, wenn bla = 1 ist:<br />
2 3 +<br />
{else}<br />
(L.L.bla) 5 =<br />
{if}<br />
'Dieser Abschnitt wird ausgeführt, wenn bla = 5 ist:<br />
3 4 +<br />
{else}<br />
'Dieser Abschnitt wird andernfalls ausgeführt:<br />
13<br />
{endif}<br />
{endif}<br />
(S.L.blub)<br />
{end}<br />
</pre><br />
<br />
Hierbei ist insbesondere auf das doppelte {endif} zu achten! Hier gilt:<br />
<br />
* bla = 1 ==> blub = 5<br />
* bla = 5 ==> blub = 7<br />
* sonst ==> blub = 13<br />
<br />
[[Kategorie:Nachschlagewerk für Addon-Entwickler]]</div>Marcel Kuhnthttp://wiki.omnibussimulator.de/omsiwikineu.de/index.php?title=Scriptsystem&diff=862Scriptsystem2014-02-11T10:47:08Z<p>Marcel Kuhnt: /* Dateien des Scriptsystems */</p>
<hr />
<div>''Hinweis: Dieser Artikel wurde noch nicht ins Englische übersetzt!''<br />
<br />
Das Scriptsystem in OMSI ermöglicht es, dass Szenerieobjekte und vor allem Fahrzeuge mit individuellen Systemen ausgestattet werden können, die über Variablen und Funktionsaufrufe mit dem Hauptprogramm und der Grafik- und Soundengine kommunizieren.<br />
<br />
Der hier beschriebene Stand des Scriptsystems entspricht OMSI Version 1.01.<br />
<br />
== Dateien des Scriptsystems ==<br />
<br />
Das Scriptsystem umfasst folgende Dateien:<br />
<br />
* Scriptdateien mit ausführbarem Code (*.osc)<br />
* Varlist- und Stringvarlist-Dateien im OMSI\program-Verzeichnis zur Definition von Systemdateien und vordefinierten Dateien<br />
* Varlist- und Stringvarlist-Dateien zur Definition von Uservariablen<br />
* Constfile-Dateien zur Definition von Userkonstanten und Funktionstabellen<br />
<br />
Abgesehen von den Dateien zur Definition von Systemvariablen müssen alle benötigten Dateien für jedes Fahrzeug/Szenerieobjekt (im folgenden kurz: Objekt) in dessen [[Konfigurationsdatei]] angemeldet werden.<br />
<br />
Hierfür gibt es die Befehle ''[script]'', ''[varnamelist]'', ''[stringvarnamelist]'' und ''[constfile]''. Der erste Eintrag jedes Befehls ist die Anzahl der Dateien, darauf folgen die entsprechenden Dateinamen (inkl. Pfad relativ zur Konfigurationsdatei. Die Namen der Dateien sind nicht relevant, solange sie korrekt in die Listen eingetragen werden.<br />
<br />
Auf die Funktion der jeweiligen Dateien wird im Laufe der Beschreibung der Scriptsprache eingegangen.<br />
<br />
== Grundlagen der Scriptsprache ==<br />
<br />
Das OMSI-Scriptsystem arbeitet mit der [http://de.wikipedia.org/wiki/Umgekehrte_Polnische_Notation umgekehrten Polnischen Notation]. Hierbei steht der Operator hinter den beiden Operanden; vereinfacht gesagt bedeutet es, dass die Operation " 1 + 2 " stattdessen folgendermaßen notiert wird: " 1 2 + ". Ein komplizierteres Beispiel: " (1 + 2) * (4 + 5) " entspricht " 1 2 + 4 5 + * ".<br />
<br />
Ganz wichtig ist die Tatsache, dass die OMSI-Textdateien und insbesondere die Scriptsprache [http://de.wikipedia.org/wiki/Case_sensitivity Case-Sensitive] ist! D.h. es ist immer auf die Groß- und Kleinschreibung zu achten!<br />
<br />
=== Stack und Register ===<br />
<br />
Bei der Verarbeitung der Scripts verfügt OMSI über einen String-Stack und einen [http://de.wikipedia.org/wiki/Stapelspeicher Stack] für [http://de.wikipedia.org/wiki/Gleitkommazahl Gleitkommazahlen]. Im folgenden ist mit "Stack" immer der Stack für Gleitkommazahlen gemeint, andernfalls wird von "String-Stack" gesprochen.<br />
<br />
Beide Stacks enthält 8 Speicherplätze, welche von 0 bis 7 durchnumeriert sind. Jede Script-Operation kann nun einen oder mehrere neue Werte in einen der Stacks einfügen (push), wobei der neue Wert auf die Position 0 gesetzt wird und alle folgenden Werte "einen Platz aufrücken", oder sie kann einen oder mehrere Werte aus dem Stack herausziehen (pop/pull) oder lediglich auslesen (peek).<br />
<br />
Fürs temporäre Ablegen von Zahlen gibt es zusätzlich acht indizierte Speicherplätze, welche direkt geschrieben oder gelesen werden können, die sich im sogenannten Register befinden - hier gibt es jedoch nur einen Register für die Gleitkommazahlen.<br />
<br />
=== Beispiel-Operationen ===<br />
<br />
Beispiel: Die Operation 1 + 4. Der Code hierfür lautet:<br />
<br />
<pre><br />
1 4 +<br />
</pre><br />
<br />
In der folgenden Tabelle wird demonstriert, wie sich hierbei der Stack verhält:<br />
<br />
<pre><br />
Operation: Stack: 0 1 2 3 4 ...<br />
-----------------------------------------------------------------------------<br />
vorher: 0 0 0 0 0<br />
"1" 1 0 0 0 0<br />
"4" 4 1 0 0 0<br />
"+" 5 0 0 0 0<br />
</pre><br />
<br />
Im Ausgangszustand ist der Stack nur mit Nullen (oder unbekannten/zufälligen Werten) gefüllt. Der Befehl "1" schiebt die Eins in den obersten Stackplatz und schiebt alle weiteren Werte (Nullen) nach hinten. Der Befehl "4" schiebt die Vier auf den 0. Platz und alle folgenden Werte, also insbesondere die Eins auf den jeweils nächsten Platz. Im nächsten Schritt "+" werden die obersten beiden Werte aus dem Stack herausgezogen - also 4 und 1 - und summiert. Das Ergebnis (5) wird wiederum in den Stack geschoben. Die beiden ursprünglichen Zahlen sind im Stack nicht mehr vorhanden.<br />
<br />
Ein zweites Beispiel:<br />
<br />
(1 + 2) * (4 + 5) muss wie bereits erwähnt folgendermaßen notiert werden:<br />
<br />
<pre><br />
1 2 + 4 5 + *<br />
</pre><br />
<br />
Der Stack verhält sich somit folgendermaßen:<br />
<br />
<pre><br />
Operation: Stack: 0 1 2 3 4 ...<br />
-----------------------------------------------------------------------------<br />
vorher: 0 0 0 0 0<br />
"1" 1 0 0 0 0<br />
"2" 2 1 0 0 0<br />
"+" 3 0 0 0 0<br />
"4" 4 3 0 0 0<br />
"5" 5 4 3 0 0<br />
"+" 9 3 0 0 0<br />
"*" 27 0 0 0 0<br />
</pre><br />
<br />
Am Ende befindet sich also das korrekte Ergebnis auf Stackplatz 0!<br />
<br />
=== Gleitkommazahlen und Strings ===<br />
<br />
Das OMSI-Skriptsystem arbeitet ausschließlich mit den Datentypen Gleitkommazahl (einfache Präzision mit Vorzeichen) und String. Beide Datentypen haben getrennte Stacks. Deshalb laufen die Verarbeitung von Gleitkommazahlen und Strings im Allgemeinen unabhängig nebeneinander. Jedoch kann es natürlich vorkommen, dass bestimmte Funktionen z.B. Zahlen in Strings umwandeln und somit gleichzeitig auf beide Teilbereiche zugreifen.<br />
<br />
Auf boolische Variablen wurde verzichtet. Für boolische Werte werden im Allgemeinen die Zahlenwerte 0 und 1 verwendet.<br />
<br />
== Script-Schlüsselwörter ==<br />
<br />
=== Kommentare ===<br />
<br />
Kommentierungen sind nur möglich, indem in der auszukommentierenden Zeile ganz vorne ein Apostroph ['] gesetzt wird:<br />
<br />
<pre><br />
'Ich bin eine Kommentarzeile<br />
'Ich bin KEINE Kommentarzeile!<br />
</pre><br />
<br />
=== Einstiegs- und Ausstiegspunkte, Makros und Trigger ===<br />
<br />
Alle Befehle müssen zwischen einem Einstiegs- und einem Ausstiegspunkt liegen.<br />
<br />
Der Einstiegspunkt wird durch eins der folgenden Schlüsselwörter gekennzeichnet:<br />
<br />
* {frame} Im Laufe jedes Frames ruft OMSI über diesen Einstiegspunkt die frameweise Scriptverarbeitung auf, sofern er vorhanden ist.<br />
* {init} Bei der Initialisierung ruft OMSI über diesen Einstiegspunkt die Script-Initialisierung auf.<br />
* {frame_ai} Hierbei handelt es sich um eine Variante des {frame}-Einstiegspunktes, welcher bei Fahrzeugen dann aufgerufen wird, wenn diese nicht im Fokus des Benutzers stehen, z.B. wenn sie als KI-Fahrzeug unterwegs sind. Ist dieser Einstiegspunkt jedoch nicht vorhanden sondern nur {frame}, dann wird dieser alternativ aufgerufen. Bei Szenerieobjekten kommt dieser Eintrittspunkt nicht zur Anwendung.<br />
* {macro:''name''} Dieser Einstiegspunkt ruft ein Subsektion (Makro) auf, welche '''stets nach dem Aufruf''' definiert werden muss.<br />
* {trigger:''name''} Dieser Einstiegspunkt wird vom Hauptprogramm aufgerufen, wenn der Benutzer die Tastenkombination oder das Maus-Event mit der Bezeichnung ''name'' aufruft - es gibt auch bestimmte Trigger, die direkt vom Hauptprogramm aufgerufen werden, z.B. wenn OMSI bei KI-Bussen die Anzeige wechselt u.Ä.<br />
<br />
{end} ist der universelle Ausstiegspunkt. Er muss stets den Block abschließen, der mit einem der obigen Befehle eröffnet wird.<br />
<br />
==== Makroaufruf ====<br />
<br />
Der Aufruf eines Makros erfolgt über (M.L.''name''). Der Aufruf des Makros muss ''immer'' vor dessen Definition erfolgen. Andernfalls meldet OMSI, dass das Makro nicht gefunden wurde.<br />
<br />
==== Aufteilung des Scripts in mehrere Dateien ====<br />
<br />
Bei einfachen Scripts (z.B. bei reinen KI-Fahrzeugen oder Szenerieobjekten) reicht es im Allgemeinen eine *.sco-Datei zu erstellen, welche über einen {frame}...{end}- und ggf. einen {init}...{end}-Block verfügt.<br />
<br />
Handelt es sich jedoch um ein komplettes Fahrzeugscript, dann empfiehlt es sich für die verschiedenen Subsysteme getrennte Dateien anzulegen. Hierbei sollte folgendermaßen vorgegangen werden:<br />
<br />
* Es gibt ein Hauptscript und die nötigen Subsystemdateien. Die Hauptdatei enthält dabei die {frame}- und {init}-Blöcke, die jedoch nur Makros aufrufen, welche in den Subsystemdateien definiert sind.<br />
* Für jedes Subsystem gibt es eine *.sco-Datei und je nach Bedarf eine eigene Varlist und Constfile mit den zum System gehörenden Variablen. Außerdem werden auch hier die Trigger für die Tastenbefehle einsortiert.<br />
* Die Makros sollten sinnvollerweise folgendermaßen benannt werden: {macro:''subsystem''_frame} und {macro:''subsystem''_init}.<br />
* Damit die Makros vom Hauptscript aufgerufen werden, muss dieses in der Liste der Scripts in der Objekt-Konfigurationsdatei als erstes aufgerufen werden. Die Reihenfolge der Scripts untereinander muss ebenfalls so gewählt werden, dass alle dateiübergreifenden Makroaufrufe stets vor der jeweiligen Makrodefinition stehen.<br />
<br />
Die Einschränkung, dass Makros immer hinter dem Aufruf definiert werden müssen, kann zwar bisweilen hinderlich sein, ist aber ein sehr wirksamer Schutz gegen Zirkelschlüsse und Endlosschleifen.<br />
<br />
==== Trigger ====<br />
<br />
Wie schon geschrieben wurde, kann ein {trigger:''name''}...{end}-Abschnitt durch verschiedene Möglichkeiten aus dem Hauptprogramm heraus aufgerufen werden. Hierzu zählen:<br />
<br />
* Auslösung per Tastatur. Wurde die Tastenkombination mit dem Namen ''tastkomb'' bezeichnet, wird {trigger:tastkomb} aufgerufen, wenn die Taste gedrückt wird und {trigger:tastkomb_off}, wenn die Taste losgelassen wird.<br />
* Auslösung per Maus. Wurde ein Mesh angeklickt mit der [mouseevent]-Bezeichnung ''mouse_ev'', so wird {trigger:mouse_ev} aufgerufen, wenn die Maustaste gedrückt wird, {trigger:mouse_ev_drag}, während die Maustaste gehalten wird und {trigger:mouse_ev_off}, wenn die Maustaste losgelassen wird.<br />
* Außerdem gibt es noch eine Reihe von [[System-Trigger|System-Triggern]].<br />
<br />
=== Operationen ===<br />
<br />
==== Stack-Operationen ====<br />
<br />
{| class="wikitable" style="font-size:95%;" <br />
|- class="hintergrundfarbe5"<br />
| align="left" |%stackdump%<br />
| align="left" |Gibt eine Dialogbox mit dem Gleitkomma-Stackinhalt aus. Sollte deshalb natürlich nur zu Debug-Zwecken eingesetzt werden.<br />
|-<br />
| align="left" |s0, s1, ..., s7<br />
| align="left" |Speichern des aktuellen Stackwertes im durch die Ziffer angegebenen Register. Der Wert verbleibt hierbei im Stack<br />
|-<br />
| align="left" |l0, l1, ..., l7<br />
| align="left" |Laden des entsprechenden Registerwertes und Verschiebung in den Stack. Registerwert bleibt erhalten.<br />
|-<br />
| align="left" |d<br />
| align="left" |Dubliziert den obersten Stackwert; alle weiteren Stackwerte rücken nach hinten.<br />
|-<br />
| align="left" |$msg<br />
| align="left" |Schreibt den obersten String-Stack-Wert in die Debug-Zeile von OMSI - egal, ob es sich um ein User-, KI-Fahrzeug oder Szenerieobjekt handelt.<br />
|-<br />
| align="left" |$d<br />
| align="left" |Dubliziert den Stringstack-Wert analog zu "d".<br />
|}<br />
<br />
==== Logische Operationen ====<br />
<br />
Die logischen Operationen arbeiten nach dem Prinzip 0 = FALSE, alles andere ist TRUE.<br />
<br />
{| class="wikitable" style="font-size:95%;" <br />
|- class="hintergrundfarbe5"<br />
| align="left" |&&<br />
| align="left" |UND, d.h. wenn einer der beiden obersten Stackwerte gleich 0 ist, ist das Ergbnis 0, sonst 1.<br />
|-<br />
| align="left" |<nowiki>||</nowiki><br />
| align="left" |ODER<br />
|-<br />
| align="left" |<nowiki>!</nowiki><br />
| align="left" |Verneinung<br />
|}<br />
<br />
==== Vergleichsoperationen ====<br />
<br />
Die Vergleichsoperationen vergleichen die Werte in den beiden jeweils obersten Stackplätzen und fügen dann je nach Ergebnis eine "1" oder "0" im obersten Stackplatz ein. Die Größer-/Kleinerzeichen stehen dabei entsprechend für der Reihenfolge, in der die Werte zuvor angegeben wurden. Das bedeutet:<br />
<br />
4 2 > ist wahr, weil die intern durchgeführte Operation in diesem Fall "4 > 2" ist.<br />
<br />
{| class="wikitable" style="font-size:95%;" <br />
|- class="hintergrundfarbe5"<br />
| align="left" |=<br />
| align="left" |"1", falls die obersten Stackwerte identisch sind, sonst "0".<br />
|-<br />
| align="left" |<<br />
| align="left" |"1", falls Stackwert 1 kleiner ist als Stackwert 0, sonst "0".<br />
|-<br />
| align="left" |><br />
| align="left" |... größer ist ...<br />
|-<br />
| align="left" |<=<br />
| align="left" |... kleiner als oder gleich ist ...<br />
|-<br />
| align="left" |>=<br />
| align="left" |... größer als oder gleich ist ...<br />
|-<br />
| align="left" |$=<br />
| align="left" |Wie "=" nur für die obersten beiden Stringstack-Plätze.<br />
|-<br />
| align="left" |$<<br />
| align="left" |Kleiner als (String). Die Ungleich-Operationen bei Strings prüfen auf alphabetische Reihenfolge. "A" ist also kleiner als "B".<br />
|-<br />
| align="left" |$><br />
| align="left" |Größer als (String).<br />
|-<br />
| align="left" |$<=<br />
| align="left" |Kleiner oder gleich (String).<br />
|-<br />
| align="left" |$>=<br />
| align="left" |Größer oder gleich (String).<br />
|}<br />
<br />
==== Mathematische Operationen ====<br />
<br />
{| class="wikitable" style="font-size:95%;" <br />
|- class="hintergrundfarbe5"<br />
| align="left" |+<br />
| align="left" |Plus<br />
|-<br />
| align="left" |-<br />
| align="left" |Minus (Stackplatz 1 - Stackplatz 0, also vom Prinzip her wie bei den Größer/Kleiner-Operationen)<br />
|-<br />
| align="left" |*<br />
| align="left" |Mal<br />
|-<br />
| align="left" |/<br />
| align="left" |geteilt (Stackplatz 1 / Stackplatz 0)<br />
|-<br />
| align="left" |%<br />
| align="left" |Rest der Division (folgendermaßen erweitert für Gleitkommazahlen: Stack0 - trunc(Stack1 / Stack0) * Stack1 )<br />
|-<br />
| align="left" |/-/<br />
| align="left" |Vorzeichenwechsel<br />
|-<br />
| align="left" |sin<br />
| align="left" |Sinus<br />
|-<br />
| align="left" |arcsin<br />
| align="left" |Umkehrfunktion zum Sinus ''(ab OMSI2)''<br />
|-<br />
| align="left" |arctan<br />
| align="left" |Umkehrfunktion zum Tangens ''(ab OMSI2)''<br />
|-<br />
| align="left" |min<br />
| align="left" |Wahl des kleineren der beiden obersten Stackwerte<br />
|-<br />
| align="left" |max<br />
| align="left" |Wahl des größeren der beiden obersten Stackwerte<br />
|-<br />
| align="left" |exp<br />
| align="left" |Exponentialfunktion zur Basis e (e^Stack0)<br />
|-<br />
| align="left" |sqrt<br />
| align="left" |Quadratwurzel<br />
|-<br />
| align="left" |sqr<br />
| align="left" |Quadrat<br />
|-<br />
| align="left" |sgn<br />
| align="left" |Rückgabe des Vorzeichens; je nachdem entweder -1, 0 oder 1<br />
|-<br />
| align="left" |pi<br />
| align="left" |Kreiszahl pi<br />
|-<br />
| align="left" |random<br />
| align="left" |ganzzahlige Zufallszahl 0 <= x < Stack0<br />
|-<br />
| align="left" |abs<br />
| align="left" |Rückgabe des Absolutwertes<br />
|-<br />
| align="left" |trunc<br />
| align="left" |Abrunden auf nächste ganze Zahl<br />
|}<br />
<br />
==== String-Operationen ====<br />
<br />
{| class="wikitable" style="font-size:95%;" <br />
|- class="hintergrundfarbe5"<br />
| align="left" |"''bla''"<br />
| align="left" |Einfügen des Strings ''bla'' auf dem obersten String-Stack-Platz<br />
|-<br />
| align="left" |$+<br />
| align="left" |Zusammenfügen zweier Strings. "Omnibus" "simulator" $+ ergibt "Omnibussimulator"<br />
|-<br />
| align="left" |$*<br />
| align="left" |Der oberste Stack-String wird sooft wiederholt, bis die resultierende Zeichenlänger gerade noch kleiner oder gleich des obersten Stackwertes ist. Beispiel: "nu" 6 $* ergibt "nununu"<br />
|-<br />
| align="left" |$length<br />
| align="left" |Gibt die Anzahl der Zeichen des obersten Stack-String zurück in den Stack. <br />
|-<br />
| align="left" |$cutBegin<br />
| align="left" |Schneidet ''stack0'' Zeichen vorne vom obersten Stack-String ab.<br />
|-<br />
| align="left" |$cutEnd<br />
| align="left" |Schneidet ''stack0'' Zeichen hinten vom obersten Stack-String ab.<br />
|-<br />
| align="left" |$SetLengthR<br />
| align="left" |Passt die Länge des obersten Stack-Strings auf ''stack0'' rechtsbündig an, indem am Anfang Zeichen entfernt oder Leerzeichen ergänzt werden.<br />
Achtung: Der Befehl entfernt den Float-Operator nicht vom Stack. Der Wert, auf dessen Länge der String gekürzt wurde, verbleibt also auf Stack0.<br />
|-<br />
| align="left" |$SetLengthC<br />
| align="left" |Passt die Länge des obersten Stack-Strings auf ''stack0'' zentriert an, indem am Anfang und am Ende Zeichen entfernt oder Leerzeichen ergänzt werden ''(ab OMSI2)''.<br />
Achtung: Der Befehl entfernt den Float-Operator nicht vom Stack. Der Wert, auf dessen Länge der String gekürzt wurde, verbleibt also auf Stack0.<br />
|-<br />
| align="left" |$SetLengthL<br />
| align="left" |Passt die Länge des obersten Stack-Strings auf ''stack0'' linksbündig an, indem am Ende Zeichen entfernt oder Leerzeichen ergänzt werden.<br />
Achtung: Der Befehl entfernt den Float-Operator nicht vom Stack. Der Wert, auf dessen Länge der String gekürzt wurde, verbleibt also auf Stack0.<br />
|-<br />
| align="left" |$IntToStr<br />
| align="left" |Rundet ''stack0'' ab und wandelt die resultierende Ganzzahl um in einen String.<br />
|-<br />
| align="left" |$IntToStrEnh<br />
| align="left" |Die erweiterte Version von IntToStr. Hierbei wird der oberste Stack-String verwendet, um das Format der String-Umwandlung zu bestimmen: Das erste Zeichen im String wird zum Auffüllen der fehlenden Zeichen verwendet, die folgenden Zeichen müssen eine Zahl ergeben, die die Stellen angibt. Beispiel: 35 " 5" $IntToStrEnh führt zu " 35" und 123456789 "011" $IntToStrEnh führt zu "00123456789". Falls ein Fehler vorliegt, wird "ERROR" ausgegeben.<br />
|-<br />
| align="left" |$StrToFloat<br />
| align="left" |Wandelt den obersten Stack-String in eine Gleitkommazahl um, falls möglich. Andernfalls wird eine -1 geschrieben.<br />
|-<br />
| align="left" |$RemoveSpaces<br />
| align="left" |Entfernt sämtliche Leerzeichen vor und nach dem eigentlichen String. Aus " Spandau Freudstr " wird "Spandau Freudstr" ''(ab OMSI2)''.<br />
|-<br />
|}<br />
<br />
=== Variablenzugriff ===<br />
<br />
Es wird unterschieden in Systemvariablen und in lokale Variablen. Die Systemvariablen gelten OMSI-weit, die lokalen Variablen werden zum Fahrzeug/Objekt zugehörig gespeichert.<br />
<br />
Bei den lokalen Variablen gibt es stets einen Grundstamm an Variablen, welcher von OMSI vordefiniert werden. Darüber hinaus können beliebig viele Variablen mit Hilfe der Varlist-Dateien ergänzt werden. <br />
<br />
{| class="wikitable" style="font-size:95%;" <br />
|- class="hintergrundfarbe5"<br />
| align="left" |(L.S.''varname'')<br />
| align="left" |Lädt die Systemvariable ''varname'' in den obersten Stackplatz<br />
|-<br />
| align="left" |(L.L.''varname'')<br />
| align="left" |Lädt die lokale Variable ''varname'' in den obersten Stackplatz<br />
|-<br />
| align="left" |(L.$.''varname'')<br />
| align="left" |Lädt die lokale String-Variable ''varname'' in den obersten String-Stackplatz<br />
|-<br />
| align="left" |(S.L.''varname'')<br />
| align="left" |Speichert den obersten Stackplatz in die lokale Variable ''varname''<br />
|-<br />
| align="left" |(S.$.''varname'')<br />
| align="left" |Speichert den obersten String-Stackplatz in die lokale String-Variable ''varname''<br />
|}<br />
<br />
Eine detaillierte Beschreibung der einzelnen Systemvariablen und der vordefinierten lokalen Variablen finden Sie hier: [[System- und vordefinierte lokalen Variablen]]<br />
<br />
=== Konstanten und Funktionen ===<br />
<br />
Lokale Konstanten und [http://de.wikipedia.org/w/index.php?title=Datei:Linear_interpolation.svg&filetimestamp=20080226155013 stückweise definierte lineare Funktionen] können in den Konstantendateien (''constfiles'', ''~_constfile.txt'') definiert werden. Der Aufbau jeder Konstantendatei entspricht der der [[Konfigurationsdateien|Konfigurationsdatei]]. Es gibt lediglich drei Schlüsselwörter. Zu beachten ist: Bisher können keine Strings, sondern nur Fließkommazahlen als Konstanten definiert werden.<br />
<br />
[const] definiert eine neue Konstante und gibt ihren Wert an:<br />
<br />
<pre><br />
[const]<br />
name<br />
wert<br />
</pre><br />
<br />
Beispiel:<br />
<br />
<pre><br />
[const]<br />
leistung<br />
200<br />
</pre><br />
<br />
[newcurve] leitet die Definition einer neuen (stückweise linearen) Funktion ein:<br />
<br />
<pre><br />
[newcurve]<br />
name<br />
</pre><br />
<br />
[pnt] fügt der zuvor mit [newcurve] definierten Funktion ein neues x-y-Paar hinzu. Jede Funktion sollte normalerweise über mindestens zwei Paare verfügen. Die Reihenfolge der Paare ''muss'' in x-Richtung aufsteigend sein!<br />
<br />
<pre><br />
[pnt]<br />
x<br />
y<br />
</pre><br />
<br />
Beispiel:<br />
<br />
<pre><br />
[newcurve]<br />
Drehzahl_Drehmoment_Kennlinie<br />
<br />
[pnt]<br />
50<br />
0<br />
<br />
[pnt]<br />
300<br />
400<br />
<br />
[pnt]<br />
1000<br />
600<br />
</pre><br />
<br />
Konstanten werden über den Befehl (C.L.''konstantenname'') in den Stack geladen.<br />
<br />
Funktionen werden über den Befehl (F.L.''funktionsname'') aufgerufen. Dabei wird stets der zuvor auf oberster Stackposition befindliche Wert als x-Parameter übergaben und der resultierende y-Wert der Funktion stattdessen auf dem obersten Stackplatz gespeichert. Bewegt sich der x-Wert außerhalb der Grenzen der durch die [pnt]-Einträge definierten Eckpunkte, wird stets der y-Wert des nächstliegenden Eckpunktes verwendet. Die Funktion wird also vor dem ersten und hinter dem letzten Eckpunkt ins Unendliche waagerecht verlängert.<br />
<br />
=== Sound-Trigger ===<br />
<br />
Soundtrigger sind nicht mit den weiter oben erwähnten Triggern zu verwechseln!<br />
<br />
Sie stellen vielmehr eine Möglichkeit dar, direkt einen gewünschten Sound abzuspielen. Hierbei gibt es zwei Möglichkeiten:<br />
<br />
(T.L.''soundtriggername'') ist ein einfacher Soundtrigger. Der so markierte Sound wird (einmalig) abgespielt.<br />
<br />
(T.F.''soundtriggername'') ist ein Soundtrigger mit Dateiwechselfunktion. Hierbei wird der oberste Stackstring ausgelesen und als Dateiname verwendet, wobei der Dateipfad relativ zum Sound-Ordner des Objektes interpretiert wird.<br />
<br />
Beispiel:<br />
<br />
Angenommen, die Sounddatei lautet "diese.wav" und ist mit dem Trigger ''MeinTrigger'' verknüpft, dann spielt<br />
<br />
(T.L.MeinTrigger)<br />
<br />
die Datei "diese.wav" ab und<br />
<br />
"andere.wav" (T.F.MeinTrigger)<br />
<br />
die Datei "andere.wav". Alternativ zu (T.L.''soundtriggername'') kann beim Befehl (T.F.''soundtriggername'') auch ein "Nullstring" im Stack liegen (also der String: "").<br />
<br />
=== System-Makros ===<br />
<br />
Die bisherigen Methoden erlauben dem Script folgende Kommunikationsmöglichkeiten mit OMSI:<br />
<br />
* Lesen von Werten über System- und vordefinierte lokale Variablen<br />
* Schreiben von Werten über ebendiese<br />
* Empfangen von Tastatur-, Maus- oder Systemtriggern<br />
<br />
Schließlich gibt es noch eine weitere Methode, um mit dem Hauptprogramm zu kommunizieren, die sogenannten System-Makros, gelegentlich auch unpräzise als "Callback-Funktionen" bezeichnet.<br />
<br />
In bestimmten Situationen ist es nötig, dass das Script Werte von OMSI bekommt, die in größeren Datenbanken vorliegen und daher nicht über vordefinierte Variablen übermittelt werden können, z.B. die Inhalte der Hofdatei. Hier kommen nun die System-Makros ins Spiel.<br />
<br />
Diese arbeiten scriptseitig sehr ähnlich wie die lokalen, selbstdefinierten Makros: Der Aufruf (M.V.''macroname'') ruft das System-Makro auf ("V" stand ursprünglich für "Vehicle-Macro", gilt aber genauso auch in Szenerieobjekten), das sich während der Ausführung Werte aus den beiden Stacks holt und/oder in diese schreibt. Eine Aufstellung aller System-Makros findet sich hier: [[System-Makros]]<br />
<br />
=== Bedingungen und Schleifen ===<br />
<br />
Die einzige Steuerung des Programmablaufs ist zur Zeit nur mit der IF-Bedingung möglich.<br />
<br />
==== IF-Bedingung ====<br />
<br />
<pre><br />
'Hier muss eine Bedingung stehen, z.B.:<br />
(L.L.bla) 1 =<br />
{if}<br />
'Dieser Abschnitt wird ausgeführt, wenn bla = 1 ist:<br />
2 3 +<br />
{else}<br />
'Dieser Abschnitt wird andernfalls ausgeführt:<br />
3 4 +<br />
{endif}<br />
(S.L.blub)<br />
{end}<br />
</pre><br />
<br />
Dass erst die Bedingung formuliert wird und dann erst das Schlüsselwort {if} folgt, sollte einleuchten: Zunächst muss an oberster Stelle des Stacks der Wert abgelegt werden und erst dann folgt das Schlüsselwort {if}, welches diesen Wert prüft. Hierbei bedeutet ähnlich wie bei && und || Gleichheit mit Null gleichbedeutend mit ''False'', alle anderen Werte bedeuten ''True''.<br />
<br />
Wenn also im obigen Beispiel ''bla'' den Wert 1 hat, wird ''blub'' auf den Wert 5 gesetzt, andernfalls auf den Wert 7.<br />
<br />
Verschachtelungen der IF-Bedingung dienen als Ersatz für die (nicht vorhandenen) "Else-If"-Konstruktionen:<br />
<br />
<pre><br />
'Hier muss eine Bedingung stehen, z.B.:<br />
(L.L.bla) 1 =<br />
{if}<br />
'Dieser Abschnitt wird ausgeführt, wenn bla = 1 ist:<br />
2 3 +<br />
{else}<br />
(L.L.bla) 5 =<br />
{if}<br />
'Dieser Abschnitt wird ausgeführt, wenn bla = 5 ist:<br />
3 4 +<br />
{else}<br />
'Dieser Abschnitt wird andernfalls ausgeführt:<br />
13<br />
{endif}<br />
{endif}<br />
(S.L.blub)<br />
{end}<br />
</pre><br />
<br />
Hierbei ist insbesondere auf das doppelte {endif} zu achten! Hier gilt:<br />
<br />
* bla = 1 ==> blub = 5<br />
* bla = 5 ==> blub = 7<br />
* sonst ==> blub = 13<br />
<br />
[[Kategorie:Nachschlagewerk für Addon-Entwickler]]</div>Marcel Kuhnthttp://wiki.omnibussimulator.de/omsiwikineu.de/index.php?title=Scriptsystem&diff=861Scriptsystem2014-02-11T10:26:13Z<p>Marcel Kuhnt: /* String-Operationen */</p>
<hr />
<div>''Hinweis: Dieser Artikel wurde noch nicht ins Englische übersetzt!''<br />
<br />
Das Scriptsystem in OMSI ermöglicht es, dass Szenerieobjekte und vor allem Fahrzeuge mit individuellen Systemen ausgestattet werden können, die über Variablen und Funktionsaufrufe mit dem Hauptprogramm und der Grafik- und Soundengine kommunizieren.<br />
<br />
Der hier beschriebene Stand des Scriptsystems entspricht OMSI Version 1.01.<br />
<br />
== Dateien des Scriptsystems ==<br />
<br />
Das Scriptsystem umfasst folgende Dateien:<br />
<br />
* Scriptdateien mit ausführbarem Code (*.osc)<br />
* Varlist- und Stringvarlist-Dateien im OMSI\program-Verzeichnis zur Definition von (reinen) Systemvariablen<br />
* Varlist- und Stringvarlist-Dateien zur Definition von Uservariablen und (zusätzlichen) Systemvariablen (seit OMSI2)<br />
* Constfile-Dateien zur Definition von Userkonstanten und Funktionstabellen<br />
<br />
Abgesehen von den Dateien zur Definition von Systemvariablen müssen alle benötigten Dateien für jedes Fahrzeug/Szenerieobjekt (im folgenden kurz: Objekt) in dessen [[Konfigurationsdatei]] angemeldet werden.<br />
<br />
Hierfür gibt es die Befehle ''[script]'', ''[varnamelist]'', ''[stringvarnamelist]'' und ''[constfile]''. Der erste Eintrag jedes Befehls ist die Anzahl der Dateien, darauf folgen die entsprechenden Dateinamen (inkl. Pfad relativ zur Konfigurationsdatei. Die Namen der Dateien sind nicht relevant, solange sie korrekt in die Listen eingetragen werden.<br />
<br />
Auf die Funktion der jeweiligen Dateien wird im Laufe der Beschreibung der Scriptsprache eingegangen.<br />
<br />
== Grundlagen der Scriptsprache ==<br />
<br />
Das OMSI-Scriptsystem arbeitet mit der [http://de.wikipedia.org/wiki/Umgekehrte_Polnische_Notation umgekehrten Polnischen Notation]. Hierbei steht der Operator hinter den beiden Operanden; vereinfacht gesagt bedeutet es, dass die Operation " 1 + 2 " stattdessen folgendermaßen notiert wird: " 1 2 + ". Ein komplizierteres Beispiel: " (1 + 2) * (4 + 5) " entspricht " 1 2 + 4 5 + * ".<br />
<br />
Ganz wichtig ist die Tatsache, dass die OMSI-Textdateien und insbesondere die Scriptsprache [http://de.wikipedia.org/wiki/Case_sensitivity Case-Sensitive] ist! D.h. es ist immer auf die Groß- und Kleinschreibung zu achten!<br />
<br />
=== Stack und Register ===<br />
<br />
Bei der Verarbeitung der Scripts verfügt OMSI über einen String-Stack und einen [http://de.wikipedia.org/wiki/Stapelspeicher Stack] für [http://de.wikipedia.org/wiki/Gleitkommazahl Gleitkommazahlen]. Im folgenden ist mit "Stack" immer der Stack für Gleitkommazahlen gemeint, andernfalls wird von "String-Stack" gesprochen.<br />
<br />
Beide Stacks enthält 8 Speicherplätze, welche von 0 bis 7 durchnumeriert sind. Jede Script-Operation kann nun einen oder mehrere neue Werte in einen der Stacks einfügen (push), wobei der neue Wert auf die Position 0 gesetzt wird und alle folgenden Werte "einen Platz aufrücken", oder sie kann einen oder mehrere Werte aus dem Stack herausziehen (pop/pull) oder lediglich auslesen (peek).<br />
<br />
Fürs temporäre Ablegen von Zahlen gibt es zusätzlich acht indizierte Speicherplätze, welche direkt geschrieben oder gelesen werden können, die sich im sogenannten Register befinden - hier gibt es jedoch nur einen Register für die Gleitkommazahlen.<br />
<br />
=== Beispiel-Operationen ===<br />
<br />
Beispiel: Die Operation 1 + 4. Der Code hierfür lautet:<br />
<br />
<pre><br />
1 4 +<br />
</pre><br />
<br />
In der folgenden Tabelle wird demonstriert, wie sich hierbei der Stack verhält:<br />
<br />
<pre><br />
Operation: Stack: 0 1 2 3 4 ...<br />
-----------------------------------------------------------------------------<br />
vorher: 0 0 0 0 0<br />
"1" 1 0 0 0 0<br />
"4" 4 1 0 0 0<br />
"+" 5 0 0 0 0<br />
</pre><br />
<br />
Im Ausgangszustand ist der Stack nur mit Nullen (oder unbekannten/zufälligen Werten) gefüllt. Der Befehl "1" schiebt die Eins in den obersten Stackplatz und schiebt alle weiteren Werte (Nullen) nach hinten. Der Befehl "4" schiebt die Vier auf den 0. Platz und alle folgenden Werte, also insbesondere die Eins auf den jeweils nächsten Platz. Im nächsten Schritt "+" werden die obersten beiden Werte aus dem Stack herausgezogen - also 4 und 1 - und summiert. Das Ergebnis (5) wird wiederum in den Stack geschoben. Die beiden ursprünglichen Zahlen sind im Stack nicht mehr vorhanden.<br />
<br />
Ein zweites Beispiel:<br />
<br />
(1 + 2) * (4 + 5) muss wie bereits erwähnt folgendermaßen notiert werden:<br />
<br />
<pre><br />
1 2 + 4 5 + *<br />
</pre><br />
<br />
Der Stack verhält sich somit folgendermaßen:<br />
<br />
<pre><br />
Operation: Stack: 0 1 2 3 4 ...<br />
-----------------------------------------------------------------------------<br />
vorher: 0 0 0 0 0<br />
"1" 1 0 0 0 0<br />
"2" 2 1 0 0 0<br />
"+" 3 0 0 0 0<br />
"4" 4 3 0 0 0<br />
"5" 5 4 3 0 0<br />
"+" 9 3 0 0 0<br />
"*" 27 0 0 0 0<br />
</pre><br />
<br />
Am Ende befindet sich also das korrekte Ergebnis auf Stackplatz 0!<br />
<br />
=== Gleitkommazahlen und Strings ===<br />
<br />
Das OMSI-Skriptsystem arbeitet ausschließlich mit den Datentypen Gleitkommazahl (einfache Präzision mit Vorzeichen) und String. Beide Datentypen haben getrennte Stacks. Deshalb laufen die Verarbeitung von Gleitkommazahlen und Strings im Allgemeinen unabhängig nebeneinander. Jedoch kann es natürlich vorkommen, dass bestimmte Funktionen z.B. Zahlen in Strings umwandeln und somit gleichzeitig auf beide Teilbereiche zugreifen.<br />
<br />
Auf boolische Variablen wurde verzichtet. Für boolische Werte werden im Allgemeinen die Zahlenwerte 0 und 1 verwendet.<br />
<br />
== Script-Schlüsselwörter ==<br />
<br />
=== Kommentare ===<br />
<br />
Kommentierungen sind nur möglich, indem in der auszukommentierenden Zeile ganz vorne ein Apostroph ['] gesetzt wird:<br />
<br />
<pre><br />
'Ich bin eine Kommentarzeile<br />
'Ich bin KEINE Kommentarzeile!<br />
</pre><br />
<br />
=== Einstiegs- und Ausstiegspunkte, Makros und Trigger ===<br />
<br />
Alle Befehle müssen zwischen einem Einstiegs- und einem Ausstiegspunkt liegen.<br />
<br />
Der Einstiegspunkt wird durch eins der folgenden Schlüsselwörter gekennzeichnet:<br />
<br />
* {frame} Im Laufe jedes Frames ruft OMSI über diesen Einstiegspunkt die frameweise Scriptverarbeitung auf, sofern er vorhanden ist.<br />
* {init} Bei der Initialisierung ruft OMSI über diesen Einstiegspunkt die Script-Initialisierung auf.<br />
* {frame_ai} Hierbei handelt es sich um eine Variante des {frame}-Einstiegspunktes, welcher bei Fahrzeugen dann aufgerufen wird, wenn diese nicht im Fokus des Benutzers stehen, z.B. wenn sie als KI-Fahrzeug unterwegs sind. Ist dieser Einstiegspunkt jedoch nicht vorhanden sondern nur {frame}, dann wird dieser alternativ aufgerufen. Bei Szenerieobjekten kommt dieser Eintrittspunkt nicht zur Anwendung.<br />
* {macro:''name''} Dieser Einstiegspunkt ruft ein Subsektion (Makro) auf, welche '''stets nach dem Aufruf''' definiert werden muss.<br />
* {trigger:''name''} Dieser Einstiegspunkt wird vom Hauptprogramm aufgerufen, wenn der Benutzer die Tastenkombination oder das Maus-Event mit der Bezeichnung ''name'' aufruft - es gibt auch bestimmte Trigger, die direkt vom Hauptprogramm aufgerufen werden, z.B. wenn OMSI bei KI-Bussen die Anzeige wechselt u.Ä.<br />
<br />
{end} ist der universelle Ausstiegspunkt. Er muss stets den Block abschließen, der mit einem der obigen Befehle eröffnet wird.<br />
<br />
==== Makroaufruf ====<br />
<br />
Der Aufruf eines Makros erfolgt über (M.L.''name''). Der Aufruf des Makros muss ''immer'' vor dessen Definition erfolgen. Andernfalls meldet OMSI, dass das Makro nicht gefunden wurde.<br />
<br />
==== Aufteilung des Scripts in mehrere Dateien ====<br />
<br />
Bei einfachen Scripts (z.B. bei reinen KI-Fahrzeugen oder Szenerieobjekten) reicht es im Allgemeinen eine *.sco-Datei zu erstellen, welche über einen {frame}...{end}- und ggf. einen {init}...{end}-Block verfügt.<br />
<br />
Handelt es sich jedoch um ein komplettes Fahrzeugscript, dann empfiehlt es sich für die verschiedenen Subsysteme getrennte Dateien anzulegen. Hierbei sollte folgendermaßen vorgegangen werden:<br />
<br />
* Es gibt ein Hauptscript und die nötigen Subsystemdateien. Die Hauptdatei enthält dabei die {frame}- und {init}-Blöcke, die jedoch nur Makros aufrufen, welche in den Subsystemdateien definiert sind.<br />
* Für jedes Subsystem gibt es eine *.sco-Datei und je nach Bedarf eine eigene Varlist und Constfile mit den zum System gehörenden Variablen. Außerdem werden auch hier die Trigger für die Tastenbefehle einsortiert.<br />
* Die Makros sollten sinnvollerweise folgendermaßen benannt werden: {macro:''subsystem''_frame} und {macro:''subsystem''_init}.<br />
* Damit die Makros vom Hauptscript aufgerufen werden, muss dieses in der Liste der Scripts in der Objekt-Konfigurationsdatei als erstes aufgerufen werden. Die Reihenfolge der Scripts untereinander muss ebenfalls so gewählt werden, dass alle dateiübergreifenden Makroaufrufe stets vor der jeweiligen Makrodefinition stehen.<br />
<br />
Die Einschränkung, dass Makros immer hinter dem Aufruf definiert werden müssen, kann zwar bisweilen hinderlich sein, ist aber ein sehr wirksamer Schutz gegen Zirkelschlüsse und Endlosschleifen.<br />
<br />
==== Trigger ====<br />
<br />
Wie schon geschrieben wurde, kann ein {trigger:''name''}...{end}-Abschnitt durch verschiedene Möglichkeiten aus dem Hauptprogramm heraus aufgerufen werden. Hierzu zählen:<br />
<br />
* Auslösung per Tastatur. Wurde die Tastenkombination mit dem Namen ''tastkomb'' bezeichnet, wird {trigger:tastkomb} aufgerufen, wenn die Taste gedrückt wird und {trigger:tastkomb_off}, wenn die Taste losgelassen wird.<br />
* Auslösung per Maus. Wurde ein Mesh angeklickt mit der [mouseevent]-Bezeichnung ''mouse_ev'', so wird {trigger:mouse_ev} aufgerufen, wenn die Maustaste gedrückt wird, {trigger:mouse_ev_drag}, während die Maustaste gehalten wird und {trigger:mouse_ev_off}, wenn die Maustaste losgelassen wird.<br />
* Außerdem gibt es noch eine Reihe von [[System-Trigger|System-Triggern]].<br />
<br />
=== Operationen ===<br />
<br />
==== Stack-Operationen ====<br />
<br />
{| class="wikitable" style="font-size:95%;" <br />
|- class="hintergrundfarbe5"<br />
| align="left" |%stackdump%<br />
| align="left" |Gibt eine Dialogbox mit dem Gleitkomma-Stackinhalt aus. Sollte deshalb natürlich nur zu Debug-Zwecken eingesetzt werden.<br />
|-<br />
| align="left" |s0, s1, ..., s7<br />
| align="left" |Speichern des aktuellen Stackwertes im durch die Ziffer angegebenen Register. Der Wert verbleibt hierbei im Stack<br />
|-<br />
| align="left" |l0, l1, ..., l7<br />
| align="left" |Laden des entsprechenden Registerwertes und Verschiebung in den Stack. Registerwert bleibt erhalten.<br />
|-<br />
| align="left" |d<br />
| align="left" |Dubliziert den obersten Stackwert; alle weiteren Stackwerte rücken nach hinten.<br />
|-<br />
| align="left" |$msg<br />
| align="left" |Schreibt den obersten String-Stack-Wert in die Debug-Zeile von OMSI - egal, ob es sich um ein User-, KI-Fahrzeug oder Szenerieobjekt handelt.<br />
|-<br />
| align="left" |$d<br />
| align="left" |Dubliziert den Stringstack-Wert analog zu "d".<br />
|}<br />
<br />
==== Logische Operationen ====<br />
<br />
Die logischen Operationen arbeiten nach dem Prinzip 0 = FALSE, alles andere ist TRUE.<br />
<br />
{| class="wikitable" style="font-size:95%;" <br />
|- class="hintergrundfarbe5"<br />
| align="left" |&&<br />
| align="left" |UND, d.h. wenn einer der beiden obersten Stackwerte gleich 0 ist, ist das Ergbnis 0, sonst 1.<br />
|-<br />
| align="left" |<nowiki>||</nowiki><br />
| align="left" |ODER<br />
|-<br />
| align="left" |<nowiki>!</nowiki><br />
| align="left" |Verneinung<br />
|}<br />
<br />
==== Vergleichsoperationen ====<br />
<br />
Die Vergleichsoperationen vergleichen die Werte in den beiden jeweils obersten Stackplätzen und fügen dann je nach Ergebnis eine "1" oder "0" im obersten Stackplatz ein. Die Größer-/Kleinerzeichen stehen dabei entsprechend für der Reihenfolge, in der die Werte zuvor angegeben wurden. Das bedeutet:<br />
<br />
4 2 > ist wahr, weil die intern durchgeführte Operation in diesem Fall "4 > 2" ist.<br />
<br />
{| class="wikitable" style="font-size:95%;" <br />
|- class="hintergrundfarbe5"<br />
| align="left" |=<br />
| align="left" |"1", falls die obersten Stackwerte identisch sind, sonst "0".<br />
|-<br />
| align="left" |<<br />
| align="left" |"1", falls Stackwert 1 kleiner ist als Stackwert 0, sonst "0".<br />
|-<br />
| align="left" |><br />
| align="left" |... größer ist ...<br />
|-<br />
| align="left" |<=<br />
| align="left" |... kleiner als oder gleich ist ...<br />
|-<br />
| align="left" |>=<br />
| align="left" |... größer als oder gleich ist ...<br />
|-<br />
| align="left" |$=<br />
| align="left" |Wie "=" nur für die obersten beiden Stringstack-Plätze.<br />
|-<br />
| align="left" |$<<br />
| align="left" |Kleiner als (String). Die Ungleich-Operationen bei Strings prüfen auf alphabetische Reihenfolge. "A" ist also kleiner als "B".<br />
|-<br />
| align="left" |$><br />
| align="left" |Größer als (String).<br />
|-<br />
| align="left" |$<=<br />
| align="left" |Kleiner oder gleich (String).<br />
|-<br />
| align="left" |$>=<br />
| align="left" |Größer oder gleich (String).<br />
|}<br />
<br />
==== Mathematische Operationen ====<br />
<br />
{| class="wikitable" style="font-size:95%;" <br />
|- class="hintergrundfarbe5"<br />
| align="left" |+<br />
| align="left" |Plus<br />
|-<br />
| align="left" |-<br />
| align="left" |Minus (Stackplatz 1 - Stackplatz 0, also vom Prinzip her wie bei den Größer/Kleiner-Operationen)<br />
|-<br />
| align="left" |*<br />
| align="left" |Mal<br />
|-<br />
| align="left" |/<br />
| align="left" |geteilt (Stackplatz 1 / Stackplatz 0)<br />
|-<br />
| align="left" |%<br />
| align="left" |Rest der Division (folgendermaßen erweitert für Gleitkommazahlen: Stack0 - trunc(Stack1 / Stack0) * Stack1 )<br />
|-<br />
| align="left" |/-/<br />
| align="left" |Vorzeichenwechsel<br />
|-<br />
| align="left" |sin<br />
| align="left" |Sinus<br />
|-<br />
| align="left" |arcsin<br />
| align="left" |Umkehrfunktion zum Sinus ''(ab OMSI2)''<br />
|-<br />
| align="left" |arctan<br />
| align="left" |Umkehrfunktion zum Tangens ''(ab OMSI2)''<br />
|-<br />
| align="left" |min<br />
| align="left" |Wahl des kleineren der beiden obersten Stackwerte<br />
|-<br />
| align="left" |max<br />
| align="left" |Wahl des größeren der beiden obersten Stackwerte<br />
|-<br />
| align="left" |exp<br />
| align="left" |Exponentialfunktion zur Basis e (e^Stack0)<br />
|-<br />
| align="left" |sqrt<br />
| align="left" |Quadratwurzel<br />
|-<br />
| align="left" |sqr<br />
| align="left" |Quadrat<br />
|-<br />
| align="left" |sgn<br />
| align="left" |Rückgabe des Vorzeichens; je nachdem entweder -1, 0 oder 1<br />
|-<br />
| align="left" |pi<br />
| align="left" |Kreiszahl pi<br />
|-<br />
| align="left" |random<br />
| align="left" |ganzzahlige Zufallszahl 0 <= x < Stack0<br />
|-<br />
| align="left" |abs<br />
| align="left" |Rückgabe des Absolutwertes<br />
|-<br />
| align="left" |trunc<br />
| align="left" |Abrunden auf nächste ganze Zahl<br />
|}<br />
<br />
==== String-Operationen ====<br />
<br />
{| class="wikitable" style="font-size:95%;" <br />
|- class="hintergrundfarbe5"<br />
| align="left" |"''bla''"<br />
| align="left" |Einfügen des Strings ''bla'' auf dem obersten String-Stack-Platz<br />
|-<br />
| align="left" |$+<br />
| align="left" |Zusammenfügen zweier Strings. "Omnibus" "simulator" $+ ergibt "Omnibussimulator"<br />
|-<br />
| align="left" |$*<br />
| align="left" |Der oberste Stack-String wird sooft wiederholt, bis die resultierende Zeichenlänger gerade noch kleiner oder gleich des obersten Stackwertes ist. Beispiel: "nu" 6 $* ergibt "nununu"<br />
|-<br />
| align="left" |$length<br />
| align="left" |Gibt die Anzahl der Zeichen des obersten Stack-String zurück in den Stack. <br />
|-<br />
| align="left" |$cutBegin<br />
| align="left" |Schneidet ''stack0'' Zeichen vorne vom obersten Stack-String ab.<br />
|-<br />
| align="left" |$cutEnd<br />
| align="left" |Schneidet ''stack0'' Zeichen hinten vom obersten Stack-String ab.<br />
|-<br />
| align="left" |$SetLengthR<br />
| align="left" |Passt die Länge des obersten Stack-Strings auf ''stack0'' rechtsbündig an, indem am Anfang Zeichen entfernt oder Leerzeichen ergänzt werden.<br />
Achtung: Der Befehl entfernt den Float-Operator nicht vom Stack. Der Wert, auf dessen Länge der String gekürzt wurde, verbleibt also auf Stack0.<br />
|-<br />
| align="left" |$SetLengthC<br />
| align="left" |Passt die Länge des obersten Stack-Strings auf ''stack0'' zentriert an, indem am Anfang und am Ende Zeichen entfernt oder Leerzeichen ergänzt werden ''(ab OMSI2)''.<br />
Achtung: Der Befehl entfernt den Float-Operator nicht vom Stack. Der Wert, auf dessen Länge der String gekürzt wurde, verbleibt also auf Stack0.<br />
|-<br />
| align="left" |$SetLengthL<br />
| align="left" |Passt die Länge des obersten Stack-Strings auf ''stack0'' linksbündig an, indem am Ende Zeichen entfernt oder Leerzeichen ergänzt werden.<br />
Achtung: Der Befehl entfernt den Float-Operator nicht vom Stack. Der Wert, auf dessen Länge der String gekürzt wurde, verbleibt also auf Stack0.<br />
|-<br />
| align="left" |$IntToStr<br />
| align="left" |Rundet ''stack0'' ab und wandelt die resultierende Ganzzahl um in einen String.<br />
|-<br />
| align="left" |$IntToStrEnh<br />
| align="left" |Die erweiterte Version von IntToStr. Hierbei wird der oberste Stack-String verwendet, um das Format der String-Umwandlung zu bestimmen: Das erste Zeichen im String wird zum Auffüllen der fehlenden Zeichen verwendet, die folgenden Zeichen müssen eine Zahl ergeben, die die Stellen angibt. Beispiel: 35 " 5" $IntToStrEnh führt zu " 35" und 123456789 "011" $IntToStrEnh führt zu "00123456789". Falls ein Fehler vorliegt, wird "ERROR" ausgegeben.<br />
|-<br />
| align="left" |$StrToFloat<br />
| align="left" |Wandelt den obersten Stack-String in eine Gleitkommazahl um, falls möglich. Andernfalls wird eine -1 geschrieben.<br />
|-<br />
| align="left" |$RemoveSpaces<br />
| align="left" |Entfernt sämtliche Leerzeichen vor und nach dem eigentlichen String. Aus " Spandau Freudstr " wird "Spandau Freudstr" ''(ab OMSI2)''.<br />
|-<br />
|}<br />
<br />
=== Variablenzugriff ===<br />
<br />
Es wird unterschieden in Systemvariablen und in lokale Variablen. Die Systemvariablen gelten OMSI-weit, die lokalen Variablen werden zum Fahrzeug/Objekt zugehörig gespeichert.<br />
<br />
Bei den lokalen Variablen gibt es stets einen Grundstamm an Variablen, welcher von OMSI vordefiniert werden. Darüber hinaus können beliebig viele Variablen mit Hilfe der Varlist-Dateien ergänzt werden. <br />
<br />
{| class="wikitable" style="font-size:95%;" <br />
|- class="hintergrundfarbe5"<br />
| align="left" |(L.S.''varname'')<br />
| align="left" |Lädt die Systemvariable ''varname'' in den obersten Stackplatz<br />
|-<br />
| align="left" |(L.L.''varname'')<br />
| align="left" |Lädt die lokale Variable ''varname'' in den obersten Stackplatz<br />
|-<br />
| align="left" |(L.$.''varname'')<br />
| align="left" |Lädt die lokale String-Variable ''varname'' in den obersten String-Stackplatz<br />
|-<br />
| align="left" |(S.L.''varname'')<br />
| align="left" |Speichert den obersten Stackplatz in die lokale Variable ''varname''<br />
|-<br />
| align="left" |(S.$.''varname'')<br />
| align="left" |Speichert den obersten String-Stackplatz in die lokale String-Variable ''varname''<br />
|}<br />
<br />
Eine detaillierte Beschreibung der einzelnen Systemvariablen und der vordefinierten lokalen Variablen finden Sie hier: [[System- und vordefinierte lokalen Variablen]]<br />
<br />
=== Konstanten und Funktionen ===<br />
<br />
Lokale Konstanten und [http://de.wikipedia.org/w/index.php?title=Datei:Linear_interpolation.svg&filetimestamp=20080226155013 stückweise definierte lineare Funktionen] können in den Konstantendateien (''constfiles'', ''~_constfile.txt'') definiert werden. Der Aufbau jeder Konstantendatei entspricht der der [[Konfigurationsdateien|Konfigurationsdatei]]. Es gibt lediglich drei Schlüsselwörter. Zu beachten ist: Bisher können keine Strings, sondern nur Fließkommazahlen als Konstanten definiert werden.<br />
<br />
[const] definiert eine neue Konstante und gibt ihren Wert an:<br />
<br />
<pre><br />
[const]<br />
name<br />
wert<br />
</pre><br />
<br />
Beispiel:<br />
<br />
<pre><br />
[const]<br />
leistung<br />
200<br />
</pre><br />
<br />
[newcurve] leitet die Definition einer neuen (stückweise linearen) Funktion ein:<br />
<br />
<pre><br />
[newcurve]<br />
name<br />
</pre><br />
<br />
[pnt] fügt der zuvor mit [newcurve] definierten Funktion ein neues x-y-Paar hinzu. Jede Funktion sollte normalerweise über mindestens zwei Paare verfügen. Die Reihenfolge der Paare ''muss'' in x-Richtung aufsteigend sein!<br />
<br />
<pre><br />
[pnt]<br />
x<br />
y<br />
</pre><br />
<br />
Beispiel:<br />
<br />
<pre><br />
[newcurve]<br />
Drehzahl_Drehmoment_Kennlinie<br />
<br />
[pnt]<br />
50<br />
0<br />
<br />
[pnt]<br />
300<br />
400<br />
<br />
[pnt]<br />
1000<br />
600<br />
</pre><br />
<br />
Konstanten werden über den Befehl (C.L.''konstantenname'') in den Stack geladen.<br />
<br />
Funktionen werden über den Befehl (F.L.''funktionsname'') aufgerufen. Dabei wird stets der zuvor auf oberster Stackposition befindliche Wert als x-Parameter übergaben und der resultierende y-Wert der Funktion stattdessen auf dem obersten Stackplatz gespeichert. Bewegt sich der x-Wert außerhalb der Grenzen der durch die [pnt]-Einträge definierten Eckpunkte, wird stets der y-Wert des nächstliegenden Eckpunktes verwendet. Die Funktion wird also vor dem ersten und hinter dem letzten Eckpunkt ins Unendliche waagerecht verlängert.<br />
<br />
=== Sound-Trigger ===<br />
<br />
Soundtrigger sind nicht mit den weiter oben erwähnten Triggern zu verwechseln!<br />
<br />
Sie stellen vielmehr eine Möglichkeit dar, direkt einen gewünschten Sound abzuspielen. Hierbei gibt es zwei Möglichkeiten:<br />
<br />
(T.L.''soundtriggername'') ist ein einfacher Soundtrigger. Der so markierte Sound wird (einmalig) abgespielt.<br />
<br />
(T.F.''soundtriggername'') ist ein Soundtrigger mit Dateiwechselfunktion. Hierbei wird der oberste Stackstring ausgelesen und als Dateiname verwendet, wobei der Dateipfad relativ zum Sound-Ordner des Objektes interpretiert wird.<br />
<br />
Beispiel:<br />
<br />
Angenommen, die Sounddatei lautet "diese.wav" und ist mit dem Trigger ''MeinTrigger'' verknüpft, dann spielt<br />
<br />
(T.L.MeinTrigger)<br />
<br />
die Datei "diese.wav" ab und<br />
<br />
"andere.wav" (T.F.MeinTrigger)<br />
<br />
die Datei "andere.wav". Alternativ zu (T.L.''soundtriggername'') kann beim Befehl (T.F.''soundtriggername'') auch ein "Nullstring" im Stack liegen (also der String: "").<br />
<br />
=== System-Makros ===<br />
<br />
Die bisherigen Methoden erlauben dem Script folgende Kommunikationsmöglichkeiten mit OMSI:<br />
<br />
* Lesen von Werten über System- und vordefinierte lokale Variablen<br />
* Schreiben von Werten über ebendiese<br />
* Empfangen von Tastatur-, Maus- oder Systemtriggern<br />
<br />
Schließlich gibt es noch eine weitere Methode, um mit dem Hauptprogramm zu kommunizieren, die sogenannten System-Makros, gelegentlich auch unpräzise als "Callback-Funktionen" bezeichnet.<br />
<br />
In bestimmten Situationen ist es nötig, dass das Script Werte von OMSI bekommt, die in größeren Datenbanken vorliegen und daher nicht über vordefinierte Variablen übermittelt werden können, z.B. die Inhalte der Hofdatei. Hier kommen nun die System-Makros ins Spiel.<br />
<br />
Diese arbeiten scriptseitig sehr ähnlich wie die lokalen, selbstdefinierten Makros: Der Aufruf (M.V.''macroname'') ruft das System-Makro auf ("V" stand ursprünglich für "Vehicle-Macro", gilt aber genauso auch in Szenerieobjekten), das sich während der Ausführung Werte aus den beiden Stacks holt und/oder in diese schreibt. Eine Aufstellung aller System-Makros findet sich hier: [[System-Makros]]<br />
<br />
=== Bedingungen und Schleifen ===<br />
<br />
Die einzige Steuerung des Programmablaufs ist zur Zeit nur mit der IF-Bedingung möglich.<br />
<br />
==== IF-Bedingung ====<br />
<br />
<pre><br />
'Hier muss eine Bedingung stehen, z.B.:<br />
(L.L.bla) 1 =<br />
{if}<br />
'Dieser Abschnitt wird ausgeführt, wenn bla = 1 ist:<br />
2 3 +<br />
{else}<br />
'Dieser Abschnitt wird andernfalls ausgeführt:<br />
3 4 +<br />
{endif}<br />
(S.L.blub)<br />
{end}<br />
</pre><br />
<br />
Dass erst die Bedingung formuliert wird und dann erst das Schlüsselwort {if} folgt, sollte einleuchten: Zunächst muss an oberster Stelle des Stacks der Wert abgelegt werden und erst dann folgt das Schlüsselwort {if}, welches diesen Wert prüft. Hierbei bedeutet ähnlich wie bei && und || Gleichheit mit Null gleichbedeutend mit ''False'', alle anderen Werte bedeuten ''True''.<br />
<br />
Wenn also im obigen Beispiel ''bla'' den Wert 1 hat, wird ''blub'' auf den Wert 5 gesetzt, andernfalls auf den Wert 7.<br />
<br />
Verschachtelungen der IF-Bedingung dienen als Ersatz für die (nicht vorhandenen) "Else-If"-Konstruktionen:<br />
<br />
<pre><br />
'Hier muss eine Bedingung stehen, z.B.:<br />
(L.L.bla) 1 =<br />
{if}<br />
'Dieser Abschnitt wird ausgeführt, wenn bla = 1 ist:<br />
2 3 +<br />
{else}<br />
(L.L.bla) 5 =<br />
{if}<br />
'Dieser Abschnitt wird ausgeführt, wenn bla = 5 ist:<br />
3 4 +<br />
{else}<br />
'Dieser Abschnitt wird andernfalls ausgeführt:<br />
13<br />
{endif}<br />
{endif}<br />
(S.L.blub)<br />
{end}<br />
</pre><br />
<br />
Hierbei ist insbesondere auf das doppelte {endif} zu achten! Hier gilt:<br />
<br />
* bla = 1 ==> blub = 5<br />
* bla = 5 ==> blub = 7<br />
* sonst ==> blub = 13<br />
<br />
[[Kategorie:Nachschlagewerk für Addon-Entwickler]]</div>Marcel Kuhnthttp://wiki.omnibussimulator.de/omsiwikineu.de/index.php?title=Scriptsystem&diff=860Scriptsystem2014-02-11T10:14:29Z<p>Marcel Kuhnt: /* Mathematische Operationen */</p>
<hr />
<div>''Hinweis: Dieser Artikel wurde noch nicht ins Englische übersetzt!''<br />
<br />
Das Scriptsystem in OMSI ermöglicht es, dass Szenerieobjekte und vor allem Fahrzeuge mit individuellen Systemen ausgestattet werden können, die über Variablen und Funktionsaufrufe mit dem Hauptprogramm und der Grafik- und Soundengine kommunizieren.<br />
<br />
Der hier beschriebene Stand des Scriptsystems entspricht OMSI Version 1.01.<br />
<br />
== Dateien des Scriptsystems ==<br />
<br />
Das Scriptsystem umfasst folgende Dateien:<br />
<br />
* Scriptdateien mit ausführbarem Code (*.osc)<br />
* Varlist- und Stringvarlist-Dateien im OMSI\program-Verzeichnis zur Definition von (reinen) Systemvariablen<br />
* Varlist- und Stringvarlist-Dateien zur Definition von Uservariablen und (zusätzlichen) Systemvariablen (seit OMSI2)<br />
* Constfile-Dateien zur Definition von Userkonstanten und Funktionstabellen<br />
<br />
Abgesehen von den Dateien zur Definition von Systemvariablen müssen alle benötigten Dateien für jedes Fahrzeug/Szenerieobjekt (im folgenden kurz: Objekt) in dessen [[Konfigurationsdatei]] angemeldet werden.<br />
<br />
Hierfür gibt es die Befehle ''[script]'', ''[varnamelist]'', ''[stringvarnamelist]'' und ''[constfile]''. Der erste Eintrag jedes Befehls ist die Anzahl der Dateien, darauf folgen die entsprechenden Dateinamen (inkl. Pfad relativ zur Konfigurationsdatei. Die Namen der Dateien sind nicht relevant, solange sie korrekt in die Listen eingetragen werden.<br />
<br />
Auf die Funktion der jeweiligen Dateien wird im Laufe der Beschreibung der Scriptsprache eingegangen.<br />
<br />
== Grundlagen der Scriptsprache ==<br />
<br />
Das OMSI-Scriptsystem arbeitet mit der [http://de.wikipedia.org/wiki/Umgekehrte_Polnische_Notation umgekehrten Polnischen Notation]. Hierbei steht der Operator hinter den beiden Operanden; vereinfacht gesagt bedeutet es, dass die Operation " 1 + 2 " stattdessen folgendermaßen notiert wird: " 1 2 + ". Ein komplizierteres Beispiel: " (1 + 2) * (4 + 5) " entspricht " 1 2 + 4 5 + * ".<br />
<br />
Ganz wichtig ist die Tatsache, dass die OMSI-Textdateien und insbesondere die Scriptsprache [http://de.wikipedia.org/wiki/Case_sensitivity Case-Sensitive] ist! D.h. es ist immer auf die Groß- und Kleinschreibung zu achten!<br />
<br />
=== Stack und Register ===<br />
<br />
Bei der Verarbeitung der Scripts verfügt OMSI über einen String-Stack und einen [http://de.wikipedia.org/wiki/Stapelspeicher Stack] für [http://de.wikipedia.org/wiki/Gleitkommazahl Gleitkommazahlen]. Im folgenden ist mit "Stack" immer der Stack für Gleitkommazahlen gemeint, andernfalls wird von "String-Stack" gesprochen.<br />
<br />
Beide Stacks enthält 8 Speicherplätze, welche von 0 bis 7 durchnumeriert sind. Jede Script-Operation kann nun einen oder mehrere neue Werte in einen der Stacks einfügen (push), wobei der neue Wert auf die Position 0 gesetzt wird und alle folgenden Werte "einen Platz aufrücken", oder sie kann einen oder mehrere Werte aus dem Stack herausziehen (pop/pull) oder lediglich auslesen (peek).<br />
<br />
Fürs temporäre Ablegen von Zahlen gibt es zusätzlich acht indizierte Speicherplätze, welche direkt geschrieben oder gelesen werden können, die sich im sogenannten Register befinden - hier gibt es jedoch nur einen Register für die Gleitkommazahlen.<br />
<br />
=== Beispiel-Operationen ===<br />
<br />
Beispiel: Die Operation 1 + 4. Der Code hierfür lautet:<br />
<br />
<pre><br />
1 4 +<br />
</pre><br />
<br />
In der folgenden Tabelle wird demonstriert, wie sich hierbei der Stack verhält:<br />
<br />
<pre><br />
Operation: Stack: 0 1 2 3 4 ...<br />
-----------------------------------------------------------------------------<br />
vorher: 0 0 0 0 0<br />
"1" 1 0 0 0 0<br />
"4" 4 1 0 0 0<br />
"+" 5 0 0 0 0<br />
</pre><br />
<br />
Im Ausgangszustand ist der Stack nur mit Nullen (oder unbekannten/zufälligen Werten) gefüllt. Der Befehl "1" schiebt die Eins in den obersten Stackplatz und schiebt alle weiteren Werte (Nullen) nach hinten. Der Befehl "4" schiebt die Vier auf den 0. Platz und alle folgenden Werte, also insbesondere die Eins auf den jeweils nächsten Platz. Im nächsten Schritt "+" werden die obersten beiden Werte aus dem Stack herausgezogen - also 4 und 1 - und summiert. Das Ergebnis (5) wird wiederum in den Stack geschoben. Die beiden ursprünglichen Zahlen sind im Stack nicht mehr vorhanden.<br />
<br />
Ein zweites Beispiel:<br />
<br />
(1 + 2) * (4 + 5) muss wie bereits erwähnt folgendermaßen notiert werden:<br />
<br />
<pre><br />
1 2 + 4 5 + *<br />
</pre><br />
<br />
Der Stack verhält sich somit folgendermaßen:<br />
<br />
<pre><br />
Operation: Stack: 0 1 2 3 4 ...<br />
-----------------------------------------------------------------------------<br />
vorher: 0 0 0 0 0<br />
"1" 1 0 0 0 0<br />
"2" 2 1 0 0 0<br />
"+" 3 0 0 0 0<br />
"4" 4 3 0 0 0<br />
"5" 5 4 3 0 0<br />
"+" 9 3 0 0 0<br />
"*" 27 0 0 0 0<br />
</pre><br />
<br />
Am Ende befindet sich also das korrekte Ergebnis auf Stackplatz 0!<br />
<br />
=== Gleitkommazahlen und Strings ===<br />
<br />
Das OMSI-Skriptsystem arbeitet ausschließlich mit den Datentypen Gleitkommazahl (einfache Präzision mit Vorzeichen) und String. Beide Datentypen haben getrennte Stacks. Deshalb laufen die Verarbeitung von Gleitkommazahlen und Strings im Allgemeinen unabhängig nebeneinander. Jedoch kann es natürlich vorkommen, dass bestimmte Funktionen z.B. Zahlen in Strings umwandeln und somit gleichzeitig auf beide Teilbereiche zugreifen.<br />
<br />
Auf boolische Variablen wurde verzichtet. Für boolische Werte werden im Allgemeinen die Zahlenwerte 0 und 1 verwendet.<br />
<br />
== Script-Schlüsselwörter ==<br />
<br />
=== Kommentare ===<br />
<br />
Kommentierungen sind nur möglich, indem in der auszukommentierenden Zeile ganz vorne ein Apostroph ['] gesetzt wird:<br />
<br />
<pre><br />
'Ich bin eine Kommentarzeile<br />
'Ich bin KEINE Kommentarzeile!<br />
</pre><br />
<br />
=== Einstiegs- und Ausstiegspunkte, Makros und Trigger ===<br />
<br />
Alle Befehle müssen zwischen einem Einstiegs- und einem Ausstiegspunkt liegen.<br />
<br />
Der Einstiegspunkt wird durch eins der folgenden Schlüsselwörter gekennzeichnet:<br />
<br />
* {frame} Im Laufe jedes Frames ruft OMSI über diesen Einstiegspunkt die frameweise Scriptverarbeitung auf, sofern er vorhanden ist.<br />
* {init} Bei der Initialisierung ruft OMSI über diesen Einstiegspunkt die Script-Initialisierung auf.<br />
* {frame_ai} Hierbei handelt es sich um eine Variante des {frame}-Einstiegspunktes, welcher bei Fahrzeugen dann aufgerufen wird, wenn diese nicht im Fokus des Benutzers stehen, z.B. wenn sie als KI-Fahrzeug unterwegs sind. Ist dieser Einstiegspunkt jedoch nicht vorhanden sondern nur {frame}, dann wird dieser alternativ aufgerufen. Bei Szenerieobjekten kommt dieser Eintrittspunkt nicht zur Anwendung.<br />
* {macro:''name''} Dieser Einstiegspunkt ruft ein Subsektion (Makro) auf, welche '''stets nach dem Aufruf''' definiert werden muss.<br />
* {trigger:''name''} Dieser Einstiegspunkt wird vom Hauptprogramm aufgerufen, wenn der Benutzer die Tastenkombination oder das Maus-Event mit der Bezeichnung ''name'' aufruft - es gibt auch bestimmte Trigger, die direkt vom Hauptprogramm aufgerufen werden, z.B. wenn OMSI bei KI-Bussen die Anzeige wechselt u.Ä.<br />
<br />
{end} ist der universelle Ausstiegspunkt. Er muss stets den Block abschließen, der mit einem der obigen Befehle eröffnet wird.<br />
<br />
==== Makroaufruf ====<br />
<br />
Der Aufruf eines Makros erfolgt über (M.L.''name''). Der Aufruf des Makros muss ''immer'' vor dessen Definition erfolgen. Andernfalls meldet OMSI, dass das Makro nicht gefunden wurde.<br />
<br />
==== Aufteilung des Scripts in mehrere Dateien ====<br />
<br />
Bei einfachen Scripts (z.B. bei reinen KI-Fahrzeugen oder Szenerieobjekten) reicht es im Allgemeinen eine *.sco-Datei zu erstellen, welche über einen {frame}...{end}- und ggf. einen {init}...{end}-Block verfügt.<br />
<br />
Handelt es sich jedoch um ein komplettes Fahrzeugscript, dann empfiehlt es sich für die verschiedenen Subsysteme getrennte Dateien anzulegen. Hierbei sollte folgendermaßen vorgegangen werden:<br />
<br />
* Es gibt ein Hauptscript und die nötigen Subsystemdateien. Die Hauptdatei enthält dabei die {frame}- und {init}-Blöcke, die jedoch nur Makros aufrufen, welche in den Subsystemdateien definiert sind.<br />
* Für jedes Subsystem gibt es eine *.sco-Datei und je nach Bedarf eine eigene Varlist und Constfile mit den zum System gehörenden Variablen. Außerdem werden auch hier die Trigger für die Tastenbefehle einsortiert.<br />
* Die Makros sollten sinnvollerweise folgendermaßen benannt werden: {macro:''subsystem''_frame} und {macro:''subsystem''_init}.<br />
* Damit die Makros vom Hauptscript aufgerufen werden, muss dieses in der Liste der Scripts in der Objekt-Konfigurationsdatei als erstes aufgerufen werden. Die Reihenfolge der Scripts untereinander muss ebenfalls so gewählt werden, dass alle dateiübergreifenden Makroaufrufe stets vor der jeweiligen Makrodefinition stehen.<br />
<br />
Die Einschränkung, dass Makros immer hinter dem Aufruf definiert werden müssen, kann zwar bisweilen hinderlich sein, ist aber ein sehr wirksamer Schutz gegen Zirkelschlüsse und Endlosschleifen.<br />
<br />
==== Trigger ====<br />
<br />
Wie schon geschrieben wurde, kann ein {trigger:''name''}...{end}-Abschnitt durch verschiedene Möglichkeiten aus dem Hauptprogramm heraus aufgerufen werden. Hierzu zählen:<br />
<br />
* Auslösung per Tastatur. Wurde die Tastenkombination mit dem Namen ''tastkomb'' bezeichnet, wird {trigger:tastkomb} aufgerufen, wenn die Taste gedrückt wird und {trigger:tastkomb_off}, wenn die Taste losgelassen wird.<br />
* Auslösung per Maus. Wurde ein Mesh angeklickt mit der [mouseevent]-Bezeichnung ''mouse_ev'', so wird {trigger:mouse_ev} aufgerufen, wenn die Maustaste gedrückt wird, {trigger:mouse_ev_drag}, während die Maustaste gehalten wird und {trigger:mouse_ev_off}, wenn die Maustaste losgelassen wird.<br />
* Außerdem gibt es noch eine Reihe von [[System-Trigger|System-Triggern]].<br />
<br />
=== Operationen ===<br />
<br />
==== Stack-Operationen ====<br />
<br />
{| class="wikitable" style="font-size:95%;" <br />
|- class="hintergrundfarbe5"<br />
| align="left" |%stackdump%<br />
| align="left" |Gibt eine Dialogbox mit dem Gleitkomma-Stackinhalt aus. Sollte deshalb natürlich nur zu Debug-Zwecken eingesetzt werden.<br />
|-<br />
| align="left" |s0, s1, ..., s7<br />
| align="left" |Speichern des aktuellen Stackwertes im durch die Ziffer angegebenen Register. Der Wert verbleibt hierbei im Stack<br />
|-<br />
| align="left" |l0, l1, ..., l7<br />
| align="left" |Laden des entsprechenden Registerwertes und Verschiebung in den Stack. Registerwert bleibt erhalten.<br />
|-<br />
| align="left" |d<br />
| align="left" |Dubliziert den obersten Stackwert; alle weiteren Stackwerte rücken nach hinten.<br />
|-<br />
| align="left" |$msg<br />
| align="left" |Schreibt den obersten String-Stack-Wert in die Debug-Zeile von OMSI - egal, ob es sich um ein User-, KI-Fahrzeug oder Szenerieobjekt handelt.<br />
|-<br />
| align="left" |$d<br />
| align="left" |Dubliziert den Stringstack-Wert analog zu "d".<br />
|}<br />
<br />
==== Logische Operationen ====<br />
<br />
Die logischen Operationen arbeiten nach dem Prinzip 0 = FALSE, alles andere ist TRUE.<br />
<br />
{| class="wikitable" style="font-size:95%;" <br />
|- class="hintergrundfarbe5"<br />
| align="left" |&&<br />
| align="left" |UND, d.h. wenn einer der beiden obersten Stackwerte gleich 0 ist, ist das Ergbnis 0, sonst 1.<br />
|-<br />
| align="left" |<nowiki>||</nowiki><br />
| align="left" |ODER<br />
|-<br />
| align="left" |<nowiki>!</nowiki><br />
| align="left" |Verneinung<br />
|}<br />
<br />
==== Vergleichsoperationen ====<br />
<br />
Die Vergleichsoperationen vergleichen die Werte in den beiden jeweils obersten Stackplätzen und fügen dann je nach Ergebnis eine "1" oder "0" im obersten Stackplatz ein. Die Größer-/Kleinerzeichen stehen dabei entsprechend für der Reihenfolge, in der die Werte zuvor angegeben wurden. Das bedeutet:<br />
<br />
4 2 > ist wahr, weil die intern durchgeführte Operation in diesem Fall "4 > 2" ist.<br />
<br />
{| class="wikitable" style="font-size:95%;" <br />
|- class="hintergrundfarbe5"<br />
| align="left" |=<br />
| align="left" |"1", falls die obersten Stackwerte identisch sind, sonst "0".<br />
|-<br />
| align="left" |<<br />
| align="left" |"1", falls Stackwert 1 kleiner ist als Stackwert 0, sonst "0".<br />
|-<br />
| align="left" |><br />
| align="left" |... größer ist ...<br />
|-<br />
| align="left" |<=<br />
| align="left" |... kleiner als oder gleich ist ...<br />
|-<br />
| align="left" |>=<br />
| align="left" |... größer als oder gleich ist ...<br />
|-<br />
| align="left" |$=<br />
| align="left" |Wie "=" nur für die obersten beiden Stringstack-Plätze.<br />
|-<br />
| align="left" |$<<br />
| align="left" |Kleiner als (String). Die Ungleich-Operationen bei Strings prüfen auf alphabetische Reihenfolge. "A" ist also kleiner als "B".<br />
|-<br />
| align="left" |$><br />
| align="left" |Größer als (String).<br />
|-<br />
| align="left" |$<=<br />
| align="left" |Kleiner oder gleich (String).<br />
|-<br />
| align="left" |$>=<br />
| align="left" |Größer oder gleich (String).<br />
|}<br />
<br />
==== Mathematische Operationen ====<br />
<br />
{| class="wikitable" style="font-size:95%;" <br />
|- class="hintergrundfarbe5"<br />
| align="left" |+<br />
| align="left" |Plus<br />
|-<br />
| align="left" |-<br />
| align="left" |Minus (Stackplatz 1 - Stackplatz 0, also vom Prinzip her wie bei den Größer/Kleiner-Operationen)<br />
|-<br />
| align="left" |*<br />
| align="left" |Mal<br />
|-<br />
| align="left" |/<br />
| align="left" |geteilt (Stackplatz 1 / Stackplatz 0)<br />
|-<br />
| align="left" |%<br />
| align="left" |Rest der Division (folgendermaßen erweitert für Gleitkommazahlen: Stack0 - trunc(Stack1 / Stack0) * Stack1 )<br />
|-<br />
| align="left" |/-/<br />
| align="left" |Vorzeichenwechsel<br />
|-<br />
| align="left" |sin<br />
| align="left" |Sinus<br />
|-<br />
| align="left" |arcsin<br />
| align="left" |Umkehrfunktion zum Sinus ''(ab OMSI2)''<br />
|-<br />
| align="left" |arctan<br />
| align="left" |Umkehrfunktion zum Tangens ''(ab OMSI2)''<br />
|-<br />
| align="left" |min<br />
| align="left" |Wahl des kleineren der beiden obersten Stackwerte<br />
|-<br />
| align="left" |max<br />
| align="left" |Wahl des größeren der beiden obersten Stackwerte<br />
|-<br />
| align="left" |exp<br />
| align="left" |Exponentialfunktion zur Basis e (e^Stack0)<br />
|-<br />
| align="left" |sqrt<br />
| align="left" |Quadratwurzel<br />
|-<br />
| align="left" |sqr<br />
| align="left" |Quadrat<br />
|-<br />
| align="left" |sgn<br />
| align="left" |Rückgabe des Vorzeichens; je nachdem entweder -1, 0 oder 1<br />
|-<br />
| align="left" |pi<br />
| align="left" |Kreiszahl pi<br />
|-<br />
| align="left" |random<br />
| align="left" |ganzzahlige Zufallszahl 0 <= x < Stack0<br />
|-<br />
| align="left" |abs<br />
| align="left" |Rückgabe des Absolutwertes<br />
|-<br />
| align="left" |trunc<br />
| align="left" |Abrunden auf nächste ganze Zahl<br />
|}<br />
<br />
==== String-Operationen ====<br />
<br />
{| class="wikitable" style="font-size:95%;" <br />
|- class="hintergrundfarbe5"<br />
| align="left" |"''bla''"<br />
| align="left" |Einfügen des Strings ''bla'' auf dem obersten String-Stack-Platz<br />
|-<br />
| align="left" |$+<br />
| align="left" |Zusammenfügen zweier Strings. "Omnibus" "simulator" $+ ergibt "Omnibussimulator"<br />
|-<br />
| align="left" |$*<br />
| align="left" |Der oberste Stack-String wird sooft wiederholt, bis die resultierende Zeichenlänger gerade noch kleiner oder gleich des obersten Stackwertes ist. Beispiel: "nu" 6 $* ergibt "nununu"<br />
|-<br />
| align="left" |$length<br />
| align="left" |Gibt die Anzahl der Zeichen des obersten Stack-String zurück in den Stack. <br />
|-<br />
| align="left" |$cutBegin<br />
| align="left" |Schneidet ''stack0'' Zeichen vorne vom obersten Stack-String ab.<br />
|-<br />
| align="left" |$cutEnd<br />
| align="left" |Schneidet ''stack0'' Zeichen hinten vom obersten Stack-String ab.<br />
|-<br />
| align="left" |$SetLengthR<br />
| align="left" |Passt die Länge des obersten Stack-Strings auf ''stack0'' rechtsbündig an, indem am Anfang Zeichen entfernt oder Leerzeichen ergänzt werden.<br />
VORSICHT Bug! Der Befehl entfernt den Float-Operator nicht vom Stack. Der Wert, auf dessen Länge der String gekürzt wurde, verbleibt also auf Stack0.<br />
|-<br />
| align="left" |$SetLengthL<br />
| align="left" |Passt die Länge des obersten Stack-Strings auf ''stack0'' linksbündig an, indem am Ende Zeichen entfernt oder Leerzeichen ergänzt werden.<br />
VORSICHT Bug! Der Befehl entfernt den Float-Operator nicht vom Stack. Der Wert, auf dessen Länge der String gekürzt wurde, verbleibt also auf Stack0.<br />
|-<br />
| align="left" |$IntToStr<br />
| align="left" |Rundet ''stack0'' ab und wandelt die resultierende Ganzzahl um in einen String.<br />
|-<br />
| align="left" |$IntToStrEnh<br />
| align="left" |Die erweiterte Version von IntToStr. Hierbei wird der oberste Stack-String verwendet, um das Format der String-Umwandlung zu bestimmen: Das erste Zeichen im String wird zum Auffüllen der fehlenden Zeichen verwendet, die folgenden Zeichen müssen eine Zahl ergeben, die die Stellen angibt. Beispiel: 35 " 5" $IntToStrEnh führt zu " 35" und 123456789 "011" $IntToStrEnh führt zu "00123456789". Falls ein Fehler vorliegt, wird "ERROR" ausgegeben.<br />
|-<br />
| align="left" |$StrToFloat<br />
| align="left" |Wandelt den obersten Stack-String in eine Gleitkommazahl um, falls möglich. Andernfalls wird eine -1 geschrieben.<br />
|-<br />
|}<br />
<br />
=== Variablenzugriff ===<br />
<br />
Es wird unterschieden in Systemvariablen und in lokale Variablen. Die Systemvariablen gelten OMSI-weit, die lokalen Variablen werden zum Fahrzeug/Objekt zugehörig gespeichert.<br />
<br />
Bei den lokalen Variablen gibt es stets einen Grundstamm an Variablen, welcher von OMSI vordefiniert werden. Darüber hinaus können beliebig viele Variablen mit Hilfe der Varlist-Dateien ergänzt werden. <br />
<br />
{| class="wikitable" style="font-size:95%;" <br />
|- class="hintergrundfarbe5"<br />
| align="left" |(L.S.''varname'')<br />
| align="left" |Lädt die Systemvariable ''varname'' in den obersten Stackplatz<br />
|-<br />
| align="left" |(L.L.''varname'')<br />
| align="left" |Lädt die lokale Variable ''varname'' in den obersten Stackplatz<br />
|-<br />
| align="left" |(L.$.''varname'')<br />
| align="left" |Lädt die lokale String-Variable ''varname'' in den obersten String-Stackplatz<br />
|-<br />
| align="left" |(S.L.''varname'')<br />
| align="left" |Speichert den obersten Stackplatz in die lokale Variable ''varname''<br />
|-<br />
| align="left" |(S.$.''varname'')<br />
| align="left" |Speichert den obersten String-Stackplatz in die lokale String-Variable ''varname''<br />
|}<br />
<br />
Eine detaillierte Beschreibung der einzelnen Systemvariablen und der vordefinierten lokalen Variablen finden Sie hier: [[System- und vordefinierte lokalen Variablen]]<br />
<br />
=== Konstanten und Funktionen ===<br />
<br />
Lokale Konstanten und [http://de.wikipedia.org/w/index.php?title=Datei:Linear_interpolation.svg&filetimestamp=20080226155013 stückweise definierte lineare Funktionen] können in den Konstantendateien (''constfiles'', ''~_constfile.txt'') definiert werden. Der Aufbau jeder Konstantendatei entspricht der der [[Konfigurationsdateien|Konfigurationsdatei]]. Es gibt lediglich drei Schlüsselwörter. Zu beachten ist: Bisher können keine Strings, sondern nur Fließkommazahlen als Konstanten definiert werden.<br />
<br />
[const] definiert eine neue Konstante und gibt ihren Wert an:<br />
<br />
<pre><br />
[const]<br />
name<br />
wert<br />
</pre><br />
<br />
Beispiel:<br />
<br />
<pre><br />
[const]<br />
leistung<br />
200<br />
</pre><br />
<br />
[newcurve] leitet die Definition einer neuen (stückweise linearen) Funktion ein:<br />
<br />
<pre><br />
[newcurve]<br />
name<br />
</pre><br />
<br />
[pnt] fügt der zuvor mit [newcurve] definierten Funktion ein neues x-y-Paar hinzu. Jede Funktion sollte normalerweise über mindestens zwei Paare verfügen. Die Reihenfolge der Paare ''muss'' in x-Richtung aufsteigend sein!<br />
<br />
<pre><br />
[pnt]<br />
x<br />
y<br />
</pre><br />
<br />
Beispiel:<br />
<br />
<pre><br />
[newcurve]<br />
Drehzahl_Drehmoment_Kennlinie<br />
<br />
[pnt]<br />
50<br />
0<br />
<br />
[pnt]<br />
300<br />
400<br />
<br />
[pnt]<br />
1000<br />
600<br />
</pre><br />
<br />
Konstanten werden über den Befehl (C.L.''konstantenname'') in den Stack geladen.<br />
<br />
Funktionen werden über den Befehl (F.L.''funktionsname'') aufgerufen. Dabei wird stets der zuvor auf oberster Stackposition befindliche Wert als x-Parameter übergaben und der resultierende y-Wert der Funktion stattdessen auf dem obersten Stackplatz gespeichert. Bewegt sich der x-Wert außerhalb der Grenzen der durch die [pnt]-Einträge definierten Eckpunkte, wird stets der y-Wert des nächstliegenden Eckpunktes verwendet. Die Funktion wird also vor dem ersten und hinter dem letzten Eckpunkt ins Unendliche waagerecht verlängert.<br />
<br />
=== Sound-Trigger ===<br />
<br />
Soundtrigger sind nicht mit den weiter oben erwähnten Triggern zu verwechseln!<br />
<br />
Sie stellen vielmehr eine Möglichkeit dar, direkt einen gewünschten Sound abzuspielen. Hierbei gibt es zwei Möglichkeiten:<br />
<br />
(T.L.''soundtriggername'') ist ein einfacher Soundtrigger. Der so markierte Sound wird (einmalig) abgespielt.<br />
<br />
(T.F.''soundtriggername'') ist ein Soundtrigger mit Dateiwechselfunktion. Hierbei wird der oberste Stackstring ausgelesen und als Dateiname verwendet, wobei der Dateipfad relativ zum Sound-Ordner des Objektes interpretiert wird.<br />
<br />
Beispiel:<br />
<br />
Angenommen, die Sounddatei lautet "diese.wav" und ist mit dem Trigger ''MeinTrigger'' verknüpft, dann spielt<br />
<br />
(T.L.MeinTrigger)<br />
<br />
die Datei "diese.wav" ab und<br />
<br />
"andere.wav" (T.F.MeinTrigger)<br />
<br />
die Datei "andere.wav". Alternativ zu (T.L.''soundtriggername'') kann beim Befehl (T.F.''soundtriggername'') auch ein "Nullstring" im Stack liegen (also der String: "").<br />
<br />
=== System-Makros ===<br />
<br />
Die bisherigen Methoden erlauben dem Script folgende Kommunikationsmöglichkeiten mit OMSI:<br />
<br />
* Lesen von Werten über System- und vordefinierte lokale Variablen<br />
* Schreiben von Werten über ebendiese<br />
* Empfangen von Tastatur-, Maus- oder Systemtriggern<br />
<br />
Schließlich gibt es noch eine weitere Methode, um mit dem Hauptprogramm zu kommunizieren, die sogenannten System-Makros, gelegentlich auch unpräzise als "Callback-Funktionen" bezeichnet.<br />
<br />
In bestimmten Situationen ist es nötig, dass das Script Werte von OMSI bekommt, die in größeren Datenbanken vorliegen und daher nicht über vordefinierte Variablen übermittelt werden können, z.B. die Inhalte der Hofdatei. Hier kommen nun die System-Makros ins Spiel.<br />
<br />
Diese arbeiten scriptseitig sehr ähnlich wie die lokalen, selbstdefinierten Makros: Der Aufruf (M.V.''macroname'') ruft das System-Makro auf ("V" stand ursprünglich für "Vehicle-Macro", gilt aber genauso auch in Szenerieobjekten), das sich während der Ausführung Werte aus den beiden Stacks holt und/oder in diese schreibt. Eine Aufstellung aller System-Makros findet sich hier: [[System-Makros]]<br />
<br />
=== Bedingungen und Schleifen ===<br />
<br />
Die einzige Steuerung des Programmablaufs ist zur Zeit nur mit der IF-Bedingung möglich.<br />
<br />
==== IF-Bedingung ====<br />
<br />
<pre><br />
'Hier muss eine Bedingung stehen, z.B.:<br />
(L.L.bla) 1 =<br />
{if}<br />
'Dieser Abschnitt wird ausgeführt, wenn bla = 1 ist:<br />
2 3 +<br />
{else}<br />
'Dieser Abschnitt wird andernfalls ausgeführt:<br />
3 4 +<br />
{endif}<br />
(S.L.blub)<br />
{end}<br />
</pre><br />
<br />
Dass erst die Bedingung formuliert wird und dann erst das Schlüsselwort {if} folgt, sollte einleuchten: Zunächst muss an oberster Stelle des Stacks der Wert abgelegt werden und erst dann folgt das Schlüsselwort {if}, welches diesen Wert prüft. Hierbei bedeutet ähnlich wie bei && und || Gleichheit mit Null gleichbedeutend mit ''False'', alle anderen Werte bedeuten ''True''.<br />
<br />
Wenn also im obigen Beispiel ''bla'' den Wert 1 hat, wird ''blub'' auf den Wert 5 gesetzt, andernfalls auf den Wert 7.<br />
<br />
Verschachtelungen der IF-Bedingung dienen als Ersatz für die (nicht vorhandenen) "Else-If"-Konstruktionen:<br />
<br />
<pre><br />
'Hier muss eine Bedingung stehen, z.B.:<br />
(L.L.bla) 1 =<br />
{if}<br />
'Dieser Abschnitt wird ausgeführt, wenn bla = 1 ist:<br />
2 3 +<br />
{else}<br />
(L.L.bla) 5 =<br />
{if}<br />
'Dieser Abschnitt wird ausgeführt, wenn bla = 5 ist:<br />
3 4 +<br />
{else}<br />
'Dieser Abschnitt wird andernfalls ausgeführt:<br />
13<br />
{endif}<br />
{endif}<br />
(S.L.blub)<br />
{end}<br />
</pre><br />
<br />
Hierbei ist insbesondere auf das doppelte {endif} zu achten! Hier gilt:<br />
<br />
* bla = 1 ==> blub = 5<br />
* bla = 5 ==> blub = 7<br />
* sonst ==> blub = 13<br />
<br />
[[Kategorie:Nachschlagewerk für Addon-Entwickler]]</div>Marcel Kuhnthttp://wiki.omnibussimulator.de/omsiwikineu.de/index.php?title=Scriptsystem&diff=859Scriptsystem2014-02-11T10:13:53Z<p>Marcel Kuhnt: /* Mathematische Operationen */</p>
<hr />
<div>''Hinweis: Dieser Artikel wurde noch nicht ins Englische übersetzt!''<br />
<br />
Das Scriptsystem in OMSI ermöglicht es, dass Szenerieobjekte und vor allem Fahrzeuge mit individuellen Systemen ausgestattet werden können, die über Variablen und Funktionsaufrufe mit dem Hauptprogramm und der Grafik- und Soundengine kommunizieren.<br />
<br />
Der hier beschriebene Stand des Scriptsystems entspricht OMSI Version 1.01.<br />
<br />
== Dateien des Scriptsystems ==<br />
<br />
Das Scriptsystem umfasst folgende Dateien:<br />
<br />
* Scriptdateien mit ausführbarem Code (*.osc)<br />
* Varlist- und Stringvarlist-Dateien im OMSI\program-Verzeichnis zur Definition von (reinen) Systemvariablen<br />
* Varlist- und Stringvarlist-Dateien zur Definition von Uservariablen und (zusätzlichen) Systemvariablen (seit OMSI2)<br />
* Constfile-Dateien zur Definition von Userkonstanten und Funktionstabellen<br />
<br />
Abgesehen von den Dateien zur Definition von Systemvariablen müssen alle benötigten Dateien für jedes Fahrzeug/Szenerieobjekt (im folgenden kurz: Objekt) in dessen [[Konfigurationsdatei]] angemeldet werden.<br />
<br />
Hierfür gibt es die Befehle ''[script]'', ''[varnamelist]'', ''[stringvarnamelist]'' und ''[constfile]''. Der erste Eintrag jedes Befehls ist die Anzahl der Dateien, darauf folgen die entsprechenden Dateinamen (inkl. Pfad relativ zur Konfigurationsdatei. Die Namen der Dateien sind nicht relevant, solange sie korrekt in die Listen eingetragen werden.<br />
<br />
Auf die Funktion der jeweiligen Dateien wird im Laufe der Beschreibung der Scriptsprache eingegangen.<br />
<br />
== Grundlagen der Scriptsprache ==<br />
<br />
Das OMSI-Scriptsystem arbeitet mit der [http://de.wikipedia.org/wiki/Umgekehrte_Polnische_Notation umgekehrten Polnischen Notation]. Hierbei steht der Operator hinter den beiden Operanden; vereinfacht gesagt bedeutet es, dass die Operation " 1 + 2 " stattdessen folgendermaßen notiert wird: " 1 2 + ". Ein komplizierteres Beispiel: " (1 + 2) * (4 + 5) " entspricht " 1 2 + 4 5 + * ".<br />
<br />
Ganz wichtig ist die Tatsache, dass die OMSI-Textdateien und insbesondere die Scriptsprache [http://de.wikipedia.org/wiki/Case_sensitivity Case-Sensitive] ist! D.h. es ist immer auf die Groß- und Kleinschreibung zu achten!<br />
<br />
=== Stack und Register ===<br />
<br />
Bei der Verarbeitung der Scripts verfügt OMSI über einen String-Stack und einen [http://de.wikipedia.org/wiki/Stapelspeicher Stack] für [http://de.wikipedia.org/wiki/Gleitkommazahl Gleitkommazahlen]. Im folgenden ist mit "Stack" immer der Stack für Gleitkommazahlen gemeint, andernfalls wird von "String-Stack" gesprochen.<br />
<br />
Beide Stacks enthält 8 Speicherplätze, welche von 0 bis 7 durchnumeriert sind. Jede Script-Operation kann nun einen oder mehrere neue Werte in einen der Stacks einfügen (push), wobei der neue Wert auf die Position 0 gesetzt wird und alle folgenden Werte "einen Platz aufrücken", oder sie kann einen oder mehrere Werte aus dem Stack herausziehen (pop/pull) oder lediglich auslesen (peek).<br />
<br />
Fürs temporäre Ablegen von Zahlen gibt es zusätzlich acht indizierte Speicherplätze, welche direkt geschrieben oder gelesen werden können, die sich im sogenannten Register befinden - hier gibt es jedoch nur einen Register für die Gleitkommazahlen.<br />
<br />
=== Beispiel-Operationen ===<br />
<br />
Beispiel: Die Operation 1 + 4. Der Code hierfür lautet:<br />
<br />
<pre><br />
1 4 +<br />
</pre><br />
<br />
In der folgenden Tabelle wird demonstriert, wie sich hierbei der Stack verhält:<br />
<br />
<pre><br />
Operation: Stack: 0 1 2 3 4 ...<br />
-----------------------------------------------------------------------------<br />
vorher: 0 0 0 0 0<br />
"1" 1 0 0 0 0<br />
"4" 4 1 0 0 0<br />
"+" 5 0 0 0 0<br />
</pre><br />
<br />
Im Ausgangszustand ist der Stack nur mit Nullen (oder unbekannten/zufälligen Werten) gefüllt. Der Befehl "1" schiebt die Eins in den obersten Stackplatz und schiebt alle weiteren Werte (Nullen) nach hinten. Der Befehl "4" schiebt die Vier auf den 0. Platz und alle folgenden Werte, also insbesondere die Eins auf den jeweils nächsten Platz. Im nächsten Schritt "+" werden die obersten beiden Werte aus dem Stack herausgezogen - also 4 und 1 - und summiert. Das Ergebnis (5) wird wiederum in den Stack geschoben. Die beiden ursprünglichen Zahlen sind im Stack nicht mehr vorhanden.<br />
<br />
Ein zweites Beispiel:<br />
<br />
(1 + 2) * (4 + 5) muss wie bereits erwähnt folgendermaßen notiert werden:<br />
<br />
<pre><br />
1 2 + 4 5 + *<br />
</pre><br />
<br />
Der Stack verhält sich somit folgendermaßen:<br />
<br />
<pre><br />
Operation: Stack: 0 1 2 3 4 ...<br />
-----------------------------------------------------------------------------<br />
vorher: 0 0 0 0 0<br />
"1" 1 0 0 0 0<br />
"2" 2 1 0 0 0<br />
"+" 3 0 0 0 0<br />
"4" 4 3 0 0 0<br />
"5" 5 4 3 0 0<br />
"+" 9 3 0 0 0<br />
"*" 27 0 0 0 0<br />
</pre><br />
<br />
Am Ende befindet sich also das korrekte Ergebnis auf Stackplatz 0!<br />
<br />
=== Gleitkommazahlen und Strings ===<br />
<br />
Das OMSI-Skriptsystem arbeitet ausschließlich mit den Datentypen Gleitkommazahl (einfache Präzision mit Vorzeichen) und String. Beide Datentypen haben getrennte Stacks. Deshalb laufen die Verarbeitung von Gleitkommazahlen und Strings im Allgemeinen unabhängig nebeneinander. Jedoch kann es natürlich vorkommen, dass bestimmte Funktionen z.B. Zahlen in Strings umwandeln und somit gleichzeitig auf beide Teilbereiche zugreifen.<br />
<br />
Auf boolische Variablen wurde verzichtet. Für boolische Werte werden im Allgemeinen die Zahlenwerte 0 und 1 verwendet.<br />
<br />
== Script-Schlüsselwörter ==<br />
<br />
=== Kommentare ===<br />
<br />
Kommentierungen sind nur möglich, indem in der auszukommentierenden Zeile ganz vorne ein Apostroph ['] gesetzt wird:<br />
<br />
<pre><br />
'Ich bin eine Kommentarzeile<br />
'Ich bin KEINE Kommentarzeile!<br />
</pre><br />
<br />
=== Einstiegs- und Ausstiegspunkte, Makros und Trigger ===<br />
<br />
Alle Befehle müssen zwischen einem Einstiegs- und einem Ausstiegspunkt liegen.<br />
<br />
Der Einstiegspunkt wird durch eins der folgenden Schlüsselwörter gekennzeichnet:<br />
<br />
* {frame} Im Laufe jedes Frames ruft OMSI über diesen Einstiegspunkt die frameweise Scriptverarbeitung auf, sofern er vorhanden ist.<br />
* {init} Bei der Initialisierung ruft OMSI über diesen Einstiegspunkt die Script-Initialisierung auf.<br />
* {frame_ai} Hierbei handelt es sich um eine Variante des {frame}-Einstiegspunktes, welcher bei Fahrzeugen dann aufgerufen wird, wenn diese nicht im Fokus des Benutzers stehen, z.B. wenn sie als KI-Fahrzeug unterwegs sind. Ist dieser Einstiegspunkt jedoch nicht vorhanden sondern nur {frame}, dann wird dieser alternativ aufgerufen. Bei Szenerieobjekten kommt dieser Eintrittspunkt nicht zur Anwendung.<br />
* {macro:''name''} Dieser Einstiegspunkt ruft ein Subsektion (Makro) auf, welche '''stets nach dem Aufruf''' definiert werden muss.<br />
* {trigger:''name''} Dieser Einstiegspunkt wird vom Hauptprogramm aufgerufen, wenn der Benutzer die Tastenkombination oder das Maus-Event mit der Bezeichnung ''name'' aufruft - es gibt auch bestimmte Trigger, die direkt vom Hauptprogramm aufgerufen werden, z.B. wenn OMSI bei KI-Bussen die Anzeige wechselt u.Ä.<br />
<br />
{end} ist der universelle Ausstiegspunkt. Er muss stets den Block abschließen, der mit einem der obigen Befehle eröffnet wird.<br />
<br />
==== Makroaufruf ====<br />
<br />
Der Aufruf eines Makros erfolgt über (M.L.''name''). Der Aufruf des Makros muss ''immer'' vor dessen Definition erfolgen. Andernfalls meldet OMSI, dass das Makro nicht gefunden wurde.<br />
<br />
==== Aufteilung des Scripts in mehrere Dateien ====<br />
<br />
Bei einfachen Scripts (z.B. bei reinen KI-Fahrzeugen oder Szenerieobjekten) reicht es im Allgemeinen eine *.sco-Datei zu erstellen, welche über einen {frame}...{end}- und ggf. einen {init}...{end}-Block verfügt.<br />
<br />
Handelt es sich jedoch um ein komplettes Fahrzeugscript, dann empfiehlt es sich für die verschiedenen Subsysteme getrennte Dateien anzulegen. Hierbei sollte folgendermaßen vorgegangen werden:<br />
<br />
* Es gibt ein Hauptscript und die nötigen Subsystemdateien. Die Hauptdatei enthält dabei die {frame}- und {init}-Blöcke, die jedoch nur Makros aufrufen, welche in den Subsystemdateien definiert sind.<br />
* Für jedes Subsystem gibt es eine *.sco-Datei und je nach Bedarf eine eigene Varlist und Constfile mit den zum System gehörenden Variablen. Außerdem werden auch hier die Trigger für die Tastenbefehle einsortiert.<br />
* Die Makros sollten sinnvollerweise folgendermaßen benannt werden: {macro:''subsystem''_frame} und {macro:''subsystem''_init}.<br />
* Damit die Makros vom Hauptscript aufgerufen werden, muss dieses in der Liste der Scripts in der Objekt-Konfigurationsdatei als erstes aufgerufen werden. Die Reihenfolge der Scripts untereinander muss ebenfalls so gewählt werden, dass alle dateiübergreifenden Makroaufrufe stets vor der jeweiligen Makrodefinition stehen.<br />
<br />
Die Einschränkung, dass Makros immer hinter dem Aufruf definiert werden müssen, kann zwar bisweilen hinderlich sein, ist aber ein sehr wirksamer Schutz gegen Zirkelschlüsse und Endlosschleifen.<br />
<br />
==== Trigger ====<br />
<br />
Wie schon geschrieben wurde, kann ein {trigger:''name''}...{end}-Abschnitt durch verschiedene Möglichkeiten aus dem Hauptprogramm heraus aufgerufen werden. Hierzu zählen:<br />
<br />
* Auslösung per Tastatur. Wurde die Tastenkombination mit dem Namen ''tastkomb'' bezeichnet, wird {trigger:tastkomb} aufgerufen, wenn die Taste gedrückt wird und {trigger:tastkomb_off}, wenn die Taste losgelassen wird.<br />
* Auslösung per Maus. Wurde ein Mesh angeklickt mit der [mouseevent]-Bezeichnung ''mouse_ev'', so wird {trigger:mouse_ev} aufgerufen, wenn die Maustaste gedrückt wird, {trigger:mouse_ev_drag}, während die Maustaste gehalten wird und {trigger:mouse_ev_off}, wenn die Maustaste losgelassen wird.<br />
* Außerdem gibt es noch eine Reihe von [[System-Trigger|System-Triggern]].<br />
<br />
=== Operationen ===<br />
<br />
==== Stack-Operationen ====<br />
<br />
{| class="wikitable" style="font-size:95%;" <br />
|- class="hintergrundfarbe5"<br />
| align="left" |%stackdump%<br />
| align="left" |Gibt eine Dialogbox mit dem Gleitkomma-Stackinhalt aus. Sollte deshalb natürlich nur zu Debug-Zwecken eingesetzt werden.<br />
|-<br />
| align="left" |s0, s1, ..., s7<br />
| align="left" |Speichern des aktuellen Stackwertes im durch die Ziffer angegebenen Register. Der Wert verbleibt hierbei im Stack<br />
|-<br />
| align="left" |l0, l1, ..., l7<br />
| align="left" |Laden des entsprechenden Registerwertes und Verschiebung in den Stack. Registerwert bleibt erhalten.<br />
|-<br />
| align="left" |d<br />
| align="left" |Dubliziert den obersten Stackwert; alle weiteren Stackwerte rücken nach hinten.<br />
|-<br />
| align="left" |$msg<br />
| align="left" |Schreibt den obersten String-Stack-Wert in die Debug-Zeile von OMSI - egal, ob es sich um ein User-, KI-Fahrzeug oder Szenerieobjekt handelt.<br />
|-<br />
| align="left" |$d<br />
| align="left" |Dubliziert den Stringstack-Wert analog zu "d".<br />
|}<br />
<br />
==== Logische Operationen ====<br />
<br />
Die logischen Operationen arbeiten nach dem Prinzip 0 = FALSE, alles andere ist TRUE.<br />
<br />
{| class="wikitable" style="font-size:95%;" <br />
|- class="hintergrundfarbe5"<br />
| align="left" |&&<br />
| align="left" |UND, d.h. wenn einer der beiden obersten Stackwerte gleich 0 ist, ist das Ergbnis 0, sonst 1.<br />
|-<br />
| align="left" |<nowiki>||</nowiki><br />
| align="left" |ODER<br />
|-<br />
| align="left" |<nowiki>!</nowiki><br />
| align="left" |Verneinung<br />
|}<br />
<br />
==== Vergleichsoperationen ====<br />
<br />
Die Vergleichsoperationen vergleichen die Werte in den beiden jeweils obersten Stackplätzen und fügen dann je nach Ergebnis eine "1" oder "0" im obersten Stackplatz ein. Die Größer-/Kleinerzeichen stehen dabei entsprechend für der Reihenfolge, in der die Werte zuvor angegeben wurden. Das bedeutet:<br />
<br />
4 2 > ist wahr, weil die intern durchgeführte Operation in diesem Fall "4 > 2" ist.<br />
<br />
{| class="wikitable" style="font-size:95%;" <br />
|- class="hintergrundfarbe5"<br />
| align="left" |=<br />
| align="left" |"1", falls die obersten Stackwerte identisch sind, sonst "0".<br />
|-<br />
| align="left" |<<br />
| align="left" |"1", falls Stackwert 1 kleiner ist als Stackwert 0, sonst "0".<br />
|-<br />
| align="left" |><br />
| align="left" |... größer ist ...<br />
|-<br />
| align="left" |<=<br />
| align="left" |... kleiner als oder gleich ist ...<br />
|-<br />
| align="left" |>=<br />
| align="left" |... größer als oder gleich ist ...<br />
|-<br />
| align="left" |$=<br />
| align="left" |Wie "=" nur für die obersten beiden Stringstack-Plätze.<br />
|-<br />
| align="left" |$<<br />
| align="left" |Kleiner als (String). Die Ungleich-Operationen bei Strings prüfen auf alphabetische Reihenfolge. "A" ist also kleiner als "B".<br />
|-<br />
| align="left" |$><br />
| align="left" |Größer als (String).<br />
|-<br />
| align="left" |$<=<br />
| align="left" |Kleiner oder gleich (String).<br />
|-<br />
| align="left" |$>=<br />
| align="left" |Größer oder gleich (String).<br />
|}<br />
<br />
==== Mathematische Operationen ====<br />
<br />
{| class="wikitable" style="font-size:95%;" <br />
|- class="hintergrundfarbe5"<br />
| align="left" |+<br />
| align="left" |Plus<br />
|-<br />
| align="left" |-<br />
| align="left" |Minus (Stackplatz 1 - Stackplatz 0, also vom Prinzip her wie bei den Größer/Kleiner-Operationen)<br />
|-<br />
| align="left" |*<br />
| align="left" |Mal<br />
|-<br />
| align="left" |/<br />
| align="left" |geteilt (Stackplatz 1 / Stackplatz 0)<br />
|-<br />
| align="left" |%<br />
| align="left" |Rest der Division (folgendermaßen erweitert für Gleitkommazahlen: Stack0 - trunc(Stack1 / Stack0) * Stack1 )<br />
|-<br />
| align="left" |/-/<br />
| align="left" |Vorzeichenwechsel<br />
|-<br />
| align="left" |sin<br />
| align="left" |Sinus<br />
|-<br />
| align="left" |arcsin<br />
| align="left" |Umkehrfunktion zum Sinus (ab OMSI2)<br />
|-<br />
| align="left" |arctan<br />
| align="left" |Umkehrfunktion zum Tangens (ab OMSI2)<br />
|-<br />
| align="left" |min<br />
| align="left" |Wahl des kleineren der beiden obersten Stackwerte<br />
|-<br />
| align="left" |max<br />
| align="left" |Wahl des größeren der beiden obersten Stackwerte<br />
|-<br />
| align="left" |exp<br />
| align="left" |Exponentialfunktion zur Basis e (e^Stack0)<br />
|-<br />
| align="left" |sqrt<br />
| align="left" |Quadratwurzel<br />
|-<br />
| align="left" |sqr<br />
| align="left" |Quadrat<br />
|-<br />
| align="left" |sgn<br />
| align="left" |Rückgabe des Vorzeichens; je nachdem entweder -1, 0 oder 1<br />
|-<br />
| align="left" |pi<br />
| align="left" |Kreiszahl pi<br />
|-<br />
| align="left" |random<br />
| align="left" |ganzzahlige Zufallszahl 0 <= x < Stack0<br />
|-<br />
| align="left" |abs<br />
| align="left" |Rückgabe des Absolutwertes<br />
|-<br />
| align="left" |trunc<br />
| align="left" |Abrunden auf nächste ganze Zahl<br />
|}<br />
<br />
==== String-Operationen ====<br />
<br />
{| class="wikitable" style="font-size:95%;" <br />
|- class="hintergrundfarbe5"<br />
| align="left" |"''bla''"<br />
| align="left" |Einfügen des Strings ''bla'' auf dem obersten String-Stack-Platz<br />
|-<br />
| align="left" |$+<br />
| align="left" |Zusammenfügen zweier Strings. "Omnibus" "simulator" $+ ergibt "Omnibussimulator"<br />
|-<br />
| align="left" |$*<br />
| align="left" |Der oberste Stack-String wird sooft wiederholt, bis die resultierende Zeichenlänger gerade noch kleiner oder gleich des obersten Stackwertes ist. Beispiel: "nu" 6 $* ergibt "nununu"<br />
|-<br />
| align="left" |$length<br />
| align="left" |Gibt die Anzahl der Zeichen des obersten Stack-String zurück in den Stack. <br />
|-<br />
| align="left" |$cutBegin<br />
| align="left" |Schneidet ''stack0'' Zeichen vorne vom obersten Stack-String ab.<br />
|-<br />
| align="left" |$cutEnd<br />
| align="left" |Schneidet ''stack0'' Zeichen hinten vom obersten Stack-String ab.<br />
|-<br />
| align="left" |$SetLengthR<br />
| align="left" |Passt die Länge des obersten Stack-Strings auf ''stack0'' rechtsbündig an, indem am Anfang Zeichen entfernt oder Leerzeichen ergänzt werden.<br />
VORSICHT Bug! Der Befehl entfernt den Float-Operator nicht vom Stack. Der Wert, auf dessen Länge der String gekürzt wurde, verbleibt also auf Stack0.<br />
|-<br />
| align="left" |$SetLengthL<br />
| align="left" |Passt die Länge des obersten Stack-Strings auf ''stack0'' linksbündig an, indem am Ende Zeichen entfernt oder Leerzeichen ergänzt werden.<br />
VORSICHT Bug! Der Befehl entfernt den Float-Operator nicht vom Stack. Der Wert, auf dessen Länge der String gekürzt wurde, verbleibt also auf Stack0.<br />
|-<br />
| align="left" |$IntToStr<br />
| align="left" |Rundet ''stack0'' ab und wandelt die resultierende Ganzzahl um in einen String.<br />
|-<br />
| align="left" |$IntToStrEnh<br />
| align="left" |Die erweiterte Version von IntToStr. Hierbei wird der oberste Stack-String verwendet, um das Format der String-Umwandlung zu bestimmen: Das erste Zeichen im String wird zum Auffüllen der fehlenden Zeichen verwendet, die folgenden Zeichen müssen eine Zahl ergeben, die die Stellen angibt. Beispiel: 35 " 5" $IntToStrEnh führt zu " 35" und 123456789 "011" $IntToStrEnh führt zu "00123456789". Falls ein Fehler vorliegt, wird "ERROR" ausgegeben.<br />
|-<br />
| align="left" |$StrToFloat<br />
| align="left" |Wandelt den obersten Stack-String in eine Gleitkommazahl um, falls möglich. Andernfalls wird eine -1 geschrieben.<br />
|-<br />
|}<br />
<br />
=== Variablenzugriff ===<br />
<br />
Es wird unterschieden in Systemvariablen und in lokale Variablen. Die Systemvariablen gelten OMSI-weit, die lokalen Variablen werden zum Fahrzeug/Objekt zugehörig gespeichert.<br />
<br />
Bei den lokalen Variablen gibt es stets einen Grundstamm an Variablen, welcher von OMSI vordefiniert werden. Darüber hinaus können beliebig viele Variablen mit Hilfe der Varlist-Dateien ergänzt werden. <br />
<br />
{| class="wikitable" style="font-size:95%;" <br />
|- class="hintergrundfarbe5"<br />
| align="left" |(L.S.''varname'')<br />
| align="left" |Lädt die Systemvariable ''varname'' in den obersten Stackplatz<br />
|-<br />
| align="left" |(L.L.''varname'')<br />
| align="left" |Lädt die lokale Variable ''varname'' in den obersten Stackplatz<br />
|-<br />
| align="left" |(L.$.''varname'')<br />
| align="left" |Lädt die lokale String-Variable ''varname'' in den obersten String-Stackplatz<br />
|-<br />
| align="left" |(S.L.''varname'')<br />
| align="left" |Speichert den obersten Stackplatz in die lokale Variable ''varname''<br />
|-<br />
| align="left" |(S.$.''varname'')<br />
| align="left" |Speichert den obersten String-Stackplatz in die lokale String-Variable ''varname''<br />
|}<br />
<br />
Eine detaillierte Beschreibung der einzelnen Systemvariablen und der vordefinierten lokalen Variablen finden Sie hier: [[System- und vordefinierte lokalen Variablen]]<br />
<br />
=== Konstanten und Funktionen ===<br />
<br />
Lokale Konstanten und [http://de.wikipedia.org/w/index.php?title=Datei:Linear_interpolation.svg&filetimestamp=20080226155013 stückweise definierte lineare Funktionen] können in den Konstantendateien (''constfiles'', ''~_constfile.txt'') definiert werden. Der Aufbau jeder Konstantendatei entspricht der der [[Konfigurationsdateien|Konfigurationsdatei]]. Es gibt lediglich drei Schlüsselwörter. Zu beachten ist: Bisher können keine Strings, sondern nur Fließkommazahlen als Konstanten definiert werden.<br />
<br />
[const] definiert eine neue Konstante und gibt ihren Wert an:<br />
<br />
<pre><br />
[const]<br />
name<br />
wert<br />
</pre><br />
<br />
Beispiel:<br />
<br />
<pre><br />
[const]<br />
leistung<br />
200<br />
</pre><br />
<br />
[newcurve] leitet die Definition einer neuen (stückweise linearen) Funktion ein:<br />
<br />
<pre><br />
[newcurve]<br />
name<br />
</pre><br />
<br />
[pnt] fügt der zuvor mit [newcurve] definierten Funktion ein neues x-y-Paar hinzu. Jede Funktion sollte normalerweise über mindestens zwei Paare verfügen. Die Reihenfolge der Paare ''muss'' in x-Richtung aufsteigend sein!<br />
<br />
<pre><br />
[pnt]<br />
x<br />
y<br />
</pre><br />
<br />
Beispiel:<br />
<br />
<pre><br />
[newcurve]<br />
Drehzahl_Drehmoment_Kennlinie<br />
<br />
[pnt]<br />
50<br />
0<br />
<br />
[pnt]<br />
300<br />
400<br />
<br />
[pnt]<br />
1000<br />
600<br />
</pre><br />
<br />
Konstanten werden über den Befehl (C.L.''konstantenname'') in den Stack geladen.<br />
<br />
Funktionen werden über den Befehl (F.L.''funktionsname'') aufgerufen. Dabei wird stets der zuvor auf oberster Stackposition befindliche Wert als x-Parameter übergaben und der resultierende y-Wert der Funktion stattdessen auf dem obersten Stackplatz gespeichert. Bewegt sich der x-Wert außerhalb der Grenzen der durch die [pnt]-Einträge definierten Eckpunkte, wird stets der y-Wert des nächstliegenden Eckpunktes verwendet. Die Funktion wird also vor dem ersten und hinter dem letzten Eckpunkt ins Unendliche waagerecht verlängert.<br />
<br />
=== Sound-Trigger ===<br />
<br />
Soundtrigger sind nicht mit den weiter oben erwähnten Triggern zu verwechseln!<br />
<br />
Sie stellen vielmehr eine Möglichkeit dar, direkt einen gewünschten Sound abzuspielen. Hierbei gibt es zwei Möglichkeiten:<br />
<br />
(T.L.''soundtriggername'') ist ein einfacher Soundtrigger. Der so markierte Sound wird (einmalig) abgespielt.<br />
<br />
(T.F.''soundtriggername'') ist ein Soundtrigger mit Dateiwechselfunktion. Hierbei wird der oberste Stackstring ausgelesen und als Dateiname verwendet, wobei der Dateipfad relativ zum Sound-Ordner des Objektes interpretiert wird.<br />
<br />
Beispiel:<br />
<br />
Angenommen, die Sounddatei lautet "diese.wav" und ist mit dem Trigger ''MeinTrigger'' verknüpft, dann spielt<br />
<br />
(T.L.MeinTrigger)<br />
<br />
die Datei "diese.wav" ab und<br />
<br />
"andere.wav" (T.F.MeinTrigger)<br />
<br />
die Datei "andere.wav". Alternativ zu (T.L.''soundtriggername'') kann beim Befehl (T.F.''soundtriggername'') auch ein "Nullstring" im Stack liegen (also der String: "").<br />
<br />
=== System-Makros ===<br />
<br />
Die bisherigen Methoden erlauben dem Script folgende Kommunikationsmöglichkeiten mit OMSI:<br />
<br />
* Lesen von Werten über System- und vordefinierte lokale Variablen<br />
* Schreiben von Werten über ebendiese<br />
* Empfangen von Tastatur-, Maus- oder Systemtriggern<br />
<br />
Schließlich gibt es noch eine weitere Methode, um mit dem Hauptprogramm zu kommunizieren, die sogenannten System-Makros, gelegentlich auch unpräzise als "Callback-Funktionen" bezeichnet.<br />
<br />
In bestimmten Situationen ist es nötig, dass das Script Werte von OMSI bekommt, die in größeren Datenbanken vorliegen und daher nicht über vordefinierte Variablen übermittelt werden können, z.B. die Inhalte der Hofdatei. Hier kommen nun die System-Makros ins Spiel.<br />
<br />
Diese arbeiten scriptseitig sehr ähnlich wie die lokalen, selbstdefinierten Makros: Der Aufruf (M.V.''macroname'') ruft das System-Makro auf ("V" stand ursprünglich für "Vehicle-Macro", gilt aber genauso auch in Szenerieobjekten), das sich während der Ausführung Werte aus den beiden Stacks holt und/oder in diese schreibt. Eine Aufstellung aller System-Makros findet sich hier: [[System-Makros]]<br />
<br />
=== Bedingungen und Schleifen ===<br />
<br />
Die einzige Steuerung des Programmablaufs ist zur Zeit nur mit der IF-Bedingung möglich.<br />
<br />
==== IF-Bedingung ====<br />
<br />
<pre><br />
'Hier muss eine Bedingung stehen, z.B.:<br />
(L.L.bla) 1 =<br />
{if}<br />
'Dieser Abschnitt wird ausgeführt, wenn bla = 1 ist:<br />
2 3 +<br />
{else}<br />
'Dieser Abschnitt wird andernfalls ausgeführt:<br />
3 4 +<br />
{endif}<br />
(S.L.blub)<br />
{end}<br />
</pre><br />
<br />
Dass erst die Bedingung formuliert wird und dann erst das Schlüsselwort {if} folgt, sollte einleuchten: Zunächst muss an oberster Stelle des Stacks der Wert abgelegt werden und erst dann folgt das Schlüsselwort {if}, welches diesen Wert prüft. Hierbei bedeutet ähnlich wie bei && und || Gleichheit mit Null gleichbedeutend mit ''False'', alle anderen Werte bedeuten ''True''.<br />
<br />
Wenn also im obigen Beispiel ''bla'' den Wert 1 hat, wird ''blub'' auf den Wert 5 gesetzt, andernfalls auf den Wert 7.<br />
<br />
Verschachtelungen der IF-Bedingung dienen als Ersatz für die (nicht vorhandenen) "Else-If"-Konstruktionen:<br />
<br />
<pre><br />
'Hier muss eine Bedingung stehen, z.B.:<br />
(L.L.bla) 1 =<br />
{if}<br />
'Dieser Abschnitt wird ausgeführt, wenn bla = 1 ist:<br />
2 3 +<br />
{else}<br />
(L.L.bla) 5 =<br />
{if}<br />
'Dieser Abschnitt wird ausgeführt, wenn bla = 5 ist:<br />
3 4 +<br />
{else}<br />
'Dieser Abschnitt wird andernfalls ausgeführt:<br />
13<br />
{endif}<br />
{endif}<br />
(S.L.blub)<br />
{end}<br />
</pre><br />
<br />
Hierbei ist insbesondere auf das doppelte {endif} zu achten! Hier gilt:<br />
<br />
* bla = 1 ==> blub = 5<br />
* bla = 5 ==> blub = 7<br />
* sonst ==> blub = 13<br />
<br />
[[Kategorie:Nachschlagewerk für Addon-Entwickler]]</div>Marcel Kuhnthttp://wiki.omnibussimulator.de/omsiwikineu.de/index.php?title=Scriptsystem&diff=858Scriptsystem2014-02-11T10:08:08Z<p>Marcel Kuhnt: /* Dateien des Scriptsystems */</p>
<hr />
<div>''Hinweis: Dieser Artikel wurde noch nicht ins Englische übersetzt!''<br />
<br />
Das Scriptsystem in OMSI ermöglicht es, dass Szenerieobjekte und vor allem Fahrzeuge mit individuellen Systemen ausgestattet werden können, die über Variablen und Funktionsaufrufe mit dem Hauptprogramm und der Grafik- und Soundengine kommunizieren.<br />
<br />
Der hier beschriebene Stand des Scriptsystems entspricht OMSI Version 1.01.<br />
<br />
== Dateien des Scriptsystems ==<br />
<br />
Das Scriptsystem umfasst folgende Dateien:<br />
<br />
* Scriptdateien mit ausführbarem Code (*.osc)<br />
* Varlist- und Stringvarlist-Dateien im OMSI\program-Verzeichnis zur Definition von (reinen) Systemvariablen<br />
* Varlist- und Stringvarlist-Dateien zur Definition von Uservariablen und (zusätzlichen) Systemvariablen (seit OMSI2)<br />
* Constfile-Dateien zur Definition von Userkonstanten und Funktionstabellen<br />
<br />
Abgesehen von den Dateien zur Definition von Systemvariablen müssen alle benötigten Dateien für jedes Fahrzeug/Szenerieobjekt (im folgenden kurz: Objekt) in dessen [[Konfigurationsdatei]] angemeldet werden.<br />
<br />
Hierfür gibt es die Befehle ''[script]'', ''[varnamelist]'', ''[stringvarnamelist]'' und ''[constfile]''. Der erste Eintrag jedes Befehls ist die Anzahl der Dateien, darauf folgen die entsprechenden Dateinamen (inkl. Pfad relativ zur Konfigurationsdatei. Die Namen der Dateien sind nicht relevant, solange sie korrekt in die Listen eingetragen werden.<br />
<br />
Auf die Funktion der jeweiligen Dateien wird im Laufe der Beschreibung der Scriptsprache eingegangen.<br />
<br />
== Grundlagen der Scriptsprache ==<br />
<br />
Das OMSI-Scriptsystem arbeitet mit der [http://de.wikipedia.org/wiki/Umgekehrte_Polnische_Notation umgekehrten Polnischen Notation]. Hierbei steht der Operator hinter den beiden Operanden; vereinfacht gesagt bedeutet es, dass die Operation " 1 + 2 " stattdessen folgendermaßen notiert wird: " 1 2 + ". Ein komplizierteres Beispiel: " (1 + 2) * (4 + 5) " entspricht " 1 2 + 4 5 + * ".<br />
<br />
Ganz wichtig ist die Tatsache, dass die OMSI-Textdateien und insbesondere die Scriptsprache [http://de.wikipedia.org/wiki/Case_sensitivity Case-Sensitive] ist! D.h. es ist immer auf die Groß- und Kleinschreibung zu achten!<br />
<br />
=== Stack und Register ===<br />
<br />
Bei der Verarbeitung der Scripts verfügt OMSI über einen String-Stack und einen [http://de.wikipedia.org/wiki/Stapelspeicher Stack] für [http://de.wikipedia.org/wiki/Gleitkommazahl Gleitkommazahlen]. Im folgenden ist mit "Stack" immer der Stack für Gleitkommazahlen gemeint, andernfalls wird von "String-Stack" gesprochen.<br />
<br />
Beide Stacks enthält 8 Speicherplätze, welche von 0 bis 7 durchnumeriert sind. Jede Script-Operation kann nun einen oder mehrere neue Werte in einen der Stacks einfügen (push), wobei der neue Wert auf die Position 0 gesetzt wird und alle folgenden Werte "einen Platz aufrücken", oder sie kann einen oder mehrere Werte aus dem Stack herausziehen (pop/pull) oder lediglich auslesen (peek).<br />
<br />
Fürs temporäre Ablegen von Zahlen gibt es zusätzlich acht indizierte Speicherplätze, welche direkt geschrieben oder gelesen werden können, die sich im sogenannten Register befinden - hier gibt es jedoch nur einen Register für die Gleitkommazahlen.<br />
<br />
=== Beispiel-Operationen ===<br />
<br />
Beispiel: Die Operation 1 + 4. Der Code hierfür lautet:<br />
<br />
<pre><br />
1 4 +<br />
</pre><br />
<br />
In der folgenden Tabelle wird demonstriert, wie sich hierbei der Stack verhält:<br />
<br />
<pre><br />
Operation: Stack: 0 1 2 3 4 ...<br />
-----------------------------------------------------------------------------<br />
vorher: 0 0 0 0 0<br />
"1" 1 0 0 0 0<br />
"4" 4 1 0 0 0<br />
"+" 5 0 0 0 0<br />
</pre><br />
<br />
Im Ausgangszustand ist der Stack nur mit Nullen (oder unbekannten/zufälligen Werten) gefüllt. Der Befehl "1" schiebt die Eins in den obersten Stackplatz und schiebt alle weiteren Werte (Nullen) nach hinten. Der Befehl "4" schiebt die Vier auf den 0. Platz und alle folgenden Werte, also insbesondere die Eins auf den jeweils nächsten Platz. Im nächsten Schritt "+" werden die obersten beiden Werte aus dem Stack herausgezogen - also 4 und 1 - und summiert. Das Ergebnis (5) wird wiederum in den Stack geschoben. Die beiden ursprünglichen Zahlen sind im Stack nicht mehr vorhanden.<br />
<br />
Ein zweites Beispiel:<br />
<br />
(1 + 2) * (4 + 5) muss wie bereits erwähnt folgendermaßen notiert werden:<br />
<br />
<pre><br />
1 2 + 4 5 + *<br />
</pre><br />
<br />
Der Stack verhält sich somit folgendermaßen:<br />
<br />
<pre><br />
Operation: Stack: 0 1 2 3 4 ...<br />
-----------------------------------------------------------------------------<br />
vorher: 0 0 0 0 0<br />
"1" 1 0 0 0 0<br />
"2" 2 1 0 0 0<br />
"+" 3 0 0 0 0<br />
"4" 4 3 0 0 0<br />
"5" 5 4 3 0 0<br />
"+" 9 3 0 0 0<br />
"*" 27 0 0 0 0<br />
</pre><br />
<br />
Am Ende befindet sich also das korrekte Ergebnis auf Stackplatz 0!<br />
<br />
=== Gleitkommazahlen und Strings ===<br />
<br />
Das OMSI-Skriptsystem arbeitet ausschließlich mit den Datentypen Gleitkommazahl (einfache Präzision mit Vorzeichen) und String. Beide Datentypen haben getrennte Stacks. Deshalb laufen die Verarbeitung von Gleitkommazahlen und Strings im Allgemeinen unabhängig nebeneinander. Jedoch kann es natürlich vorkommen, dass bestimmte Funktionen z.B. Zahlen in Strings umwandeln und somit gleichzeitig auf beide Teilbereiche zugreifen.<br />
<br />
Auf boolische Variablen wurde verzichtet. Für boolische Werte werden im Allgemeinen die Zahlenwerte 0 und 1 verwendet.<br />
<br />
== Script-Schlüsselwörter ==<br />
<br />
=== Kommentare ===<br />
<br />
Kommentierungen sind nur möglich, indem in der auszukommentierenden Zeile ganz vorne ein Apostroph ['] gesetzt wird:<br />
<br />
<pre><br />
'Ich bin eine Kommentarzeile<br />
'Ich bin KEINE Kommentarzeile!<br />
</pre><br />
<br />
=== Einstiegs- und Ausstiegspunkte, Makros und Trigger ===<br />
<br />
Alle Befehle müssen zwischen einem Einstiegs- und einem Ausstiegspunkt liegen.<br />
<br />
Der Einstiegspunkt wird durch eins der folgenden Schlüsselwörter gekennzeichnet:<br />
<br />
* {frame} Im Laufe jedes Frames ruft OMSI über diesen Einstiegspunkt die frameweise Scriptverarbeitung auf, sofern er vorhanden ist.<br />
* {init} Bei der Initialisierung ruft OMSI über diesen Einstiegspunkt die Script-Initialisierung auf.<br />
* {frame_ai} Hierbei handelt es sich um eine Variante des {frame}-Einstiegspunktes, welcher bei Fahrzeugen dann aufgerufen wird, wenn diese nicht im Fokus des Benutzers stehen, z.B. wenn sie als KI-Fahrzeug unterwegs sind. Ist dieser Einstiegspunkt jedoch nicht vorhanden sondern nur {frame}, dann wird dieser alternativ aufgerufen. Bei Szenerieobjekten kommt dieser Eintrittspunkt nicht zur Anwendung.<br />
* {macro:''name''} Dieser Einstiegspunkt ruft ein Subsektion (Makro) auf, welche '''stets nach dem Aufruf''' definiert werden muss.<br />
* {trigger:''name''} Dieser Einstiegspunkt wird vom Hauptprogramm aufgerufen, wenn der Benutzer die Tastenkombination oder das Maus-Event mit der Bezeichnung ''name'' aufruft - es gibt auch bestimmte Trigger, die direkt vom Hauptprogramm aufgerufen werden, z.B. wenn OMSI bei KI-Bussen die Anzeige wechselt u.Ä.<br />
<br />
{end} ist der universelle Ausstiegspunkt. Er muss stets den Block abschließen, der mit einem der obigen Befehle eröffnet wird.<br />
<br />
==== Makroaufruf ====<br />
<br />
Der Aufruf eines Makros erfolgt über (M.L.''name''). Der Aufruf des Makros muss ''immer'' vor dessen Definition erfolgen. Andernfalls meldet OMSI, dass das Makro nicht gefunden wurde.<br />
<br />
==== Aufteilung des Scripts in mehrere Dateien ====<br />
<br />
Bei einfachen Scripts (z.B. bei reinen KI-Fahrzeugen oder Szenerieobjekten) reicht es im Allgemeinen eine *.sco-Datei zu erstellen, welche über einen {frame}...{end}- und ggf. einen {init}...{end}-Block verfügt.<br />
<br />
Handelt es sich jedoch um ein komplettes Fahrzeugscript, dann empfiehlt es sich für die verschiedenen Subsysteme getrennte Dateien anzulegen. Hierbei sollte folgendermaßen vorgegangen werden:<br />
<br />
* Es gibt ein Hauptscript und die nötigen Subsystemdateien. Die Hauptdatei enthält dabei die {frame}- und {init}-Blöcke, die jedoch nur Makros aufrufen, welche in den Subsystemdateien definiert sind.<br />
* Für jedes Subsystem gibt es eine *.sco-Datei und je nach Bedarf eine eigene Varlist und Constfile mit den zum System gehörenden Variablen. Außerdem werden auch hier die Trigger für die Tastenbefehle einsortiert.<br />
* Die Makros sollten sinnvollerweise folgendermaßen benannt werden: {macro:''subsystem''_frame} und {macro:''subsystem''_init}.<br />
* Damit die Makros vom Hauptscript aufgerufen werden, muss dieses in der Liste der Scripts in der Objekt-Konfigurationsdatei als erstes aufgerufen werden. Die Reihenfolge der Scripts untereinander muss ebenfalls so gewählt werden, dass alle dateiübergreifenden Makroaufrufe stets vor der jeweiligen Makrodefinition stehen.<br />
<br />
Die Einschränkung, dass Makros immer hinter dem Aufruf definiert werden müssen, kann zwar bisweilen hinderlich sein, ist aber ein sehr wirksamer Schutz gegen Zirkelschlüsse und Endlosschleifen.<br />
<br />
==== Trigger ====<br />
<br />
Wie schon geschrieben wurde, kann ein {trigger:''name''}...{end}-Abschnitt durch verschiedene Möglichkeiten aus dem Hauptprogramm heraus aufgerufen werden. Hierzu zählen:<br />
<br />
* Auslösung per Tastatur. Wurde die Tastenkombination mit dem Namen ''tastkomb'' bezeichnet, wird {trigger:tastkomb} aufgerufen, wenn die Taste gedrückt wird und {trigger:tastkomb_off}, wenn die Taste losgelassen wird.<br />
* Auslösung per Maus. Wurde ein Mesh angeklickt mit der [mouseevent]-Bezeichnung ''mouse_ev'', so wird {trigger:mouse_ev} aufgerufen, wenn die Maustaste gedrückt wird, {trigger:mouse_ev_drag}, während die Maustaste gehalten wird und {trigger:mouse_ev_off}, wenn die Maustaste losgelassen wird.<br />
* Außerdem gibt es noch eine Reihe von [[System-Trigger|System-Triggern]].<br />
<br />
=== Operationen ===<br />
<br />
==== Stack-Operationen ====<br />
<br />
{| class="wikitable" style="font-size:95%;" <br />
|- class="hintergrundfarbe5"<br />
| align="left" |%stackdump%<br />
| align="left" |Gibt eine Dialogbox mit dem Gleitkomma-Stackinhalt aus. Sollte deshalb natürlich nur zu Debug-Zwecken eingesetzt werden.<br />
|-<br />
| align="left" |s0, s1, ..., s7<br />
| align="left" |Speichern des aktuellen Stackwertes im durch die Ziffer angegebenen Register. Der Wert verbleibt hierbei im Stack<br />
|-<br />
| align="left" |l0, l1, ..., l7<br />
| align="left" |Laden des entsprechenden Registerwertes und Verschiebung in den Stack. Registerwert bleibt erhalten.<br />
|-<br />
| align="left" |d<br />
| align="left" |Dubliziert den obersten Stackwert; alle weiteren Stackwerte rücken nach hinten.<br />
|-<br />
| align="left" |$msg<br />
| align="left" |Schreibt den obersten String-Stack-Wert in die Debug-Zeile von OMSI - egal, ob es sich um ein User-, KI-Fahrzeug oder Szenerieobjekt handelt.<br />
|-<br />
| align="left" |$d<br />
| align="left" |Dubliziert den Stringstack-Wert analog zu "d".<br />
|}<br />
<br />
==== Logische Operationen ====<br />
<br />
Die logischen Operationen arbeiten nach dem Prinzip 0 = FALSE, alles andere ist TRUE.<br />
<br />
{| class="wikitable" style="font-size:95%;" <br />
|- class="hintergrundfarbe5"<br />
| align="left" |&&<br />
| align="left" |UND, d.h. wenn einer der beiden obersten Stackwerte gleich 0 ist, ist das Ergbnis 0, sonst 1.<br />
|-<br />
| align="left" |<nowiki>||</nowiki><br />
| align="left" |ODER<br />
|-<br />
| align="left" |<nowiki>!</nowiki><br />
| align="left" |Verneinung<br />
|}<br />
<br />
==== Vergleichsoperationen ====<br />
<br />
Die Vergleichsoperationen vergleichen die Werte in den beiden jeweils obersten Stackplätzen und fügen dann je nach Ergebnis eine "1" oder "0" im obersten Stackplatz ein. Die Größer-/Kleinerzeichen stehen dabei entsprechend für der Reihenfolge, in der die Werte zuvor angegeben wurden. Das bedeutet:<br />
<br />
4 2 > ist wahr, weil die intern durchgeführte Operation in diesem Fall "4 > 2" ist.<br />
<br />
{| class="wikitable" style="font-size:95%;" <br />
|- class="hintergrundfarbe5"<br />
| align="left" |=<br />
| align="left" |"1", falls die obersten Stackwerte identisch sind, sonst "0".<br />
|-<br />
| align="left" |<<br />
| align="left" |"1", falls Stackwert 1 kleiner ist als Stackwert 0, sonst "0".<br />
|-<br />
| align="left" |><br />
| align="left" |... größer ist ...<br />
|-<br />
| align="left" |<=<br />
| align="left" |... kleiner als oder gleich ist ...<br />
|-<br />
| align="left" |>=<br />
| align="left" |... größer als oder gleich ist ...<br />
|-<br />
| align="left" |$=<br />
| align="left" |Wie "=" nur für die obersten beiden Stringstack-Plätze.<br />
|-<br />
| align="left" |$<<br />
| align="left" |Kleiner als (String). Die Ungleich-Operationen bei Strings prüfen auf alphabetische Reihenfolge. "A" ist also kleiner als "B".<br />
|-<br />
| align="left" |$><br />
| align="left" |Größer als (String).<br />
|-<br />
| align="left" |$<=<br />
| align="left" |Kleiner oder gleich (String).<br />
|-<br />
| align="left" |$>=<br />
| align="left" |Größer oder gleich (String).<br />
|}<br />
<br />
==== Mathematische Operationen ====<br />
<br />
{| class="wikitable" style="font-size:95%;" <br />
|- class="hintergrundfarbe5"<br />
| align="left" |+<br />
| align="left" |Plus<br />
|-<br />
| align="left" |-<br />
| align="left" |Minus (Stackplatz 1 - Stackplatz 0, also vom Prinzip her wie bei den Größer/Kleiner-Operationen)<br />
|-<br />
| align="left" |*<br />
| align="left" |Mal<br />
|-<br />
| align="left" |/<br />
| align="left" |geteilt (Stackplatz 1 / Stackplatz 0)<br />
|-<br />
| align="left" |%<br />
| align="left" |Rest der Division (folgendermaßen erweitert für Gleitkommazahlen: Stack0 - trunc(Stack1 / Stack0) * Stack1 )<br />
|-<br />
| align="left" |/-/<br />
| align="left" |Vorzeichenwechsel<br />
|-<br />
| align="left" |sin<br />
| align="left" |Sinus<br />
|-<br />
| align="left" |min<br />
| align="left" |Wahl des kleineren der beiden obersten Stackwerte<br />
|-<br />
| align="left" |max<br />
| align="left" |Wahl des größeren der beiden obersten Stackwerte<br />
|-<br />
| align="left" |exp<br />
| align="left" |Exponentialfunktion zur Basis e (e^Stack0)<br />
|-<br />
| align="left" |sqrt<br />
| align="left" |Quadratwurzel<br />
|-<br />
| align="left" |sqr<br />
| align="left" |Quadrat<br />
|-<br />
| align="left" |sgn<br />
| align="left" |Rückgabe des Vorzeichens; je nachdem entweder -1, 0 oder 1<br />
|-<br />
| align="left" |pi<br />
| align="left" |Kreiszahl pi<br />
|-<br />
| align="left" |random<br />
| align="left" |ganzzahlige Zufallszahl 0 <= x < Stack0<br />
|-<br />
| align="left" |abs<br />
| align="left" |Rückgabe des Absolutwertes<br />
|-<br />
| align="left" |trunc<br />
| align="left" |Abrunden auf nächste ganze Zahl<br />
|}<br />
<br />
==== String-Operationen ====<br />
<br />
{| class="wikitable" style="font-size:95%;" <br />
|- class="hintergrundfarbe5"<br />
| align="left" |"''bla''"<br />
| align="left" |Einfügen des Strings ''bla'' auf dem obersten String-Stack-Platz<br />
|-<br />
| align="left" |$+<br />
| align="left" |Zusammenfügen zweier Strings. "Omnibus" "simulator" $+ ergibt "Omnibussimulator"<br />
|-<br />
| align="left" |$*<br />
| align="left" |Der oberste Stack-String wird sooft wiederholt, bis die resultierende Zeichenlänger gerade noch kleiner oder gleich des obersten Stackwertes ist. Beispiel: "nu" 6 $* ergibt "nununu"<br />
|-<br />
| align="left" |$length<br />
| align="left" |Gibt die Anzahl der Zeichen des obersten Stack-String zurück in den Stack. <br />
|-<br />
| align="left" |$cutBegin<br />
| align="left" |Schneidet ''stack0'' Zeichen vorne vom obersten Stack-String ab.<br />
|-<br />
| align="left" |$cutEnd<br />
| align="left" |Schneidet ''stack0'' Zeichen hinten vom obersten Stack-String ab.<br />
|-<br />
| align="left" |$SetLengthR<br />
| align="left" |Passt die Länge des obersten Stack-Strings auf ''stack0'' rechtsbündig an, indem am Anfang Zeichen entfernt oder Leerzeichen ergänzt werden.<br />
VORSICHT Bug! Der Befehl entfernt den Float-Operator nicht vom Stack. Der Wert, auf dessen Länge der String gekürzt wurde, verbleibt also auf Stack0.<br />
|-<br />
| align="left" |$SetLengthL<br />
| align="left" |Passt die Länge des obersten Stack-Strings auf ''stack0'' linksbündig an, indem am Ende Zeichen entfernt oder Leerzeichen ergänzt werden.<br />
VORSICHT Bug! Der Befehl entfernt den Float-Operator nicht vom Stack. Der Wert, auf dessen Länge der String gekürzt wurde, verbleibt also auf Stack0.<br />
|-<br />
| align="left" |$IntToStr<br />
| align="left" |Rundet ''stack0'' ab und wandelt die resultierende Ganzzahl um in einen String.<br />
|-<br />
| align="left" |$IntToStrEnh<br />
| align="left" |Die erweiterte Version von IntToStr. Hierbei wird der oberste Stack-String verwendet, um das Format der String-Umwandlung zu bestimmen: Das erste Zeichen im String wird zum Auffüllen der fehlenden Zeichen verwendet, die folgenden Zeichen müssen eine Zahl ergeben, die die Stellen angibt. Beispiel: 35 " 5" $IntToStrEnh führt zu " 35" und 123456789 "011" $IntToStrEnh führt zu "00123456789". Falls ein Fehler vorliegt, wird "ERROR" ausgegeben.<br />
|-<br />
| align="left" |$StrToFloat<br />
| align="left" |Wandelt den obersten Stack-String in eine Gleitkommazahl um, falls möglich. Andernfalls wird eine -1 geschrieben.<br />
|-<br />
|}<br />
<br />
=== Variablenzugriff ===<br />
<br />
Es wird unterschieden in Systemvariablen und in lokale Variablen. Die Systemvariablen gelten OMSI-weit, die lokalen Variablen werden zum Fahrzeug/Objekt zugehörig gespeichert.<br />
<br />
Bei den lokalen Variablen gibt es stets einen Grundstamm an Variablen, welcher von OMSI vordefiniert werden. Darüber hinaus können beliebig viele Variablen mit Hilfe der Varlist-Dateien ergänzt werden. <br />
<br />
{| class="wikitable" style="font-size:95%;" <br />
|- class="hintergrundfarbe5"<br />
| align="left" |(L.S.''varname'')<br />
| align="left" |Lädt die Systemvariable ''varname'' in den obersten Stackplatz<br />
|-<br />
| align="left" |(L.L.''varname'')<br />
| align="left" |Lädt die lokale Variable ''varname'' in den obersten Stackplatz<br />
|-<br />
| align="left" |(L.$.''varname'')<br />
| align="left" |Lädt die lokale String-Variable ''varname'' in den obersten String-Stackplatz<br />
|-<br />
| align="left" |(S.L.''varname'')<br />
| align="left" |Speichert den obersten Stackplatz in die lokale Variable ''varname''<br />
|-<br />
| align="left" |(S.$.''varname'')<br />
| align="left" |Speichert den obersten String-Stackplatz in die lokale String-Variable ''varname''<br />
|}<br />
<br />
Eine detaillierte Beschreibung der einzelnen Systemvariablen und der vordefinierten lokalen Variablen finden Sie hier: [[System- und vordefinierte lokalen Variablen]]<br />
<br />
=== Konstanten und Funktionen ===<br />
<br />
Lokale Konstanten und [http://de.wikipedia.org/w/index.php?title=Datei:Linear_interpolation.svg&filetimestamp=20080226155013 stückweise definierte lineare Funktionen] können in den Konstantendateien (''constfiles'', ''~_constfile.txt'') definiert werden. Der Aufbau jeder Konstantendatei entspricht der der [[Konfigurationsdateien|Konfigurationsdatei]]. Es gibt lediglich drei Schlüsselwörter. Zu beachten ist: Bisher können keine Strings, sondern nur Fließkommazahlen als Konstanten definiert werden.<br />
<br />
[const] definiert eine neue Konstante und gibt ihren Wert an:<br />
<br />
<pre><br />
[const]<br />
name<br />
wert<br />
</pre><br />
<br />
Beispiel:<br />
<br />
<pre><br />
[const]<br />
leistung<br />
200<br />
</pre><br />
<br />
[newcurve] leitet die Definition einer neuen (stückweise linearen) Funktion ein:<br />
<br />
<pre><br />
[newcurve]<br />
name<br />
</pre><br />
<br />
[pnt] fügt der zuvor mit [newcurve] definierten Funktion ein neues x-y-Paar hinzu. Jede Funktion sollte normalerweise über mindestens zwei Paare verfügen. Die Reihenfolge der Paare ''muss'' in x-Richtung aufsteigend sein!<br />
<br />
<pre><br />
[pnt]<br />
x<br />
y<br />
</pre><br />
<br />
Beispiel:<br />
<br />
<pre><br />
[newcurve]<br />
Drehzahl_Drehmoment_Kennlinie<br />
<br />
[pnt]<br />
50<br />
0<br />
<br />
[pnt]<br />
300<br />
400<br />
<br />
[pnt]<br />
1000<br />
600<br />
</pre><br />
<br />
Konstanten werden über den Befehl (C.L.''konstantenname'') in den Stack geladen.<br />
<br />
Funktionen werden über den Befehl (F.L.''funktionsname'') aufgerufen. Dabei wird stets der zuvor auf oberster Stackposition befindliche Wert als x-Parameter übergaben und der resultierende y-Wert der Funktion stattdessen auf dem obersten Stackplatz gespeichert. Bewegt sich der x-Wert außerhalb der Grenzen der durch die [pnt]-Einträge definierten Eckpunkte, wird stets der y-Wert des nächstliegenden Eckpunktes verwendet. Die Funktion wird also vor dem ersten und hinter dem letzten Eckpunkt ins Unendliche waagerecht verlängert.<br />
<br />
=== Sound-Trigger ===<br />
<br />
Soundtrigger sind nicht mit den weiter oben erwähnten Triggern zu verwechseln!<br />
<br />
Sie stellen vielmehr eine Möglichkeit dar, direkt einen gewünschten Sound abzuspielen. Hierbei gibt es zwei Möglichkeiten:<br />
<br />
(T.L.''soundtriggername'') ist ein einfacher Soundtrigger. Der so markierte Sound wird (einmalig) abgespielt.<br />
<br />
(T.F.''soundtriggername'') ist ein Soundtrigger mit Dateiwechselfunktion. Hierbei wird der oberste Stackstring ausgelesen und als Dateiname verwendet, wobei der Dateipfad relativ zum Sound-Ordner des Objektes interpretiert wird.<br />
<br />
Beispiel:<br />
<br />
Angenommen, die Sounddatei lautet "diese.wav" und ist mit dem Trigger ''MeinTrigger'' verknüpft, dann spielt<br />
<br />
(T.L.MeinTrigger)<br />
<br />
die Datei "diese.wav" ab und<br />
<br />
"andere.wav" (T.F.MeinTrigger)<br />
<br />
die Datei "andere.wav". Alternativ zu (T.L.''soundtriggername'') kann beim Befehl (T.F.''soundtriggername'') auch ein "Nullstring" im Stack liegen (also der String: "").<br />
<br />
=== System-Makros ===<br />
<br />
Die bisherigen Methoden erlauben dem Script folgende Kommunikationsmöglichkeiten mit OMSI:<br />
<br />
* Lesen von Werten über System- und vordefinierte lokale Variablen<br />
* Schreiben von Werten über ebendiese<br />
* Empfangen von Tastatur-, Maus- oder Systemtriggern<br />
<br />
Schließlich gibt es noch eine weitere Methode, um mit dem Hauptprogramm zu kommunizieren, die sogenannten System-Makros, gelegentlich auch unpräzise als "Callback-Funktionen" bezeichnet.<br />
<br />
In bestimmten Situationen ist es nötig, dass das Script Werte von OMSI bekommt, die in größeren Datenbanken vorliegen und daher nicht über vordefinierte Variablen übermittelt werden können, z.B. die Inhalte der Hofdatei. Hier kommen nun die System-Makros ins Spiel.<br />
<br />
Diese arbeiten scriptseitig sehr ähnlich wie die lokalen, selbstdefinierten Makros: Der Aufruf (M.V.''macroname'') ruft das System-Makro auf ("V" stand ursprünglich für "Vehicle-Macro", gilt aber genauso auch in Szenerieobjekten), das sich während der Ausführung Werte aus den beiden Stacks holt und/oder in diese schreibt. Eine Aufstellung aller System-Makros findet sich hier: [[System-Makros]]<br />
<br />
=== Bedingungen und Schleifen ===<br />
<br />
Die einzige Steuerung des Programmablaufs ist zur Zeit nur mit der IF-Bedingung möglich.<br />
<br />
==== IF-Bedingung ====<br />
<br />
<pre><br />
'Hier muss eine Bedingung stehen, z.B.:<br />
(L.L.bla) 1 =<br />
{if}<br />
'Dieser Abschnitt wird ausgeführt, wenn bla = 1 ist:<br />
2 3 +<br />
{else}<br />
'Dieser Abschnitt wird andernfalls ausgeführt:<br />
3 4 +<br />
{endif}<br />
(S.L.blub)<br />
{end}<br />
</pre><br />
<br />
Dass erst die Bedingung formuliert wird und dann erst das Schlüsselwort {if} folgt, sollte einleuchten: Zunächst muss an oberster Stelle des Stacks der Wert abgelegt werden und erst dann folgt das Schlüsselwort {if}, welches diesen Wert prüft. Hierbei bedeutet ähnlich wie bei && und || Gleichheit mit Null gleichbedeutend mit ''False'', alle anderen Werte bedeuten ''True''.<br />
<br />
Wenn also im obigen Beispiel ''bla'' den Wert 1 hat, wird ''blub'' auf den Wert 5 gesetzt, andernfalls auf den Wert 7.<br />
<br />
Verschachtelungen der IF-Bedingung dienen als Ersatz für die (nicht vorhandenen) "Else-If"-Konstruktionen:<br />
<br />
<pre><br />
'Hier muss eine Bedingung stehen, z.B.:<br />
(L.L.bla) 1 =<br />
{if}<br />
'Dieser Abschnitt wird ausgeführt, wenn bla = 1 ist:<br />
2 3 +<br />
{else}<br />
(L.L.bla) 5 =<br />
{if}<br />
'Dieser Abschnitt wird ausgeführt, wenn bla = 5 ist:<br />
3 4 +<br />
{else}<br />
'Dieser Abschnitt wird andernfalls ausgeführt:<br />
13<br />
{endif}<br />
{endif}<br />
(S.L.blub)<br />
{end}<br />
</pre><br />
<br />
Hierbei ist insbesondere auf das doppelte {endif} zu achten! Hier gilt:<br />
<br />
* bla = 1 ==> blub = 5<br />
* bla = 5 ==> blub = 7<br />
* sonst ==> blub = 13<br />
<br />
[[Kategorie:Nachschlagewerk für Addon-Entwickler]]</div>Marcel Kuhnthttp://wiki.omnibussimulator.de/omsiwikineu.de/index.php?title=Plug-in-Schnittstelle&diff=857Plug-in-Schnittstelle2014-02-11T09:46:31Z<p>Marcel Kuhnt: </p>
<hr />
<div>''Hinweis: Änderungen dieses Artikels wurden noch nicht ins Englische übersetzt!''<br />
<br />
''OMSI-Version: 1.00 - 2.00, für OMSI 2 bitte letztes Kapitel beachten!''<br />
<br />
= Allgemeines Prinzip =<br />
<br />
Es besteht die Möglichkeit, für den OMSI Plugin-DLLs zu programmieren, welche Lese- und Schreibzugriff auf die [[System-_und_vordefinierte_lokalen_Variablen#Fahrzeuge|Fahrzeugvariablen]] haben und [[Scriptsystem#Trigger|Fahrzeug-Trigger]] auslösen können.<br />
<br />
Jedes Plugin besteht aus einer [[Konfigurationsdatei]] mit der Dateiendung *.opl und einer zugehörigen DLL. Beide Dateien müssen im Verzeichnis "OMSI\plugins" liegen.<br />
<br />
= Beschreibung des Beispiels =<br />
<br />
In OMSI enthalten ist bereits ein Beispiel-Plugin enthalten. Um es zu aktivieren, muss die Datei "test.txt" im "<OMSI>\plugins"-Verzeichnis in "test.opl" umbenannt werden.<br />
<br />
== Funktionsumfang ==<br />
<br />
Dieses Plugin hat drei Funktionen: Einen Tacho (analog und digital) ganz oben, einen Sollwertregler für den roten Heizungsregler (obwohl da falscherweise "Rollband-Sollwert" steht) und einen Türtaster "Button1" (der aber trotzdem nur funktioniert, wenn die Haltestellenbremse aktiv und die Elektrik an ist).<br />
<br />
[[Datei:Beispiel-Plugin.jpg|600px|thumb|right|Oberfläche des Beispiel-Plugins]]<br />
<br />
== Aufbau der *.opl-Datei ==<br />
<br />
<pre><br />
To activate, rename this file to "test.opl"<br />
<br />
[dll]<br />
Test.dll<br />
<br />
[varlist]<br />
2<br />
Velocity<br />
cockpit_heizregler_temp<br />
<br />
[triggers]<br />
1<br />
bus_doorfront0<br />
</pre><br />
<br />
Die erste Zeile ist nur eine Kommentarzeile. Der [dll]-Befehl gibt den Dateinamen der zugehörigen DLL an.<br />
<br />
Der [varlist]-Befehl beginnt mit der Anzahl der zu erwartenden (lokalen) Fahrzeugvariablen. Hierbei können auch User-Variablen eines bestimmten Busses angegeben werden. Wenn der tatsächlich gefahrene Bus dann diese Variable nicht hat, dann werden die zugehörigen Zugriffe natürlich nicht durchgeführt.<br />
<br />
Die Variable mit dem Index 0 ist also bei dieser DLL "Velocity", die Variable mit dem Index 1 ist "cockpit_heizregler_temp".<br />
<br />
Der [triggers]-Befehl beginnt ebenfalls mit der Anzahl der zu erwartenden Fahrzeugtrigger. In diesem Fall ist dies nur ein Trigger: "bus_doorfront0" mit dem Index 0.<br />
<br />
== Aufbau der DLL ==<br />
<br />
Anhand der Beispiel-DLL wird nun erklärt, wie der zugehörige Delphi-Code aussehen soll. Im Allgemeinen sollte es möglich sein, auch mit anderen Programmiersprachen passende DLLs zu programmieren. Ausprobiert habe ich dies allerdings nicht.<br />
<br />
Die DLL besteht aus zwei Units. Erklärt wird aber nur die Hauptunit (Test.dpr) (die zweite Unit enthält nur einige wenige nicht-relevante Implementierungen für die Form):<br />
<br />
<pre><br />
library Test;<br />
<br />
uses<br />
SysUtils,<br />
Dialogs,<br />
Classes,<br />
TestU in 'TestU.pas' {Form1};<br />
<br />
{$R *.res}<br />
<br />
procedure Start( AOwner: TComponent ); stdcall;<br />
begin<br />
form1 := TForm1.Create( AOwner );<br />
form1.Show;<br />
end;<br />
<br />
procedure Finalize; stdcall;<br />
begin<br />
form1.Free;<br />
end;<br />
<br />
procedure AccessVariable( varindex: word; var value: single; var write: boolean ); stdcall;<br />
begin<br />
case varindex of<br />
0:<br />
begin<br />
form1.Label2.Caption := floattostrF( value, ffFixed, 5, 1 ) + ' km/h';<br />
form1.Gauge1.Progress := round( value );<br />
write := false; <br />
end;<br />
1:<br />
begin<br />
value := form1.TrackBar1.Position / 30;<br />
write := true;<br />
end;<br />
end;<br />
end;<br />
<br />
procedure AccessTrigger( triggerindex: word; var active: boolean ); stdcall;<br />
begin<br />
case triggerindex of<br />
0:<br />
begin<br />
active := form1.button1_pressed;<br />
end;<br />
end;<br />
end;<br />
<br />
exports<br />
AccessVariable,<br />
AccessTrigger, <br />
Start,<br />
Finalize;<br />
<br />
<br />
begin<br />
end.<br />
</pre><br />
<br />
Zunächst ist der letzte Abschnitt "exports" zu beachten: Die vier gelisteten Prozeduren sollen von der DLL angeboten werden: ''AccessVariable'', ''AccessTrigger'', ''Start'' und ''Finalize''.<br />
<br />
Die vier Prozeduren haben folgenden Aufbau:<br />
<br />
=== Aufbau der Prozedur ''Start'' ===<br />
<br />
''Start( AOwner: TComponent )'' wird am Anfang aufgerufen und ermöglicht es der DLL, sich zu initialisieren. In diesem Fall wird ''Form1'' erzeugt und der gleichnamigen Variable zugeordnet, welche sich jedoch in der Unit ''TestU'' befindet. Als zweiter Schritt wird der ''Show''-Befehl aufgerufen, um die ''Form1'' anzuzeigen. ''Start'' übergibt den Parameter "AOwner", welcher der Handler des Hauptprogramms von OMSI darstellt.<br />
<br />
=== Aufbau der Prozedur ''Finalize'' ===<br />
<br />
''Finalize'' dagegen wird beim Schließen aufgerufen. Hier wird schlicht das Objekt ''Form1'' zerstört.<br />
<br />
=== Aufbau der Prozedur ''AccessVariable'' ===<br />
<br />
Im Betrieb ruft OMSI diese Prozedur für alle in der *.opl-Datei gelisteten lokalen Variablen auf. Sie übergibt dabei stets den Index der Variable (''varindex''). Die Prozedur kann nun ihrerseits die Variablen ''value'' und ''write'' schreiben.<br />
<br />
Bei einem Lesezugriff kann die Prozedur wie im Beispiel unter "0:" die Variable über ''value'' einfach auslesen. Es ist aber wie unter "1" auch möglich, dem Wert von ''value'' einen neuen Wert zuzuweisen. Dann aber muss die Variable ''write'' auch auf ''wahr'' gesetzt werden, damit der Wert von OMSI übernommen wird. Im Beispiel wird die ''TrackBar'' ausgelesen und der Wert auf den Wert von ''value'' geschrieben.<br />
<br />
=== Aufbau der Prozedur ''AccessTrigger'' ===<br />
<br />
Diese Prozedur arbeitet recht ähnlich. Hier allerdings wird die Triggerliste durchgearbeitet. Die DLL kann bei Aufruf dieser Funktion den Wert ''active'' auf ''true'' setzen; dann löst OMSI den gewünschten Trigger aus.<br />
<br />
= Ausführliches Tutorial =<br />
<br />
Ein ausführliches Tutorial zur Nutzung dieser Schnittstelle - allerdings mit der Programmiersprache C++ - ist hier im Wiki in der Kategorie [[OMSI Plugin Framework|Tutorials]] zu finden.<br />
<br />
= Neuerungen OMSI2 =<br />
<br />
Aus Gründen der Kompatibilität wurden die folgenden Prozedurnamen geändert:<br />
<br />
''Start'' ==> ''PluginStart'' sowie<br />
<br />
''Finalize'' ==> ''PluginFinalize''.<br />
<br />
Außerdem wurde die *.opl-Datei um die Schlüsselworte [stringvarlist] und [systemvarlist] ergänzt, mit denen nun auch auf String- und Systemvariablen zugegriffen werden kann. Deren Syntax entspricht der von [varlist]. Dementsprechend wurden folgende Methoden ergänzt:<br />
<br />
<pre><br />
AccessSystemVariable( varindex: word; var value: single; var write: boolean );<br />
AccessStringVariable( varindex: word; str: PWideChar; var write: boolean );<br />
</pre><br />
<br />
[[Kategorie:Nachschlagewerk_für_Addon-Entwickler]]<br />
<br />
[[en:Plug-In Interface]]</div>Marcel Kuhnthttp://wiki.omnibussimulator.de/omsiwikineu.de/index.php?title=Plug-in-Schnittstelle&diff=856Plug-in-Schnittstelle2014-02-11T09:45:08Z<p>Marcel Kuhnt: OMSI2</p>
<hr />
<div>''Hinweis: Änderungen dieses Artikels wurden noch nicht ins Englische übersetzt!''<br />
<br />
''OMSI-Version: 1.00 - 2.00''<br />
<br />
= Allgemeines Prinzip =<br />
<br />
Es besteht die Möglichkeit, für den OMSI Plugin-DLLs zu programmieren, welche Lese- und Schreibzugriff auf die [[System-_und_vordefinierte_lokalen_Variablen#Fahrzeuge|Fahrzeugvariablen]] haben und [[Scriptsystem#Trigger|Fahrzeug-Trigger]] auslösen können.<br />
<br />
Jedes Plugin besteht aus einer [[Konfigurationsdatei]] mit der Dateiendung *.opl und einer zugehörigen DLL. Beide Dateien müssen im Verzeichnis "OMSI\plugins" liegen.<br />
<br />
= Beschreibung des Beispiels =<br />
<br />
In OMSI enthalten ist bereits ein Beispiel-Plugin enthalten. Um es zu aktivieren, muss die Datei "test.txt" im "<OMSI>\plugins"-Verzeichnis in "test.opl" umbenannt werden.<br />
<br />
== Funktionsumfang ==<br />
<br />
Dieses Plugin hat drei Funktionen: Einen Tacho (analog und digital) ganz oben, einen Sollwertregler für den roten Heizungsregler (obwohl da falscherweise "Rollband-Sollwert" steht) und einen Türtaster "Button1" (der aber trotzdem nur funktioniert, wenn die Haltestellenbremse aktiv und die Elektrik an ist).<br />
<br />
[[Datei:Beispiel-Plugin.jpg|600px|thumb|right|Oberfläche des Beispiel-Plugins]]<br />
<br />
== Aufbau der *.opl-Datei ==<br />
<br />
<pre><br />
To activate, rename this file to "test.opl"<br />
<br />
[dll]<br />
Test.dll<br />
<br />
[varlist]<br />
2<br />
Velocity<br />
cockpit_heizregler_temp<br />
<br />
[triggers]<br />
1<br />
bus_doorfront0<br />
</pre><br />
<br />
Die erste Zeile ist nur eine Kommentarzeile. Der [dll]-Befehl gibt den Dateinamen der zugehörigen DLL an.<br />
<br />
Der [varlist]-Befehl beginnt mit der Anzahl der zu erwartenden (lokalen) Fahrzeugvariablen. Hierbei können auch User-Variablen eines bestimmten Busses angegeben werden. Wenn der tatsächlich gefahrene Bus dann diese Variable nicht hat, dann werden die zugehörigen Zugriffe natürlich nicht durchgeführt.<br />
<br />
Die Variable mit dem Index 0 ist also bei dieser DLL "Velocity", die Variable mit dem Index 1 ist "cockpit_heizregler_temp".<br />
<br />
Der [triggers]-Befehl beginnt ebenfalls mit der Anzahl der zu erwartenden Fahrzeugtrigger. In diesem Fall ist dies nur ein Trigger: "bus_doorfront0" mit dem Index 0.<br />
<br />
== Aufbau der DLL ==<br />
<br />
Anhand der Beispiel-DLL wird nun erklärt, wie der zugehörige Delphi-Code aussehen soll. Im Allgemeinen sollte es möglich sein, auch mit anderen Programmiersprachen passende DLLs zu programmieren. Ausprobiert habe ich dies allerdings nicht.<br />
<br />
Die DLL besteht aus zwei Units. Erklärt wird aber nur die Hauptunit (Test.dpr) (die zweite Unit enthält nur einige wenige nicht-relevante Implementierungen für die Form):<br />
<br />
<pre><br />
library Test;<br />
<br />
uses<br />
SysUtils,<br />
Dialogs,<br />
Classes,<br />
TestU in 'TestU.pas' {Form1};<br />
<br />
{$R *.res}<br />
<br />
procedure Start( AOwner: TComponent ); stdcall;<br />
begin<br />
form1 := TForm1.Create( AOwner );<br />
form1.Show;<br />
end;<br />
<br />
procedure Finalize; stdcall;<br />
begin<br />
form1.Free;<br />
end;<br />
<br />
procedure AccessVariable( varindex: word; var value: single; var write: boolean ); stdcall;<br />
begin<br />
case varindex of<br />
0:<br />
begin<br />
form1.Label2.Caption := floattostrF( value, ffFixed, 5, 1 ) + ' km/h';<br />
form1.Gauge1.Progress := round( value );<br />
write := false; <br />
end;<br />
1:<br />
begin<br />
value := form1.TrackBar1.Position / 30;<br />
write := true;<br />
end;<br />
end;<br />
end;<br />
<br />
procedure AccessTrigger( triggerindex: word; var active: boolean ); stdcall;<br />
begin<br />
case triggerindex of<br />
0:<br />
begin<br />
active := form1.button1_pressed;<br />
end;<br />
end;<br />
end;<br />
<br />
exports<br />
AccessVariable,<br />
AccessTrigger, <br />
Start,<br />
Finalize;<br />
<br />
<br />
begin<br />
end.<br />
</pre><br />
<br />
Zunächst ist der letzte Abschnitt "exports" zu beachten: Die vier gelisteten Prozeduren sollen von der DLL angeboten werden: ''AccessVariable'', ''AccessTrigger'', ''Start'' und ''Finalize''.<br />
<br />
Die vier Prozeduren haben folgenden Aufbau:<br />
<br />
=== Aufbau der Prozedur ''Start'' ===<br />
<br />
''Start( AOwner: TComponent )'' wird am Anfang aufgerufen und ermöglicht es der DLL, sich zu initialisieren. In diesem Fall wird ''Form1'' erzeugt und der gleichnamigen Variable zugeordnet, welche sich jedoch in der Unit ''TestU'' befindet. Als zweiter Schritt wird der ''Show''-Befehl aufgerufen, um die ''Form1'' anzuzeigen. ''Start'' übergibt den Parameter "AOwner", welcher der Handler des Hauptprogramms von OMSI darstellt.<br />
<br />
=== Aufbau der Prozedur ''Finalize'' ===<br />
<br />
''Finalize'' dagegen wird beim Schließen aufgerufen. Hier wird schlicht das Objekt ''Form1'' zerstört.<br />
<br />
=== Aufbau der Prozedur ''AccessVariable'' ===<br />
<br />
Im Betrieb ruft OMSI diese Prozedur für alle in der *.opl-Datei gelisteten lokalen Variablen auf. Sie übergibt dabei stets den Index der Variable (''varindex''). Die Prozedur kann nun ihrerseits die Variablen ''value'' und ''write'' schreiben.<br />
<br />
Bei einem Lesezugriff kann die Prozedur wie im Beispiel unter "0:" die Variable über ''value'' einfach auslesen. Es ist aber wie unter "1" auch möglich, dem Wert von ''value'' einen neuen Wert zuzuweisen. Dann aber muss die Variable ''write'' auch auf ''wahr'' gesetzt werden, damit der Wert von OMSI übernommen wird. Im Beispiel wird die ''TrackBar'' ausgelesen und der Wert auf den Wert von ''value'' geschrieben.<br />
<br />
=== Aufbau der Prozedur ''AccessTrigger'' ===<br />
<br />
Diese Prozedur arbeitet recht ähnlich. Hier allerdings wird die Triggerliste durchgearbeitet. Die DLL kann bei Aufruf dieser Funktion den Wert ''active'' auf ''true'' setzen; dann löst OMSI den gewünschten Trigger aus.<br />
<br />
= Ausführliches Tutorial =<br />
<br />
Ein ausführliches Tutorial zur Nutzung dieser Schnittstelle - allerdings mit der Programmiersprache C++ - ist hier im Wiki in der Kategorie [[OMSI Plugin Framework|Tutorials]] zu finden.<br />
<br />
= Neuerungen OMSI2 =<br />
<br />
Aus Gründen der Kompatibilität wurden die folgenden Prozedurnamen geändert:<br />
<br />
''Start'' ==> ''PluginStart'' sowie<br />
<br />
''Finalize'' ==> ''PluginFinalize''.<br />
<br />
Außerdem wurde die *.opl-Datei um die Schlüsselworte [stringvarlist] und [systemvarlist] ergänzt, mit denen nun auch auf String- und Systemvariablen zugegriffen werden kann. Deren Syntax entspricht der von [varlist]. Dementsprechend wurden folgende Methoden ergänzt:<br />
<br />
<pre><br />
AccessSystemVariable( varindex: word; var value: single; var write: boolean );<br />
AccessStringVariable( varindex: word; str: PWideChar; var write: boolean );<br />
</pre><br />
<br />
[[Kategorie:Nachschlagewerk_für_Addon-Entwickler]]<br />
<br />
[[en:Plug-In Interface]]</div>Marcel Kuhnthttp://wiki.omnibussimulator.de/omsiwikineu.de/index.php?title=Objekte_und_Splines_erstellen_(Artikel-%C3%9Cbersicht)&diff=855Objekte und Splines erstellen (Artikel-Übersicht)2014-02-11T09:35:25Z<p>Marcel Kuhnt: Ausgeblendet</p>
<hr />
<div>Eine Übersicht über alle Artikel, die sich mit Objekten und Splines erstellen befassen.<br />
<br />
== Objekte ==<br />
<br />
=== Häuser ===<br />
<br />
*[[Altbauhaus (Blender-Tutorial)]]<br />
<br />
=== Kreuzungen und andere Straßenobjekte ===<br />
<br />
*''Derzeit keine Einträge''<br />
<br />
=== Sonstiges ===<br />
<br />
*''Derzeit keine Einträge''<br />
<br />
== Splines ==<br />
<br />
=== Straßen ===<br />
<br />
*''Derzeit keine Einträge''<br />
<br />
=== Andere Splines ===<br />
<br />
*''Derzeit keine Einträge''<br />
<br />
== Fahrzeuge ==<br />
<br />
*Das [[Fahrzeug-SDK]]<br />
<br />
Kategorie:Nachschlagewerk für Addon-Entwickler</div>Marcel Kuhnthttp://wiki.omnibussimulator.de/omsiwikineu.de/index.php?title=DISABLED-Befehl&diff=854DISABLED-Befehl2014-02-11T09:21:54Z<p>Marcel Kuhnt: </p>
<hr />
<div>''Hinweis: Dieser Artikel wurde noch nicht ins Englische übersetzt!''<br />
<br />
''OMSI-Version: 2.0''<br />
<br />
Die Befehle "-<DISABLED>-" und "-<ENABLED>-" sind in einigen Konfigurationsdateien erlaubt und dienen dem Auskommentieren mehrerer Zeilen, ohne dass die jeweiligen Schlüsselworte einzeln auskommentiert werden müssen.<br />
<br />
Die Anwendung erfolgt schlicht:<br />
<br />
<pre><br />
...<br />
{gültige Zeilen}<br />
...<br />
-<DISABLED>-<br />
...<br />
{auskommentierte Zeilen}<br />
...<br />
-<ENABLED>-<br />
...<br />
{gültige Zeilen}<br />
...<br />
</pre><br />
<br />
In folgenden Konfigurationsdateien kann dieser Befehl benutzt werden:<br />
<br />
*.bus, *.ovh, *.sco, *.hum, model.cfg, envir.cfg, passengercabin.cfg, path.cfg<br />
<br />
[[Kategorie:Nachschlagewerk für Addon-Entwickler]]</div>Marcel Kuhnthttp://wiki.omnibussimulator.de/omsiwikineu.de/index.php?title=Fahrgastwege_und_-sitzpl%C3%A4tze_konfigurieren&diff=853Fahrgastwege und -sitzplätze konfigurieren2014-02-11T09:02:53Z<p>Marcel Kuhnt: </p>
<hr />
<div>''Hinweis: Dieser Artikel wurde noch nicht ins Englische übersetzt!''<br />
<br />
''OMSI-Version: 2.0''<br />
<br />
== Überblick ==<br />
<br />
Die Wege, die ein Fahrgast im Bus laufen kann und die Positionen, wo er stehen oder sitzen darf, werden in zwei Dateien festgelegt:<br />
<br />
* passengercabin.cfg: Enthält die Sitz- und Stehplätze<br />
* paths.cfg: Enthält die Laufwege<br />
<br />
, welche sich (bei unseren Fahrzeugen) üblicherweise im "Model"-Verzeichnis befinden. Allerdings ist sowohl der Name als auch der Speicherort nicht festgelegt.<br />
<br />
Wichtig ist nur, dass sie korrekt in der *.bus, *.ovh oder - bei Szenerieobjekten, die zumindest auch Sitz- und Stehplätze haben können - in der *.sco-Datei eingetragen werden: <br />
<br />
<pre><br />
[paths]<br />
model\paths_eintrepper.cfg<br />
<br />
[passengercabin]<br />
model\passengercabin.cfg<br />
</pre><br />
<br />
=== Tipp zur Vorgehensweise ===<br />
<br />
Bevor man mit der Arbeit an den Bus-Pfaden beginnt, erstellt man am Besten in Blender mit Ecken und Punkten die Sitzpositionen und Wege im Fahrzeug. Dann fertigt man davon einen Screenshot an und beschriftet die Wegpunkte mit Nummern von 0 an aufsteigend:<br />
<br />
[[Datei:A3 Pfad- und Sitzpositionen.png|600px]]<br />
<br />
Nun kann man sich durch die Sitzpositionen "hangeln" und jeweils in Blender die Eckpunktkoordinaten ablesen (dafür zuvor [N] drücken) und eintragen.<br />
<br />
Bei den Pfaden erstellt man die [pathpnt]-Einträge in der numerierten Reihenfolge, sodass man direkt aus der Zeichnung dann ablesen kann, welche Punkte mittels [pathlink] oder ggf. [pathlink_oneway]-Einträgen verbunden werden müssen.<br />
<br />
== Schlüsselwörter für die passengercabin.cfg ==<br />
<br />
Die Passengercabin-Datei verfügt (neben dem [[DISABLED-Befehl]]) über folgende Schlüsselwörter:<br />
<br />
=== [passpos]/[drivpos] ===<br />
<br />
Definiert einen neuen Sitz- oder Stehplatz für einen Fahrgast oder für den Fahrer. Beide Schlüsselwörter verfügen über dieselben Parameter:<br />
<br />
<pre><br />
[passpos]<br />
x<br />
y<br />
z<br />
h<br />
rot<br />
</pre><br />
<br />
''x'', ''y'' und ''z'' definieren die Position des Gesäßes (Sitzplatz) oder der Füße (Stehplatz).<br />
<br />
Der Parameter ''h'' gibt an, wie hoch der Sitzplatz über dem Boden angebracht ist (was einen Einfluss auf die Beinstellung hat) oder - wenn er "0" ist - dass es sich um einen Stehplatz handelt.<br />
<br />
Der Parameter ''rot'' gibt die Rotation in Grad an. 0 = in Fahrtrichtung sitzend, 90 = quer zur Fahrtrichtung, nach rechts schauend.<br />
<br />
=== [illumination_interior] ===<br />
<br />
Dieser Befehl gibt an, mit welchen (bis zu vier) Lichtquellen die vorherige durch [passpos] oder [drivpos] definierte Sitz-/Stehposition beleuchtet wird. Außerdem werden alle weiteren Positionen derart beleuchtet bis zum Auftauchen eines weiteren [illumination_interior]-Befehls. Sollen weniger als vier Lichtquellen verwendet werden, sind die restlichen Positionen auf "-1" zu setzen.<br />
<br />
Die zur Anwendung kommenden Indizes entsprechen (nullbasiert) der Reihenfolge der "[interiorlight]"-Befehle (die die Lichtquellen definieren) in der model.cfg.<br />
<br />
<pre><br />
[illumination_interior]<br />
Index einer Lichtquelle<br />
Index einer weiteren Lichtquelle<br />
Index einer dritten Lichtquelle<br />
Index einer vierten Lichtquelle<br />
</pre><br />
<br />
=== [entry] / [exit] ===<br />
<br />
Definiert einen neuen Ein- oder Ausgang des Fahrzeuges.<br />
<br />
<pre><br />
[entry] / [exit]<br />
num<br />
</pre><br />
<br />
Hierzu muss kurz auf die Path.cfg-Datei vorgegriffen werden: Dort werden Pfad-Punkte definiert, die wiederum mit Pfad-Links miteinander verbunden werden. Die Pfadpunkte sind von 0 beginnend durchnumeriert.<br />
<br />
Der Parameter ''num'' gibt nun an, welcher dieser Pfadpunkte ein Eingang oder Ausgang ist. Pfadpunkte können auch gleichzeitig Ein- und Ausstieg sein, auch wenn das momentan eventuell zu einem gewissen Durcheinander führen kann.<br />
<br />
Jeder neue [entry]/[exit]-Befehl definiert einen weiteren Ein- oder Ausgang und diese Reihe ist ebenfalls von 0 an beginnend durchnumeriert. Es gibt also die Eingänge 0, 1, 2,... und die Ausgänge 0, 1, 2, ... .<br />
<br />
Über das Fahrzeug-Script kann nun über die vordefinierten Variablen ''PAX_Entry#_Open'' (# = Nummer des Eingangs) bzw. ''PAX_Exit#_Open'' der Öffnungszustand des jeweiligen Ein- oder Ausgangs gesetzt werden.<br />
<br />
Es ist also wichtig, dass das Script über diese Variablen den Ein- oder Ausgangs öffnet, damit Fahrgäste durch diese Tür ein- oder aussteigen können.<br />
<br />
Mit ''PAX_Entry#_Req'' und ''PAX_Exit#_Req'' kann die Anforderung der Fahrgäste am jeweiligen Ein- oder Ausgang abgefragt werden; sie können somit ersatzweise für den Bus-weiten alten Haltewunsch-Trigger ''int_haltewunsch'' genutzt werden, der aber weiterhin gültig bleibt.<br />
<br />
=== {noticketsale} ===<br />
<br />
Gibt an, dass der vorherige [entry] nicht benutzt werden darf, wenn der Fahrgast einen Fahrschein kaufen möchte. Typischerweise kommt der Befehl bei Hintertüren zum Einsatz, da die Fahrgäste nicht von der Hintertür nach vorne laufen sollen, um einen Fahrschein zu kaufen, sondern gleich vorne einsteigen sollen.<br />
<br />
=== {withbutton} ===<br />
<br />
Gibt an, dass für der vorherige [entry] über die Möglichkeit verfügt, dass Fahrgäste die Türöffnung von außen anfordern können, also z.B. über Außentürtaster verfügt. In diesem Fall nämlich laufen die Fahrgäste auch dann zum entsprechenden Eingang, wenn die Tür zu ist, da sie davon ausgehen, dass sie sie selbst öffnen können. Die Anforderung kann im Script mittels der Variable ''PAX_Entry#_Req'' abgefragt werden.<br />
<br />
=== [stamper] ===<br />
<br />
Definiert die Position des Entwerters.<br />
<br />
<pre><br />
[stamper]<br />
num<br />
x<br />
y<br />
z <br />
</pre><br />
<br />
Erst wenn ein solcher Eintrag vorhanden ist, können Fahrgäste ihre Fahrkarten an einem Entwerter abstempeln. Es kann nur ein Entwerter pro Fahrzeug definiert werden. Der Fahrgast läuft zunächst zum Pfadpunkt ''num'' und führt dann seine seine Hand (mit der virtuellen Fahrkarte) zur Position ''x'', ''y'', ''z''. Dann wird der Sound-Trigger ''ev_Stamper'' ausgelöst (woraufhin üblicherweise das Entwertergeräusche ertönt), der Fahrgast nimmt die Hand wieder weg und geht weiter.<br />
<br />
=== [ticket_sale] ===<br />
<br />
Definiert die Fahrschein-Verkausstelle (Zahltisch).<br />
<br />
<pre><br />
[ticket_sale]<br />
num<br />
x<br />
y<br />
z <br />
</pre><br />
<br />
Ähnlich wie im ''Stamper''-Eintrag wird hierüber die Verkaufsstelle für Fahrscheine definiert, wobei ''num'' wieder der Index des Pfadpunktes ist, an dem der Fahrgast den Fahrschein bestellt. Die Koordinaten geben wieder die Position an, wo der Fahrgast "hinfassen" muss, um den Fahrschein zu nehmen. Allerdings wird über diesen Eintrag ''nicht'' eingestellt, wo die Fahrkarten erscheinen, dies regelt der Eintrag [ticket_sale_money_point].<br />
<br />
=== [ticket_sale_money_point] / [ticket_sale_money_point_2] ===<br />
<br />
Hierüber wird der Tisch definiert, auf den die Fahrgäste das Geld zum Bezahlen und worauf der Fahrer den Fahrschein legt.<br />
<br />
Es gibt zwei Varianten des Befehls:<br />
<br />
<pre><br />
[ticket_sale_money_point]<br />
pos_x<br />
pos_y<br />
pos_z<br />
var_x<br />
var_y<br />
</pre><br />
<br />
oder<br />
<br />
<pre><br />
[ticket_sale_money_point_2]<br />
pos_x<br />
pos_y<br />
pos_z<br />
var_x<br />
var_y<br />
anim-parent<br />
</pre><br />
<br />
Hierbei geben die Koordinaten pos_x bis pos_z die Position der Münzen, Scheine und Fahrscheine an und über var_x und var_y wird noch die Ausdehnung der Fläche definiert, wie stark die Werte variieren dürfen. Wenn der Fahrgast Geld hinlegt, dann wird der Soundtrigger ''ev_ticketsale_givemoney'' ausgelöst, allerdings nur, wenn Münzen enthalten sind - Scheine machen ja kein Geräusch! ;) Wenn der Fahrer dagegen den Fahrschein durch Klick auf einen Fahrscheinblock ausgibt, dann wird der Trigger ''ev_ticketsale_giveticket'' ausgelöst, sobald der Fahrgast den Fahrschein nimmt, dann ''ev_ticketsale_taketicket''<br />
<br />
Der neu eingeführte "anim-parent"-Parameter erlaubt die Animation der Geld-Position. Hierfür wird beim zugehörigen, animierten Mesh mit dem Befehl [mesh_ident] ein Name zugewiesen, der als "anim-parent" angegeben wird.<br />
<br />
=== [ticket_sale_change_point] / [ticket_sale_change_point_2] ===<br />
<br />
Auf gleiche Weise wie der Eintrag [ticket_sale_money_point] definiert dieser Eintrag den Punkt (bzw. die Fläche), wo das Rückgeld ausgegeben wird.<br />
<br />
Auch hier gibt es zwei Varianten:<br />
<br />
<pre><br />
[ticket_sale_change_point]<br />
pos_x<br />
pos_y<br />
pos_z<br />
var_x<br />
var_y<br />
</pre><br />
<br />
oder<br />
<br />
<pre><br />
[ticket_sale_change_point_2]<br />
pos_x<br />
pos_y<br />
pos_z<br />
var_x<br />
var_y<br />
anim-parent<br />
</pre><br />
<br />
Auch hier hat "anim-parent" dieselbe Funktion wie beim Befehl [ticket_sale_money_point_2].<br />
<br />
=== [linkToNextVeh]/[linkToPrevVeh] ===<br />
<br />
Bei Gelenkbussen gibt dieser Befehl an, welcher Pfadpunkt für den Übergang zum vorderen ("Next") bzw. hinteren ("Prev") Fahrzeugteil genutzt werden soll:<br />
<br />
<pre><br />
[linkToNextVeh]<br />
Pfadpunktindex<br />
</pre><br />
<br />
== Schlüsselwörter für die paths.cfg ==<br />
<br />
Die Paths-Datei verfügt über folgende Schlüsselwörter:<br />
<br />
=== [stepsoundpack] ===<br />
<br />
Dieser Befehl definiert ein neues Schritt-Sound-Paket.<br />
<br />
<pre><br />
[stepsoundpack]<br />
num<br />
filename1.wav<br />
filename2.wav<br />
...<br />
</pre><br />
<br />
Damit unterschiedliche Bereiche oder gewissermaßen Bodenbeläge unterschiedlich klingen, aber dennoch die Schritte einen abwechslungsreichen Klang auch innerhalb der jeweiligen Bereiche haben, können verschiedene Schritt-Sound-Pakete definiert werden. Jeder Eintrag definiert ein neues Paket, sie werden automatisch bei Null beginnend durchgezählt. ''num'' gibt an, wieviele Einzelschrittsounds definiert werden sollen, darauf folgt dann die Reihe der Wave-Dateien, welche sich im Verzeichnis ''Omsi\Sounds\Passengers'' befinden müssen. (Dort kann natürlich auch ein Unterverzeichnis eingerichtet werden und dann mit ''unterverzeichnis\filename1.wav'' vermerkt werden.)<br />
<br />
Die Stepsoundpacks müssen vor dem ersten [pathlink]/[pathlink_oneway]-Eintrag definiert werden.<br />
<br />
=== [pathpnt] ===<br />
<br />
<pre><br />
[pathpnt]<br />
x<br />
y<br />
z<br />
</pre><br />
<br />
Dieser Eintrag definiert einen neuen Pfadpunkt. Die Pfadpunkte werden bei Null beginnend automatisch in der Reihenfolge der Einträge durchnumeriert.<br />
<br />
=== [pathlink] ===<br />
<br />
Dieser Eintrag definiert eine Verbindung zweier Pfadpunkte:<br />
<br />
<pre><br />
[pathlink]<br />
Pfadpunkt-Index 1<br />
Pfadpunkt-Index 2<br />
</pre><br />
<br />
=== [pathlink_oneway] ===<br />
<br />
Dieser Befehl wird genauso wie [pathlink] definiert, aber erzeugt einen "Einbahnstraßen"-Pfad. Die Fahrgäste können nur vom ersteingetragenen zum zweiteingetragenen Pfadpunkt laufen.<br />
<br />
=== [next_roomheight] ===<br />
<br />
Dieser Befehl setzt für alle folgenden [pathlink]- und [pathlink_oneway]-Befehle bis zum nächsten Auftauchen dieses Befehls die Raumhöhe auf den Wert ''height'' (in Metern), sodass verhindert wird, dass die Fahrgäste mit ihrem Kopf durch die Decke stoßen.<br />
<br />
<pre><br />
[next_roomheight]<br />
height<br />
</pre><br />
<br />
=== [next_stepsound] ===<br />
<br />
Dieser Befehl setzt für alle folgenden [pathlink]- und [pathlink_oneway]-Befehle bis zum nächsten Auftauchen dieses Befehls das zu verwendende Schritt-Soundpaket. Wenn die Fahrgäste über Pfadverbindungen laufen, die ab hier definiert werden, wird der Schrittsound aus dem gewählten Schritt-Soundpaket ausgewählt.<br />
<br />
<pre><br />
[next_stepsound]<br />
index_stepsoundpack<br />
</pre><br />
<br />
[[Kategorie:Nachschlagewerk für Addon-Entwickler]]</div>Marcel Kuhnthttp://wiki.omnibussimulator.de/omsiwikineu.de/index.php?title=Fahrgastwege_und_-sitzpl%C3%A4tze_konfigurieren&diff=852Fahrgastwege und -sitzplätze konfigurieren2014-02-11T09:02:12Z<p>Marcel Kuhnt: /* [pathlink_oneway] */</p>
<hr />
<div>''Hinweis: Dieser Artikel wurde noch nicht ins Englische übersetzt!''<br />
<br />
== Überblick ==<br />
<br />
Die Wege, die ein Fahrgast im Bus laufen kann und die Positionen, wo er stehen oder sitzen darf, werden in zwei Dateien festgelegt:<br />
<br />
* passengercabin.cfg: Enthält die Sitz- und Stehplätze<br />
* paths.cfg: Enthält die Laufwege<br />
<br />
, welche sich (bei unseren Fahrzeugen) üblicherweise im "Model"-Verzeichnis befinden. Allerdings ist sowohl der Name als auch der Speicherort nicht festgelegt.<br />
<br />
Wichtig ist nur, dass sie korrekt in der *.bus, *.ovh oder - bei Szenerieobjekten, die zumindest auch Sitz- und Stehplätze haben können - in der *.sco-Datei eingetragen werden: <br />
<br />
<pre><br />
[paths]<br />
model\paths_eintrepper.cfg<br />
<br />
[passengercabin]<br />
model\passengercabin.cfg<br />
</pre><br />
<br />
=== Tipp zur Vorgehensweise ===<br />
<br />
Bevor man mit der Arbeit an den Bus-Pfaden beginnt, erstellt man am Besten in Blender mit Ecken und Punkten die Sitzpositionen und Wege im Fahrzeug. Dann fertigt man davon einen Screenshot an und beschriftet die Wegpunkte mit Nummern von 0 an aufsteigend:<br />
<br />
[[Datei:A3 Pfad- und Sitzpositionen.png|600px]]<br />
<br />
Nun kann man sich durch die Sitzpositionen "hangeln" und jeweils in Blender die Eckpunktkoordinaten ablesen (dafür zuvor [N] drücken) und eintragen.<br />
<br />
Bei den Pfaden erstellt man die [pathpnt]-Einträge in der numerierten Reihenfolge, sodass man direkt aus der Zeichnung dann ablesen kann, welche Punkte mittels [pathlink] oder ggf. [pathlink_oneway]-Einträgen verbunden werden müssen.<br />
<br />
== Schlüsselwörter für die passengercabin.cfg ==<br />
<br />
Die Passengercabin-Datei verfügt (neben dem [[DISABLED-Befehl]]) über folgende Schlüsselwörter:<br />
<br />
=== [passpos]/[drivpos] ===<br />
<br />
Definiert einen neuen Sitz- oder Stehplatz für einen Fahrgast oder für den Fahrer. Beide Schlüsselwörter verfügen über dieselben Parameter:<br />
<br />
<pre><br />
[passpos]<br />
x<br />
y<br />
z<br />
h<br />
rot<br />
</pre><br />
<br />
''x'', ''y'' und ''z'' definieren die Position des Gesäßes (Sitzplatz) oder der Füße (Stehplatz).<br />
<br />
Der Parameter ''h'' gibt an, wie hoch der Sitzplatz über dem Boden angebracht ist (was einen Einfluss auf die Beinstellung hat) oder - wenn er "0" ist - dass es sich um einen Stehplatz handelt.<br />
<br />
Der Parameter ''rot'' gibt die Rotation in Grad an. 0 = in Fahrtrichtung sitzend, 90 = quer zur Fahrtrichtung, nach rechts schauend.<br />
<br />
=== [illumination_interior] ===<br />
<br />
Dieser Befehl gibt an, mit welchen (bis zu vier) Lichtquellen die vorherige durch [passpos] oder [drivpos] definierte Sitz-/Stehposition beleuchtet wird. Außerdem werden alle weiteren Positionen derart beleuchtet bis zum Auftauchen eines weiteren [illumination_interior]-Befehls. Sollen weniger als vier Lichtquellen verwendet werden, sind die restlichen Positionen auf "-1" zu setzen.<br />
<br />
Die zur Anwendung kommenden Indizes entsprechen (nullbasiert) der Reihenfolge der "[interiorlight]"-Befehle (die die Lichtquellen definieren) in der model.cfg.<br />
<br />
<pre><br />
[illumination_interior]<br />
Index einer Lichtquelle<br />
Index einer weiteren Lichtquelle<br />
Index einer dritten Lichtquelle<br />
Index einer vierten Lichtquelle<br />
</pre><br />
<br />
=== [entry] / [exit] ===<br />
<br />
Definiert einen neuen Ein- oder Ausgang des Fahrzeuges.<br />
<br />
<pre><br />
[entry] / [exit]<br />
num<br />
</pre><br />
<br />
Hierzu muss kurz auf die Path.cfg-Datei vorgegriffen werden: Dort werden Pfad-Punkte definiert, die wiederum mit Pfad-Links miteinander verbunden werden. Die Pfadpunkte sind von 0 beginnend durchnumeriert.<br />
<br />
Der Parameter ''num'' gibt nun an, welcher dieser Pfadpunkte ein Eingang oder Ausgang ist. Pfadpunkte können auch gleichzeitig Ein- und Ausstieg sein, auch wenn das momentan eventuell zu einem gewissen Durcheinander führen kann.<br />
<br />
Jeder neue [entry]/[exit]-Befehl definiert einen weiteren Ein- oder Ausgang und diese Reihe ist ebenfalls von 0 an beginnend durchnumeriert. Es gibt also die Eingänge 0, 1, 2,... und die Ausgänge 0, 1, 2, ... .<br />
<br />
Über das Fahrzeug-Script kann nun über die vordefinierten Variablen ''PAX_Entry#_Open'' (# = Nummer des Eingangs) bzw. ''PAX_Exit#_Open'' der Öffnungszustand des jeweiligen Ein- oder Ausgangs gesetzt werden.<br />
<br />
Es ist also wichtig, dass das Script über diese Variablen den Ein- oder Ausgangs öffnet, damit Fahrgäste durch diese Tür ein- oder aussteigen können.<br />
<br />
Mit ''PAX_Entry#_Req'' und ''PAX_Exit#_Req'' kann die Anforderung der Fahrgäste am jeweiligen Ein- oder Ausgang abgefragt werden; sie können somit ersatzweise für den Bus-weiten alten Haltewunsch-Trigger ''int_haltewunsch'' genutzt werden, der aber weiterhin gültig bleibt.<br />
<br />
=== {noticketsale} ===<br />
<br />
Gibt an, dass der vorherige [entry] nicht benutzt werden darf, wenn der Fahrgast einen Fahrschein kaufen möchte. Typischerweise kommt der Befehl bei Hintertüren zum Einsatz, da die Fahrgäste nicht von der Hintertür nach vorne laufen sollen, um einen Fahrschein zu kaufen, sondern gleich vorne einsteigen sollen.<br />
<br />
=== {withbutton} ===<br />
<br />
Gibt an, dass für der vorherige [entry] über die Möglichkeit verfügt, dass Fahrgäste die Türöffnung von außen anfordern können, also z.B. über Außentürtaster verfügt. In diesem Fall nämlich laufen die Fahrgäste auch dann zum entsprechenden Eingang, wenn die Tür zu ist, da sie davon ausgehen, dass sie sie selbst öffnen können. Die Anforderung kann im Script mittels der Variable ''PAX_Entry#_Req'' abgefragt werden.<br />
<br />
=== [stamper] ===<br />
<br />
Definiert die Position des Entwerters.<br />
<br />
<pre><br />
[stamper]<br />
num<br />
x<br />
y<br />
z <br />
</pre><br />
<br />
Erst wenn ein solcher Eintrag vorhanden ist, können Fahrgäste ihre Fahrkarten an einem Entwerter abstempeln. Es kann nur ein Entwerter pro Fahrzeug definiert werden. Der Fahrgast läuft zunächst zum Pfadpunkt ''num'' und führt dann seine seine Hand (mit der virtuellen Fahrkarte) zur Position ''x'', ''y'', ''z''. Dann wird der Sound-Trigger ''ev_Stamper'' ausgelöst (woraufhin üblicherweise das Entwertergeräusche ertönt), der Fahrgast nimmt die Hand wieder weg und geht weiter.<br />
<br />
=== [ticket_sale] ===<br />
<br />
Definiert die Fahrschein-Verkausstelle (Zahltisch).<br />
<br />
<pre><br />
[ticket_sale]<br />
num<br />
x<br />
y<br />
z <br />
</pre><br />
<br />
Ähnlich wie im ''Stamper''-Eintrag wird hierüber die Verkaufsstelle für Fahrscheine definiert, wobei ''num'' wieder der Index des Pfadpunktes ist, an dem der Fahrgast den Fahrschein bestellt. Die Koordinaten geben wieder die Position an, wo der Fahrgast "hinfassen" muss, um den Fahrschein zu nehmen. Allerdings wird über diesen Eintrag ''nicht'' eingestellt, wo die Fahrkarten erscheinen, dies regelt der Eintrag [ticket_sale_money_point].<br />
<br />
=== [ticket_sale_money_point] / [ticket_sale_money_point_2] ===<br />
<br />
Hierüber wird der Tisch definiert, auf den die Fahrgäste das Geld zum Bezahlen und worauf der Fahrer den Fahrschein legt.<br />
<br />
Es gibt zwei Varianten des Befehls:<br />
<br />
<pre><br />
[ticket_sale_money_point]<br />
pos_x<br />
pos_y<br />
pos_z<br />
var_x<br />
var_y<br />
</pre><br />
<br />
oder<br />
<br />
<pre><br />
[ticket_sale_money_point_2]<br />
pos_x<br />
pos_y<br />
pos_z<br />
var_x<br />
var_y<br />
anim-parent<br />
</pre><br />
<br />
Hierbei geben die Koordinaten pos_x bis pos_z die Position der Münzen, Scheine und Fahrscheine an und über var_x und var_y wird noch die Ausdehnung der Fläche definiert, wie stark die Werte variieren dürfen. Wenn der Fahrgast Geld hinlegt, dann wird der Soundtrigger ''ev_ticketsale_givemoney'' ausgelöst, allerdings nur, wenn Münzen enthalten sind - Scheine machen ja kein Geräusch! ;) Wenn der Fahrer dagegen den Fahrschein durch Klick auf einen Fahrscheinblock ausgibt, dann wird der Trigger ''ev_ticketsale_giveticket'' ausgelöst, sobald der Fahrgast den Fahrschein nimmt, dann ''ev_ticketsale_taketicket''<br />
<br />
Der neu eingeführte "anim-parent"-Parameter erlaubt die Animation der Geld-Position. Hierfür wird beim zugehörigen, animierten Mesh mit dem Befehl [mesh_ident] ein Name zugewiesen, der als "anim-parent" angegeben wird.<br />
<br />
=== [ticket_sale_change_point] / [ticket_sale_change_point_2] ===<br />
<br />
Auf gleiche Weise wie der Eintrag [ticket_sale_money_point] definiert dieser Eintrag den Punkt (bzw. die Fläche), wo das Rückgeld ausgegeben wird.<br />
<br />
Auch hier gibt es zwei Varianten:<br />
<br />
<pre><br />
[ticket_sale_change_point]<br />
pos_x<br />
pos_y<br />
pos_z<br />
var_x<br />
var_y<br />
</pre><br />
<br />
oder<br />
<br />
<pre><br />
[ticket_sale_change_point_2]<br />
pos_x<br />
pos_y<br />
pos_z<br />
var_x<br />
var_y<br />
anim-parent<br />
</pre><br />
<br />
Auch hier hat "anim-parent" dieselbe Funktion wie beim Befehl [ticket_sale_money_point_2].<br />
<br />
=== [linkToNextVeh]/[linkToPrevVeh] ===<br />
<br />
Bei Gelenkbussen gibt dieser Befehl an, welcher Pfadpunkt für den Übergang zum vorderen ("Next") bzw. hinteren ("Prev") Fahrzeugteil genutzt werden soll:<br />
<br />
<pre><br />
[linkToNextVeh]<br />
Pfadpunktindex<br />
</pre><br />
<br />
== Schlüsselwörter für die paths.cfg ==<br />
<br />
Die Paths-Datei verfügt über folgende Schlüsselwörter:<br />
<br />
=== [stepsoundpack] ===<br />
<br />
Dieser Befehl definiert ein neues Schritt-Sound-Paket.<br />
<br />
<pre><br />
[stepsoundpack]<br />
num<br />
filename1.wav<br />
filename2.wav<br />
...<br />
</pre><br />
<br />
Damit unterschiedliche Bereiche oder gewissermaßen Bodenbeläge unterschiedlich klingen, aber dennoch die Schritte einen abwechslungsreichen Klang auch innerhalb der jeweiligen Bereiche haben, können verschiedene Schritt-Sound-Pakete definiert werden. Jeder Eintrag definiert ein neues Paket, sie werden automatisch bei Null beginnend durchgezählt. ''num'' gibt an, wieviele Einzelschrittsounds definiert werden sollen, darauf folgt dann die Reihe der Wave-Dateien, welche sich im Verzeichnis ''Omsi\Sounds\Passengers'' befinden müssen. (Dort kann natürlich auch ein Unterverzeichnis eingerichtet werden und dann mit ''unterverzeichnis\filename1.wav'' vermerkt werden.)<br />
<br />
Die Stepsoundpacks müssen vor dem ersten [pathlink]/[pathlink_oneway]-Eintrag definiert werden.<br />
<br />
=== [pathpnt] ===<br />
<br />
<pre><br />
[pathpnt]<br />
x<br />
y<br />
z<br />
</pre><br />
<br />
Dieser Eintrag definiert einen neuen Pfadpunkt. Die Pfadpunkte werden bei Null beginnend automatisch in der Reihenfolge der Einträge durchnumeriert.<br />
<br />
=== [pathlink] ===<br />
<br />
Dieser Eintrag definiert eine Verbindung zweier Pfadpunkte:<br />
<br />
<pre><br />
[pathlink]<br />
Pfadpunkt-Index 1<br />
Pfadpunkt-Index 2<br />
</pre><br />
<br />
=== [pathlink_oneway] ===<br />
<br />
Dieser Befehl wird genauso wie [pathlink] definiert, aber erzeugt einen "Einbahnstraßen"-Pfad. Die Fahrgäste können nur vom ersteingetragenen zum zweiteingetragenen Pfadpunkt laufen.<br />
<br />
=== [next_roomheight] ===<br />
<br />
Dieser Befehl setzt für alle folgenden [pathlink]- und [pathlink_oneway]-Befehle bis zum nächsten Auftauchen dieses Befehls die Raumhöhe auf den Wert ''height'' (in Metern), sodass verhindert wird, dass die Fahrgäste mit ihrem Kopf durch die Decke stoßen.<br />
<br />
<pre><br />
[next_roomheight]<br />
height<br />
</pre><br />
<br />
=== [next_stepsound] ===<br />
<br />
Dieser Befehl setzt für alle folgenden [pathlink]- und [pathlink_oneway]-Befehle bis zum nächsten Auftauchen dieses Befehls das zu verwendende Schritt-Soundpaket. Wenn die Fahrgäste über Pfadverbindungen laufen, die ab hier definiert werden, wird der Schrittsound aus dem gewählten Schritt-Soundpaket ausgewählt.<br />
<br />
<pre><br />
[next_stepsound]<br />
index_stepsoundpack<br />
</pre><br />
<br />
[[Kategorie:Nachschlagewerk für Addon-Entwickler]]</div>Marcel Kuhnthttp://wiki.omnibussimulator.de/omsiwikineu.de/index.php?title=Fahrgastwege_und_-sitzpl%C3%A4tze_konfigurieren&diff=851Fahrgastwege und -sitzplätze konfigurieren2014-02-11T09:00:56Z<p>Marcel Kuhnt: /* Schlüsselwörter für die passengercabin.cfg */</p>
<hr />
<div>''Hinweis: Dieser Artikel wurde noch nicht ins Englische übersetzt!''<br />
<br />
== Überblick ==<br />
<br />
Die Wege, die ein Fahrgast im Bus laufen kann und die Positionen, wo er stehen oder sitzen darf, werden in zwei Dateien festgelegt:<br />
<br />
* passengercabin.cfg: Enthält die Sitz- und Stehplätze<br />
* paths.cfg: Enthält die Laufwege<br />
<br />
, welche sich (bei unseren Fahrzeugen) üblicherweise im "Model"-Verzeichnis befinden. Allerdings ist sowohl der Name als auch der Speicherort nicht festgelegt.<br />
<br />
Wichtig ist nur, dass sie korrekt in der *.bus, *.ovh oder - bei Szenerieobjekten, die zumindest auch Sitz- und Stehplätze haben können - in der *.sco-Datei eingetragen werden: <br />
<br />
<pre><br />
[paths]<br />
model\paths_eintrepper.cfg<br />
<br />
[passengercabin]<br />
model\passengercabin.cfg<br />
</pre><br />
<br />
=== Tipp zur Vorgehensweise ===<br />
<br />
Bevor man mit der Arbeit an den Bus-Pfaden beginnt, erstellt man am Besten in Blender mit Ecken und Punkten die Sitzpositionen und Wege im Fahrzeug. Dann fertigt man davon einen Screenshot an und beschriftet die Wegpunkte mit Nummern von 0 an aufsteigend:<br />
<br />
[[Datei:A3 Pfad- und Sitzpositionen.png|600px]]<br />
<br />
Nun kann man sich durch die Sitzpositionen "hangeln" und jeweils in Blender die Eckpunktkoordinaten ablesen (dafür zuvor [N] drücken) und eintragen.<br />
<br />
Bei den Pfaden erstellt man die [pathpnt]-Einträge in der numerierten Reihenfolge, sodass man direkt aus der Zeichnung dann ablesen kann, welche Punkte mittels [pathlink] oder ggf. [pathlink_oneway]-Einträgen verbunden werden müssen.<br />
<br />
== Schlüsselwörter für die passengercabin.cfg ==<br />
<br />
Die Passengercabin-Datei verfügt (neben dem [[DISABLED-Befehl]]) über folgende Schlüsselwörter:<br />
<br />
=== [passpos]/[drivpos] ===<br />
<br />
Definiert einen neuen Sitz- oder Stehplatz für einen Fahrgast oder für den Fahrer. Beide Schlüsselwörter verfügen über dieselben Parameter:<br />
<br />
<pre><br />
[passpos]<br />
x<br />
y<br />
z<br />
h<br />
rot<br />
</pre><br />
<br />
''x'', ''y'' und ''z'' definieren die Position des Gesäßes (Sitzplatz) oder der Füße (Stehplatz).<br />
<br />
Der Parameter ''h'' gibt an, wie hoch der Sitzplatz über dem Boden angebracht ist (was einen Einfluss auf die Beinstellung hat) oder - wenn er "0" ist - dass es sich um einen Stehplatz handelt.<br />
<br />
Der Parameter ''rot'' gibt die Rotation in Grad an. 0 = in Fahrtrichtung sitzend, 90 = quer zur Fahrtrichtung, nach rechts schauend.<br />
<br />
=== [illumination_interior] ===<br />
<br />
Dieser Befehl gibt an, mit welchen (bis zu vier) Lichtquellen die vorherige durch [passpos] oder [drivpos] definierte Sitz-/Stehposition beleuchtet wird. Außerdem werden alle weiteren Positionen derart beleuchtet bis zum Auftauchen eines weiteren [illumination_interior]-Befehls. Sollen weniger als vier Lichtquellen verwendet werden, sind die restlichen Positionen auf "-1" zu setzen.<br />
<br />
Die zur Anwendung kommenden Indizes entsprechen (nullbasiert) der Reihenfolge der "[interiorlight]"-Befehle (die die Lichtquellen definieren) in der model.cfg.<br />
<br />
<pre><br />
[illumination_interior]<br />
Index einer Lichtquelle<br />
Index einer weiteren Lichtquelle<br />
Index einer dritten Lichtquelle<br />
Index einer vierten Lichtquelle<br />
</pre><br />
<br />
=== [entry] / [exit] ===<br />
<br />
Definiert einen neuen Ein- oder Ausgang des Fahrzeuges.<br />
<br />
<pre><br />
[entry] / [exit]<br />
num<br />
</pre><br />
<br />
Hierzu muss kurz auf die Path.cfg-Datei vorgegriffen werden: Dort werden Pfad-Punkte definiert, die wiederum mit Pfad-Links miteinander verbunden werden. Die Pfadpunkte sind von 0 beginnend durchnumeriert.<br />
<br />
Der Parameter ''num'' gibt nun an, welcher dieser Pfadpunkte ein Eingang oder Ausgang ist. Pfadpunkte können auch gleichzeitig Ein- und Ausstieg sein, auch wenn das momentan eventuell zu einem gewissen Durcheinander führen kann.<br />
<br />
Jeder neue [entry]/[exit]-Befehl definiert einen weiteren Ein- oder Ausgang und diese Reihe ist ebenfalls von 0 an beginnend durchnumeriert. Es gibt also die Eingänge 0, 1, 2,... und die Ausgänge 0, 1, 2, ... .<br />
<br />
Über das Fahrzeug-Script kann nun über die vordefinierten Variablen ''PAX_Entry#_Open'' (# = Nummer des Eingangs) bzw. ''PAX_Exit#_Open'' der Öffnungszustand des jeweiligen Ein- oder Ausgangs gesetzt werden.<br />
<br />
Es ist also wichtig, dass das Script über diese Variablen den Ein- oder Ausgangs öffnet, damit Fahrgäste durch diese Tür ein- oder aussteigen können.<br />
<br />
Mit ''PAX_Entry#_Req'' und ''PAX_Exit#_Req'' kann die Anforderung der Fahrgäste am jeweiligen Ein- oder Ausgang abgefragt werden; sie können somit ersatzweise für den Bus-weiten alten Haltewunsch-Trigger ''int_haltewunsch'' genutzt werden, der aber weiterhin gültig bleibt.<br />
<br />
=== {noticketsale} ===<br />
<br />
Gibt an, dass der vorherige [entry] nicht benutzt werden darf, wenn der Fahrgast einen Fahrschein kaufen möchte. Typischerweise kommt der Befehl bei Hintertüren zum Einsatz, da die Fahrgäste nicht von der Hintertür nach vorne laufen sollen, um einen Fahrschein zu kaufen, sondern gleich vorne einsteigen sollen.<br />
<br />
=== {withbutton} ===<br />
<br />
Gibt an, dass für der vorherige [entry] über die Möglichkeit verfügt, dass Fahrgäste die Türöffnung von außen anfordern können, also z.B. über Außentürtaster verfügt. In diesem Fall nämlich laufen die Fahrgäste auch dann zum entsprechenden Eingang, wenn die Tür zu ist, da sie davon ausgehen, dass sie sie selbst öffnen können. Die Anforderung kann im Script mittels der Variable ''PAX_Entry#_Req'' abgefragt werden.<br />
<br />
=== [stamper] ===<br />
<br />
Definiert die Position des Entwerters.<br />
<br />
<pre><br />
[stamper]<br />
num<br />
x<br />
y<br />
z <br />
</pre><br />
<br />
Erst wenn ein solcher Eintrag vorhanden ist, können Fahrgäste ihre Fahrkarten an einem Entwerter abstempeln. Es kann nur ein Entwerter pro Fahrzeug definiert werden. Der Fahrgast läuft zunächst zum Pfadpunkt ''num'' und führt dann seine seine Hand (mit der virtuellen Fahrkarte) zur Position ''x'', ''y'', ''z''. Dann wird der Sound-Trigger ''ev_Stamper'' ausgelöst (woraufhin üblicherweise das Entwertergeräusche ertönt), der Fahrgast nimmt die Hand wieder weg und geht weiter.<br />
<br />
=== [ticket_sale] ===<br />
<br />
Definiert die Fahrschein-Verkausstelle (Zahltisch).<br />
<br />
<pre><br />
[ticket_sale]<br />
num<br />
x<br />
y<br />
z <br />
</pre><br />
<br />
Ähnlich wie im ''Stamper''-Eintrag wird hierüber die Verkaufsstelle für Fahrscheine definiert, wobei ''num'' wieder der Index des Pfadpunktes ist, an dem der Fahrgast den Fahrschein bestellt. Die Koordinaten geben wieder die Position an, wo der Fahrgast "hinfassen" muss, um den Fahrschein zu nehmen. Allerdings wird über diesen Eintrag ''nicht'' eingestellt, wo die Fahrkarten erscheinen, dies regelt der Eintrag [ticket_sale_money_point].<br />
<br />
=== [ticket_sale_money_point] / [ticket_sale_money_point_2] ===<br />
<br />
Hierüber wird der Tisch definiert, auf den die Fahrgäste das Geld zum Bezahlen und worauf der Fahrer den Fahrschein legt.<br />
<br />
Es gibt zwei Varianten des Befehls:<br />
<br />
<pre><br />
[ticket_sale_money_point]<br />
pos_x<br />
pos_y<br />
pos_z<br />
var_x<br />
var_y<br />
</pre><br />
<br />
oder<br />
<br />
<pre><br />
[ticket_sale_money_point_2]<br />
pos_x<br />
pos_y<br />
pos_z<br />
var_x<br />
var_y<br />
anim-parent<br />
</pre><br />
<br />
Hierbei geben die Koordinaten pos_x bis pos_z die Position der Münzen, Scheine und Fahrscheine an und über var_x und var_y wird noch die Ausdehnung der Fläche definiert, wie stark die Werte variieren dürfen. Wenn der Fahrgast Geld hinlegt, dann wird der Soundtrigger ''ev_ticketsale_givemoney'' ausgelöst, allerdings nur, wenn Münzen enthalten sind - Scheine machen ja kein Geräusch! ;) Wenn der Fahrer dagegen den Fahrschein durch Klick auf einen Fahrscheinblock ausgibt, dann wird der Trigger ''ev_ticketsale_giveticket'' ausgelöst, sobald der Fahrgast den Fahrschein nimmt, dann ''ev_ticketsale_taketicket''<br />
<br />
Der neu eingeführte "anim-parent"-Parameter erlaubt die Animation der Geld-Position. Hierfür wird beim zugehörigen, animierten Mesh mit dem Befehl [mesh_ident] ein Name zugewiesen, der als "anim-parent" angegeben wird.<br />
<br />
=== [ticket_sale_change_point] / [ticket_sale_change_point_2] ===<br />
<br />
Auf gleiche Weise wie der Eintrag [ticket_sale_money_point] definiert dieser Eintrag den Punkt (bzw. die Fläche), wo das Rückgeld ausgegeben wird.<br />
<br />
Auch hier gibt es zwei Varianten:<br />
<br />
<pre><br />
[ticket_sale_change_point]<br />
pos_x<br />
pos_y<br />
pos_z<br />
var_x<br />
var_y<br />
</pre><br />
<br />
oder<br />
<br />
<pre><br />
[ticket_sale_change_point_2]<br />
pos_x<br />
pos_y<br />
pos_z<br />
var_x<br />
var_y<br />
anim-parent<br />
</pre><br />
<br />
Auch hier hat "anim-parent" dieselbe Funktion wie beim Befehl [ticket_sale_money_point_2].<br />
<br />
=== [linkToNextVeh]/[linkToPrevVeh] ===<br />
<br />
Bei Gelenkbussen gibt dieser Befehl an, welcher Pfadpunkt für den Übergang zum vorderen ("Next") bzw. hinteren ("Prev") Fahrzeugteil genutzt werden soll:<br />
<br />
<pre><br />
[linkToNextVeh]<br />
Pfadpunktindex<br />
</pre><br />
<br />
== Schlüsselwörter für die paths.cfg ==<br />
<br />
Die Paths-Datei verfügt über folgende Schlüsselwörter:<br />
<br />
=== [stepsoundpack] ===<br />
<br />
Dieser Befehl definiert ein neues Schritt-Sound-Paket.<br />
<br />
<pre><br />
[stepsoundpack]<br />
num<br />
filename1.wav<br />
filename2.wav<br />
...<br />
</pre><br />
<br />
Damit unterschiedliche Bereiche oder gewissermaßen Bodenbeläge unterschiedlich klingen, aber dennoch die Schritte einen abwechslungsreichen Klang auch innerhalb der jeweiligen Bereiche haben, können verschiedene Schritt-Sound-Pakete definiert werden. Jeder Eintrag definiert ein neues Paket, sie werden automatisch bei Null beginnend durchgezählt. ''num'' gibt an, wieviele Einzelschrittsounds definiert werden sollen, darauf folgt dann die Reihe der Wave-Dateien, welche sich im Verzeichnis ''Omsi\Sounds\Passengers'' befinden müssen. (Dort kann natürlich auch ein Unterverzeichnis eingerichtet werden und dann mit ''unterverzeichnis\filename1.wav'' vermerkt werden.)<br />
<br />
Die Stepsoundpacks müssen vor dem ersten [pathlink]/[pathlink_oneway]-Eintrag definiert werden.<br />
<br />
=== [pathpnt] ===<br />
<br />
<pre><br />
[pathpnt]<br />
x<br />
y<br />
z<br />
</pre><br />
<br />
Dieser Eintrag definiert einen neuen Pfadpunkt. Die Pfadpunkte werden bei Null beginnend automatisch in der Reihenfolge der Einträge durchnumeriert.<br />
<br />
=== [pathlink] ===<br />
<br />
Dieser Eintrag definiert eine Verbindung zweier Pfadpunkte:<br />
<br />
<pre><br />
[pathlink]<br />
Pfadpunkt-Index 1<br />
Pfadpunkt-Index 2<br />
</pre><br />
<br />
=== [pathlink_oneway] ===<br />
<br />
Dieser Befehl wird genauso wie [pathlink] definiert, aber erzeugt einen Einrichtungs-Pfad. Die Fahrgäste können nur vom ersteingetragenen zum zweiteingetragenen Pfadpunkt laufen.<br />
<br />
=== [next_roomheight] ===<br />
<br />
Dieser Befehl setzt für alle folgenden [pathlink]- und [pathlink_oneway]-Befehle bis zum nächsten Auftauchen dieses Befehls die Raumhöhe auf den Wert ''height'' (in Metern), sodass verhindert wird, dass die Fahrgäste mit ihrem Kopf durch die Decke stoßen.<br />
<br />
<pre><br />
[next_roomheight]<br />
height<br />
</pre><br />
<br />
=== [next_stepsound] ===<br />
<br />
Dieser Befehl setzt für alle folgenden [pathlink]- und [pathlink_oneway]-Befehle bis zum nächsten Auftauchen dieses Befehls das zu verwendende Schritt-Soundpaket. Wenn die Fahrgäste über Pfadverbindungen laufen, die ab hier definiert werden, wird der Schrittsound aus dem gewählten Schritt-Soundpaket ausgewählt.<br />
<br />
<pre><br />
[next_stepsound]<br />
index_stepsoundpack<br />
</pre><br />
<br />
[[Kategorie:Nachschlagewerk für Addon-Entwickler]]</div>Marcel Kuhnt