Difference between revisions of "Documentation/Engine/Truck Interior Animations and IDs"

From SCS Modding Wiki
Jump to navigation Jump to search
(→‎Stick Animations)
 
(58 intermediate revisions by 4 users not shown)
Line 1: Line 1:
 
==Interior Animations==
 
==Interior Animations==
  
−
For movement of various things in truck interior are used program driven animations ( '''_anim''' ). For each animation can be set range by '''*_anim_min''' and '''*_anim_max''' values. As most animations expect range from 0 to 1, this are also default values. If animation expect any other value range it will be stated below.
+
The movement of various things in the truck interior is controlled by program-driven animations ( '''*_anim''' ). For each animation, the range is set by the '''*_anim_min''' and '''*_anim_max''' values. As most animations expect a range from 0 to 1, these are also the default values. If an animation expects any other value range, it will be stated below.
  
 
===Special Animations===
 
===Special Animations===
Line 14: Line 14:
 
|Steering wheel
 
|Steering wheel
 
|0 - left full lock<br />0.5 - center<br />1 - right full lock
 
|0 - left full lock<br />0.5 - center<br />1 - right full lock
−
|For best results, each keyframe should be less than 45°<br />The steering wheel bone should be named '''steering_w''' for compatibility with [[Games/ETS2/Modding_guides/1.25#Steering_wheel_accessory|interchangeable steering wheels]].
+
|''(Obsolete in 1.42)''<br><br>For best results, each keyframe should be less than 45°<br />The steering wheel bone should be named '''steering_w''' for compatibility with [[Games/ETS2/Modding_guides/1.25#Steering_wheel_accessory|interchangeable steering wheels]].
 
|-
 
|-
 
|wheel_updown_anim
 
|wheel_updown_anim
Line 33: Line 33:
 
|gadget_anim
 
|gadget_anim
 
|
 
|
−
|
+
|0&rarr;1 is a full animation cycle<br />(animation will be played as a continuous loop)
−
|
+
|This animation is played in a loop while the truck's ignition/electricity is on.
 +
|-
 +
|left_window_anim
 +
|Left window up/down animation
 +
|0 - closed<br />1 - open
 +
|Controlled with window up/down controls.
 +
|-
 +
|right_window_anim
 +
|Right window up/down animation
 +
|0 - closed<br />1 - open
 +
|Controlled with window up/down controls.
 
|}
 
|}
  
Line 78: Line 88:
 
|-
 
|-
 
|'''Europe:'''
 
|'''Europe:'''
 +
|-
 +
|parking_stick_electric_anim
 +
|Parking brake control
 +
|0 - parking brake releasing<br />0.5 - parking brake mid/neutral/return position<br />1 - parking brake application
 +
|Electronic version of parking brake. It is clicked to some position and then returns automatically to default position (games handles return proceduraly).
 
|-
 
|-
 
|flasher_4way_anim
 
|flasher_4way_anim
Line 114: Line 129:
 
1 - maximum setting
 
1 - maximum setting
 
|
 
|
 +
|-
 +
|engine_brake_stick_anim
 +
|Engine brake control
 +
|0 - off
 +
1 - maximum setting
 +
|''Added in 1.38''
 
|-
 
|-
 
|auto_transmission_stick_anim
 
|auto_transmission_stick_anim
Line 123: Line 144:
 
|Lift axle switch/control
 
|Lift axle switch/control
 
|
 
|
 +
|
 +
|-
 +
|differential_lock_stick_anim
 +
|Differential lock switch/control
 +
|0 - disengaged<br />1 - engaged
 +
|''Added in ETS2 1.27/ATS 1.6''
 +
|-
 +
|left_window_stick_anim
 +
|Left window switch/control
 +
|0 - closing<br />0.5 - rest position<br />1 - opening
 +
|
 +
|-
 +
|right_window_stick_anim
 +
|Right window switch/control
 +
|0 - closing<br />0.5 - rest position<br />1 - opening
 
|
 
|
 
|}
 
|}
 +
 
===Gauge animations===
 
===Gauge animations===
 
This set of animations handles analog gauges. The related '''*_min''' and '''*_max''' attributes set the values that the start and end of the animation correspond to. Where the simulated value exceeds the min/max attribute, the animation is clamped.
 
This set of animations handles analog gauges. The related '''*_min''' and '''*_max''' attributes set the values that the start and end of the animation correspond to. Where the simulated value exceeds the min/max attribute, the animation is clamped.
 +
{{Note|All '''*_psi_*''' attributes have been renamed to '''*_pressure_*''' as of ETS2 1.27/ATS 1.6. This is to reflect the change to ''bar'' (atmospheres) as the working pressure unit instead of ''psi''.}}
 
