transformator_util¶

Quelle: base/tealdef/scripts/transformator_util.d.tl

Hinweise

Typen für Transformator-Skripte. Diese Skripte laufen in jedem Frame und animieren Fahrzeug- und Gebäudemodelle (Räder, Türen, Lichter, Stromabnehmer, ausgegebene Personenmodelle, Partikel). TransformatorParams bekommt eine Update-Funktion übergeben. TransformatorUtil (/scripts/transformator_util.tl) enthält die gemeinsamen Animationshelfer, die die Transformatoren des Basisspiels aufrufen.

Beispiel

-- from base/content/vehicle/tram/shared/shared/transformator_tram.script.tl
local updateFnTram = function(__captureParams : NativeLuaTable, params : TransformatorParams, transfsOutput : Transformator.TransfOutput)
    if params.currentInfo.landVehicle ~= nil then
        local time = transformator_util.getEntityTime(params.currentInfo.world.gameTime, params.entityId)
        transformator_util.addDriveAnimationState(params.currentInfo.landVehicle.wheelAnimationInfo.totalDist, params.currentInfo.landVehicle.reversed, transfsOutput)
        transformator_util.addDoorAnimationState(params.currentInfo.vehicle.doorAnimationInfo, transfsOutput)
        transformator_util.addBrakeLightsAnimationState(params.currentInfo.landVehicle.brakingTimer, time, transfsOutput)
    end
end
return { tram = { updateFn = updateFnTram, updateParticleSystemFn = transformator_util.updateParticleSystemFn } }

Globale Namen¶

Typen

Name	Definition	Beschreibung
`UpdateFn`	`function(captureParams : any, transformatorParams : TransformatorParams, transfsOutput : Transformator.TransfOutput)`	Signatur einer Transformator-Update-Funktion. Sie bekommt die Capture-Parameter, die `TransformatorParams` und das Ausgabeobjekt und setzt darauf Animationszustände und User-Transforms.
`UpdateParticleSystemFn`	`function(captureParams : any, transformatorParams : TransformatorParams, Transformator.ParticleSystem)`	Signatur einer Partikel-Update-Funktion eines Transformators (siehe `TransformatorUtil.updateParticleSystemFn`).
`GetEmittableModelsFn`	`function(captureParams : any, transformatorParams : TransformatorParams) : {string}`	Signatur einer Funktion, die die Modelldateien auflistet, die ein Transformator ausgeben darf.
`ComputeEmittedModelsFn`	`function(captureParams : any, transformatorParams : TransformatorParams, modelEmitter : Transformator.ModelEmitter)`	Signatur einer Funktion, die in jedem Update Modelle über den `ModelEmitter` ausgibt.

TransformatorParams¶

record global base/tealdef/scripts/transformator_util.d.tl:3

global record TransformatorParams

Hinweise

Alles, was eine Transformator-Update-Funktion über die animierte Modellinstanz bekommt: aktuelle und vorige dynamische Infos, statische Fahrzeuginfos, Modell-Metadaten und die Tabelle params aus der transformatorConfig des Modells.

Felder

Name	Typ	Beschreibung
`previousInfo`	`DynamicInfo`	Dynamische Infos des vorigen Updates.
`currentInfo`	`DynamicInfo`	Dynamische Infos des aktuellen Updates.
`landVehicleApi`	`Transformator.LandVehicleScriptingApi`	Abfragen entlang des Fahrwegs, z. B. `getAverageCatenaryHeight` und `getAverageCurvature`.
`vehicleStaticInfo`	`Transformator.VehicleStaticScriptingInfo`	Statische (unveränderliche) Infos des Fahrzeugs.
`aircraftStaticInfo`	`Transformator.AircraftStaticScriptingInfo`	Statische Infos des Luftfahrzeugs.
`modelMetadataInfo`	`Transformator.ModelMetadataInfo`	Modell-Metadaten, die der Transformator lesen kann, z. B. `seats`.
`entityId`	`Engine.Entity`	Entitäts-ID der Modellinstanz.
`instIndex`	`integer`	Index der Modellinstanz innerhalb der Entität. Wird mit `seat.instanceIndex` verglichen.
`transformatorConfigParams`	`any`	Die Tabelle `transformatorConfig.params` aus den Metadaten des Modells (z. B. `ModelParamsTram`).

TransformatorParams.TransformatorLanes¶

record base/tealdef/scripts/transformator_util.d.tl:5

