Get_Z_Distance - Scanlab RTC6 PCIe Board Installation And Operation Manual

Ctrl Command get_z_distance
Function Returns the focus length value l for the specified point within the
Restriction If the Option "3D"
(see select_cor_table), then get_z_distance returns 0 and otherwise has no effect.
ZDistance = get_z_distance( X, Y, Z )
Call
X
Parameters
Y
Z
Result Focus length value. [–524,288...+524,287].
As a signed 32-bit value.
Comments • get_z_distance is only needed for re-calibrating the z axis in a 3-axis scan system, see
Section "Checking the z axis Calibration", page
• The focus length value l:
– Has no dimension
– Corresponds to the focus length difference between the specified point (x|y|z) and
the point (0|0|0)
– Can be positive or negative
• With the RTC6, ZDistance is always in 20-bit range [–524,288...+524,287]:
– In
– In
– In
Important: If you do not use
divide ZDistance by 16 and insert the result into the parabolic function
z
out
• get_z_distance 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 get_z_distance has no effect and returns 0
(get_last_error
• get_z_distance is not executed and returns 0
(get_last_error
– the
– the
• get_z_distance is even executed, if:
– a list has been paused by
• For 3D
RTC4RTC6 Unchanged functionality.
In RTC4 Compatibility
The allowed value range decreases accordingly.
RTC5RTC6 Unchanged functionality.
In RTC5 Compatibility
The allowed value range decreases accordingly.
Version info Available as of DLL 600, OUT 600, RBF 600.
References load_z_table, load_z_table_no, load_z_table_20b,
RTC6 boards
Doc. Rev. 1.0.21 en-US
10 RTC6 Commands
has not been enabled or if no 3D correction table has been assigned
Absolute coordinates of the point (x|y|z) in the
As a signed 32-bit value.
Allowed value range: [–524,288...+524,287].
Out-of-range values are clipped to the boundary values.
Like X (analogously).
Like X (analogously).
RTC4 Compatibility Mode
RTC5 Compatibility Mode
RTC6 Standard Mode
load_z_table_20b
2
= A + Bl + Cl .
return code RTC6_BUSY).
return code RTC6_BUSY), if:
BUSY list execution status
INTERNAL-BUSY list execution status
set_wait (PAUSED list execution status
Image Field calibration, see
Mode, the RTC6 multiplies the values specified for X, Y and Z by 16.
Mode, the RTC6 multiplies the value specified for Z by 16.
3D Image
170.
or load_z_table_no_20b, you must
is set
is set
Chapter "3D Commands", page
load_z_table_no_20b
3D Image Field.
Field. In bits.
set)
238.
449