{| class="wikitable"
 
{| class="wikitable"
 
!Attribute Name
 
!Attribute Name
Line 133: Line 171:
 
!Notes
 
!Notes
 
|-
 
|-
−
|oil_psi_anim
+
|oil_pressure_anim
−
|Engine oil pressure in pounds per square inch (psi)
+
|Engine oil pressure (bar)
−
|0 - oil_psi_anim_min
+
|0 - oil_pressure_anim_min
−
1 - oil_psi_anim_max
+
1 - oil_pressure_anim_max
−
|40-90 psi is typical working value
+
|3-6 bars (43.5-87 psi) is typical working value
 
|-
 
|-
 
|water_temp_anim
 
|water_temp_anim
Line 146: Line 184:
 
|-
 
|-
 
|battery_anim
 
|battery_anim
−
|Battery potential in volts
+
|Battery potential (V)
 
|0 - battery_anim_min
 
|0 - battery_anim_min
 
1 - battery_anim_max
 
1 - battery_anim_max
Line 156: Line 194:
 
1 - oil_temp_anim_max
 
1 - oil_temp_anim_max
 
|working value 90°C
 
|working value 90°C
 +
|-
 +
|exhaust_temp_anim
 +
|Exhaust gas temperature (°C)
 +
|0 - exhaust_temp_anim_min
 +
1 - exhaust_temp_anim_max
 +
|working range cca to 650°C
 
|-
 
|-
 
|diff_temp_anim
 
|diff_temp_anim
Line 175: Line 219:
 
|1mph = 1.60934km/h
 
|1mph = 1.60934km/h
 
|-
 
|-
−
|air_psi_anim
+
|air_pressure_anim
−
|Air brake reservoir pressure in psi (pounds per square inch)
+
|Air brake reservoir pressure (bar)
−
|0 - air_psi_anim_min
+
|0 - air_pressure_anim_min
−
1 - air_psi_anim_max
+
1 - air_pressure_anim_max
−
|working value 140 psi
+
|
 +
|-
 +
|brake_pressure_anim
 +
|Air brake application (bar)
 +
|0 - brake_pressure_anim_min
 +
1 - brake_pressure_anim_max
 +
|
 +
|-
 +
|general_air_press_anim
 +
|General air supply (bar)
 +
|0 - general_air_press_anim_min
 +
1 - general_air_press_anim_max
 +
|
 
|-
 
|-
−
|brake_psi_anim
+
|trailer_air_press_anim
−
|Air brake application
+
|Trailer air supply (bar)
 +
|0 - trailer_air_press_anim_min
 +
1 - trailer_air_press_anim_max
 
|
 
|
−
|range is 0 to 1, maximum pressure value should be equivalent of 60-70 psi
 
 
|-
 
|-
 
|suspension_load_anim
 
|suspension_load_anim
−
|Suspension load in newtons
+
|Suspension load (newtons)
 
|0 - suspension_load_anim_min
 
|0 - suspension_load_anim_min
 
1 - suspension_load_anim_max
 
1 - suspension_load_anim_max
Line 217: Line 274:
 
|clock_big_anim
 
|clock_big_anim
 
|Analog clock, minute hand (0-60)
 
|Analog clock, minute hand (0-60)
−
|
+
|0 - clock_big_anim_min (default 0)
 +
1 - clock_big_anim_max (default 60)
 
|
 
|
 
|-
 
|-
 
|clock_small_anim
 
|clock_small_anim
 
|Analog clock, hour hand (0-12)
 
|Analog clock, hour hand (0-12)
−
|
+
|0 - clock_small_anim_min (default 0)
 +
1 - clock_small_anim_max (default 24)
 
|
 
|
 
|-
 
|-
 
|generic_anim
 
|generic_anim
 
|Animation for other gauges.  
 
|Animation for other gauges.  
−
|0 when truck is turned off<br />1 when truck is turned on
+
|0 when truck is turned off
 +
1 when truck is turned on
 
|
 
|
 
|}
 
|}
 +
 
===Indicator animations===
 
===Indicator animations===
  
−
These animations are not interpolated from 0 to 1 rather they have only 2 states: switched off and switched on. So this animations should have only 2 key frames.
+
These animations are not interpolated from 0 to 1. Instead they have only 2 states: switched off (0) and switched on (1), so these animations should have only 2 key frames. All indicator animations are triggered during the start-up electrical check, as well as for their particular functions.
  
