System- und vordefinierte lokalen Variablen

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.

Systemvariablen

Siehe bitte auch Datei program\varlist_system.txt!

Variablenname	Beschreibung	Einheit
Timegap	Zeitschritt seit dem letzten Durchlauf (Frame)	Sekunden
GetTime	Enthält eine absolute Zeitangabe, die vom Beginn des Ausführens von OMSI zählt	Sekunden
NoSound	Sounds deaktiviert?	0 = Sounds aktiviert, 1 = Sounds deaktiviert
Pause	Simulations-Pause aktiv?	0 = Simulation läuft, 1 = Simulation angehalten
Time	Uhrzeit gerechnet von Mitternacht des aktuellen Tages	Sekunden
Day	Tag gezählt ab Monatsbeginn	Tage
Month	Monat	Monate
Year	Jahr	Jahre
DayOfYear	Tag gezählt ab Jahresbeginn	Tage
mouse_x	X-Koordinate des Mauszeigers auf dem Bildschirm	Pixel
mouse_y	Y-Koordinate des Mauszeigers auf dem Bildschirm	Pixel
PrecipType	Niederschlagstyp	0 = keiner, 1 = Regen, 2 = Schnee
PrecipRate	Niederschlagstyp	0 = kein Niederschlag, 1 = maximaler Niederschlag
coll_pos_x	Position der Kollision, x-Richtung relativ zum Fahrzeugursprung (nur bei Auslösung des Kollisions-Triggers)	Meter
coll_pos_y	Position der Kollision, y-Richtung relativ zum Fahrzeugursprung (nur bei Auslösung des Kollisions-Triggers)	Meter
coll_pos_z	Position der Kollision, z-Richtung relativ zum Fahrzeugursprung (nur bei Auslösung des Kollisions-Triggers)	Meter
coll_energy	Energie der Kollision (nur bei Auslösung des Kollisions-Triggers)	Nm
Weather_Temperature	Außentemperatur	°C
Weather_AbsHum	Absolute Luftfeuchtigkeit	g/m³

Vordefinierte lokale Variablen

Szenerieobjekte

Siehe bitte auch Datei program\varlist_scenobj.txt!

Variablenname	Beschreibung	Einheit	kein Schreibzugriff
NightLightA	Ist die Nachtbeleuchtung aktiv?	0 = aus, 1 = an	X
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
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
TrafficLightApproach	Hierüber kann das Script eine Ampelanforderung erkennen und bspw. eine Kennleuchte aktiviert werden.	0 = keine Anforderung, 1 = Anforderung	X
Colorscheme	(veraltet)	(-)	X
Signal	Hierüber erhalten Signale ihr anzuzeigendes Signalbild	individuell	X
NextSignal	Hierüber erhalten Signale mit Vorsignalfunktion das anzuzeigende Signalbild des nächsten Signals	individuell	X
Refresh_Strings	Diese Variable muss auf "1" gesetzt werden, damit die Text-Texturen aktualisiert werden! Wird nach erfolgreicher Abarbeitung von OMSI auf 0 gesetzt.	-

Fahrzeuge

Zahlvariablen

Siehe bitte auch Datei program\varlist_roadvehicle.txt!

