Move To

Text Language Definition

procedure TNAxis.MoveTo(XTarget:double, YTarget:double, ...);

Description

Move To performs a relative coordinated move by the specified position parameters. The procedure requires as many parameters as there are dimensions in the axis group. For example, a single axis has one parameter while a group with three axes requires three parameters. The motion is performed with a trapezoidal velocity profile based on parameters set with the Set Accel, Set Decel, and Set Speed command. These parameters apply to the resulting vector path motion of the coordinated group, not to any particular axis. Move To can be used on an axis that is already in motion, replacing the previous target position with the new absolute position. Move To is a blocking command and does not return until the motion has been completed. Blocking program execution until the end of the move is helpful for synchronizing following events. If program execution is required during the move, a non-blocking command such as Begin Move To should be used instead. The Stop, Begin Stop, and Abort commands will end the motion before it reaches the target position.

Escapes

Move To will produce an Axis Is Busy Escape Code if the coordinated group is already in motion.

A single axis can be directed to a new destination while in motion as long as the destination is still ahead of the motion and obtainable with the current decel setting. If not a Motion Overrun Escape Code will occur.

If the destination of the move is beyond the positive and negative software limits the Move To will produce a Position Limit Escape Code.

Examples

This list of commands performs absolute moves with the command interpreter blocking until the move is finished:

This list performs coordinated vector motion blocking the interpreter until the move is complete:

Related Topics

Move By
Set Speed
Set Accel
Set Decel