record TransformatorLanes

Hinweise

Aufbau von transformatorConfig.params bei Stadtgebäuden, die bewegte Modelle entlang von Kurven ausgeben. TransformatorUtil.getEmittableModelsTownbuildingFn und computeEmittedModelsTownbuildingFn lesen ihn.

Im Basisspiel verwendet: 2-mal in 1 Datei

base/content/scripts/scripts/transformator_util.tl:52

local lanes = (transformatorParams.transformatorConfigParams as TransformatorParams.TransformatorLanes).lanes

Felder

Name	Typ	Beschreibung
`lanes`	`{Curve}`	Die Spuren.

TransformatorParams.TransformatorLanes.Curve¶

record base/tealdef/scripts/transformator_util.d.tl:6

record Curve

Hinweise

Eine Spur mit ausgegebenen Modellen.

Felder

Name	Typ	Beschreibung
`curves`	`ConstructionUtilSerialized.GeneratedDataGroup.GeneratedCurve`	Kurven (Startpunkt, Tangenten, Endpunkt), entlang derer sich die Modelle bewegen.
`speed`	`number`	Fahrzeit pro Meter Kurve. Ein Durchlauf entlang einer Kurve dauert `speed * length` Einheiten Spielzeit.
`density`	`number`	Anzahl ausgegebener Modelle pro Meter Kurve.
`model`	`string`	Modelldatei, die ausgegeben wird.
`tags`	`string`	Optionaler Filter nach Zustand der Industrie: enthält `idle`, `prod_low`, `prod_high` und/oder `boost`. Die Spur erscheint nur im passenden Produktionszustand.

TransformatorParams.ModelParamsHelicopter¶

record base/tealdef/scripts/transformator_util.d.tl:17

record ModelParamsHelicopter

Hinweise

transformatorConfig.params von Hubschraubern.

Im Basisspiel verwendet: 1-mal in 1 Datei

base/content/vehicle/shared/shared/transformator_air.script.tl:20

(params.transformatorConfigParams as TransformatorParams.ModelParamsHelicopter).vtol,

Felder

Name	Typ	Beschreibung
`vtol`	`boolean`	True bei Luftfahrzeugen, die bei geringer horizontaler Geschwindigkeit den Rotor angestellt lassen (Senkrechtstart).

TransformatorParams.ModelParamsTram¶

record base/tealdef/scripts/transformator_util.d.tl:22

record ModelParamsTram

Hinweise

transformatorConfig.params von Trams und anderen Fahrzeugen mit Stromabnehmer.

Im Basisspiel verwendet: 1-mal in 1 Datei

base/content/vehicle/tram/shared/shared/transformator_tram.script.tl:47

local transformatorConfigParamsTram = params.transformatorConfigParams as TransformatorParams.ModelParamsTram

Felder

Name	Typ	Beschreibung
`pantographMin`	`number`	Höhe der Oberleitung (Meter), bei der die Stromabnehmer-Animation auf ihrem ersten Frame steht.
`pantographMax`	`number`	Höhe der Oberleitung (Meter), bei der die Stromabnehmer-Animation auf ihrem letzten Frame steht.
`pantographOffsetFromCenter`	`number`	Abstand des Stromabnehmers von der Fahrzeugmitte in Fahrtrichtung, in Metern.

TransformatorParams.ModelParamsZeppelin¶

record base/tealdef/scripts/transformator_util.d.tl:29

record ModelParamsZeppelin

Hinweise

transformatorConfig.params von Zeppelinen: Modelle, die auf den Sitzen von Besatzung und Passagieren ausgegeben werden.

Im Basisspiel verwendet: 2-mal in 2 Dateien

base/content/vehicle/zeppelin/shared/shared/transformator_zeppelin.script.tl:84

local transformatorConfigParamsZeppelin = params.transformatorConfigParams as TransformatorParams.ModelParamsZeppelin

dlcs/urbangames_deluxe_upgrade_pack/content/vehicle/vehicle/zeppelin/hot_air_balloon/hot_air_balloon.script.tl:24

local transformatorConfigParams = params.transformatorConfigParams as TransformatorParams.ModelParamsZeppelin

Felder

Name	Typ	Beschreibung
`crewPath`	`string`	Modelldatei für Sitze, die als Besatzung markiert sind.
`passengerPathsA`	`{string}`	Passagiermodelle in Epoche A.
`passengerPathsB`	`{string}`	Passagiermodelle in Epoche B.
`passengerPathsC`	`{string}`	Passagiermodelle in Epoche C (und als Rückfall).

