System- und vordefinierte lokalen Variablen: Unterschied zwischen den Versionen

Aus OMSIWiki
Wechseln zu:Navigation, Suche
(Die Seite wurde neu angelegt: „''Hinweis: Dieser Artikel wurde noch nicht ins Englische übersetzt!'' ''Hinweis: Dieser Artikel befindet sich noch im Aufbau!'' == Systemvariablen == {| class…“)
 
(Fahrzeugvariablen)
Zeile 4: Zeile 4:
  
 
== Systemvariablen ==
 
== Systemvariablen ==
 +
 +
Siehe bitte auch Datei ''program\varlist_system.txt''!
  
 
{| class="wikitable" style="font-size:95%;"   
 
{| class="wikitable" style="font-size:95%;"   
Zeile 92: Zeile 94:
 
=== Szenerieobjekte ===
 
=== Szenerieobjekte ===
  
Normale Variablen:
+
Siehe bitte auch Datei ''program\varlist_scenobj.txt''!
  
 
{| class="wikitable" style="font-size:95%;"   
 
{| class="wikitable" style="font-size:95%;"   
Zeile 136: Zeile 138:
 
| align="left" |-
 
| align="left" |-
 
|}
 
|}
 +
 +
=== Fahrzeuge ===
 +
 +
Siehe bitte auch Datei ''program\varlist_roadvehicle.txt''!
 +
 +
{| class="wikitable" style="font-size:95%;" 
 +
|- class="hintergrundfarbe5"
 +
| align="left" |''Variablenname''
 +
| align="left" |''Beschreibung''
 +
| align="left" |''Einheit''
 +
| align="left" |''kein Schreibzugriff''
 +
|-
 +
| align="left" |Refresh_Strings
 +
| align="left" |Diese Variable muss auf "1" gesetzt werden, damit die Text-Texturen aktualisiert werden! Wird nach erfolgreicher Abarbeitung von OMSI auf 0 gesetzt.
 +
| align="left" |-
 +
| align="left" |
 +
|-
 +
| align="left" |Envir_Brightness
 +
| align="left" |Umgebungshelligkeit in Fahrzeugnähe
 +
| align="left" |0 = dunkel, 1 = hell
 +
| align="left" |X
 +
|-
 +
| align="left" |StreetCond
 +
| align="left" |Information über die Oberflächenbedingungen
 +
| align="left" |0: Trocken, 0..1: zunehmende Feuchtigkeit, 1: komplett feucht, 1..2: teilweise Pfützen, 2: Fahrzeug komplett in Pfützen
 +
| align="left" |X
 +
|-
 +
| align="left" |Spot_Select
 +
| align="left" |Hierüber kann gesteuert werden, welches fürs Fahrzeug vordefinierte Spotlight aktiv sein soll.
 +
| align="left" |-1: kein Spotlight, 0: Spotlight Nr. 0, 1: Spotlight Nr. 1 usw.
 +
| align="left" |
 +
|-
 +
| align="left" |Colorscheme
 +
| align="left" |Index des gewählten Farbschemas/Anstriches
 +
| align="left" |-
 +
| align="left" |X
 +
|-
 +
| align="left" |M_Wheel
 +
| 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
 +
soll.
 +
| align="left" |kNm = 1000 [http://de.wikipedia.org/wiki/Newtonmeter Nm]
 +
| align="left" |
 +
|-
 +
| align="left" |n_Wheel
 +
| align="left" |Mittlere Raddrehzahl des Fahrzeuges
 +
| align="left" |Umdrehungen pro Minute
 +
| align="left" |X
 +
|-
 +
| align="left" |Throttle
 +
| align="left" |Stellung des Gaspedals
 +
| align="left" |0..1
 +
| align="left" |X
 +
|-
 +
| align="left" |Brake
 +
| align="left" |Stellung des Bremspedals
 +
| align="left" |0..1
 +
| align="left" |X
 +
|-
 +
| align="left" |Clutch
 +
| align="left" |Stellung des Kupplungspedals
 +
| align="left" |0..1
 +
| align="left" |X
 +
|-
 +
| align="left" |Brakeforce
 +
| 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.
 +
| align="left" |[http://de.wikipedia.org/wiki/Newton_(Einheit) N]
 +
| align="left" |
 +
|-
 +
| align="left" |Velocity
 +
| align="left" |Geschwindigkeit, welche sich über die Raddrehung ergibt, entspricht der Tachoanzeige
 +
| align="left" |[http://de.wikipedia.org/wiki/Km/h km/h]
 +
| align="left" |X
 +
|-
 +
| align="left" |Velocity_Ground
 +
| align="left" |Geschwindigkeit, welche direkt relativ zum Grund gemessen wird, berücksichtigt kein Radschleudern oder -blockieren, entspricht der Anzeige auf einem GPS
 +
| align="left" |[http://de.wikipedia.org/wiki/Km/h km/h]
 +
| align="left" |X
 +
|-
 +
| align="left" |tank_percent
 +
| 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.
 +
| align="left" |0..1
 +
| align="left" |
 +
|-
 +
| align="left" |kmcounter_km
 +
| align="left" |Stand des Kilometerzählers (nur ganze km)
 +
| align="left" |km
 +
| align="left" |X
 +
|-
 +
| align="left" |kmcounter_m
 +
| align="left" |Stand des Kilometerzählers (zusätzliche Meter, läuft stets nur von 0m bis 999m; hinzu kommen die Kilometer von ''kmcounter_km'')
 +
| align="left" |m
 +
| align="left" |X
 +
|-
 +
| align="left" |relrange
 +
| align="left" |Zurückgelegte, relative Strecke. Wurde nur testweise für pfadfixierte Fahrzeuge eingeführt. Nicht benutzen!
 +
| align="left" |---
 +
| align="left" |X
 +
|-
 +
| align="left" |Driver_Seat_VertTransl
 +
| align="left" |Einfederung des federnden Fahrersitzes
 +
| align="left" |m
 +
| align="left" |X
 +
|-
 +
| align="left" |Wheel_Rotation_0_L / ~_R ... ~_3_L / _R
 +
| align="left" |Drehwinkel des jeweiligen Rades, z.B. für die Animation
 +
| align="left" |[http://de.wikipedia.org/wiki/Radiant_(Einheit) rad]
 +
| align="left" |X
 +
|-
 +
| align="left" |Wheel_RotationSpeed_0_L / ~_R ... ~_3_L / _R
 +
| align="left" |Drehzahl des jeweiligen Rades
 +
| align="left" |Umdrehungen pro Minute
 +
| align="left" |X
 +
|-
 +
| align="left" |Axle_Suspension_0_L / ~_R ... ~_3_L / _R
 +
| align="left" |Einfederungsweg des jeweiligen Rades
 +
| align="left" |m
 +
| align="left" |X
 +
|-
 +
| align="left" |Axle_Steering_0_L / ~_R ... ~_3_L / _R
 +
| align="left" |Lenkwinkel des jeweiligen Rades
 +
| align="left" |[http://de.wikipedia.org/wiki/Radiant_(Einheit) rad]
 +
| align="left" |X
 +
|-
 +
| align="left" |Axle_Springfactor_0_L / ~_R ... ~_3_L / _R
 +
| align="left" |Faktor, mit dem radweise die Federstärke angepasst werden kann, z.B. um Luftfederungen zu simulieren.
 +
| align="left" |0 = keine, 1 = normale, 2 = doppelte Federkraft
 +
| align="left" |
 +
|-
 +
| align="left" |Axle_Brakeforce_0_L / ~_R ... ~_3_L / _R
 +
| align="left" |Ermöglicht Setzen der Bremskraft pro Rad. Sollte nicht gleichzeitig mit ''Brakeforce'' verwendet werden!
 +
| align="left" |[http://de.wikipedia.org/wiki/Newton_(Einheit) N]
 +
| align="left" |
 +
|-
 +
| align="left" |Debug_0 ... _5
 +
| align="left" |Debug-Variablen. Können im Debug-Modus in der Informationsleiste angezeigt werden, um auf diese Weise die Scripts zu testen.
 +
| align="left" |bliebig
 +
| align="left" |
 +
|-
 +
| align="left" |A_Trans_X ... _Z
 +
| align="left" |Beschleunigungen im Fahrzeug, die durch die Fahrzeugbewegungen ausgelöst werden (beim Bremsen oder bei Kurvenfahrten usw.)
 +
| align="left" |m/s²
 +
| align="left" |X
 +
|-
 +
| align="left" |AI_Blinker_L, ~_R
 +
| align="left" |Linker oder rechter Blinker aktiv
 +
| align="left" |0: aus, 1: ein
 +
| align="left" |(X)<ref group="roadvars">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.</ref>
 +
|-
 +
| align="left" |AI_Light
 +
| align="left" |Fahrlicht, Standlicht, Lichthupe
 +
| align="left" |0: Licht aus, 0.5: Standlicht an, 1: Fahrlicht an, 2: Fernlicht/Lichthupe an
 +
| align="left" |(X)
 +
|-
 +
| align="left" |
 +
| align="left" |
 +
| align="left" |
 +
| align="left" |
 +
|-
 +
| align="left" |
 +
| align="left" |
 +
| align="left" |
 +
| align="left" |
 +
|-
 +
| align="left" |
 +
| align="left" |
 +
| align="left" |
 +
| align="left" |
 +
|}
 +
 +
<references group="roadvars" />
  
 
[[Kategorie:Nachschlagewerk für Addon-Entwickler]]
 
[[Kategorie:Nachschlagewerk für Addon-Entwickler]]

Version vom 11. September 2011, 11:52 Uhr

Hinweis: Dieser Artikel wurde noch nicht ins Englische übersetzt!

Hinweis: Dieser Artikel befindet sich noch im Aufbau!

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
NightLightA Ist die Nachtbeleuchtung aktiv? 0 = aus, 1 = an
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
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
TrafficLightApproach Hierüber kann das Script eine Ampelanforderung erkennen und bspw. eine Kennleuchte aktiviert werden. 0 = keine Anforderung, 1 = Anforderung
Colorscheme (veraltet) (-)
Signal Hierüber erhalten Signale ihr anzuzeigendes Signalbild individuell
NextSignal Hierüber erhalten Signale mit Vorsignalfunktion das anzuzeigende Signalbild des nächsten Signals individuell
Signal Hierüber erhalten Signale ihr anzuzeigendes Signalbild individuell
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

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)<ref group="roadvars">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.</ref>
AI_Light Fahrlicht, Standlicht, Lichthupe 0: Licht aus, 0.5: Standlicht an, 1: Fahrlicht an, 2: Fernlicht/Lichthupe an (X)

<references group="roadvars" />