vehicle_util¶

Quelle: base/tealdef/gui/line_vehicle_mgmt/vehicle_util.d.tl

Hinweise

Kleine Hilfsfunktionen für Fahrzeuge und Depots. Dazu gehören Lebensdauer und Alter, Text und Symbole für den Zustand, der Verkehrsträger eines Depots, der Fahrzeugtyp, Kapazitätsprüfungen und die vom Jahr abhängigen Wertebereiche, mit denen die Fortschrittsbalken des Ladens skaliert werden.

VehicleUtil¶

record global base/tealdef/gui/line_vehicle_mgmt/vehicle_util.d.tl:3

global record VehicleUtil

Laden: local vehicle_util = ug_require "::/gui/line_vehicle_mgmt/vehicle_util.tl" as VehicleUtil

Hinweise

Kleine Hilfsfunktionen für Fahrzeuge und Depots.

Felder

Name	Typ	Beschreibung
`ConditionLevels`	`{string}`	Übersetzte Zustandsnamen vom schlechtesten zum besten, also „Sehr schlecht“, „Schlecht“, „Mittelmässig“, „Gut“ und „Sehr gut“.
`MaintenanceLevels`	`{string}`	Deklariert, aber in der Implementierung des Basisspiels nicht zugewiesen (zur Laufzeit nil).

Funktionen

makePart(modelId : integer, forward : boolean, color : Vec3f) : TransportVehiclePart base/tealdef/gui/line_vehicle_mgmt/vehicle_util.d.tl:11

Aufruf: vehicle_util.makePart(…)

Hinweise

Erzeugt ein TransportVehiclePart für ein Modell, mit Ladekonfiguration 0 für jedes Abteil.

Parameter	Typ	Beschreibung
`modelId`	`integer`	Modell-ID eines Fahrzeugs.
`forward`	`boolean`	false, um das Teil umzudrehen.
`color`	`Vec3f`	Optionale Farbe des Teils.

Rückgabe TransportVehiclePart

Im Basisspiel verwendet: 5-mal in 2 Dateien

base/content/gui/gui/line_vehicle_mgmt/vehicle_store_window.tl:3967

local part = vehicle_util.makePart(modelId, true, color)

base/content/mission/mission/tasks/vehicle_util/replace_vehicles.tl:41

local vehiclePartsList = { vehicle_util.makePart(modelId, true, nil) }

getLifespan(integer) : integer base/tealdef/gui/line_vehicle_mgmt/vehicle_util.d.tl:12

Aufruf: vehicle_util.getLifespan(…)

Hinweise

Lebensdauer eines Fahrzeugmodells.

Rückgabe integer: maintenance.lifespan mal 1000. Wird mit den Kaufzeiten der Teile in Spielzeit verglichen.

getMinPurchaseTimeAndLifespan(Engine.Component.TransportVehicle) : {integer, integer} base/tealdef/gui/line_vehicle_mgmt/vehicle_util.d.tl:13

Aufruf: vehicle_util.getMinPurchaseTimeAndLifespan(…)

Hinweise

Kaufzeit und Lebensdauer des ältesten Teils eines Transportfahrzeugs (bei Gleichstand die kürzeste Lebensdauer).

Rückgabe {integer, integer}: {purchaseTime, lifespan}.

Im Basisspiel verwendet: 2-mal in 1 Datei

base/content/gui/gui/entity_window/line/line_eow.script.tl:126

return vehicle_util.getMinPurchaseTimeAndLifespan(transportVehicle)

getDepotCarriers(Engine.Entity) : {Carrier} base/tealdef/gui/line_vehicle_mgmt/vehicle_util.d.tl:14

Aufruf: vehicle_util.getDepotCarriers(…)

Hinweise

Verkehrsträger der Transportmodi, die in einem Fahrzeugdepot eingeschaltet sind.

Rückgabe {Carrier}