−
* button_left_blinker
+
{| class="wikitable"
−
* button_right_blinker
+
!Attribute Name
−
* blinker_delay - this is not animation, but value describing length of half blinking loop
+
!Function
−
* button_water_temp
+
!Behavior
−
* indicator_oil_temp
+
!Notes
−
* indicator_position_lights
+
|-
−
* button_lights
+
|button_left_blinker
−
* button_high_beam_lights
+
|Left turn signal indicator
−
* indicator_aux_lights_front
+
|rowspan="2"|Flashes on and off with left/right turn signal
−
* indicator_aux_lights_roof
+
|rowspan="2"|The related attribute '''blinker_delay''' is describing length of the half blinking loop (in seconds)
−
* indicator_aux_lights_any
+
|-
−
* button_low_air_psi
+
|button_right_blinker
−
* button_low_oil_psi
+
|Right turn signal indicator
−
* button_battery_warning
+
|-
−
* button_low_fuel
+
|button_water_temp
−
* indicator_low_adblue
+
|Water temperature warning light
−
* button_jakebrake
+
|On when engine temperature is excessive
−
* button_parking_brake
+
|
−
* button_4way - indicator should be placed on hazard warning button for blinking
+
|-
−
* button_abs
+
|indicator_oil_temp
−
* button_bbw
+
|Engine oil temperature warning light
−
* button_avi
+
|On when engine oil temperature is excessive
−
* indicator_retarder
+
|
−
* indicator_warning - damage warning indicator
+
|-
−
* indicator_stop - critical damage indicator
+
|indicator_position_lights
−
* indicator_axle_lift - lifted axle indicator
+
|Position light indicator
−
* indicator_cruise_control
+
|On when positional/marker/parking lights are on
−
* indicator_generic - animation for other indicator. 0 most of the time, 1 when truck is making electricity check (after turned on).
+
|
 +
|-
 +
|button_lights
 +
|Headlight indicator
 +
|On when headlights are on
 +
|
 +
|-
 +
|button_high_beam_lights
 +
|Highbeam indicator
 +
|On when highbeam headlights are on
 +
|
 +
|-
 +
|indicator_aux_lights_front
 +
|Front auxiliary lights indicator
 +
|On when ''front'' auxiliary lights are on
 +
|
 +
|-
 +
|indicator_aux_lights_roof
 +
|Roof auxiliary lights indicator
 +
|On when ''roof'' auxiliary lights are on
 +
|
 +
|-
 +
|indicator_aux_lights_any
 +
|Auxiliary lights indicator
 +
|On when any auxiliary lights are on
 +
|
 +
|-
 +
|indicator_low_air_pressure
 +
|Low air pressure warning light
 +
|On when air pressure drops below cca 5 bars
 +
|
 +
|-
 +
|indicator_low_oil_pressure
 +
|Low oil pressure warning light
 +
|On when engine oil pressure is low
 +
|This will also illuminate when the electrical is on and the engine is off
 +
|-
 +
|button_battery_warning
 +
|Low battery voltage warning light
 +
|On when battery voltage is low
 +
|
 +
|-
 +
|button_low_fuel
 +
|Low fuel warning light
 +
|On when fuel level is low
 +
|
 +
|-
 +
|indicator_low_adblue
 +
|Low AdBlue/DEF warning light
 +
|On when AdBlue/DEF level is low
 +
|
 +
|-
 +
|button_jakebrake
 +
|Engine brake indicator light
 +
|On when engine brake (jake brake) is armed or active
 +
|
 +
|-
 +
|button_parking_brake
 +
|Parking brake indicator light
 +
|On when parking brake is applied
 +
|
 +
|-
 +
|button_4way
 +
|Four-way flasher status light
 +
|On when four-way flasher is on
 +
|Indicator should be placed on hazard warning button for blinking
 +
|-
 +
|indicator_retarder
 +
|Retarder status light
 +
|On when the retarder is active
 +
|
 +
|-
 +
|indicator_warning
 +
|Damage warning indicator
 +
|On when damage is 15% or more
 +
|
 +
|-
 +
|indicator_stop
 +
|Critical damage indicator
 +
|On when damage is 50% or more
 +
|
 +
|-
 +
|indicator_axle_lift
 +
|Lift axle indicator
 +
|On when lift axle is up
 +
|
 +
|-
 +
|indicator_cruise_control
 +
|Cruise control status light
 +
|On when cruise control is engaged
 +
|
 +
|-
 +
|indicator_generic
 +
|Animation for other indicators
 +
|0 most of the time, 1 when truck is making electricity check (after turned on).
 +
|
 +
|-
 +
|indicator_differential_lock
 +
|Differential lock status light
 +
|On when differential lock is engaged
 +
|''Added in ETS2 1.27/ATS 1.6''
 +
|-
 +
|indicator_trailer_axle_lift
 +
|Trailer lift axle status light
 +
|On when trailer axle(s) are raised.
 +
|''Added in ETS2 1.27/ATS 1.6''
 +
|-
 +
|indicator_weigh_green
 +
|(ATS) Weigh pass transponder green (bypass) light
 +
|On when the player may bypass an upcoming weigh station
 +
|''Added in ETS2 1.27/ATS 1.6''
 +
|-
 +
|indicator_weigh_red
 +
|(ATS) Weigh pass transponder red (no bypass) light
 +
|On when the player must enter an upcoming weigh station
 +
|''Added in ETS2 1.27/ATS 1.6''
 +
|-
 +
|indicator_blind_spot_left
 +
|Left blind spot indicator
 +
|On when some vehicle is near left blind spot of player vehicle
 +
|''Added in ETS2 1.47/ATS 1.45''
 +
|-
 +
|indicator_blind_spot_right
 +
|Right blind spot indicator
 +
|On when some vehicle is near right blind spot of player vehicle
 +
|''Added in ETS2 1.47/ATS 1.45''
 +
|}
  
 
==Dashboards IDs==
 
==Dashboards IDs==
Line 279: Line 466:
 
* 1020 - current speed
 
* 1020 - current speed
 
* 1030 - odometer, needs space for at least six digits
 
* 1030 - odometer, needs space for at least six digits
−
* 1040 - current gear, uses N, D[number], R or R[number] for automatic and N, [number], R or R[number] for maual
+
* 1040 - current gear, uses N, A[number], R or R[number] for automatic and N, [number], R or R[number] for manual or sequential
−
* 1050 - current clock time in proper format, eg. "12:34 pm"
+
* 1050 - current clock time in proper format, eg. "12:34" (am/pm is omitted)
 
* 1060 - remaining fuel in tank
 
* 1060 - remaining fuel in tank
−
* 1070 - ui::text for fuel bar, the text is cut left-to-right according to current fuel tank state
+
* 1070 - ui_text_bar  for fuel bar, the text is cut according to current fuel tank state
−
* 1075 - ui::text that defines size, orientation and range of fuel bar
+
* 1075 - ''(obsolete in 1.49)'' ui::text that defines size, orientation and range of fuel bar (typical data "H~~0~~1", horizontal range 0 to 1)
 
* 1080 - guessed operating range of vehicle
 
* 1080 - guessed operating range of vehicle
 
* 1090 - water temperature
 
* 1090 - water temperature
 
* 1100 - cruise control speed value
 
