MC_PlanarTrack

A track within a plane which Planar Movers can follow. Planar Movers on the track automatically avoid collisions with each other. The Planar Track can consist of several consecutive segments and be joined with other Planar Tracks at its start/end.

Do not call the main FB directly. Only use the available methods.

MC_PlanarTrack 1: Methods

Name

Description

Clear

Clears the geometric information of the Planar Track.

AppendPosition

Appends a position to the Planar Track.

AppendLine

Appends a line to the Planar Track.

AppendCircle

Appends a circular arc to the Planar Track.

CloseLoop

Closes the loop of the Planar Track, no further part can be appended.

StartFromTrack

Sets the other Planar Track's endpoint as start point of this Planar Track, transition is smooth. The other Planar Track is blocked for further changes (until it is cleared).

EndAtTrack

Appends a smooth transition from the end of this Planar Track to the other Planar Track's start point. The Planar Track is blocked for further changes (until it is cleared).

StartFromTrackAdvanced

Sets the other Planar Track's endpoint as start point of this Planar Track, transition is smooth. The other Planar Track is blocked for further geometrical changes (until it is cleared).

EndAtTrackAdvanced

Appends a smooth transition from the end of this Planar Track to the other Planar Track's start point. The Planar Track is blocked for further geometrical changes (until it is cleared).

Enable

Starts enabling the Planar Track.

Disable

Starts disabling the Planar Track.

Reset

Starts resetting the Planar Track.

GetArcLengthClosestTo

Calculate the arc length value where the Planar Track is closest to a geometry's center point.

GetPositionAt

Get a position on the Planar Track at a specific arc length value.

GetLength

Returns the Planar Track's length, -1 return value indicates no connection to Nc Track.

GetPlanarObjectInfo

Returns track object info (type: track, id: OID of nc track).

Update

Updates internal state of the object, must be triggered each cycle.

AddToGroup

Adds the Planar Track to the given Planar Group.

RemoveFromGroup

Removes the Planar Track from its current Planar Group, i.e. disables collision checks.

Required License

TC3 Planar Motion Base

System Requirements

Development environment

Target system type

PLC libraries to include

TwinCAT V3.1.4024.12

Advanced Motion Pack V3.1.10.11

PC or CX (x64)

Tc3_Mc3PlanarMotion, Tc3_Physics