TransformatorParams.DynamicInfo¶

record base/tealdef/scripts/transformator_util.d.tl:37

record DynamicInfo

Dynamic Info that will update every render step

Felder

Name	Typ	Beschreibung
`world`	`Transformator.WorldScriptingInfo`	Infos zur Welt wie `gameTime`.
`vehicle`	`Transformator.VehicleScriptingInfo`	Infos jedes Fahrzeugs (Geschwindigkeit, Geschwindigkeitsvektor, Türen, Wartung, ...). Bei Nicht-Fahrzeugen nil.
`roadVehicle`	`Transformator.RoadVehicleScriptingInfo`	Infos zu Straßenfahrzeugen. Bei anderen Modellen nil.
`railVehicle`	`Transformator.RailVehicleScriptingInfo`	Infos zu Schienenfahrzeugen (Gewicht, Achsen, Bremsverzögerung, ...). Bei anderen Modellen nil.
`tram`	`Transformator.TramScriptingInfo`	Infos zu Trams. Bei anderen Modellen nil.
`landVehicle`	`Transformator.LandVehicleScriptingInfo`	Gemeinsame Infos von Landfahrzeugen (rückwärts, Seite, Radanimation, Bremsen, Blinker).
`aircraft`	`Transformator.AircraftScriptingInfo`	Infos zu Luftfahrzeugen. Bei anderen Modellen nil.
`ship`	`Transformator.ShipScriptingInfo`	Infos zu Schiffen. Bei anderen Modellen nil.
`airWaterVehicle`	`Transformator.AirWaterVehicleScriptingInfo`	Gemeinsame Infos von Luftfahrzeugen und Schiffen.
`industry`	`Transformator.IndustryScriptingInfo`	Infos zur Industrie (produziert, Boost, Arbeitsplätze) bei Industriegebäuden.
`station`	`Transformator.StationScriptingInfo`	Infos zur Station bei Stationsmodellen.
`townBuilding`	`Transformator.TownBuildingScriptingInfo`	Infos zum Stadtgebäude bei Stadtgebäuden.
`personCapacity`	`Transformator.PersonCapacityInfo`	Personen, die gerade im Modell sind (`simPersons`). Danach werden Personenmodelle auf Sitzen ausgegeben.
`modelPerson`	`any`
`modelPersonIdle`	`any`
`customState`	`any`	Vom Skript festgelegter eigener Zustand der Entität (der Zeppelin-Transformator liest daraus seine Epoche).

TransformatorUtil¶

record global base/tealdef/scripts/transformator_util.d.tl:76

global record TransformatorUtil

Laden: local transformator_util = ug_require "::/scripts/transformator_util.tl" as TransformatorUtil

Hinweise

Gemeinsame Transformator-Helfer, die ug_require "::/scripts/transformator_util.tl" zurückgibt.

Felder

Name	Typ	Beschreibung
`updateParticleSystemFn`	`UpdateParticleSystemFn`	Standard-Partikelupdate für Fahrzeuge: skaliert Größe, Lebensdauer und Takt des Rauchs mit Leistungsabgabe und Wartung, färbt die Partikel nach Typ (`steam_chimney`, `cylinder`, `diesel`) und stoppt die Ausgabe in Tunneln. 10-mal im Basisspiel verwendet
`getEmittableModelsTownbuildingFn`	`GetEmittableModelsFn`	Gibt das `model` jeder Spur in `TransformatorLanes` zurück, damit die Engine sie laden kann. 3-mal im Basisspiel verwendet
`computeEmittedModelsTownbuildingFn`	`ComputeEmittedModelsFn`	Gibt für die Personen in `personCapacity` Personenmodelle auf den Sitzen des Modells aus und bewegte Modelle entlang der Kurven von `TransformatorLanes` (über `tags` nach Zustand der Industrie gefiltert). 3-mal im Basisspiel verwendet
`colorAttributePostition`	`integer`	Attribute position for color instance attribute 1-mal im Basisspiel verwendet
`ageAttributePostition`	`integer`	Attribute position for age instance attribute 1-mal im Basisspiel verwendet
`color0AttributePostition`	`integer`	Attribute position for the first color of cblend 4 instance attribute
`color1AttributePostition`	`integer`	Attribute position for the seconn color of cblend 4 instance attribute
`color2AttributePostition`	`integer`	Attribute position for the third color of cblend 4 instance attribute
`color3AttributePostition`	`integer`	Attribute position for the fourth color of cblend 4 instance attribute

