RTC6 boards
Doc. Rev. 1.0.21 en-US
10 RTC6 Commands
390
Variable
List Command
fly_return_3_axes
Function “Fly Extension” Command: Deactivates all 3 Axes of a Processing-on-the-fly application
and subsequently carries-out a jump to the specified new output position.
Restriction If the Option Processing-on-the-fly is not enabled, then fly_return_3_axes terminates the
Processing-on-the-fly process (even though it could not have been activated).
Call
fly_return_3_axes( RetPosX, RetPosY, RetPosZ )
Parameters
RetPosX
Absolute axis coordinate of the new output position. In bits.
As a signed 32-bit value.
Allowed value range: [–524,288…+524,287].
Out-of-range values are clipped to the boundary values.
RetPosY
Like
RetPosX
.
RetPosZ
Like
RetPosX
.
Comments • Being an “Fly Extension” Command, fly_return_3_axes must not be used mixed with
“Classic“ Processing-on-the-fly commands (see Footnote, page 242).
• See Chapter 8.6 ”Processing-on-the-fly”, page 242 and Section
”“Fly Extension” Commands”, page 259.
• fly_return_3_axes only deactivates Axes of a Processing-on-the-fly application, if
these have been activated by an “Fly Extension” Command.
• If no Processing-on-the-fly functionality is active at one of the specified Axes, only the
jump is carried out.
• With an unallowed parameter value, fly_return_3_axes is replaced by a list_nop
(get_last_error return code
RTC6_PARAM_ERROR
).
• See also comments on fly_return.
• The following command calls are executed in the same way:
–
fly_return_3_axes( X, Y, Z )
=
fly_return_z( X, Y, Z )
RTC4RTC6 New command.
RTC5RTC6 New command.
Version info Available as of DLL 617, OUT 617, RBF 623.
References fly_return_1_axis, fly_return_2_axes