Im Basisspiel verwendet: 3-mal in 2 Dateien

base/content/gui/gui/construction/constructionHudIconMaster.tl:84

carriers = vehicle_util.getDepotCarriers(param.entity)

base/content/gui/gui/line_vehicle_mgmt/manager_hud_util.tl:1246

local depotCarriers = vehicle_util.getDepotCarriers(hudIconParam.entity)

getDepotCarrier(Engine.Entity) : Carrier base/tealdef/gui/line_vehicle_mgmt/vehicle_util.d.tl:15

Aufruf: vehicle_util.getDepotCarrier(…)

Hinweise

Der einzige Verkehrsträger eines Fahrzeugdepots.

Rückgabe Carrier: Der Verkehrsträger, oder nil (mit einer Warnung im Log), wenn das Depot keinen oder mehrere hat.

Im Basisspiel verwendet: 1-mal in 1 Datei

base/content/gui/gui/line_vehicle_mgmt/manager_window.tl:7141

carrier = vehicle_util.getDepotCarrier(depotEntity),

getDepotTransportModes(Engine.Entity) : {TransportMode : boolean} base/tealdef/gui/line_vehicle_mgmt/vehicle_util.d.tl:16

Aufruf: vehicle_util.getDepotTransportModes(…)

Hinweise

Transportmodi eines Fahrzeugdepots.

Rückgabe {TransportMode : boolean}: Die transportModes des Depots, oder eine leere Tabelle, wenn das Depot keine Ein- oder Ausgangsknoten hat.

Im Basisspiel verwendet: 3-mal in 3 Dateien

base/content/game_mechanics/game_mechanics/notifications/types/availability.script.tl:99

local depotTransportModes = vehicle_util.getDepotTransportModes(e)

base/content/gui/gui/line_vehicle_mgmt/line_react_util.tl:425

local transportModeMap = vehicle_util.getDepotTransportModes(depotEntity)

base/content/gui/gui/line_vehicle_mgmt/manager_window.tl:7142

transportModes = vehicle_util.getDepotTransportModes(depotEntity),

getVehicleTypeFromModel(model : Model) : VehicleType base/tealdef/gui/line_vehicle_mgmt/vehicle_util.d.tl:28

Aufruf: vehicle_util.getVehicleTypeFromModel(…)

Hinweise

Fahrzeugtyp eines Modells nach seinen transportVehicle.transportModes. Train, wenn nichts passt.

Rückgabe VehicleType

Im Basisspiel verwendet: 2-mal in 1 Datei

base/content/game_mechanics/game_mechanics/notifications/types/availability.script.tl:118

vehicleType = vehicle_util.getVehicleTypeFromModel(model)

getVehicleTypeFromEntity(ent : Engine.Entity) : VehicleType base/tealdef/gui/line_vehicle_mgmt/vehicle_util.d.tl:29

Aufruf: vehicle_util.getVehicleTypeFromEntity(…)

Hinweise

Fahrzeugtyp einer Fahrzeug-Entität nach ihrem Verkehrsträger. Bus oder Lkw ergibt sich aus den Transportmodi, Hubschrauber oder Flugzeug aus dem Modell des ersten Teils.

Rückgabe VehicleType

Im Basisspiel verwendet: 2-mal in 2 Dateien

base/content/game_mechanics/game_mechanics/notifications/types/vehicle_warning.sim.script.tl:14

old.typeMapping[entityAndRev.entity] = vehicle_util.getVehicleTypeFromEntity(entityAndRev.entity)

base/content/game_mechanics/game_mechanics/notifications/types/vehiclecondition.sim.script.tl:14

old.typeMapping[entityAndRev.entity] = vehicle_util.getVehicleTypeFromEntity(entityAndRev.entity)

getConditionText(number) : string base/tealdef/gui/line_vehicle_mgmt/vehicle_util.d.tl:32

Aufruf: vehicle_util.getConditionText(…)