* 1100 - cruise control speed value
−
* 1110 - ui::text for oil pressure bar, the text is cut according to current oil pressure
+
* 1110 - ui_text_bar for oil pressure bar, the text is cut according to current oil pressure
−
* 1115 - ui::text that defines size, orientation and range of oil pressure bar (typical data "H~~0~~116", horizontal range 0psi to 116psi (8bar))
+
* 1115 - ''(obsolete in 1.49)'' ui::text that defines size, orientation and range of oil pressure bar (typical data "H~~0~~8", horizontal range 0bar to 8bar (116psi))
−
* 1120 - ui::text for air pressure bar, the text is cut according to current air pressure
+
* 1120 - ui_text_bar for air pressure bar, the text is cut according to current air pressure
−
* 1125 - ui::text that defines size, orientation and range of air pressure bar (typical data "H~~0~~174", horizontal range 0psi to 174psi (12bar))
+
* 1125 - ''(obsolete in 1.49)'' ui::text that defines size, orientation and range of air pressure bar (typical data "H~~0~~12", horizontal range 0bar to 12bar (174psi))
−
* 1130 - ui::text for turbo pressure bar, the text is cut according to current oil pressure
+
* 1130 - ui_text_bar for turbo pressure bar, the text is cut according to current oil pressure
−
* 1135 - ui::text that defines size, orientation and range of turbo pressure bar (typical data "H~~0~~1", horizontal range 0 to 1)
+
* 1135 - ''(obsolete in 1.49)'' ui::text that defines size, orientation and range of turbo pressure bar (typical data "H~~0~~1", horizontal range 0 to 1)
−
* 1140 - ui::text for adblue bar, the text is cut according to current adblue tank state
+
* 1140 - ui_text_bar for adblue bar, the text is cut according to current adblue tank state
−
* 1145 - ui::text that defines size, orientation and range of adblue bar
+
* 1145 - ''(obsolete in 1.49)'' ui::text that defines size, orientation and range of adblue bar (typical data "H~~0~~1", horizontal range 0 to 1)
−
* 1150 - ui::text for water temperature bar, the text is cut according to current water temperature
+
* 1150 - ui_text_bar for water temperature bar, the text is cut according to current water temperature
−
* 1155 - ui::text that defines size, orientation and range of water temperature bar (typical data "H~~0~~130", horizontal range 0*C to 130*C)
+
* 1155 - ''(obsolete in 1.49)'' ui::text that defines size, orientation and range of water temperature bar (typical data "H~~0~~130", horizontal range 0°C to 130°C (32°F to 266°F))
 
* 1160 - instant consumption
 
* 1160 - instant consumption
 
* 1170 - average (trip) consumption
 
* 1170 - average (trip) consumption
−
* 1180 - unused
+
* 1180 - ui_text_bar for brake pedal pressure bar, the text is cut according to current pressure
−
* 1185 - unused
+
* 1185 - ''(obsolete in 1.49)'' ui::text that defines size, orientation and range of brake pedal pressure bar (typical data "H~~0~~1", horizontal range 0 to 1)
 
* 1190 - damage warning icon, can be ui::group or ui::text or any other element that could show/hide
 
* 1190 - damage warning icon, can be ui::group or ui::text or any other element that could show/hide
 
* 1200 - low fuel warning icon, can be ui::group or ui::text or any other element that could show/hide
 
* 1200 - low fuel warning icon, can be ui::group or ui::text or any other element that could show/hide
Line 306: Line 493:
 
* 1220 - compass, displays strings like "N", "E", "SW".
 
* 1220 - compass, displays strings like "N", "E", "SW".
 
* 1230 - engine brake icon
 
* 1230 - engine brake icon
−
* 1240 - cruise control icon, can be ui::group or ui::text or any other element that could show/hide. Cruise control speed ( 1100) explicitly CAN be child of this group.
+
* 1240 - cruise control icon, can be ui::group or ui::text or any other element that could show/hide. Cruise control speed (id 1100) explicitly CAN be child of this group.
 
* 1250 - cruise control memory icon, can be ui::group or ui::text or any other element that could show/hide.
 
* 1250 - cruise control memory icon, can be ui::group or ui::text or any other element that could show/hide.
 +
* 1260 - low air pressure warning icon
 +
* 1270 - parking brake indicator icon
 +
* 1280 - engine running time
 +
* 1290 - retarder icon
 +
* 1300 - transmission gear (raw, without mode info)
 +
* 1310 - transmission mode (without gear info, A/M)
 +
* 1320 - battery voltage
 +
* 1330 - battery voltage gauge, expected to be ui_gauge element type
 +
* 1340 - oil temperature gauge, expected to be ui_gauge element type
 +
* 1350 - ui_text_bar for instant fuel economy bar, the text is cut according to current value
 +
* 1355 - ''(obsolete in 1.49)'' ui::text that defines size, orientation and range of instant fuel economy bar (typical data "H~~0~~5", horizontal range 0 to 5 km/l (11.8mpg))
 +
* 1360 - ui_text_bar for average fuel economy bar, the text is cut according to current value
 +
* 1365 - ''(obsolete in 1.49)'' ui::text that defines size, orientation and range of average fuel economy bar (typical data "H~~0~~5", horizontal range 0 to 5 km/l (11.8mpg))
 +
* 1370 - air pressure value (psi only)
 +
* 1380 - transmission mode, detailed (D/N/R/M)
 +
* 1390 - trip time
 +
* 1400 - trip average speed (trip distance / trip time)
 +
* 1410 - smart cruise control tolerance if CC is engaged, otherwise hides the element
 +
* 1420 - damage stop icon, can be ui::group or ui::text or any other element that could show/hide
 +
* 1430 - speed gauge, expected to be ui_gauge element type
 +
* 1440 - revolutions per minute (rpm) gauge, expected to be ui_gauge element type
 +
* 1450 - cruise control speed gauge, expected to be ui_gauge element type
 +
* 1460 - water temperature gauge, expected to be ui_gauge element type
 +
* 1470 - parking lights icon, can be ui::group or ui::text or any other element that could show/hide
 +
* 1480 - low beam lights icon, can be ui::group or ui::text or any other element that could show/hide
 +
