Class Crossing

Revision as of 15:58, 24 August 2022 (view source) Christopher824 (Talk | contribs) (→‎SetCrossingState) ← Older edit		Revision as of 15:58, 24 August 2022 (view source) Christopher824 (Talk | contribs) m (→‎SetCrossingAutomatic) Newer edit →
Line 94:		Line 94:
	MyCrossing.SetCrossingAutomatic(token, false);		MyCrossing.SetCrossingAutomatic(token, false);
	;Notes		;Notes
−	If you do not include the SecurityToken, the call will be flagged obsolete	+	*If you do not include the SecurityToken, the call will be flagged obsolete
	<br>		<br>

---

Revision as of 15:58, 24 August 2022

• API Hierarchy
  • GSObject *
    • GameObject
      • TrainzGameObject
      • PropertyObject *
        • MeshObject
          • MapObject
            • SceneryWithTrack
              • Crossing

• An interface to operate a level crossing or similar object.
• By default a crossing is automatically controlled by trains.
• When a train is within 200 meters of the crossing, it will be closed and road traffic will not cross the the track.
• The crossing will reopen for traffic when there are no trains within 200 meters.
• This class allows a crossing asset with custom scripted behavior to be created so the default behavior described above can be disabled and a script can take control.

Contents 1 Constants & Messages 1.1 Crossing States 1.2 Related Messages 2 Methods 2.1 GetCrossingAutomatic 2.2 GetCrossingHasNearbyTrain 2.3 GetCrossingState 2.4 SetCrossingAutomatic 2.5 SetCrossingState 3 Categories

Constants & Messages

Crossing States

---

• These values define the current state of the crossing.
• Note that values 1 and 3 are transient and will occur if the crossing is interrogated in the act of opening or closing.

public define int CROSSING_STATE_OPEN = 0	Crossing is open to road traffic.
public define int CROSSING_STATE_CLOSING = 1	Crossing is in the act of closing.
public define int CROSSING_STATE_CLOSED = 2	Crossing is closed to road traffic.
public define int CROSSING_STATE_OPENING = 3	Crossing is in the act of opening.

Related Messages

---

• Messages sent to and from Crossings objects are listed below:
• Note that these are only a subset of the messages exchanged by the parent SceneryWithTrack class.

Major	Minor	Source	Destination
Object	Enter	Crossing	Crossing
Object	Leave	Crossing	Crossing

Methods

GetCrossingAutomatic

Parameters

• None

Returned Value

• True if crossing is operating in default automatic mode, false if under script control.

Syntax

bool Auto = MyCrossing.GetCrossingAutomatic();

Notes

GetCrossingHasNearbyTrain

Parameters

• None

Returned Value

• True if any trains are found within the 200 metre trigger radius, false otherwise.

Syntax

bool TrainPresent = MyCrossing.GetCrossingHasNearbyTrain();

Notes

GetCrossingState

Parameters

• None

Returned Value

• One of the crossing state constants indicating the current condition of the crossing.

Syntax

int State = MyCrossing.GetCrossingState();

Notes

• If the crossing is in automatic mode the returned state is only valid at the time of the call and can change without script intervention.

SetCrossingAutomatic

Parameters

• auto = True to select automatic mode, false to allow a script to take over.

Returned Value

• None

Syntax

MyCrossing.SetCrossingAutomatic(token, false);

Notes

• If you do not include the SecurityToken, the call will be flagged obsolete

SetCrossingState

Parameters

• state = One of the crossing state constants indicating which state to set.

Returned Value

• None

Syntax

MyCrossing.SetCrossingState(token, Crossing.CROSSING_STATE_CLOSED);

Notes

• Allows the crossing to be opened or closed by a script call.
• Before using this method you should call SetCrossingAutomatic(token, false);
• If you do not include the SecurityToken, the call will be flagged obsolete

Categories