vehicle_react_util¶

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

Hinweise

GUI-Recipes für Fahrzeuge (Symbole, Zustand, Ertrag) und HandleVehicleChanges, das die Ergebnisse des Ladens in Befehle zum Kaufen, Ersetzen und Verkaufen umsetzt.

VehicleReactUtil¶

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

global record VehicleReactUtil

Laden: local vehicle_react_util = ug_require "::/gui/line_vehicle_mgmt/vehicle_react_util.tl" as VehicleReactUtil

Hinweise

GUI-Recipes für Fahrzeuge und die Hilfsfunktion, die die Ergebnisse des Fahrzeugladens anwendet.

Felder

Name	Typ	Beschreibung
`ConditionTextView`	`Recipe<Engine.Entity>`	Recipe, das eine Fahrzeug-Entität bekommt. Es zeigt den Zustandstext (`VehicleUtil.getConditionText`) als Schaltfläche, die das Infofenster des Fahrzeugs öffnet, und aktualisiert sich in jedem Step.
`ConditionIcon`	`Recipe<Engine.Entity>`	Recipe, das eine Fahrzeug-Entität bekommt. Es zeigt das Zustandssymbol mit dem Zustandstext als Tooltip. Ein Klick wählt das Fahrzeug aus.
`VehicleImage`	`Recipe<VehicleIconData>`	Recipe, das das Symbol eines Fahrzeugteils zeichnet. Sind `color` und `cblendFileName` beide gesetzt, wird es durch die Maske eingefärbt.
`VehicleWidget`	`Recipe<VehicleWidgetParams>`	Recipe, das die Symbole eines oder mehrerer Fahrzeuge in einem waagerecht scrollbaren Bereich zeigt. Gleiche Zusammenstellungen und gleiche aufeinanderfolgende Teile werden mit Zählern zusammengefasst. 6-mal im Basisspiel verwendet
`VehicleBalance`	`Recipe<VehicleBalanceParams>`	Recipe, das den Ertrag eines Fahrzeugs im letzten Spieljahr zeigt (`api.engine.util.finance.calculateBalance`), im Stil `negative` oder `positive`. 2-mal im Basisspiel verwendet

Funktionen

makeVehicleIconData(VehicleImageParams) : VehicleIconData base/tealdef/gui/line_vehicle_mgmt/vehicle_react_util.d.tl:38

Aufruf: vehicle_react_util.makeVehicleIconData(…)

Hinweise

Baut die Symboldaten für ein Teil eines Fahrzeugs aus dessen Modellbeschreibung.

Rückgabe VehicleIconData: Symboldaten für VehicleImage.

getVehicleIconType(Engine.Entity) : VehicleIconType base/tealdef/gui/line_vehicle_mgmt/vehicle_react_util.d.tl:43

Aufruf: vehicle_react_util.getVehicleIconType(…)

Hinweise

Wählt den VehicleIconType eines Fahrzeugs nach Verkehrsträger, Transportmodi, Motortyp (Schiene) und Hubschrauber-Flag (Luft).

Rückgabe VehicleIconType: Der Symboltyp, oder nil bei unbekannten Verkehrsträgern.

getVehicleIconPathBig(Engine.Entity) : string base/tealdef/gui/line_vehicle_mgmt/vehicle_react_util.d.tl:44

Aufruf: vehicle_react_util.getVehicleIconPathBig(…)

Hinweise

Pfad des großen HUD-Fahrzeugsymbols (::/gui/hud/icons/vehicle_*.tga) eines Fahrzeugs, ermittelt über getVehicleIconType.

Rückgabe string: Symbolpfad, oder nil.

HandleVehicleChanges(changes : {VehicleReactUtil.VehicleChange}, protectedEntities : {Engine.Entity : GameContext.Filters.ProtectionConfig | boolean}, getLineAndDepot : function(vehicleEntity : Engine.Entity) : {Engine.Entity, Engine.Entity}, getFirstStopToSendTo : function(vehicleToSendToLine : Engine.Entity, lineToSendTo : Engine.Entity) : integer, onBuy : function(resultEntities : {{Engine.Entity, Engine.Revision}}), onFail? : function(reason : string)) base/tealdef/gui/line_vehicle_mgmt/vehicle_react_util.d.tl:46

