RTC
®
5 PC Interface Board
Rev. 1.9 e
10 Commands And Functions
259
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 jump_abs_3d (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 chapter 6.5.1 "Subroutines", "“AbsCalls”", page 77).
• 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 init_rtc5_dll (page 306) command. free_rtc5_dll deletes
DLL board management. Afterward, the application has no access to boards
(get_last_error 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 load_program_file, page 340.
• 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 init_rtc5_dll, release_rtc
To Next Page
Loading...
