Class JunctionBase

Revision as of 14:12, 26 February 2024 (view source) Pw3r (Talk | contribs) ← Older edit		Revision as of 14:32, 26 February 2024 (view source) Pw3r (Talk | contribs) Newer edit →
Line 1:		Line 1:
	*[[TrainzScript Library Reference|API Hierarchy]]		*[[TrainzScript Library Reference|API Hierarchy]]
−	**[[Class JunctionBase|JunctionBase]]*	+	**[[Class JunctionBase|JunctionBase]]
	<br>		<br>

---

Revision as of 14:32, 26 February 2024

• API Hierarchy
  • JunctionBase

• Interface methods to control and obtain information about the status of Junction objects.
• This class relates equally to switch levers controlling spline track junctions and to the junction nodes attached to Fixed Track Junction objects.

Contents 1 Constants & Messages 1.1 Junction States 2 Related Messages 3 Methods 3.1 AllowManualControl 3.2 GetDebugString 3.3 GetDirection 3.4 GetDirectionToTrain 3.5 GetGameObject 3.6 GetJunctionOwner 3.7 GetManualControl 3.8 GetMapObject 3.9 JunctionInnerReEnter 3.10 JunctionReEnter 3.11 RequestPermit 3.12 SetDirection 3.13 SetJunctionOwner 3.14 SwitchForTrain 3.15 ToggleJunction 4 Related Methods 5 Categories

Constants & Messages

Junction States

• These values define the directions possible through a junction object.

public define int DIRECTION_LEFT = 0	Left junction direction.
public define int DIRECTION_FORWARD = 1	Forward junction direction (straight on for three way points).
public define int DIRECTION_RIGHT = 2	Right junction direction.
public define int DIRECTION_BACKWARD = -1	Backward junction direction (leading approach).
public define int DIRECTION_NONE = 3	No junction direction or error condition.

Related Messages

• Messages sent to and from Junction objects are listed below:

Major	Minor	Source	Destination
Junction	Toggled	Junction	Broadcast
Junction	Enter	Junction	Train
Junction	InnerEnter	Junction	Train
Junction	Stopped	Junction	Train
Junction	InnerLeave	Junction	Train
Junction	Leave	Junction	Train
Object	Enter	Train	Junction
Object	InnerEnter	Train	Junction
Object	Stopped	Train	Junction
Object	InnerLeave	Train	Junction
Object	Leave	Train	Junction

Methods

AllowManualControl

Parameters

• allow - True to allow the user to toggle the junction, false otherwise.

Returned Value

• None

Syntax;

AllowManualControl(true);

Notes

GetDebugString

Parameters

• None

Returned Value

• A string that contains the node ID and name of the MapObject associated with this junction. If successful, the returned string will include the node ID and name of the MapObject. Otherwise an error string will be returned instead.

Syntax;

Interface.Print(GetDebugString());

Notes

GetDirection

Parameters

• None

Returned Value

• One of the Junction State constants indicating the current direction of the junction.

Syntax;

int direction = GetDirection();

Notes

GetDirectionToTrain

Parameters

• train - A reference to a train located within 15 track stretches of the junction.

Returned Value

• One of the Junction State constants indicating the track on which the train was found.

Syntax;

int approachPath = GetDirectionToTrain(train);

Notes

• DIRECTION_NONE is returned if the train is not within range.

GetGameObject

Parameters

• None

Returned Value

• A reference to the GameObject associated with this junction.

Syntax;

GameObject go = junction.GetGameObject();

Notes

• For a trackside spline junction this method returns the junction lever object.
• For an embedded junction in a fixed track junction the object returned is the embedded junction node.
• In either case null is returned on failure.

GetJunctionOwner

Parameters

• None

Returned Value

• The junction owner, or null.

Syntax;

if (junction.GetJunctionOwner())
 return; // The junction is owned, so we cannot alter state.

Notes

• Returns the junction owner, if any.
• Owned junctions cannot have their direction altered by any script except the owner, including the junction itself.
• Introduced for [[Class InterlockingTower|Interlocking Towers].

GetManualControl

Parameters

• None

Returned Value

• True if the user is allowed to toggle this junction, false otherwise.

Syntax;

bool locked = !GetManualControl();

Notes

GetMapObject

Parameters

• None

Returned Value

• A reference to the MapObject associated with this junction.

Syntax;

MapObject mo = junction.GetMapObject();

Notes

• For a trackside spline junction this method returns the junction lever object.
• For an embedded junction in a fixed track piece the object returned is the fixed track parent object.
• In either case null is returned on failure.

JunctionInnerReEnter

Parameters

• node - Node Id of train as returned by Train.GetId().

Returned Value

• None

Syntax;

junction.JunctionInnerReEnter(train);

Notes

• The effect of this method is to cause a new Junction,InnerEnter message to be sent to the Junction if any part of the train is within the inner trigger radius.

JunctionReEnter

Parameters

• node - Node Id of train as returned by Train.GetId().

Returned Value

• None

Syntax;

junction.JunctionReEnter(train);

Notes

• The effect of this method is to cause a new Junction,Enter message to be sent to the Junction if any part of the train is within the default outer trigger radius.

RequestPermit

Parameters

• token - A token for the junction owner with rights "junction-permit", or null.
• obj - Object requesting the Permit.
• direction - The junction direction for the permit.

Returned Value

• Permit - A Permit for obj to drive through the junction, in the direction request.

Syntax;

Permit permit = RequestPermit(null, train, JunctionBase.DIRECTION_LEFT);

Notes

• The token is unused if the junction is unowned, and can be passed as null.
• Although a Permit is always returned, it may not initially be granted.

SetDirection

Parameters

• token - A token for the junction owner with rights "junction-dir", or null.
• direction - New direction to set.

Returned Value

• Whether the junction was changed to the direction requested.

Syntax;

junction.SetDirection(null, JunctionBase.DIRECTION_LEFT);

Notes

• The token is unused if the junction is unowned, and can be passed as null.

SetJunctionOwner

Parameters

• token - A token for the junction owner (new and current, if applicable) with rights "junction-owner".
• owner - New owner to set, may be null.

Returned Value

• Whether the call succeeded, and the junction owner was changed.

Syntax;

string[] rights = new string[1];
rights[0] = "junction-owner";
SecurityToken token = IssueSecurityToken(GetAsset().GetKUID(), rights);

junction.SetJunctionOwner(token, me);

Notes

• Updates the junction 'owner', which is used to lock access to various functions.
• Owned junctions cannot have their direction altered by any script except the owner, including the junction itself.
• Introduced for [[Class InterlockingTower|Interlocking Towers].

SwitchForTrain

Parameters

• token - A token for the junction owner with rights "junction-dir", or null.
• train - Train that is to pass over the junction.
• direction - One of the Junction State constants indicating the current position of the train relative junction.

Returned Value

• Whether the junction was changed to the direction requested.

Syntax;

junction.SwitchForTrain(null, train, JunctionBase.DIRECTION_BACKWARD);

Notes

• The new direction must be on the opposite side of the junction to the train's current position.
• The token is unused if the junction is unowned, and can be passed as null.

ToggleJunction

Parameters

• token - A token for the junction owner with rights "junction-dir", or null.

Returned Value

• Whether the junction was changed.

Syntax;

junction.ToggleJunction(null);

Notes

• Toggles the junction to the 'next' valid direction.
• The token is unused if the junction is unowned, and can be passed as null.

Related Methods

SceneryWithTrack.GetAttachedJunctions()
World.GetJunctionList()

Categories