Skip to content

Zone Object

The Zone object provides a method for grabbing all Movers within a specified geographic area on the track. A Zone is defined by a Start Position and an End Position, and returns every mover between these points. Zones are especially useful for programming recovery scenarios. When using track management, zones make use of TrackId and only return movers that are both within the zones defined geographic area and have a matching TrackId.



Setup & Execution

1
2
3
// Declaration
ZoneLeftSide        : Zone;
ZoneRightSide       : Zone;

1
2
3
4
5
6
// Initialization
ZoneLeftSide.StartPosition  := 0;
ZoneLeftSide.EndPosition    := 2000;

ZoneRightSide.StartPosition := 2000;
ZoneRightSide.EndPosition   := 4000;



Methods

GetMover

GetMover( Index : USINT, Direction : Tc2_MC2.MC_Direction) : REFERENCE TO Mover

Provides a reference to the Mover that has n = Index movers between it and the end of the Zone specified by the Direction

1
2
3
4
5
6
7
// Selects the mover closest to the Zone's End Position
// Then issues a motion command
ZoneLeftSide.GetMover( 0, MC_Positive_Direction ).MoveToPosition( 2000 );

// Selects the fourth-closest mover to the Zone's Start Position
// Then sets its velocity
ZoneRightSide.GetMover( 3, MC_Negative_Direction ).SetVelocity( 1200 );



Properties

.CurrentMoverList

Provides a MoverList object reference, containing all Movers that are currently within the boundaries set by Start Position and End Position. As a MoverList, methods are provided to command all movers as a group. See MoverList objective for more information

1
2
3
4
5
6
7
8
// Command all movers from position 0 through 2000 to Station#1
ZoneLeftSide.CurrentMoverList.MoveAllToStation( Station[1] );

// Command all movers from position 2000 through 4000 to Station#2
ZoneRightSide.CurrentMoverList.MoveAllToStation( Station[2] );

// Command the singular mover which is closest to the end of the zone to Station#3
Zone.CurrentMoverList.GetMoverByLocation(0,Zone.EndPosition,MC_Positive_Direction).MoveToStation( Station[3] );

.StartPosition

Defines the lower bound for the track region considered by the Zone object.

.EndPosition

Defines the upper bound for the track region considered by the Zone object.

.TrackId

Track that the station is assigned to when using track management. See the Track object.

.ZoneLength

Calculates the length of the defined zone, in millimeters.