Aufruf: vehicle_react_util.HandleVehicleChanges(…)

Hinweise

Sendet die Befehle für eine Liste von Änderungen aus dem Fahrzeugladen. Es kauft neue Fahrzeuge, ersetzt Fahrzeugkonfigurationen oder verkauft Fahrzeuge.

Im Spiel Konnte Fahrzeuge nicht duplizieren (nicht genügend Geld) · Kein passendes Depot gefunden.Im Code: Could not clone vehicles (not enough money). · Could not find suitable depot.

Parameter	Typ	Beschreibung
`changes`	`{VehicleReactUtil.VehicleChange}`	Änderungen, die angewendet werden. Teile mit `purchaseTime <= 0` bekommen die aktuelle Spielzeit. Die automatische Ladekonfiguration wird für alle Abteile eingeschaltet.
`protectedEntities`	`{Engine.Entity : GameContext.Filters.ProtectionConfig \| boolean}`	Fahrzeuge, die nicht verkauft werden dürfen (aus `gameCtx.filters`). Darf nil sein.
`getLineAndDepot`	`function(vehicleEntity : Engine.Entity) : {Engine.Entity, Engine.Entity}`	Gibt für neue Fahrzeuge (negatives `vehicleEntity`) `{line, depot}` zurück. Das Fahrzeug wird im Depot gekauft und, wenn die Linie >= 0 ist, auf sie geschickt.
`getFirstStopToSendTo`	`function(vehicleToSendToLine : Engine.Entity, lineToSendTo : Engine.Entity) : integer`	Gibt den Index der Haltestelle zurück, zu der ein neu gekauftes Fahrzeug auf seiner Linie fährt. Bei nil ist es 0.
`onBuy`	`function(resultEntities : {{Engine.Entity, Engine.Revision}})`	Wird für jedes gekaufte Fahrzeug mit `{{entity, revision}}` aufgerufen.
`onFail?`	`function(reason : string)`	Wird mit einem übersetzten Grund aufgerufen, wenn der Kauf scheitert oder kein Depot gefunden wird.

Details

Verwendet api.cmd.makeVehicleBuyCmd, makeVehicleSetLineCmd, makeVehicleReplaceCmd und makeVehicleSellCmd. Über einem ersetzten Fahrzeug erscheint ein fröhliches Emote als HUD-Bild, außer die Ereignissymbole sind im HUD-Filter ausgeblendet.

VehicleReactUtil.VehicleImageParams¶

record base/tealdef/gui/line_vehicle_mgmt/vehicle_react_util.d.tl:5

record VehicleImageParams

Hinweise

Wählt ein Teil eines Fahrzeugs für makeVehicleIconData aus.

Im Basisspiel verwendet: 1-mal in 1 Datei

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

vehicle_react_util.makeVehicleIconData = function(params : VehicleReactUtil.VehicleImageParams) : VehicleReactUtil.VehicleIconData

Felder

Name	Typ	Beschreibung
`vehicleEntity`	`Engine.Entity`	Fahrzeug-Entität (mit einer Komponente `TRANSPORT_VEHICLE`).
`vehicleIndex`	`integer`	Index (ab 1) in `transportVehicleConfig.vehicles`, also das Teil, z. B. ein Waggon.

VehicleReactUtil.VehicleIconData¶

record base/tealdef/gui/line_vehicle_mgmt/vehicle_react_util.d.tl:10

record VehicleIconData

Hinweise

Daten, mit denen VehicleImage das Symbol eines Fahrzeugteils zeichnet.

Im Basisspiel verwendet: 9-mal in 1 Datei

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

vehicle_react_util.makeVehicleIconData = function(params : VehicleReactUtil.VehicleImageParams) : VehicleReactUtil.VehicleIconData

Felder