Variablenname	Beschreibung	Einheit	kein Schreibzugriff
Refresh_Strings	Diese Variable muss auf "1" gesetzt werden, damit die Text-Texturen aktualisiert werden! Wird nach erfolgreicher Abarbeitung von OMSI auf 0 gesetzt.	-
Envir_Brightness	Umgebungshelligkeit in Fahrzeugnähe	0 = dunkel, 1 = hell	X
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
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.
Colorscheme	Index des gewählten Farbschemas/Anstriches	-	X
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
n_Wheel	Mittlere Raddrehzahl des Fahrzeuges	Umdrehungen pro Minute	X
Throttle	Stellung des Gaspedals	0..1	X
Brake	Stellung des Bremspedals	0..1	X
Clutch	Stellung des Kupplungspedals	0..1	X
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
Velocity	Geschwindigkeit, welche sich über die Raddrehung ergibt, entspricht der Tachoanzeige	km/h	X
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
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
kmcounter_km	Stand des Kilometerzählers (nur ganze km)	km	X
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
relrange	Zurückgelegte, relative Strecke. Wurde nur testweise für pfadfixierte Fahrzeuge eingeführt. Nicht benutzen!	---	X
Driver_Seat_VertTransl	Einfederung des federnden Fahrersitzes	m	X
Wheel_Rotation_0_L / ~_R ... ~_3_L / _R	Drehwinkel des jeweiligen Rades, z.B. für die Animation	rad	X
Wheel_RotationSpeed_0_L / ~_R ... ~_3_L / _R	Drehzahl des jeweiligen Rades	Umdrehungen pro Minute	X
Axle_Suspension_0_L / ~_R ... ~_3_L / _R	Einfederungsweg des jeweiligen Rades	m	X
Axle_Steering_0_L / ~_R ... ~_3_L / _R	Lenkwinkel des jeweiligen Rades	rad	X
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
Axle_Brakeforce_0_L / ~_R ... ~_3_L / _R	Ermöglicht Setzen der Bremskraft pro Rad. Sollte nicht gleichzeitig mit Brakeforce verwendet werden!	N
Debug_0 ... _5	Debug-Variablen. Können im Debug-Modus in der Informationsleiste angezeigt werden, um auf diese Weise die Scripts zu testen.	bliebig
A_Trans_X ... _Z	Beschleunigungen im Fahrzeug, die durch die Fahrzeugbewegungen ausgelöst werden (beim Bremsen oder bei Kurvenfahrten usw.)	m/s²	X
AI_Blinker_L, ~_R	Linker oder rechter Blinker aktiv	0: aus, 1: ein	(X)*
AI_Light	Fahrlicht, Standlicht, Lichthupe	0: Licht aus, 0.5: Standlicht an, 1: Fahrlicht an, 2: Fernlicht/Lichthupe an	(X)*
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)*
AI_Brakelight	Nur für KI-Fahrzeuge: Script soll Bremslicht einschalten	0: aus, 1: an	X
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
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
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.	-
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)
AI	Hierüber erfährt das Script, ob das Fahrzeug von der AI gesteuert wird.	0: nein, 1: ja	X
PAX_Entry0_Open ... ~7_Open	Teilt OMSI mit, ob die jeweiligen Eingänge offen oder geschlossen sind.	0: geschlossen, 1: offen
PAX_Exit0_Open	Teilt OMSI mit, ob die jeweiligen Ausgänge offen oder geschlossen sind.	0: geschlossen, 1: offen
GivenTicket	Teilt OMSI mit, ob der ggf. vorhandene Fahrscheinautomat ein Ticket ausgegeben hat.	-1: kein Ticket, 0: Tickettyp 0, 1: Tickettyp 1, ...
humans_count	Anzahl der Fahrgäste im Fahrzeug	-	X
FF_Vib_Period	Setzt die Force-Feedback-Vibrationsperiode im Lenkrad	s
FF_Vib_Amp	Setzt die Force-Feedback-Vibrationsamplitude im Lenkrad	0...1
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
Snd_Microphone	Soll das (Hardware-)Mikrofon aktiv sein?	0: aus, 1: an
Snd_Radio	Soll das (Internet-)Radio laufen?	0: aus, 1: an
Cabinair_Temp	Innenraumtemperatur für die Beurteilung durch die Fahrgäste	°C
Cabinair_absHum	Absolute Luftfeuchtigkeit im Innenraum für die Beurteilung durch die Fahrgäste	g/m³
Cabinair_relHum	Relative Luftfeuchtigkeit im Innenraum, wird durch OMSI automatisch über die absolute Feuchtigkeit und die Innentemperatur berechnet.	0 = 0%, 1 = 100%	X
PrecipRate	Niederschlagsrate	0 = kein, 1 = maximal	X
PrecipType	Niederschlagstyp	0 = kein, 1 = Regen, 2 = Schnee	X
Dirt_Norm	allgemeiner Verdreckungszustand (Windschutzscheiben können sauberer sein und werden nur vom Script simuliert)	0 = sauber, 1 = total verdreckt	X
DirtRate	aktuelle Verdreckungsrate	Verdreckung / s, wobei eine Verdreckung = 1 bedeutet, dass die Verdreckung maximal ist.	X
schedule_active	Ist gerade ein Fahrplan aktiv? (Bspw. für Einblendung der Fahrplankarte)	0: nein, 1: ja	X
train_frontcoupling	Ist an der vorderen Kupplung etwas angekuppelt? (Eventuell spätere Benutzung zum Abkuppeln)	0: nein, 1: ja	X
train_backcoupling	Ist an der hinteren Kupplung etwas angekuppelt? (Eventuell spätere Benutzung zum Abkuppeln)	0: nein, 1: ja	X
train_me_reverse	Steht dieses Fahrzeug rückwärts zum gesamten Fahrzeugverband?	0: nein, 1: ja	X

*) 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