Scanlab RTC 5 PC Interface Board Installation And Operation Manual page 295

Ctrl Command get_z_distance
Function returns the focus length value l for the specified point within the working volume.
Restriction If the 3D option has not been enabled or if no 3D correction table has been assigned (see
select_cor_table), then the command returns 0 and otherwise has no effect.
Call
ZDistance = get_z_distance( X, Y, Z )
Parameters
X, Y, Z
Result focus length value as a signed 32-bit value [–32768 ... 32767]
Comments • This command is only needed for re-calibrating the Z-axis in a 3-axis scan system (see
page
ence between the specified point(x|y|z) and the point(0|0|0). The focus length value
can be positive or negative.
• The command first performs a (virtual) jump to the point (x|y|z) and then returns the
focus length value.
• If a list is currently executed, then the command has no effect and will return 0
(get_last_error
• The command has no effect and will return 0
if the board's BUSY status is currently set (list is being processed or has been halted via
pause_list) or the board's INTERNAL-BUSY status is currently set. In contrast, the
command is normally executed when a list has been paused via
status set).
• For 3D image field calibration, see
® ®
RTC 4 RTC 5 unchanged functionality (except for the extended range of X and Y values).
®
In RTC 4 compatibility mode, the RTC
by 16 (the permissible range of values is correspondingly reduced to [–32768 ... 32767]).
The value range for Z coordinates is identical for the RTC
References load_z_table
®
RTC 5 PC Interface Board
Rev. 1.9 e
10 Commands And Functions
absolute coordinates of the point (x|y|z) in the working volume 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.
174). The (unit-free) focus length value l corresponds to the focus length differ-
return code: RTC5_BUSY).
(get_last_error
"3D Marking Commands", page
®
5 multiplies the specified X and Y coordinate values
®
5 and RTC
return code: RTC5_BUSY)
set_wait (PAUSED
172.
®
4.
295