* 1490 - differential lock icon, can be ui::group or ui::text or any other element that could show/hide
 +
* 1500 - fuel consumed since last trip computer reset
 +
* 1510 - remaining fuel in tank percent (range 0-100)
 +
* 1520 - remaining adblue in tank percent (range 0-100)
 +
* 1530 - ETA (estimated time to arrival), hidden when time is not available (no delivery, no navigation etc.)
 +
* 1540 - time until rest is needed, hidden when g_fatigue is 0 (fatigue option is disabled)
 +
* 1550 - ui_text_bar for differential temperature bar, the text is cut according to current value
 +
* 1555 - ''(obsolete in 1.49)'' ui::text that defines size, orientation and range of differential temperature bar (typical data "H~~0~~130", horizontal range 0°C to 130°C (32°F to 266°F))
 +
* 1560 - ui_text_bar for suspension load bar, the text is cut according to current value
 +
* 1565 - ''(obsolete in 1.49)'' ui::text that defines size, orientation and range of suspension load bar (typical data "H~~0~~100000", horizontal range 0 to 100kN)
 +
* 1570 - left blinker icon
 +
* 1580 - right blinker icon
 +
* 1590 - high beam icon
 +
* 1600 - ui_text_bar for oil temperature bar, the text is cut according to current value
 +
* 1605 - ''(obsolete in 1.49)'' ui::text that defines size, orientation and range of oil temperature bar (typical data "H~~0~~130", horizontal range 0°C to 130°C (32°F to 266°F))
 +
* 1610 - speed limit
 +
* 1620 - digital main mirrors, can be any element that can show/hide (shown when digital main mirrors are detected by the main mirrors using camera unit prefix)
 +
* 1630 - digital side mirror, can be any element that can show/hide (shown when digital side mirror is detected by the side mirror using camera unit prefix)
 +
* 1640 - digital front mirror, can be any element that can show/hide (shown when digital front mirror is detected by the front mirror using camera unit prefix)
 +
* 1650 - digital hood mirrors, can be any element that can show/hide (shown when digital hood mirror is detected by the hood mirror using camera unit prefix)
 +
* 1660 - close blind spot indicator (side depends on <code>left_hand_traffic</code> interior data attribute), can be any element that can show/hide (shown when obstacle is detected on left side of the vehicle)
 +
* 1670 - far blind spot indicator (side depends on <code>left_hand_traffic</code> interior data attribute), can be any element that can show/hide (shown when obstacle is detected on right side of the vehicle)
 +
* 1680 - trip recuperation (energy returned)
 +
* 1690 - ui_text_bar for power consumption, the text is cut according to current value (specific behavior based on Renaut E-Tech)
 +
* 1700 - ui_text_bar for rpm, the text is cut according to current value
 +
 +
{{Note|In 1.49 text bars were changed to ui_text_bar element. No additional data is needed now, all is kept in regular members (vertical, min_size, max_size, min_value, max_value).
  
−
Data for bars are entered in format "H~~0~~130", H means the bar is horizontal (or V for vertical), leftmost position represents value 0, rightmost position represents value 130. Empty text defaults to "H~~0~~1".
+
Old system (pre 1.49) used secondary text fields. Data for bars were entered in format "H~~0~~130", H means the bar is horizontal (or V for vertical), leftmost position represents value 0, rightmost position represents value 130. Empty text defaults to "H~~0~~1".}}

Latest revision as of 11:58, 19 September 2024

Interior Animations

The movement of various things in the truck interior is controlled by program-driven animations ( *_anim ). For each animation, the range is set by the *_anim_min and *_anim_max values. As most animations expect a range from 0 to 1, these are also the default values. If an animation expects any other value range, it will be stated below.

Special Animations

Attribute Name Function Behavior Notes
wheel_anim Steering wheel 0 - left full lock
0.5 - center
1 - right full lock 		(Obsolete in 1.42)

For best results, each keyframe should be less than 45°
The steering wheel bone should be named steering_w for compatibility with interchangeable steering wheels.
wheel_updown_anim Steering column tilt adjustment 0 - lowest setting
1 - highest setting 		The default position is set by wheel_updown_anim_default
wheel_frontback_anim Steering column telescope adjustment 0 - fully retracted
1 - fully extended 		The default position is set by wheel_frontback_anim_default
wiper_anim Windshield wipers 0→1 is a full wipe cycle
(from park to full travel and back to park) 		The keyframes at 0 and 1 should match.
gadget_anim 0→1 is a full animation cycle
(animation will be played as a continuous loop) 		This animation is played in a loop while the truck's ignition/electricity is on.
left_window_anim Left window up/down animation 0 - closed
1 - open 		Controlled with window up/down controls.
right_window_anim Right window up/down animation 0 - closed
1 - open 		Controlled with window up/down controls.

Stick Animations

Attribute Name Function Behavior Notes
blinker_anim Turn signal control lever 0 - left indicator active
0.5 - rest position
1 - right indicator active
lights_anim Headlight control 0 - lights off
0.5 - parking/clearance lights on
1 - headlights on
high_beam_anim High beam headlight control 0 - rest position
1 - high beams on
light_horn_stick_anim Light/city horn button 0 - rest position
1 - light horn being applied
wiper_stick_anim Windshield wiper control 0 - off
1 - maximum speed 		This animation is interpolated based on the total number of wiper speeds. For example, if there are two additional wiper speeds (delays), 0.33 would correspond with the first and 0.67 with the second delay definition.
parking_stick_anim Parking brake control 0 - parking brake released
1 - parking brake applied 		North America: Whether 'in' or 'out' is the applied state will depend on the truck – make sure that the animation matches the label on the valve or you will look like a goof.

