System- und vordefinierte lokalen Variablen
Aus OMSIWiki
Hinweis: Dieser Artikel wurde noch nicht ins Englische übersetzt!
Beschreibung der System- und der lokalen Scriptvariablen, welche für jedes Objekt vordefiniert werden und im Allgemeinen bestimmte Sonderfunktionen gegenüber frei definierten Scriptvariablen übernehmen.
Inhaltsverzeichnis
Systemvariablen
Siehe bitte auch Datei program\varlist_system.txt!
| Variablenname | Beschreibung | Einheit | ab OMSI-Vs. |
| Timegap | Zeitschritt seit dem letzten Durchlauf (Frame) | Sekunden | 1.00 |
| GetTime | Enthält eine absolute Zeitangabe, die vom Beginn des Ausführens von OMSI zählt | Sekunden | 1.00 |
| NoSound | Sounds deaktiviert? | 0 = Sounds aktiviert, 1 = Sounds deaktiviert | 1.00 |
| Pause | Simulations-Pause aktiv? | 0 = Simulation läuft, 1 = Simulation angehalten | 1.00 |
| Time | Uhrzeit gerechnet von Mitternacht des aktuellen Tages | Sekunden | 1.00 |
| Day | Tag gezählt ab Monatsbeginn | Tage | 1.00 |
| Month | Monat | Monate | 1.00 |
| Year | Jahr | Jahre | 1.00 |
| DayOfYear | Tag gezählt ab Jahresbeginn | Tage | 1.00 |
| mouse_x | X-Koordinate des Mauszeigers auf dem Bildschirm | Pixel | 1.00 |
| mouse_y | Y-Koordinate des Mauszeigers auf dem Bildschirm | Pixel | 1.00 |
| PrecipType | Niederschlagstyp | 0 = keiner, 1 = Regen, 2 = Schnee | 1.00 |
| PrecipRate | Niederschlagstyp | 0 = kein Niederschlag, 1 = maximaler Niederschlag | 1.00 |
| coll_pos_x | Position der Kollision, x-Richtung relativ zum Fahrzeugursprung (nur bei Auslösung des Kollisions-Triggers) | Meter | 1.00 |
| coll_pos_y | Position der Kollision, y-Richtung relativ zum Fahrzeugursprung (nur bei Auslösung des Kollisions-Triggers) | Meter | 1.00 |
| coll_pos_z | Position der Kollision, z-Richtung relativ zum Fahrzeugursprung (nur bei Auslösung des Kollisions-Triggers) | Meter | 1.00 |
| coll_energy | Energie der Kollision (nur bei Auslösung des Kollisions-Triggers) | Nm | 1.00 |
| Weather_Temperature | Außentemperatur | °C | 1.00 |
| Weather_AbsHum | Absolute Luftfeuchtigkeit | g/m³ | 1.00 |
| AutoClutch | Option "automatische Kupplung" aktiviert | 0 = aus, 1 = an | 1.03 |
| wearlifespan | nicht nutzen! | 2.00 | |
| SunAlt | Höhenwinkel der Sonne | ° | 2.00 |
Vordefinierte lokale Variablen
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!
Szenerieobjekte
Siehe bitte auch Datei program\varlist_scenobj.txt!
| Variablenname | Beschreibung | Einheit | kein Schreibzugriff | ab OMSI-Vs. |
| NightLightA | Ist die Nachtbeleuchtung aktiv? | 0 = aus, 1 = an | X | 1.00 |
| InUse | 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. | 0 = inaktiv, 1 = aktiv | X | 1.00 |
| TrafficLightPhase | Hierüber wird Ampelobjekten die anzuzeigende Ampelphase mitgeteilt. | 0..2 = rot, 3..5 = rot-gelb, 6..8 = grün, 9..11 = gelb, sonst aus | X | 1.00 |
| TrafficLightApproach | Hierüber kann das Script eine Ampelanforderung erkennen und bspw. eine Kennleuchte aktiviert werden. | 0 = keine Anforderung, 1 = Anforderung | X | 1.00 |
| Colorscheme | (veraltet) | (-) | X | 1.00 |
| Signal | Hierüber erhalten Signale ihr anzuzeigendes Signalbild | individuell | X | 1.00 |
| NextSignal | Hierüber erhalten Signale mit Vorsignalfunktion das anzuzeigende Signalbild des nächsten Signals | individuell | X | 1.00 |
| Refresh_Strings | Diese Variable muss auf "1" gesetzt werden, damit die Text-Texturen aktualisiert werden! Wird nach erfolgreicher Abarbeitung von OMSI auf 0 gesetzt. | - | 1.00 | |
| Switch | 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. | - | 2.00 |
Fahrzeuge
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.
Zahlvariablen
Siehe bitte auch Datei program\varlist_roadvehicle.txt!
| Variablenname | Beschreibung | Einheit | kein Schreibzugriff | "on demand" | ab OMSI-Vs. |
| Refresh_Strings | Diese Variable muss auf "1" gesetzt werden, damit die Text-Texturen aktualisiert werden! Wird nach erfolgreicher Abarbeitung von OMSI auf 0 gesetzt. | - | 1.00 | ||
| Envir_Brightness | Umgebungshelligkeit in Fahrzeugnähe | 0 = dunkel, 1 = hell | X | 1.00 | |
| StreetCond | Information über die Oberflächenbedingungen | 0: Trocken, 0..1: zunehmende Feuchtigkeit, 1: komplett feucht, 1..2: teilweise Pfützen, 2: Fahrzeug komplett in Pfützen | X | 1.00 | |
| Spot_Select | Hierüber kann gesteuert werden, welches fürs Fahrzeug vordefinierte Spotlight aktiv sein soll. | -1: kein Spotlight, 0: Spotlight Nr. 0, 1: Spotlight Nr. 1 usw. | 1.00 | ||
| Colorscheme | Index des gewählten Farbschemas/Anstriches | - | X | 1.00 | |
| M_Wheel | Hierüber kann das Script ein Drehmoment auf die Räder übertragen. Hierbei die Summe anzugeben, welche auf alle als angetrieben ausgewiesene Achsen wirken
soll. |
kNm = 1000 Nm | 1.00 | ||
| n_Wheel | Mittlere Raddrehzahl des Fahrzeuges | Umdrehungen pro Minute | X | 1.00 | |
| Throttle | Stellung des Gaspedals | 0..1 | X | 1.00 | |
| Brake | Stellung des Bremspedals | 0..1 | X | 1.00 | |
| Clutch | Stellung des Kupplungspedals | 0..1 | X | 1.00 | |
| Brakeforce | Hierüber kann das Script die Gesamtbremskraft des Fahrzeuges vorgeben, welche auf die Räder wirkt. Sollte nicht gleichzeitig mit Axle_Brakeforce... verwendet werden. | N | 1.00 | ||
| Velocity | Geschwindigkeit, welche sich über die Raddrehung ergibt, entspricht der Tachoanzeige | km/h | X | 1.00 | |
| Velocity_Ground | Geschwindigkeit, welche direkt relativ zum Grund gemessen wird, berücksichtigt kein Radschleudern oder -blockieren, entspricht der Anzeige auf einem GPS | km/h | X | 1.00 | |
| tank_percent | 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. | 0..1 | 1.00 | ||
| kmcounter_km | Stand des Kilometerzählers (nur ganze km) | km | X | 1.00 | |
| kmcounter_m | Stand des Kilometerzählers (zusätzliche Meter, läuft stets nur von 0m bis 999m; hinzu kommen die Kilometer von kmcounter_km) | m | X | 1.00 | |
| relrange | Zurückgelegte, relative Strecke. Wurde nur testweise für pfadfixierte Fahrzeuge eingeführt. Nicht benutzen! | --- | X | 1.00 | |
| Driver_Seat_VertTransl | Einfederung des federnden Fahrersitzes | m | X | 1.00 | |
| Wheel_Rotation_0_L / ~_R ... ~_3_L / _R | Drehwinkel des jeweiligen Rades, z.B. für die Animation | rad | X | 1.00 | |
| Wheel_RotationSpeed_0_L / ~_R ... ~_3_L / _R | Drehzahl des jeweiligen Rades | Umdrehungen pro Minute | X | 1.00 | |
| Axle_Suspension_0_L / ~_R ... ~_3_L / _R | Einfederungsweg des jeweiligen Rades | m | X | 1.00 | |
| Axle_Steering_0_L / ~_R ... ~_3_L / _R | Lenkwinkel des jeweiligen Rades | rad | X | 1.00 | |
| Axle_Springfactor_0_L / ~_R ... ~_3_L / _R | Faktor, mit dem radweise die Federstärke angepasst werden kann, z.B. um Luftfederungen zu simulieren. | 0 = keine, 1 = normale, 2 = doppelte Federkraft | 1.00 | ||
| Axle_Brakeforce_0_L / ~_R ... ~_3_L / _R | Ermöglicht Setzen der Bremskraft pro Rad. Sollte nicht gleichzeitig mit Brakeforce verwendet werden! | N | 1.00 | ||
| Axle_SurfaceID_0_L / ~_R ... ~_3_L / _R | Oberflächenbeschaffenheit unter dem Rad | Oberflächen-Codes | X | X | 2.00 |
| Debug_0 ... _5 | Debug-Variablen. Können im Debug-Modus in der Informationsleiste angezeigt werden, um auf diese Weise die Scripts zu testen. | bliebig | 1.00 | ||
| A_Trans_X ... _Z | Beschleunigungen im Fahrzeug, die durch die Fahrzeugbewegungen ausgelöst werden (beim Bremsen oder bei Kurvenfahrten usw.) | m/s² | X | 1.00 | |
| AI_Blinker_L, ~_R | Linker oder rechter Blinker aktiv | 0: aus, 1: ein | (X)* | 1.00 | |
| AI_Light | Fahrlicht, Standlicht, Lichthupe | 0: Licht aus, 0.5: Standlicht an, 1: Fahrlicht an, 2: Fernlicht/Lichthupe an | (X)* | 1.00 | |
| AI_Interiorlight | Innenbeleuchtung. Hierüber erfahren die einsteigenden Fahrgäste auch, ob es im Bus zu dunkel ist (sodass sie meckern dürfen). | 0: aus, 1: an | (X)* | 1.00 | |
| AI_Brakelight | Nur für KI-Fahrzeuge: Script soll Bremslicht einschalten | 0: aus, 1: an | X | 1.00 | |
| AI_Engine | Nur für KI-Fahrzeuge: Aufforderung zum Ein- oder Ausschalten des Motors | -1: Motor ausschalten!, 0: egal/nicht-KI, 1: Motor einschalten! | X | 1.00 | |
| AI_target_index | 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 | - | X | 1.00 | |
| target_index_int | Ü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. | - | 1.00 | ||
| AI_Scheduled_AtStation | 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. | -1: Bus abfahrbereit machen, 0: Bus ist abfahrbereit, 1: Türen freigeben/öffnen | (X) | 1.00 | |
| AI | Hierüber erfährt das Script, ob das Fahrzeug von der AI gesteuert wird. | 0: nein, 1: ja | X | 1.00 | |
| PAX_Entry0_Open ... ~7_Open | Teilt OMSI mit, ob die jeweiligen Eingänge offen oder geschlossen sind. | 0: geschlossen, 1: offen | 1.00 | ||
| PAX_Exit0_Open | Teilt OMSI mit, ob die jeweiligen Ausgänge offen oder geschlossen sind. | 0: geschlossen, 1: offen | 1.00 | ||
| PAX_Entry0_Req ... ~7_Open | Mindestens ein Fahrgast fordert den Einstieg durch diesen Eingang an. | 0: keine Anforderung, 1: Anforderung | 1.03 | ||
| PAX_Exit0_Req | Mindestens ein Fahrgast fordert den Ausstieg durch diesen Ausgang an ("Haltewunsch"). | 0: keine Anforderung, 1: Anforderung | 1.03 | ||
| GivenTicket | Teilt OMSI mit, ob der ggf. vorhandene Fahrscheinautomat ein Ticket ausgegeben hat. | -1: kein Ticket, 0: Tickettyp 0, 1: Tickettyp 1, ... | 1.00 | ||
| humans_count | Anzahl der Fahrgäste im Fahrzeug | - | X | 1.00 | |
| FF_Vib_Period | Setzt die Force-Feedback-Vibrationsperiode im Lenkrad | s | 1.00 | ||
| FF_Vib_Amp | Setzt die Force-Feedback-Vibrationsamplitude im Lenkrad | 0...1 | 1.00 | ||
| Snd_OutsideVol | Teilt OMSI mit, wie stark der Außensound im Innenraum hörbar ist; verändert sich bspw. wenn eine Tür geöffnet wird. | 0: kaum hörbar, 1: wie draußen | 1.00 | ||
| Snd_Microphone | Soll das (Hardware-)Mikrofon aktiv sein? | 0: aus, 1: an | 1.00 | ||
| Snd_Radio | Soll das (Internet-)Radio laufen? | 0: aus, 1: an | 1.00 | ||
| Cabinair_Temp | Innenraumtemperatur für die Beurteilung durch die Fahrgäste | °C | 1.00 | ||
| Cabinair_absHum | Absolute Luftfeuchtigkeit im Innenraum für die Beurteilung durch die Fahrgäste | g/m³ | 1.00 | ||
| Cabinair_relHum | Relative Luftfeuchtigkeit im Innenraum, wird durch OMSI automatisch über die absolute Feuchtigkeit und die Innentemperatur berechnet. | 0 = 0%, 1 = 100% | X | 1.00 | |
| PrecipRate | Niederschlagsrate | 0 = kein, 1 = maximal | X | 1.00 | |
| PrecipType | Niederschlagstyp | 0 = kein, 1 = Regen, 2 = Schnee | X | 1.00 | |
| Dirt_Norm | allgemeiner Verdreckungszustand (Windschutzscheiben können sauberer sein und werden nur vom Script simuliert) | 0 = sauber, 1 = total verdreckt | X | 1.00 | |
| DirtRate | aktuelle Verdreckungsrate | Verdreckung / s, wobei eine Verdreckung = 1 bedeutet, dass die Verdreckung maximal ist. | X | 1.00 | |
| schedule_active | Ist gerade ein Fahrplan aktiv? (Bspw. für Einblendung der Fahrplankarte) | 0: nein, 1: ja | X | 1.00 | |
| train_frontcoupling | Ist an der vorderen Kupplung etwas angekuppelt? (Eventuell spätere Benutzung zum Abkuppeln) | 0: nein, 1: ja | X | 1.00 | |
| train_backcoupling | Ist an der hinteren Kupplung etwas angekuppelt? (Eventuell spätere Benutzung zum Abkuppeln) | 0: nein, 1: ja | X | 1.00 | |
| train_me_reverse | Steht dieses Fahrzeug rückwärts zum gesamten Fahrzeugverband? | 0: nein, 1: ja | X | 1.00 | |
| TrafficPriority | 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. | 0: nein, 1: ja | 2.00 | ||
| wearlifespan | 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. | 10: sehr gute Wartung, 1: normale Wartung, 0.1: schlechte Wartung, 0.01: sehr schlechte Wartung, 1500000: "unendlich" | X | 2.00 | |
| articulation_#_alpha / ~_beta | Winkel, um den das #. Gelenk um die Hochachse (alpha) bzw. Querachse (beta) geknickt ist | ° | X | X | 2.00 |
*) 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.
Stringvariablen
Siehe bitte auch Datei program\stringvarlist_roadvehicle.txt!
| Variablenname | Beschreibung | kein Schreibzugriff |
| ident | Enthält das Kraftfahrzeugkennzeichen dieses Fahrzeugs (z.B. "B-V 3503") | X |
| number | Enthält die Fahrzeugnummer (z.B. "3503") | X |
| act_route | (keine Verwendung) | |
| act_busstop | Wird zusammen mit dem internen Trigger ai_scheduled_setbusstop verwendet: Enthält dann den Namen der im Fahrplansystem aktiven Haltestelle. | X |
| SetLineTo | 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) | X |
| yard | Name der Hofdatei des Fahrzeuges, bspw. damit das Scriptsystem den Dateinamen der Zielcode-Tabelle generieren kann. | X |
| file_schedule | Enthält den Dateinamen der Fahrplan-Bitmap, die zu der von diesem Fahrzeug gefahrenen Strecke gehört. | X |
Menschen
Siehe bitte auch Datei program\varlist_human.txt!
| Variablenname | Beschreibung | Einheit | kein Schreibzugriff |
| LastMovedDist | Entfernung, die der Mensch seit dem letzten Durchlauf zurückgelegt hat. Wurde für die alten Animationen gebraucht. | m | X |
| PAX_State | Zustand des Menschens. Wurde für die alten Animationen gebraucht. | 0: stehen, 1: gehen, 2: sitzen | X |
| HeightOfSeat | 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. | m | X |
| Colorscheme | Tauschtextur-Index ("Farbschema") des Menschens. | - | X |
