Class Cabin - Revision history

Danny252: Change link to library reference, not language reference

2020-12-28T13:47:05Z

Change link to library reference, not language reference

← Older revision		Revision as of 13:47, 28 December 2020
Line 1:		Line 1:
	*[[TrainzScript ~~Language~~ Reference\|API Hierarchy]]		*[[TrainzScript Library Reference\|API Hierarchy]]
	*[[Class GSObject\|GSObject]]		*[[Class GSObject\|GSObject]]
	***[[Class GameObject\|GameObject]]		***[[Class GameObject\|GameObject]]

Laurinlaki: /* Attach */ Added that this gets called after the init has run, sat an hour today on a script where the init crashed because it tried to retrieve the parent from the Attach function which hadn't yet run.

2019-12-07T22:02:58Z

Attach: Added that this gets called after the init has run, sat an hour today on a script where the init crashed because it tried to retrieve the parent from the Attach function which hadn't yet run.

← Older revision		Revision as of 22:02, 7 December 2019
Line 28:		Line 28:
	*A Locomotive object has a cache of cabin control settings that can be saved to when the cabin is updated (see [[Class Locomotive#GetCabinData\|Locomotive.GetCabinData()]])		*A Locomotive object has a cache of cabin control settings that can be saved to when the cabin is updated (see [[Class Locomotive#GetCabinData\|Locomotive.GetCabinData()]])
	*The programmer will need to update and make use of cabin settings in their implementation of this method.		*The programmer will need to update and make use of cabin settings in their implementation of this method.
			*This gets called '''after''' the cabin is fully initialized (after the Init function has run successfully). You can not rely on any information from here to be present during the init.
	<br>		<br>

Ciceronmt: /* SetCabLightIntensity */

2019-09-05T16:59:21Z

SetCabLightIntensity

← Older revision		Revision as of 16:59, 5 September 2019
Line 93:		Line 93:
	;Syntax		;Syntax
	SetCabLightIntensity(0.5);		SetCabLightIntensity(0.5);
	;Notes		;Notes
			''It works? In build 4.3 no changes are visible. Should the texture glow turn on?''
	<br>		<br>
	~~''It works? In build 4.3 no changes are visible. Should the texture glow turn on?''~~

	===Update===		===Update===

Ciceronmt: /* SetCabLightIntensity */

2019-09-05T16:58:30Z

SetCabLightIntensity

← Older revision		Revision as of 16:58, 5 September 2019
Line 95:		Line 95:
	;Notes		;Notes
	<br>		<br>
			''It works? In build 4.3 no changes are visible. Should the texture glow turn on?''

	===Update===		===Update===

Vvmm: /* UserKeyPress */

2016-02-14T19:30:53Z

UserKeyPress

← Older revision		Revision as of 19:30, 14 February 2016
Line 110:		Line 110:
	<br>		<br>

	===~~UserKeyPress~~===		===UserPressKey===
	{{MethodHeader\|public void ~~UserKeyPress~~(string keyName)}}		{{MethodHeader\|public void UserPressKey(string keyName)}}
	;Parameters		;Parameters
	*'''keyName''' = The name of the key pressed.		*'''keyName''' = The name of the key pressed.

Windwalkr: Reverted edits by Vvmm (talk) to last revision by Windwalkr

2013-08-20T04:10:53Z

Reverted edits by Vvmm (talk) to last revision by Windwalkr

← Older revision		Revision as of 04:10, 20 August 2013
Line 110:		Line 110:
	<br>		<br>

	===~~UserPressKey~~===		===UserKeyPress===
	{{MethodHeader\|public void ~~UserPressKey~~(string s)}}		{{MethodHeader\|public void UserKeyPress(string keyName)}}
	;Parameters		;Parameters
	*'''s''' = The name of the key pressed~~, as it is found in [[keyboard~~.~~txt]]~~		*'''keyName''' = The name of the key pressed.
	;Returned Value		;Returned Value
	*None		*None

Vvmm: modified UserPressKey

2013-08-17T17:04:28Z

modified UserPressKey

← Older revision		Revision as of 17:04, 17 August 2013
Line 110:		Line 110:
	<br>		<br>

	===~~UserKeyPress~~===		===UserPressKey===
	{{MethodHeader\|public void ~~UserKeyPress~~(string ~~keyName~~)}}		{{MethodHeader\|public void UserPressKey(string s)}}
	;Parameters		;Parameters
	*'''~~keyName~~''' = The name of the key pressed.		*'''s''' = The name of the key pressed, as it is found in [[keyboard.txt]]
	;Returned Value		;Returned Value
	*None		*None

Windwalkr at 16:20, 9 February 2010

2010-02-09T16:20:01Z

← Older revision		Revision as of 16:20, 9 February 2010
Line 1:		Line 1:
	*[[TrainzScript ~~Langage~~ Reference\|API Hierarchy]]		*[[TrainzScript Language Reference\|API Hierarchy]]
	*[[Class GSObject\|GSObject]]		*[[Class GSObject\|GSObject]]
	***[[Class GameObject\|GameObject]]		***[[Class GameObject\|GameObject]]

Windwalkr: 1 revision

2010-02-03T13:58:33Z

1 revision

← Older revision	Revision as of 13:58, 3 February 2010
(No difference)

Andi06 at 21:12, 7 August 2008

2008-08-07T21:12:58Z

New page

*[[TrainzScript Langage Reference|API Hierarchy]]
**[[Class GSObject|GSObject]] *
***[[Class GameObject|GameObject]]
****[[Class TrainzGameObject|TrainzGameObject]]
****[[Class PropertyObject|PropertyObject]] *
*****[[Class MeshObject|MeshObject]]
******Bogey

 
*This class is the interface class used for cabins and interior assets in Trainz.
*From the scripting perspective, a Cabin is mainly a collection of controls.
*What controls the cabin has depends on the configuration of the asset.
*If a cabin asset is to have custom scripted features, it's script class will need to be derived from this one.
*The types of controls a cabin has is locomotive specific hence this class is the interface and not a cabin implementation.
*The DefaultLocomotiveCabin and DefaultSteamCabin classes provide basic default Cabin implementations.
 

===Attach===
{{MethodHeader|public void Attach(GameObject owner)}}
;Parameters
*'''owner''' = GameObjet to which the cabin will be attached, normally a Locomotive.
;Returned Value
*None
;Notes
*A callback method used by the game engine when it is about to attach this cabin to an object.
*A cabin is destroyed when it is no longer needed and re-created by Trainz later on if needed again.
*This method is where you should restore any saved cabin control settings.
*A Locomotive object has a cache of cabin control settings that can be saved to when the cabin is updated (see [[Class Locomotive#GetCabinData|Locomotive.GetCabinData()]])
*The programmer will need to update and make use of cabin settings in their implementation of this method.
 

===FireAddCoal===
{{MethodHeader|public native bool FireAddCoal(void)}}
;Parameters
*None
;Returned Value
*True if coal is added successfully, false otherwise.
;Syntax
FireAddCoal();
;Notes
 

===GetControls===
{{MethodHeader|public native CabinControl[ ] GetControls(void)}}
;Parameters
*None
;Returned Value
*An array of the CabinControl objects applicable to the cabin.
;Syntax
CabinControl[] controls = GetControls();
;Notes
 

===GetNamedControl===
{{MethodHeader|public native CabinControl GetNamedControl(string name)}}
;Parameters
*'''name''' = Name of control to return.
;Returned Value
*A reference to the named control if it exists, null otherwise.
;Syntax
CabinControl control = GetNamedControl("brake");
;Notes
 

===GetParentObject===
{{MethodHeader|public native GameObject GetParentObject(void)}}
;Parameters
*None
;Returned Value
*A reference to the parent GameObject to which the cabin is attached, usually a Locomotive.
;Syntax
Locomotive loco = cast<Locomotive>cabin.GetParentObject();
;Notes
 

===IsActive===
{{MethodHeader|public native bool IsActive(void)}}
;Parameters
*None
;Returned Value
*True if the cabin is currently active, false otherwise.
;Syntax
bool cabinExists = cabin.IsActive();
;Notes
 

===SetCabLightIntensity===
{{MethodHeader|public native void SetCabLightIntensity(float intensity)}}
;Parameters
*''intensity''' = A normalised lighting level in the range 0.0..1.0
;Returned Value
*None
;Syntax
SetCabLightIntensity(0.5);
;Notes
 

===Update===
{{MethodHeader|public void Update(void)}}
;Parameters
*None
;Returned Value
*None
;Notes
*This is a callback method used by Trainz to update the cabin object.
*This implementation is empty so the script programmer must implement it if they want their cabin's controls to be updated.
*If you want to keep the controls in the cabin up to date and to accurately reflect the current state of the locomotive, you will need to perform those updates from an overridden implementation of this method.
*This is mostly a case of querying the current status of the host locomotive and applying it to the matching control.
*The speedometer in the cab for instance should be updated based on the loco's current velocity.
 

===UserKeyPress===
{{MethodHeader|public void UserKeyPress(string keyName)}}
;Parameters
*'''keyName''' = The name of the key pressed.
;Returned Value
*None
;Notes
*This is a callback method used by Trainz when the user presses a key.
*The default Cabin implementation does not handle any keystrokes. You must do so in your own overridden implementation.
 

===UserSetControl===
{{MethodHeader|public void UserSetControl(CabinControl control, float value)}}
;Parameters
*'''control''' = The control that the user has operated.
*'''value''' = The value to assign as a result of the user's action.
;Returned Value
*None
;Notes
*This is a callback method used by Trainz when the user presses a key.
*You should override this method to apply the settings selected by the user.
 

==Related Methods==
 

==Categories==
[[Category:Script Class]]