The typical usage is for 'push to release' systems where the 0.0 state is 'in' and the 1.0 state is 'out'.

Europe:
parking_stick_electric_anim Parking brake control 0 - parking brake releasing
0.5 - parking brake mid/neutral/return position
1 - parking brake application 		Electronic version of parking brake. It is clicked to some position and then returns automatically to default position (games handles return proceduraly).
flasher_4way_anim Four-way flasher (hazard light) control 0 - rest position
1 - hazard lights are active 		For a button, the “depressed” state would be 0.5 to make the button press and rebound for both activation and deactivation
engine_start_anim Ignition and starting controls 0 - off
0.33 - electricity on
0.67 - engine on
1 - engine starting
beacon_anim Beacon on/off switch 0 - beacon off

1 - beacon on

trailer_air_stick_anim Trailer air supply valve 0 - trailer disconnected

1 - trailer connected

This is directly tied to whether a trailer is connected to the truck or not.

Typical usage is for a 'push to supply' type, so the valve is 'out' in the 0.0 state and 'in' in the 1.0 state

trailer_brake_stick_anim Trailer brake hand valve

(sometimes called the 'spike')

0 - rest position

1 - trailer brake hand valve fully applied

Do not confuse this with the trailer supply valve - the hand valve is used (rarely) to apply only the trailer brakes in a controlled manner
retarder_stick_anim Retarder control 0 - off

1 - maximum setting

engine_brake_stick_anim Engine brake control 0 - off

1 - maximum setting

Added in 1.38
auto_transmission_stick_anim Automatic transmission gear selector 0 - reverse
0.5 - neutral
1 - drive
lift_axle_stick_anim Lift axle switch/control
differential_lock_stick_anim Differential lock switch/control 0 - disengaged
1 - engaged 		Added in ETS2 1.27/ATS 1.6
left_window_stick_anim Left window switch/control 0 - closing
0.5 - rest position
1 - opening
right_window_stick_anim Right window switch/control 0 - closing
0.5 - rest position
1 - opening

Gauge animations

This set of animations handles analog gauges. The related *_min and *_max attributes set the values that the start and end of the animation correspond to. Where the simulated value exceeds the min/max attribute, the animation is clamped.

Note: All *_psi_* attributes have been renamed to *_pressure_* as of ETS2 1.27/ATS 1.6. This is to reflect the change to bar (atmospheres) as the working pressure unit instead of psi.

Attribute Name Function Behavior Notes
oil_pressure_anim Engine oil pressure (bar) 0 - oil_pressure_anim_min

1 - oil_pressure_anim_max

3-6 bars (43.5-87 psi) is typical working value
water_temp_anim Engine water/coolant temperature (°C) 0 - water_temp_anim_min

1 - water_temp_anim_max

working value 90°C
battery_anim Battery potential (V) 0 - battery_anim_min

1 - battery_anim_max

Nominally 24V. For 12V systems, set the min/max attributes to twice the value the gauge displays and it should appear as if it is indeed a 12V system.
oil_temp_anim Engine oil temperature (°C) 0 - oil_temp_anim_min

1 - oil_temp_anim_max

working value 90°C
exhaust_temp_anim Exhaust gas temperature (°C) 0 - exhaust_temp_anim_min

1 - exhaust_temp_anim_max

working range cca to 650°C
diff_temp_anim Differential temperature (°C) 0 - diff_temp_anim_min

1 - diff_temp_anim_max

working value 90°C
tachometer_anim Tachometer in rpm (revolution per minute) 0 - tachometer_anim_min

1 - tachometer_anim_max

speedometer_anim Speedometer (km/h) 0 - speedometer_anim_min

1 - speedometer_anim_max

1mph = 1.60934km/h
air_pressure_anim Air brake reservoir pressure (bar) 0 - air_pressure_anim_min

1 - air_pressure_anim_max

brake_pressure_anim Air brake application (bar) 0 - brake_pressure_anim_min

1 - brake_pressure_anim_max

general_air_press_anim General air supply (bar) 0 - general_air_press_anim_min

1 - general_air_press_anim_max

trailer_air_press_anim Trailer air supply (bar) 0 - trailer_air_press_anim_min

1 - trailer_air_press_anim_max

suspension_load_anim Suspension load (newtons) 0 - suspension_load_anim_min

1 - suspension_load_anim_max

expects range in newtons (22t trailer creates like 70kN on kingpin)
fuel_anim Fuel gauge (relative to full) 0 - fuel_anim_min

1 - fuel_anim_max

By default, 0 corresponds to empty state and 1 corresponds to full
ad_blue_anim Ad Blue/DEF gauge (relative to full) 0 - fuel_anim_min

1 - fuel_anim_max

By default, 0 corresponds to empty state and 1 corresponds to full
turbo_anim Manifold pressure
consumption_anim Instantaneous fuel consumption in l/100km 0 - consumption_anim_min

1 - consumption_anim_max

scania gauge has 0 to 120
clock_big_anim Analog clock, minute hand (0-60) 0 - clock_big_anim_min (default 0)

1 - clock_big_anim_max (default 60)

clock_small_anim Analog clock, hour hand (0-12) 0 - clock_small_anim_min (default 0)

1 - clock_small_anim_max (default 24)

generic_anim Animation for other gauges. 0 when truck is turned off

1 when truck is turned on

Indicator animations

These animations are not interpolated from 0 to 1. Instead they have only 2 states: switched off (0) and switched on (1), so these animations should have only 2 key frames. All indicator animations are triggered during the start-up electrical check, as well as for their particular functions.