Hinweise

Zustandsname für einen Wartungszustand von 0 bis 1 (in fünf gleiche Stufen geteilt).

Rückgabe string

Im Basisspiel verwendet: 6-mal in 4 Dateien

base/content/gui/gui/entity_window/entity_window_util.tl:1999

text = vehicle_util.getConditionText(state:old()[1]),

base/content/gui/gui/entity_window/vehicle/vehicle_eow.script.tl:1115

ratingText = vehicle_util.getConditionText(vehicleMaintenanceState:old().maintenanceState),

base/content/gui/gui/line_vehicle_mgmt/vehicle_react_util.tl:42

return vehicle_util.getConditionText(condition)

base/content/gui/gui/statistics/statistic_vehicles.tl:228

text = vehicle_util.getConditionText(maintenanceState:old()),

getConditionIcon(number) : string base/tealdef/gui/line_vehicle_mgmt/vehicle_util.d.tl:33

Aufruf: vehicle_util.getConditionIcon(…)

Hinweise

Pfad des Zustandssymbols (::/gui/line_vehicle_mgmt/icons/condition_*.tga) für einen Wartungszustand von 0 bis 1.

Rückgabe string

Im Basisspiel verwendet: 1-mal in 1 Datei

base/content/gui/gui/line_vehicle_mgmt/vehicle_react_util.tl:54

return {vehicle_util.getConditionIcon(condition), vehicle_util.getConditionText(condition)}

getNoise01(emissions : number, carrier : Carrier) : number base/tealdef/gui/line_vehicle_mgmt/vehicle_util.d.tl:37

Aufruf: vehicle_util.getNoise01(…)

Hinweise

Bildet einen Lärmemissionswert je nach Verkehrsträger auf 0 bis 1 ab (0 bis 200 bei Schiene, 0 bis 300 bei Luft, sonst 0 bis 100).

Rückgabe number

getPollution01(emissions : number, carrier : Carrier) : number base/tealdef/gui/line_vehicle_mgmt/vehicle_util.d.tl:38

Aufruf: vehicle_util.getPollution01(…)

Hinweise

Bildet einen Verschmutzungswert je nach Verkehrsträger auf 0 bis 1 ab (0 bis 200 bei Schiene, 0 bis 300 bei Luft, sonst 0 bis 100).

Rückgabe number

isAbleToLoadCargo(tv : Engine.Component.TransportVehicle) : boolean base/tealdef/gui/line_vehicle_mgmt/vehicle_util.d.tl:40

Aufruf: vehicle_util.isAbleToLoadCargo(…)

Hinweise

True, wenn das Transportfahrzeug Kapazität für andere Güter als Passagiere hat.

Rückgabe boolean

isAbleToLoadPassenger(tv : Engine.Component.TransportVehicle) : boolean base/tealdef/gui/line_vehicle_mgmt/vehicle_util.d.tl:41

Aufruf: vehicle_util.isAbleToLoadPassenger(…)

Hinweise

True, wenn das Transportfahrzeug Kapazität für Passagiere hat (in irgendeiner Ladekonfiguration).

Rückgabe boolean

Im Basisspiel verwendet: 1-mal in 1 Datei

base/content/gui/gui/line_vehicle_mgmt/manager_window.tl:4461

if vehicle_util.isAbleToLoadPassenger(tv) then

getRanges(carrier : Carrier, onlyPassengers : boolean, year : integer) : Ranges base/tealdef/gui/line_vehicle_mgmt/vehicle_util.d.tl:57

Aufruf: vehicle_util.getRanges(…)

Hinweise

Wertebereiche für einen Verkehrsträger und ein Spieljahr.

Parameter	Typ	Beschreibung
`carrier`	`Carrier`	Verkehrsträger des Fahrzeugs.
`onlyPassengers`	`boolean`	True für Fahrzeuge, die nur Passagiere befördern.
`year`	`integer`	Aktuelles Spieljahr.

