C Definition

double dms_DestinationPosition(long NodeNumber, long AxisNumber)

Pascal Definition

function dms_DestinationPosition(NodeNumber:longint; AxisNumber:longint):double;

Description

The Destination Position command is valid during a motion and indicates the current target position of the move as an absolute coordinate. This value is useful for identifying how far an axis has to go before the move is finished by subtracting the Commanded Position from the Destination Position. For multiaxis moves the Destination Position is the length of the hypotenuse of the vector move being performed. The beginning of the move is 0 and the end is the Destination Position. If a move is retargeted with a move by command while the move is in progress the Destination Position is a way to identify the final target position for that axis.

Escapes

The Destination Position command does not produce any escapes.

Note that the EscapeResult parameter must be preset to 0 before making the call or the routine will not run

Related Topics

Actual Position
Capture Position
Error Position
Move To
Set Commanded Position
Commanded Position