Attribute Name Function Behavior Notes
button_left_blinker Left turn signal indicator Flashes on and off with left/right turn signal The related attribute blinker_delay is describing length of the half blinking loop (in seconds)
button_right_blinker Right turn signal indicator
button_water_temp Water temperature warning light On when engine temperature is excessive
indicator_oil_temp Engine oil temperature warning light On when engine oil temperature is excessive
indicator_position_lights Position light indicator On when positional/marker/parking lights are on
button_lights Headlight indicator On when headlights are on
button_high_beam_lights Highbeam indicator On when highbeam headlights are on
indicator_aux_lights_front Front auxiliary lights indicator On when front auxiliary lights are on
indicator_aux_lights_roof Roof auxiliary lights indicator On when roof auxiliary lights are on
indicator_aux_lights_any Auxiliary lights indicator On when any auxiliary lights are on
indicator_low_air_pressure Low air pressure warning light On when air pressure drops below cca 5 bars
indicator_low_oil_pressure Low oil pressure warning light On when engine oil pressure is low This will also illuminate when the electrical is on and the engine is off
button_battery_warning Low battery voltage warning light On when battery voltage is low
button_low_fuel Low fuel warning light On when fuel level is low
indicator_low_adblue Low AdBlue/DEF warning light On when AdBlue/DEF level is low
button_jakebrake Engine brake indicator light On when engine brake (jake brake) is armed or active
button_parking_brake Parking brake indicator light On when parking brake is applied
button_4way Four-way flasher status light On when four-way flasher is on Indicator should be placed on hazard warning button for blinking
indicator_retarder Retarder status light On when the retarder is active
indicator_warning Damage warning indicator On when damage is 15% or more
indicator_stop Critical damage indicator On when damage is 50% or more
indicator_axle_lift Lift axle indicator On when lift axle is up
indicator_cruise_control Cruise control status light On when cruise control is engaged
indicator_generic Animation for other indicators 0 most of the time, 1 when truck is making electricity check (after turned on).
indicator_differential_lock Differential lock status light On when differential lock is engaged Added in ETS2 1.27/ATS 1.6
indicator_trailer_axle_lift Trailer lift axle status light On when trailer axle(s) are raised. Added in ETS2 1.27/ATS 1.6
indicator_weigh_green (ATS) Weigh pass transponder green (bypass) light On when the player may bypass an upcoming weigh station Added in ETS2 1.27/ATS 1.6
indicator_weigh_red (ATS) Weigh pass transponder red (no bypass) light On when the player must enter an upcoming weigh station Added in ETS2 1.27/ATS 1.6
indicator_blind_spot_left Left blind spot indicator On when some vehicle is near left blind spot of player vehicle Added in ETS2 1.47/ATS 1.45
indicator_blind_spot_right Right blind spot indicator On when some vehicle is near right blind spot of player vehicle Added in ETS2 1.47/ATS 1.45

Dashboards IDs

Screen of dashboard computers uses our UI library and shows thus UI elements. Each element has unique ID and can be used only once (due to caching). Most of fields can be used as two parameter template - value and unit, both are used accordingly to current game options. As in different languages can be units and other texts translated ensure that there are enough space for all of them.

Screen IDs ( ui::group type):

  • 100 to 800 - basic screens, up to 8 screens
  • 900 - warning screen, used when truck is damage and should be repaired, shown alone (without shared screen)
  • 950 - shared screen (used together with all basic screens)