Rückgabe Ranges

Im Basisspiel verwendet: 3-mal in 3 Dateien

base/content/game_mechanics/game_mechanics/subventions/subvention_util.tl:487

local maxSpeed = vehicle_util.getRanges(api.type["enum"].Carrier.RAIL, true, api.engine.util.getYear()).maxSpeed

base/content/gui/gui/entity_window/vehicle/vehicle_eow.script.tl:502

return vehicle_util.getRanges(param.carrier, onlyPassengers, date.year)

base/content/gui/gui/line_vehicle_mgmt/vehicle_store_util.tl:425

return vehicle_util.getRanges(carrier, onlyPassengers, year)

getAvgMaintenanceState(Engine.Entity) : number, number base/tealdef/gui/line_vehicle_mgmt/vehicle_util.d.tl:59

Aufruf: vehicle_util.getAvgMaintenanceState(…)

Hinweise

Mittlerer Wartungszustand aller Teile eines Fahrzeugs.

Rückgabe number, number: Mittlerer Zustand (1.0, wenn das Fahrzeug keine Teile hat) und mittlere Änderung der Wartung.

Im Basisspiel verwendet: 11-mal in 6 Dateien

base/content/gui/gui/entity_window/entity_window_util.tl:1990

local state, change = vehicle_util.getAvgMaintenanceState(params.entityId)

base/content/gui/gui/entity_window/maintenance_station/maintenance_station_eow.script.tl:209

local aCondition, __ = vehicle_util.getAvgMaintenanceState(a)

base/content/gui/gui/entity_window/vehicle/vehicle_eow.script.tl:686

local maintenanceState, __ = vehicle_util.getAvgMaintenanceState(params.vehicleEntity)

base/content/gui/gui/line_vehicle_mgmt/vehicle_react_util.tl:41

local condition, __ = vehicle_util.getAvgMaintenanceState(vehicleEntity)

base/content/gui/gui/statistics/statistic_vehicles.tl:218

local condition, __ = vehicle_util.getAvgMaintenanceState(entity)

mods/release/urbangames_campaign_mission_03/content/mission/mission/tasks/fatal_maintenance/fatal_maintenance.tl:42

maintenanceState, maintenanceChange = vehicle_util.getAvgMaintenanceState(vehicleEntityId)

getAge(Engine.Entity) : AgeInfo base/tealdef/gui/line_vehicle_mgmt/vehicle_util.d.tl:68

Aufruf: vehicle_util.getAge(…)

Hinweise

Altersangaben eines Fahrzeugs, nach seinem ältesten Teil und der aktuellen Spielzeit.

Rückgabe AgeInfo

Im Basisspiel verwendet: 2-mal in 1 Datei

base/content/gui/gui/statistics/statistic_vehicles.tl:237

return vehicle_util.getAge(entity)

GetVehicleModelIds(Engine.Entity) : {integer} base/tealdef/gui/line_vehicle_mgmt/vehicle_util.d.tl:70

Aufruf: vehicle_util.GetVehicleModelIds(…)

Hinweise

Modell-IDs aller Teile eines Fahrzeugs, in der Reihenfolge des Zugverbands.

Rückgabe {integer}

Im Basisspiel verwendet: 4-mal in 4 Dateien

base/content/gui/gui/line_vehicle_mgmt/vehicle_list_react_util.tl:560

return vehicle_util.GetVehicleModelIds(rowKey)

base/content/gui/gui/statistics/statistic_depots.tl:135

local ids1 = vehicle_util.GetVehicleModelIds(vehicles[i])

base/content/gui/gui/statistics/statistic_lines.tl:268

local ids1 = vehicle_util.GetVehicleModelIds(vehicles[i])

base/content/gui/gui/statistics/statistic_vehicles.tl:361

{ name = _("Vehicle"), recipe = VehicleImageCell, getCompareValue = vehicle_util.GetVehicleModelIds, weight = 2.8, },