Funktionen

getEntityTime(gameTime : number, entityId : Engine.Entity) : number base/tealdef/scripts/transformator_util.d.tl:81

Aufruf: transformator_util.getEntityTime(…)

Hinweise

Zeitversatz pro Entität: gameTime + entityId. So laufen die Animationen gleicher Modelle nicht im Gleichtakt.

Rückgabe number

Im Basisspiel verwendet: 9-mal in 9 Dateien

base/content/industries/shared/shared/transformator_industry.script.tl:20

local time = transformator_util.getEntityTime(transformatorParams.currentInfo.world.gameTime, transformatorParams.entityId)

base/content/vehicle/shared/shared/transformator_air.script.tl:9

local time = transformator_util.getEntityTime(

base/content/vehicle/shared/shared/transformator_road.script.tl:9

local time = transformator_util.getEntityTime(

base/content/vehicle/ship/shared/shared/transformator_hovercraft.script.tl:32

local time = transformator_util.getEntityTime(

base/content/vehicle/train/shared/shared/transformator_tiltingTrain.script.tl:9

local time = transformator_util.getEntityTime(

base/content/vehicle/train/shared/shared/transformator_train.script.tl:9

local time = transformator_util.getEntityTime(

… und 3 weitere Dateien.

stableRandomColor(entityId : Engine.Entity) : Vec3f base/tealdef/scripts/transformator_util.d.tl:83

Aufruf: transformator_util.stableRandomColor(…)

Hinweise

Pseudozufällige Farbe aus der Entitäts-ID. Dieselbe Entität bekommt immer dieselbe Farbe.

Rückgabe Vec3f

Im Basisspiel verwendet: 1-mal in 1 Datei

base/content/vehicle/zeppelin/shared/shared/transformator_zeppelin.script.tl:64

local color = transformator_util.stableRandomColor(blimpData.blimpEntity.entity)

scaleUserTransfIndicesLoadConfig(indicesLoadConfig : {integer}, transfsOutput : Transformator.TransfOutput) base/tealdef/scripts/transformator_util.d.tl:85

Aufruf: transformator_util.scaleUserTransfIndicesLoadConfig(…)

Hinweise

Blendet die Modellteile mit den angegebenen User-Transform-Indizes aus, indem es sie auf null skaliert.

Parameter	Typ	Beschreibung
`indicesLoadConfig`	`{integer}`	Indizes der auszublendenden Teile (die `indicesLoadConfig` des Fahrzeugs). Bei nil passiert nichts.
`transfsOutput`	`Transformator.TransfOutput`

Im Basisspiel verwendet: 8-mal in 8 Dateien

base/content/vehicle/shared/shared/transformator_air.script.tl:82

transformator_util.scaleUserTransfIndicesLoadConfig(

base/content/vehicle/shared/shared/transformator_road.script.tl:40

transformator_util.scaleUserTransfIndicesLoadConfig(

base/content/vehicle/ship/shared/shared/transformator_hovercraft.script.tl:60

transformator_util.scaleUserTransfIndicesLoadConfig(

base/content/vehicle/ship/shared/shared/transformator_ship.script.tl:35

transformator_util.scaleUserTransfIndicesLoadConfig(

base/content/vehicle/train/shared/shared/transformator_tiltingTrain.script.tl:45

transformator_util.scaleUserTransfIndicesLoadConfig(

base/content/vehicle/train/shared/shared/transformator_train.script.tl:45

transformator_util.scaleUserTransfIndicesLoadConfig(

… und 2 weitere Dateien.

setWheelUserTransf(modelInfo : Transformator.ModelInfo, wheelRotation : number, totalDist : number, transfsOutput : Transformator.TransfOutput) base/tealdef/scripts/transformator_util.d.tl:90

Aufruf: transformator_util.setWheelUserTransf(…)

Hinweise

Setzt User-Transforms, die die Räder nach der gefahrenen Strecke drehen und sie um wheelRotation lenken.

Parameter	Typ	Beschreibung
`modelInfo`	`Transformator.ModelInfo`	Infos des Modells zu Rädern, Lenkteilen und Radvorzeichen.
`wheelRotation`	`number`	Lenkwinkel im Bogenmaß.
`totalDist`	`number`	Insgesamt gefahrene Strecke in Metern.
`transfsOutput`	`Transformator.TransfOutput`

Im Basisspiel verwendet: 1-mal in 1 Datei

base/content/vehicle/shared/shared/transformator_road.script.tl:45

transformator_util.setWheelUserTransf(

addDoorAnimationState(doorAnimationInfo : Transformator.DoorAnimationInfo, transfsOutput : Transformator.TransfOutput) base/tealdef/scripts/transformator_util.d.tl:96

Aufruf: transformator_util.addDoorAnimationState(…)

Hinweise

Fügt die Türanimation aus doorAnimationInfo hinzu (Name, Türzeit, Dauer). Bei nil passiert nichts.

Im Basisspiel verwendet: 8-mal in 8 Dateien

base/content/vehicle/shared/shared/transformator_air.script.tl:39

transformator_util.addDoorAnimationState(

base/content/vehicle/shared/shared/transformator_road.script.tl:20

transformator_util.addDoorAnimationState(

base/content/vehicle/ship/shared/shared/transformator_hovercraft.script.tl:17

transformator_util.addDoorAnimationState(

base/content/vehicle/ship/shared/shared/transformator_ship.script.tl:17

transformator_util.addDoorAnimationState(

base/content/vehicle/train/shared/shared/transformator_tiltingTrain.script.tl:34

transformator_util.addDoorAnimationState(

base/content/vehicle/train/shared/shared/transformator_train.script.tl:34

transformator_util.addDoorAnimationState(

… und 2 weitere Dateien.

addBrakeLightsAnimationState(brakingTimer : number, time : number, transfsOutput : Transformator.TransfOutput) base/tealdef/scripts/transformator_util.d.tl:100

Aufruf: transformator_util.addBrakeLightsAnimationState(…)

Hinweise

Spielt brake_lights_on, solange brakingTimer positiv ist, sonst brake_lights_off.

Im Basisspiel verwendet: 4-mal in 4 Dateien

base/content/vehicle/shared/shared/transformator_road.script.tl:25

transformator_util.addBrakeLightsAnimationState(

base/content/vehicle/train/shared/shared/transformator_tiltingTrain.script.tl:39

transformator_util.addBrakeLightsAnimationState(

base/content/vehicle/train/shared/shared/transformator_train.script.tl:39

transformator_util.addBrakeLightsAnimationState(

base/content/vehicle/tram/shared/shared/transformator_tram.script.tl:31

transformator_util.addBrakeLightsAnimationState(

addAnimationStatesRailVehicles(side : {boolean}, reversed : boolean, transfsOutput : Transformator.TransfOutput) base/tealdef/scripts/transformator_util.d.tl:105

Aufruf: transformator_util.addAnimationStatesRailVehicles(…)

Hinweise

Setzt die An/Aus-Animationen, die von der Position des Fahrzeugs im Zug und von der Fahrtrichtung abhängen: front_/back_/inner_/single_ forward_/backward_parts_on|off, forward_parts_*, backward_parts_*, has_previous_*, has_no_previous_*, has_next_* und has_no_next_*.

Parameter	Typ	Beschreibung
`side`	`{boolean}`	`{isFront, isBack}`: ob das Fahrzeug am vorderen und/oder hinteren Ende des Zugs steht.
`reversed`	`boolean`	True, wenn das Fahrzeug rückwärts fährt.
`transfsOutput`	`Transformator.TransfOutput`

Im Basisspiel verwendet: 3-mal in 3 Dateien

base/content/vehicle/train/shared/shared/transformator_tiltingTrain.script.tl:14

transformator_util.addAnimationStatesRailVehicles(

base/content/vehicle/train/shared/shared/transformator_train.script.tl:14

transformator_util.addAnimationStatesRailVehicles(

base/content/vehicle/tram/shared/shared/transformator_tram.script.tl:14

transformator_util.addAnimationStatesRailVehicles(

addDriveAnimationState(totalDist : number, reversed : boolean, transfsOutput : Transformator.TransfOutput) base/tealdef/scripts/transformator_util.d.tl:110

Aufruf: transformator_util.addDriveAnimationState(…)

Hinweise

Fügt die Schleifenanimation drive hinzu, die von der Strecke angetrieben wird (1 Meter = 1.000 Animationseinheiten).

Im Basisspiel verwendet: 6-mal in 6 Dateien

base/content/vehicle/shared/shared/transformator_road.script.tl:14

transformator_util.addDriveAnimationState(

base/content/vehicle/ship/shared/shared/transformator_hovercraft.script.tl:10

transformator_util.addDriveAnimationState(

base/content/vehicle/ship/shared/shared/transformator_ship.script.tl:10

transformator_util.addDriveAnimationState(

base/content/vehicle/train/shared/shared/transformator_tiltingTrain.script.tl:20

transformator_util.addDriveAnimationState(

base/content/vehicle/train/shared/shared/transformator_train.script.tl:20

transformator_util.addDriveAnimationState(

base/content/vehicle/tram/shared/shared/transformator_tram.script.tl:20

transformator_util.addDriveAnimationState(

addBlinkLightsAnimationState(turnLeft : boolean, turnRight : boolean, reversed : boolean, leftStationSince : number, time : number, transfsOutput : Transformator.TransfOutput) base/tealdef/scripts/transformator_util.d.tl:115

Aufruf: transformator_util.addBlinkLightsAnimationState(…)

Hinweise

Blinker-Animationen blink_lights_left_on/off und blink_lights_right_on/off (bei Rückwärtsfahrt vertauscht). Der linke Blinker blinkt auch 5 Zeiteinheiten lang nach dem Verlassen einer Station.

Im Basisspiel verwendet: 2-mal in 2 Dateien

base/content/vehicle/shared/shared/transformator_road.script.tl:31

transformator_util.addBlinkLightsAnimationState(

base/content/vehicle/tram/shared/shared/transformator_tram.script.tl:37

transformator_util.addBlinkLightsAnimationState(

addPantographAnimationState(landVehicleApi : Transformator.LandVehicleScriptingApi, pantographMin : number, pantographMax : number, pantographOffsetFromCenter : number, reversed : boolean, distance : number, transfsOutput : Transformator.TransfOutput) base/tealdef/scripts/transformator_util.d.tl:124

Aufruf: transformator_util.addPantographAnimationState(…)

Hinweise

Setzt den Frame der Animation pantograph aus der mittleren Oberleitungshöhe rund um die Position des Stromabnehmers.

Parameter	Typ	Beschreibung
`landVehicleApi`	`Transformator.LandVehicleScriptingApi`	API für Abfragen entlang des Fahrwegs.
`pantographMin`	`number`	Oberleitungshöhe für den ersten Frame.
`pantographMax`	`number`	Oberleitungshöhe für den letzten Frame.
`pantographOffsetFromCenter`	`number`	Position des Stromabnehmers von der Fahrzeugmitte aus in Fahrtrichtung, in Metern.
`reversed`	`boolean`	True, wenn das Fahrzeug rückwärts fährt.
`distance`	`number`	Halbe Länge des abgetasteten Abschnitts (in beide Richtungen), in Metern. Der Tram-Transformator nutzt 15.
`transfsOutput`	`Transformator.TransfOutput`

Im Basisspiel verwendet: 1-mal in 1 Datei

base/content/vehicle/tram/shared/shared/transformator_tram.script.tl:48

transformator_util.addPantographAnimationState(

addDrivingWheelAnimationState(drivingWheelRadius : number, totalDist : number, wheelDuration : number, reversed : boolean, transfsOutput : Transformator.TransfOutput) base/tealdef/scripts/transformator_util.d.tl:134

Aufruf: transformator_util.addDrivingWheelAnimationState(…)

Hinweise

Fügt die Schleifenanimation wheels für Treibräder (Dampflokomotiven) hinzu, im Takt mit der gefahrenen Strecke.

Parameter	Typ	Beschreibung
`drivingWheelRadius`	`number`	Radius des Treibrads in Metern. Bei 0 oder weniger passiert nichts.
`totalDist`	`number`	Insgesamt gefahrene Strecke in Metern.
`wheelDuration`	`number`	Länge einer Radumdrehung in der Animation.
`reversed`	`boolean`
`transfsOutput`	`Transformator.TransfOutput`

Im Basisspiel verwendet: 2-mal in 2 Dateien

base/content/vehicle/train/shared/shared/transformator_tiltingTrain.script.tl:26

transformator_util.addDrivingWheelAnimationState(

base/content/vehicle/train/shared/shared/transformator_train.script.tl:26

transformator_util.addDrivingWheelAnimationState(

addPaddleAnimationState(paddlePhase : number, transfsOutput : Transformator.TransfOutput) base/tealdef/scripts/transformator_util.d.tl:142

Aufruf: transformator_util.addPaddleAnimationState(…)

Hinweise

Fügt die Schleifenanimation paddles von Raddampfern aus der Schaufelphase (Bogenmaß) hinzu.

Im Basisspiel verwendet: 2-mal in 2 Dateien

base/content/vehicle/ship/shared/shared/transformator_hovercraft.script.tl:22

transformator_util.addPaddleAnimationState(

base/content/vehicle/ship/shared/shared/transformator_ship.script.tl:22

transformator_util.addPaddleAnimationState(

addRudderAnimationState(rudderAngleZ : number, transfsOutput : Transformator.TransfOutput) base/tealdef/scripts/transformator_util.d.tl:146

Aufruf: transformator_util.addRudderAnimationState(…)

Hinweise

Setzt die Animation rudder aus dem Ruderwinkel (Bogenmaß; 0 ist der mittlere Frame).

Im Basisspiel verwendet: 2-mal in 2 Dateien

base/content/vehicle/ship/shared/shared/transformator_hovercraft.script.tl:27

transformator_util.addRudderAnimationState(

base/content/vehicle/ship/shared/shared/transformator_ship.script.tl:27

transformator_util.addRudderAnimationState(

addHelicopterAnimationState(pitchDyn : number, velocityX : number, touchesGround : boolean, bodyAngle : number, vtol : boolean, transfsOutput : Transformator.TransfOutput) base/tealdef/scripts/transformator_util.d.tl:151

Aufruf: transformator_util.addHelicopterAnimationState(…)

Hinweise

Setzt die Rotoranimation pitch und neigt den Rumpf (User-Transform 1) um bodyAngle.

Im Basisspiel verwendet: 1-mal in 1 Datei

base/content/vehicle/shared/shared/transformator_air.script.tl:15

transformator_util.addHelicopterAnimationState(

addPitchAnimationState(velocity : Vec2f, topSpeed : number, transfsOutput : Transformator.TransfOutput) base/tealdef/scripts/transformator_util.d.tl:159

Aufruf: transformator_util.addPitchAnimationState(…)

Hinweise

Setzt die Animation pitch aus der aktuellen Geschwindigkeit im Verhältnis zu 75 % der Höchstgeschwindigkeit.

Im Basisspiel verwendet: 2-mal in 2 Dateien

base/content/vehicle/shared/shared/transformator_air.script.tl:24

transformator_util.addPitchAnimationState(

dlcs/urbangames_deluxe_upgrade_pack/content/vehicle/vehicle/plane/concorde/transformator_concorde.script.tl:14

transformator_util.addPitchAnimationState(

addFlapsAnimation(flapsDuration : number, flaps : number, transfsOutput : Transformator.TransfOutput) base/tealdef/scripts/transformator_util.d.tl:164

Aufruf: transformator_util.addFlapsAnimation(…)

Hinweise

Setzt die Position der Animation flaps aus der Klappenstellung.

Im Basisspiel verwendet: 2-mal in 2 Dateien

base/content/vehicle/shared/shared/transformator_air.script.tl:32

transformator_util.addFlapsAnimation(

dlcs/urbangames_deluxe_upgrade_pack/content/vehicle/vehicle/plane/concorde/transformator_concorde.script.tl:20

transformator_util.addFlapsAnimation(

addGearAnimation(gear : boolean, gearTime : number, gearDuration : number, transfsOutput : Transformator.TransfOutput) base/tealdef/scripts/transformator_util.d.tl:169

Aufruf: transformator_util.addGearAnimation(…)

Hinweise

Spielt open_wheels oder close_wheels für das Fahrwerk.

Im Basisspiel verwendet: 2-mal in 2 Dateien

base/content/vehicle/shared/shared/transformator_air.script.tl:44

transformator_util.addGearAnimation(

dlcs/urbangames_deluxe_upgrade_pack/content/vehicle/vehicle/plane/concorde/transformator_concorde.script.tl:31

transformator_util.addGearAnimation(

addAircraftControlSurfacesAnimation(aileronLeft : number, elevator : number, roll : number, transfsOutput : Transformator.TransfOutput) base/tealdef/scripts/transformator_util.d.tl:175

Aufruf: transformator_util.addAircraftControlSurfacesAnimation(…)

Hinweise

Setzt die Animationen aileron_left, aileron_right, elevator und rudder aus den Steuerwinkeln (Bogenmaß).

Im Basisspiel verwendet: 3-mal in 3 Dateien

base/content/vehicle/shared/shared/transformator_air.script.tl:51

transformator_util.addAircraftControlSurfacesAnimation(

base/content/vehicle/zeppelin/shared/shared/transformator_zeppelin.script.tl:57

transformator_util.addAircraftControlSurfacesAnimation(

dlcs/urbangames_deluxe_upgrade_pack/content/vehicle/vehicle/plane/concorde/transformator_concorde.script.tl:38

transformator_util.addAircraftControlSurfacesAnimation(

addAircraftLightsAnimation(gear : boolean, gearTime : number, gameTime : number, time : number, transfsOutput : Transformator.TransfOutput) base/tealdef/scripts/transformator_util.d.tl:181

Aufruf: transformator_util.addAircraftLightsAnimation(…)

Hinweise

Spielt beacon_lights und strobe_lights und schaltet landing_light_on/off zusammen mit dem Fahrwerk.

Im Basisspiel verwendet: 3-mal in 3 Dateien

base/content/vehicle/shared/shared/transformator_air.script.tl:58

transformator_util.addAircraftLightsAnimation(

base/content/vehicle/zeppelin/shared/shared/transformator_zeppelin.script.tl:45

transformator_util.addAircraftLightsAnimation(

dlcs/urbangames_deluxe_upgrade_pack/content/vehicle/vehicle/plane/concorde/transformator_concorde.script.tl:45

transformator_util.addAircraftLightsAnimation(

addBlurredPropsAnimation(propPhase : number, hasPropsBlurred : boolean, thrust : number, maxThrust : number, transfsOutput : Transformator.TransfOutput) base/tealdef/scripts/transformator_util.d.tl:188

Aufruf: transformator_util.addBlurredPropsAnimation(…)

Hinweise

Wechselt je nach Schub zwischen props_on und props_blurred_on (und den passenden _off-Zuständen). Hat das Modell unscharfe Propeller, erscheinen sie ab 5 % des maximalen Schubs.

Im Basisspiel verwendet: 3-mal in 3 Dateien

base/content/vehicle/shared/shared/transformator_air.script.tl:66

transformator_util.addBlurredPropsAnimation(

base/content/vehicle/ship/shared/shared/transformator_hovercraft.script.tl:49

transformator_util.addBlurredPropsAnimation(

base/content/vehicle/zeppelin/shared/shared/transformator_zeppelin.script.tl:36

transformator_util.addBlurredPropsAnimation(

addAircraftWheelTransformation(modelInfo : Transformator.ModelInfo, touchesGround : boolean, totalDist : number, wheelAngleZ : number, transfsOutput : Transformator.TransfOutput) base/tealdef/scripts/transformator_util.d.tl:195

Aufruf: transformator_util.addAircraftWheelTransformation(…)

Hinweise

Dreht am Boden Achsen und Räder nach der gefahrenen Strecke und lenkt die Lenkteile.

Im Basisspiel verwendet: 2-mal in 2 Dateien

base/content/vehicle/shared/shared/transformator_air.script.tl:74

transformator_util.addAircraftWheelTransformation(

dlcs/urbangames_deluxe_upgrade_pack/content/vehicle/vehicle/plane/concorde/transformator_concorde.script.tl:53

transformator_util.addAircraftWheelTransformation(

calculateTilt(landVehicleApi : Transformator.LandVehicleScriptingApi, speed : number, distance : number, trainReversed : boolean) : number base/tealdef/scripts/transformator_util.d.tl:203

Aufruf: transformator_util.calculateTilt(…)

Hinweise

Neigungswert für Neigezüge aus der Geschwindigkeit und der mittleren Gleiskrümmung rund um das Fahrzeug.

Parameter	Typ	Beschreibung
`landVehicleApi`	`Transformator.LandVehicleScriptingApi`	API für Abfragen entlang des Fahrwegs.
`speed`	`number`	Aktuelle Geschwindigkeit.
`distance`	`number`	Halbe Länge des abgetasteten Abschnitts (in beide Richtungen), in Metern.
`trainReversed`	`boolean`	True, wenn der Zug rückwärts fährt.

Rückgabe number: Wert zwischen 0 und 1. 0,5 heißt keine Neigung.

Im Basisspiel verwendet: 1-mal in 1 Datei

base/content/vehicle/train/shared/shared/transformator_tiltingTrain.script.tl:52

local tilt = transformator_util.calculateTilt(