Fly_Return_Z; Free_Rtc5_Dll - Scanlab RTC 5 PC Interface Board Installation And Operation Manual

Normal

fly_return_z

List Command
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
Comments • The jump to the new output position is executed as with
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
® ®
RTC 4 RTC 5 new command. In RTC
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
®
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
DLL board management. Afterward, the application has no access to boards
(get_last_error
• The free_rtc5_dll command does not cause RTC
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 init_rtc5_dll,
®
RTC 5 PC Interface Board
Rev. 1.9 e
10 Commands And Functions
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.
chapter 8.7 "Processing-on-the-fly (Optional)", page
®
4 compatibility mode, the RTC
init_rtc5_dll (page 306)
return code: RTC5_ACCESS_DENIED).
load_program_file, page
release_rtc
jump_abs_3d
chapter 6.5.1 "Subroutines",
177.
®
5 multiplies the specified value for
command. free_rtc5_dll deletes
®
5 board resets. Board resets can only
340.
(see comments
""AbsCalls"", page 77).
®
5 and
259