
RTC
®
5 PC Interface Board
Rev. 1.9 e
10 Commands And Functions
259
innovators for industry
Normal
List Command
fly_return_z
Function
deactivates the previously set Processing-on-the-fly correction (for multiple directions in
space, if necessary) and subsequently executes a jump to the defined position.
Restriction
If the Processing-on-the-fly option is not enabled, the command only executes the jump to
the defined new output position.
Call
fly_return_z( X, Y, Z )
Parameter
X
,
Y
,
Z
absolute coordinates of the new output position in
bits
as signed 32-bit
values; allowed range:
• for
X
and
Y
: [–524288 … 524287]
• for
Z
: [–32768 … 32767]
Out-of-range values will be edge-clipped.
Comments
• The jump to the new output position is executed as with
(see comments
there).
• If Processing-on-the-fly-correction was activated within a subroutine called via an
“AbsCall” and subsequently gets deactivated via
fly_return_z
, then the coordinate
values specified with
fly_return_z
will receive an offset (based on the current coordi-
nates at the time of the call, also see
).
• Also see
chapter 8.7 "Processing-on-the-fly (Optional)", page 177
.
RTC
®
4
RTC
®
5 new command. In RTC
®
4 compatibility mode, the RTC
®
5 multiplies the specified value for
the X and Y coordinates by 16 (the permissible range of values is correspondingly reduced
to [–32768 … 32767]). The value range for Z coordinates is identical for the RTC
®
5 and
RTC
®
4.
Version info
Available beginning with version DLL 531, OUT 532
References
–
Ctrl Command free_rtc5_dll
Function
Frees up all resources allocated by the DLL for an application (user program)
Call
free_rtc5_dll()
Comments
• DLL-allocated resources particularly include board-management memory in the DLL
allocated as the result of the
command.
free_rtc5_dll
deletes
DLL board management. Afterward, the application has no access to boards
(
return code
:
RTC5_ACCESS_DENIED
).
• The
free_rtc5_dll
command does not cause RTC
®
5 board resets. Board resets can only
be initiated via the command
• The calling of
free_rtc5_dll
is not absolutely necessary, because DLL-assigned resources
will be automatically freed up when the application terminates and the DLL is thereby
unloaded by Microsoft WINDOWS. However, some application development environ-
ments (in debug mode) issue “memory leaks detected” warnings even though the DLL
will be unloaded. The calling of
free_rtc5_dll
eliminates this annoyance.
RTC
®
4
RTC
®
5 new command
References