Element IDs (mostly ui::text_common type):

  • 1000 - ambient temperature
  • 1010 - oil temperature
  • 1020 - current speed
  • 1030 - odometer, needs space for at least six digits
  • 1040 - current gear, uses N, A[number], R or R[number] for automatic and N, [number], R or R[number] for manual or sequential
  • 1050 - current clock time in proper format, eg. "12:34" (am/pm is omitted)
  • 1060 - remaining fuel in tank
  • 1070 - ui_text_bar for fuel bar, the text is cut according to current fuel tank state
  • 1075 - (obsolete in 1.49) ui::text that defines size, orientation and range of fuel bar (typical data "H~~0~~1", horizontal range 0 to 1)
  • 1080 - guessed operating range of vehicle
  • 1090 - water temperature
  • 1100 - cruise control speed value
  • 1110 - ui_text_bar for oil pressure bar, the text is cut according to current oil pressure
  • 1115 - (obsolete in 1.49) ui::text that defines size, orientation and range of oil pressure bar (typical data "H~~0~~8", horizontal range 0bar to 8bar (116psi))
  • 1120 - ui_text_bar for air pressure bar, the text is cut according to current air pressure
  • 1125 - (obsolete in 1.49) ui::text that defines size, orientation and range of air pressure bar (typical data "H~~0~~12", horizontal range 0bar to 12bar (174psi))
  • 1130 - ui_text_bar for turbo pressure bar, the text is cut according to current oil pressure
  • 1135 - (obsolete in 1.49) ui::text that defines size, orientation and range of turbo pressure bar (typical data "H~~0~~1", horizontal range 0 to 1)
  • 1140 - ui_text_bar for adblue bar, the text is cut according to current adblue tank state
  • 1145 - (obsolete in 1.49) ui::text that defines size, orientation and range of adblue bar (typical data "H~~0~~1", horizontal range 0 to 1)
  • 1150 - ui_text_bar for water temperature bar, the text is cut according to current water temperature
  • 1155 - (obsolete in 1.49) ui::text that defines size, orientation and range of water temperature bar (typical data "H~~0~~130", horizontal range 0°C to 130°C (32°F to 266°F))
  • 1160 - instant consumption
  • 1170 - average (trip) consumption
  • 1180 - ui_text_bar for brake pedal pressure bar, the text is cut according to current pressure
  • 1185 - (obsolete in 1.49) ui::text that defines size, orientation and range of brake pedal pressure bar (typical data "H~~0~~1", horizontal range 0 to 1)
  • 1190 - damage warning icon, can be ui::group or ui::text or any other element that could show/hide
  • 1200 - low fuel warning icon, can be ui::group or ui::text or any other element that could show/hide
  • 1210 - trip distance
  • 1220 - compass, displays strings like "N", "E", "SW".
  • 1230 - engine brake icon
  • 1240 - cruise control icon, can be ui::group or ui::text or any other element that could show/hide. Cruise control speed (id 1100) explicitly CAN be child of this group.
  • 1250 - cruise control memory icon, can be ui::group or ui::text or any other element that could show/hide.
  • 1260 - low air pressure warning icon
  • 1270 - parking brake indicator icon
  • 1280 - engine running time
  • 1290 - retarder icon
  • 1300 - transmission gear (raw, without mode info)
  • 1310 - transmission mode (without gear info, A/M)
  • 1320 - battery voltage
  • 1330 - battery voltage gauge, expected to be ui_gauge element type
  • 1340 - oil temperature gauge, expected to be ui_gauge element type
  • 1350 - ui_text_bar for instant fuel economy bar, the text is cut according to current value
  • 1355 - (obsolete in 1.49) ui::text that defines size, orientation and range of instant fuel economy bar (typical data "H~~0~~5", horizontal range 0 to 5 km/l (11.8mpg))
  • 1360 - ui_text_bar for average fuel economy bar, the text is cut according to current value
  • 1365 - (obsolete in 1.49) ui::text that defines size, orientation and range of average fuel economy bar (typical data "H~~0~~5", horizontal range 0 to 5 km/l (11.8mpg))
  • 1370 - air pressure value (psi only)
  • 1380 - transmission mode, detailed (D/N/R/M)
  • 1390 - trip time
  • 1400 - trip average speed (trip distance / trip time)
  • 1410 - smart cruise control tolerance if CC is engaged, otherwise hides the element
  • 1420 - damage stop icon, can be ui::group or ui::text or any other element that could show/hide
  • 1430 - speed gauge, expected to be ui_gauge element type
  • 1440 - revolutions per minute (rpm) gauge, expected to be ui_gauge element type
  • 1450 - cruise control speed gauge, expected to be ui_gauge element type
  • 1460 - water temperature gauge, expected to be ui_gauge element type
  • 1470 - parking lights icon, can be ui::group or ui::text or any other element that could show/hide
  • 1480 - low beam lights icon, can be ui::group or ui::text or any other element that could show/hide
  • 1490 - differential lock icon, can be ui::group or ui::text or any other element that could show/hide
  • 1500 - fuel consumed since last trip computer reset
  • 1510 - remaining fuel in tank percent (range 0-100)
  • 1520 - remaining adblue in tank percent (range 0-100)
  • 1530 - ETA (estimated time to arrival), hidden when time is not available (no delivery, no navigation etc.)
  • 1540 - time until rest is needed, hidden when g_fatigue is 0 (fatigue option is disabled)
  • 1550 - ui_text_bar for differential temperature bar, the text is cut according to current value
  • 1555 - (obsolete in 1.49) ui::text that defines size, orientation and range of differential temperature bar (typical data "H~~0~~130", horizontal range 0°C to 130°C (32°F to 266°F))
  • 1560 - ui_text_bar for suspension load bar, the text is cut according to current value
  • 1565 - (obsolete in 1.49) ui::text that defines size, orientation and range of suspension load bar (typical data "H~~0~~100000", horizontal range 0 to 100kN)
  • 1570 - left blinker icon
  • 1580 - right blinker icon
  • 1590 - high beam icon
  • 1600 - ui_text_bar for oil temperature bar, the text is cut according to current value
  • 1605 - (obsolete in 1.49) ui::text that defines size, orientation and range of oil temperature bar (typical data "H~~0~~130", horizontal range 0°C to 130°C (32°F to 266°F))
  • 1610 - speed limit
  • 1620 - digital main mirrors, can be any element that can show/hide (shown when digital main mirrors are detected by the main mirrors using camera unit prefix)
  • 1630 - digital side mirror, can be any element that can show/hide (shown when digital side mirror is detected by the side mirror using camera unit prefix)
  • 1640 - digital front mirror, can be any element that can show/hide (shown when digital front mirror is detected by the front mirror using camera unit prefix)
  • 1650 - digital hood mirrors, can be any element that can show/hide (shown when digital hood mirror is detected by the hood mirror using camera unit prefix)
  • 1660 - close blind spot indicator (side depends on left_hand_traffic interior data attribute), can be any element that can show/hide (shown when obstacle is detected on left side of the vehicle)
  • 1670 - far blind spot indicator (side depends on left_hand_traffic interior data attribute), can be any element that can show/hide (shown when obstacle is detected on right side of the vehicle)
  • 1680 - trip recuperation (energy returned)
  • 1690 - ui_text_bar for power consumption, the text is cut according to current value (specific behavior based on Renaut E-Tech)
  • 1700 - ui_text_bar for rpm, the text is cut according to current value

Note: In 1.49 text bars were changed to ui_text_bar element. No additional data is needed now, all is kept in regular members (vertical, min_size, max_size, min_value, max_value).

Old system (pre 1.49) used secondary text fields. Data for bars were entered in format "H~~0~~130", H means the bar is horizontal (or V for vertical), leftmost position represents value 0, rightmost position represents value 130. Empty text defaults to "H~~0~~1".

Retrieved from "https://modding.scssoft.com/index.php?title=Documentation/Engine/Truck_Interior_Animations_and_IDs&oldid=5577"