Name	Typ	Beschreibung
`fileName`	`string`	Pfad des Symbolbildes (`description.icon20` des Modells).
`cblendFileName`	`string`	Farbmischmaske (`description.icon20cblend`). Ist `color` gesetzt, wird das Symbol durch diese Maske eingefärbt.
`name`	`string`	Modellname, der als Tooltip erscheint.
`flippedHorizontally`	`boolean`	True, wenn das Teil im Zugverband umgedreht ist.
`color`	`Vec3f`	Farbe des Teils. nil, wenn das Teil keine eigene Farbe hat (Farbe x < 0).
`tooltipOverride`	`string`	Tooltip, der statt `name` verwendet wird.

VehicleReactUtil.VehicleWidgetParams¶

record base/tealdef/gui/line_vehicle_mgmt/vehicle_react_util.d.tl:19

record VehicleWidgetParams

Hinweise

Parameter von VehicleWidget.

Im Basisspiel verwendet: 1-mal in 1 Datei

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

vehicle_react_util.VehicleWidget = react.RegisterRecipe("VehicleWidget", function(params : VehicleReactUtil.VehicleWidgetParams) : TreeNodeId

Felder

Name	Typ	Beschreibung
`vehicleEntities`	`{Engine.Entity}`	Fahrzeuge, die angezeigt werden. Fahrzeuge mit gleicher Zusammenstellung werden mit einem Zähler `Nx` gruppiert.
`class`	`string`	Zusätzliche Style-Klassen.
`blinking`	`boolean`	Fügt der Schaltfläche die Style-Klasse `blinking` hinzu (nur mit `onClick`).
`tooltipOverride`	`string`	Tooltip für alle Teilsymbole statt der Modellnamen.

Funktionen

onClick() base/tealdef/gui/line_vehicle_mgmt/vehicle_react_util.d.tl:21

Hinweise

Wenn gesetzt, ist das Widget eine Schaltfläche, die diese Funktion aufruft.

VehicleReactUtil.MaintenanceSelectorParams¶

record base/tealdef/gui/line_vehicle_mgmt/vehicle_react_util.d.tl:27

record MaintenanceSelectorParams

Hinweise

Deklarierter Parameter-Record, den der Code des Basisspiels nicht verwendet.

Felder

Name	Typ	Beschreibung
`vehicles`	`{EntityUtil.EntityAndRevision}`
`onlySlider`	`boolean`

Funktionen

onClose() base/tealdef/gui/line_vehicle_mgmt/vehicle_react_util.d.tl:28

Die Spieldateien enthalten hierzu noch keine Beschreibung.

VehicleReactUtil.VehicleChange¶

record base/tealdef/gui/line_vehicle_mgmt/vehicle_react_util.d.tl:33

record VehicleChange

Hinweise

Eine Änderung, die der Fahrzeugladen erzeugt und HandleVehicleChanges anwendet.

Im Basisspiel verwendet: 9-mal in 4 Dateien

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

local toAdd : {VehicleReactUtil.VehicleChange} = {}

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

changes : {VehicleReactUtil.VehicleChange},

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

onAccepted : function(vehicleChanges : {VehicleReactUtil.VehicleChange})

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

local replaceVehicles = function(changes : {VehicleReactUtil.VehicleChange})

Felder

Name	Typ	Beschreibung
`vehicleEntity`	`Engine.Entity`	Fahrzeug, das ersetzt oder verkauft wird. Ein negativer Wert heißt, dass ein neues Fahrzeug gekauft wird.
`config`	`TransportVehicleConfig`	Neue Fahrzeugkonfiguration. Eine leere Liste `vehicles` verkauft das Fahrzeug.

VehicleReactUtil.VehicleBalanceParams¶

record base/tealdef/gui/line_vehicle_mgmt/vehicle_react_util.d.tl:58

record VehicleBalanceParams

Hinweise

Parameter von VehicleBalance.

Im Basisspiel verwendet: 1-mal in 1 Datei

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

vehicle_react_util.VehicleBalance = react.RegisterRecipe("VehicleBalance", function(vehicleBalanceParams : VehicleReactUtil.VehicleBalanceParams) : TreeNodeId

Felder

Name	Typ	Beschreibung
`entity`	`Engine.Entity`	Fahrzeug, dessen Ertrag angezeigt wird.
`stepTimer`	`boolean`	Bei true wird über einen Step-Timer aktualisiert statt in jedem Step.