Class Locomotive

Revision as of 19:27, 24 September 2019 (view source) Ciceronmt (Talk | contribs) (→‎Methods) ← Older edit		Revision as of 19:30, 24 September 2019 (view source) Ciceronmt (Talk | contribs) (→‎SetEngineSetting) Newer edit →
Line 119:		Line 119:
	**"dynamic-brake"		**"dynamic-brake"
	**"headlight"		**"headlight"
		+	**"horn"
	**"injector"		**"injector"
	**"loco-auto-brake" (i.e independantbrake_lever)		**"loco-auto-brake" (i.e independantbrake_lever)

---

Revision as of 19:30, 24 September 2019

• API Hierarchy
  • GSObject *
    • GameObject
      • TrainzGameObject
      • PropertyObject *
        • MeshObject
          • MapObject
            • Trackside
              • Vehicle
                • Locomotive

• A Locomotive is a specialised instance of a vehicle.
• In practice many of the methods in Class Vehicle apply to powered vehicles.
• A locomotive is always part of a train, if a locomotive is decoupled and left alone TRS will create a new consist to include it.

Contents 1 Methods 1.1 GetCabinData 1.2 GetEngineSetting 1.3 SetBellState 1.4 SetBrokenReverser 1.5 SetBrokenThrottle 1.6 SetCabinData 1.7 SetCompressorEfficiency 1.8 SetEngineSetting 1.9 SetHasDriver 2 Code Examples 3 Related Methods 4 Categories

Methods

GetCabinData

Parameters

• None

Returned Value

• A reference to a data object which stores the state of the locomotive's cabin.

Syntax

MyCabinData = loco.GetCabinData();

Notes

• See Class CabinData
• The data object refers to an internal private CabinData object in this class that represents the state of the cabin's controls.
• This is usually maintained by the Cabin.Attach() and Cabin.Update() methods of the Cabin script.

GetEngineSetting

Parameters

• setting = The name of the setting to retrieve.

Returned Value

• The value of the named setting.

Syntax

float throttle = GetEngineSetting("throttle");

Notes

• See SetEngineSetting() for details of the values which can be used for the setting parameter.

SetBellState

Parameters

• state = If true plays and loops the sound of a bell, a value of false will reactivate it.

Returned Value

• None

Syntax

SetBellState(true);

Notes

• Asset of kind "hornsound" must be in the locomotive config.

SetBrokenReverser

Parameters

• broken = If true the reverser will not function, a value of false will reactivate it.

Returned Value

• None

Syntax

SetBrokenReverser(true); 

Notes

• When broken the reverser lever can still be used by the player but it will have no effect on the locomotive.

SetBrokenThrottle

Parameters

• broken = If true the throttle will not function, a value of false will reactivate it.

Returned Value

• None

Syntax

SetBrokenThrottle(true);

Notes

• When broken the throttle lever can still be used by the player but it will have no effect on the locomotive.

SetCabinData

Parameters

• data = A reference to the data object used to store details of the locomotive's cabin controls.

Returned Value

• None

Syntax

SetCabinData(MyCabinData);

Notes

• See Class CabinData
• The data object refers to an internal private CabinData object in this class that represents the state of the cabin's controls.
• This is usually maintained by the Cabin.Attach() and Cabin.Update() methods of the Cabin script.

SetCompressorEfficiency

Parameters

• efficiency = Efficiency of the compressor in the range 0.0 .. 1.0

Returned Value

• None

Syntax

SetCompressorEfficiency(0.5);

Notes

• For a slow increase in pressure of the main reservoir.

SetEngineSetting

Parameters

• setting = The name of the setting to save.
• value = The value of the named setting.

Returned Value

• None

Syntax

SetEngineSetting("regulator",0.5);

Notes

• Settings you can write to with this method are:
  • "dynamic-brake"
  • "headlight"
  • "horn"
  • "injector"
  • "loco-auto-brake" (i.e independantbrake_lever)
  • "pantograph"
  • "regulator"
  • "reverser"
  • "steam-blower"
  • "throttle"
  • "train-auto-brake" (i.e. trainbrake_lever')
  • "train-lap-brake"
  • "script-brake-pressure" - A script-only brake pressure which does not correspond to any real brake device, specified in kPa. This may be used by interior scripts for implementing custom cab-mode braking behaviour, and is intended to be directly mapped from the cab controls rather than updated on a regular frame-by-frame basis from script. Native brake controls should be used where possible to avoid significant performance problems.
• Some apply to steam locomotives only.
• From personal experience: the settings for the electric locomotive are set in whole numbers ("dynamic-brake" 0-1-2; "reverser" 0-1-2 and so on).

SetHasDriver

Parameters

• hasDriver = If true the locomotive has an assigned driver, if false it does not.

Returned Value

• None

Syntax

SetHasDriver(true);

Notes

• Only one locomotive in a train may have a driver.
• If you attempt to place a driver in this loco, any other driver on the train will be removed.
• The consist name and id will always stay with the driver.

Code Examples

Related Methods

Train.GetFrontmostLocomotive()
Train.GetVehicles()
World.GetVehicleList()

Categories