getPowerRatingTextAndToolTip(weight : number, power : number, tractiveEffort : number, topSpeed : number, rollingFriction : number) : {string, string, number} base/tealdef/gui/line_vehicle_mgmt/vehicle_util.d.tl:72

Aufruf: vehicle_util.getPowerRatingTextAndToolTip(…)

Hinweise

Leistungsbewertung eines Landfahrzeugs („Schlecht“, „Mittelmässig“, „Gut“, „Ausgezeichnet“) mit einem Tooltip, der die erreichbare Höchstgeschwindigkeit in der Ebene sowie bei mittlerer und starker Steigung nennt.

Im Spiel Höchstgeschwindigkeit in Steigungen: · {name}: nicht genug LeistungIm Code: Top Speed for Slopes: · {name}: Not Enough Power

Parameter	Typ	Beschreibung
`weight`	`number`	Gewicht des Fahrzeugs.
`power`	`number`	Motorleistung.
`tractiveEffort`	`number`	Zugkraft.
`topSpeed`	`number`	Höchstgeschwindigkeit.
`rollingFriction`	`number`	Rollreibung.

Rückgabe {string, string, number}: {ratingText, tooltip, rating01}, oder nil, wenn die Integration der Beschleunigung scheitert.

Im Basisspiel verwendet: 1-mal in 1 Datei

base/content/gui/gui/line_vehicle_mgmt/vehicle_store_window.tl:3737

local textAndTooltipAndValue = vehicle_util.getPowerRatingTextAndToolTip(

isCurrentlyAbleToHoldPassengers(vehicleEntity : Engine.Entity) : boolean base/tealdef/gui/line_vehicle_mgmt/vehicle_util.d.tl:75

Aufruf: vehicle_util.isCurrentlyAbleToHoldPassengers(…)

Hinweise

True, wenn die aktuelle Konfiguration des Fahrzeugs Kapazität für Passagiere hat.

Rückgabe boolean

Im Basisspiel verwendet: 2-mal in 2 Dateien

base/content/gui/gui/layers/layer_passenger_flow.tl:52

if not vehicleUtil.isCurrentlyAbleToHoldPassengers(params.entity) then

base/content/gui/gui/layers/layer_public_transport.tl:97

if vehicle and vehicleUtil.isCurrentlyAbleToHoldPassengers(params.entity) then

VehicleUtil.AgeInfo¶

record base/tealdef/gui/line_vehicle_mgmt/vehicle_util.d.tl:4

record AgeInfo

Hinweise

Altersangaben eines Fahrzeugs, aus getAge.

Im Basisspiel verwendet: 2-mal in 2 Dateien

base/content/gui/gui/line_vehicle_mgmt/vehicle_util.tl:297

vehicle_util.getAge = function(vehicleEntity : Engine.Entity) : VehicleUtil.AgeInfo

base/content/gui/gui/statistics/statistic_vehicles.tl:236

local makeState = function() : VehicleUtil.AgeInfo

Felder

Name	Typ	Beschreibung
`age`	`string`	Formatiertes Alter seit dem Kauf des ältesten Teils.
`purchaseTime`	`integer`	Spielzeit, zu der das älteste Teil gekauft wurde.
`agePercent`	`number`	Alter als gerundeter Prozentsatz der Lebensdauer (kann über 100 liegen).
`timeRemaining`	`string \| nil`	Formatierte Zeit bis zum Ende der Lebensdauer, oder nil, wenn sie abgelaufen ist.

VehicleUtil.VehicleType¶

enum base/tealdef/gui/line_vehicle_mgmt/vehicle_util.d.tl:18

enum VehicleType

Hinweise

Grober Fahrzeugtyp, abgeleitet aus Transportmodi oder Verkehrsträger.

Im Basisspiel verwendet: 11-mal in 4 Dateien

base/content/game_mechanics/game_mechanics/notifications/types/availability.script.tl:115

local vehicleType : VehicleUtil.VehicleType

base/content/game_mechanics/game_mechanics/notifications/types/vehicle_warning.script.tl:81

local makeTypeState = function() : VehicleUtil.VehicleType

base/content/game_mechanics/game_mechanics/notifications/types/vehiclecondition.script.tl:23

local makeTypeState = function() : VehicleUtil.VehicleType

base/content/gui/gui/line_vehicle_mgmt/vehicle_util.tl:84

vehicle_util.getVehicleTypeFromModel = function(model : Model) : VehicleUtil.VehicleType

Wert	Beschreibung
`"Train"`	Zug (auch der Rückfallwert).
`"Tram"`	Tram.
`"Bus"`	Bus.
`"Truck"`	Lkw.
`"Ship"`	Schiff (groß oder klein).
`"Airplane"`	Flugzeug (groß oder klein).
`"Helicopter"`	Hubschrauber.

VehicleUtil.Ranges¶

record base/tealdef/gui/line_vehicle_mgmt/vehicle_util.d.tl:43

record Ranges

Hinweise

Wertebereiche, mit denen der Fahrzeugladen und das Fahrzeugfenster die Eigenschaftsbalken skalieren, aus getRanges.

Details

Das Basisspiel hat pro Verkehrsträger eine kleine Tabelle mit Einträgen für bestimmte Jahre (z. B. Schiene 1900, 1921, 1941, 1981). Es gilt der letzte Eintrag, dessen Jahr erreicht ist.

Im Basisspiel verwendet: 7-mal in 4 Dateien

base/content/gui/gui/entity_window/vehicle/vehicle_eow.script.tl:420

ranges : VehicleUtil.Ranges,

base/content/gui/gui/line_vehicle_mgmt/vehicle_store_util.tl:412

) : VehicleUtil.Ranges

