Robot.DestAngles Property

Returns an Angles Location whose value is equal to the originally planned final destination of the previously executed motion.

...Robot.DestAngles ( robot )

Prerequisites

None

Parameters

robot

An optional numeric expression that specifies the robot to be accessed (1-n). If this value is 0 or unspecified, the Selected robot will be accessed.

Remarks

This property can be used for retrieving the axes positions that were originally planned as the final destination for the previously executed motion. The previously executed motion can still be in progress or could have already stopped executing when this property is accessed.

This information is useful since it is not altered even if the previous motion was prematurely terminated due to a RapidDecel, E-Stop, or other condition. Consequently, this data can be utilized to complete the previous motion.

Note that performing a motion that is relative to the DestAngles Location is not the same as performing a Move.Rel instruction. The Move.Rel instruction will perform a incremental motion relative to wherever the robot's final position was at the conclusion of the previous motion. Moving relative to the DestAngles Location moves with respect to where the previous motion was planned to terminate.

Table 19-80 describes the data returned in the Location value.

Table 19-80: DestAngles Property Location Value
Property	Returned Location Object value
Type	Angles Location
Angles	Set equal to planned axes position destinations of the previous motion.
RefFrame	Always Null
ZClearance	1.0e32 to indicate not initialized
All other properties	Always zeroed.

Examples

Dim DestLoc As Location 
DestLoc = Robot.DestAngles()  ' Reads planned motion destination