base/content/gui/gui/line_vehicle_mgmt/vehicle_store_window.tl:480

ranges : VehicleUtil.Ranges

base/content/gui/gui/line_vehicle_mgmt/vehicle_util.tl:210

local carrierToYearToRange : {Carrier : {VehicleUtil.Ranges}} = {

Felder

Name	Typ	Beschreibung
`year`	`integer`	Erstes Jahr, ab dem der Eintrag gilt.
`onlyPassengers`	`boolean \| nil`	Wenn gesetzt, gilt der Eintrag nur für reine Passagierfahrzeuge (true) oder nur für andere Fahrzeuge (false).
`minSpeed`	`number`	Unteres Ende des Geschwindigkeitsbalkens, in m/s.
`maxSpeed`	`number`	Oberes Ende des Geschwindigkeitsbalkens, in m/s (Standard 200 km/h).
`maxPower`	`number`	Oberes Ende des Leistungsbalkens (Standard 15.000).
`maxThrust`	`number`	Oberes Ende des Schubbalkens (Standard 500.000).
`maxRunningCosts`	`number`	Oberes Ende des Betriebskostenbalkens (1.000.000).
`pollutionScoreRange`	`{number, number}`	`{min, max}` des Verschmutzungsbalkens.
`noiseScoreRange`	`{number, number}`	`{min, max}` des Lärmbalkens.
`comfortScoreRange`	`{number, number}`	`{min, max}` des Komfortbalkens.
`loadSpeedScoreRange`	`{number, number}`	`{min, max}` des Balkens für die Ladegeschwindigkeit.

VehicleUtil.Emissions¶

record base/tealdef/gui/line_vehicle_mgmt/vehicle_util.d.tl:61

record Emissions

Hinweise

Deklarierter Record, den der Code des Basisspiels nicht verwendet.

Felder

Name	Typ	Beschreibung
`score`	`integer`
`currentBase`	`integer`
`currentExtra`	`integer`
`conditionIndex`	`integer`