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

Ctrl Command load_z_table
Function loads coefficients A, B and C into the currently assigned 3D correction table.
Restriction If the 3D option has not been enabled or a 3D correction table has not been assigned (see
select_cor_table), then the command returns the error code 12 or 13 and otherwise has
no effect.
Call
ErrorNo = load_z_table( A, B, C )
Parameters
A, B, C
Result error code as an unsigned 32-bit value:
Error bits with values 1 to 64 can also occur combined, but not in conjunction with error codes 11 to 14, which only
occur separately. Warnings 12 and 13 are only returned if no other errors exist.
Value
0
1
2
4
8
16
32
64
11
12
13
14
Comments • This command is only needed for re-calibrating the Z-axis in a 3-axis scan system (for
adjusting corresponding coefficients see
cients can be specified. The coefficients should preferably be chosen so that all Z output
values lie within the range [ – 32768 ... +32767].
• The command will be ignored
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
executed when a list has been paused via
• This command should always be used after the command load_correction_file, since
load_correction_file
correction table.
• Prior to the next list command that directly follows load_z_table, a smooth transition
from the last Z position to the changed position will be performed at jump_speed. You
can also immediately force this via select_cor_table. This way, time delays can be
avoided during an external start.
• Coefficients A, B and C can be queried from the loaded 3D correction table via
get_table_para
get_head_para).
®
RTC 5 PC Interface Board
Rev. 1.9 e
10 Commands And Functions
coefficients (as 64-bit IEEE floating point values) of the parabolic function
2
z = A + Bl +Cl which is used for calculating the Z output values;
out
allowed range:
• for A: [–67108864.0 ... 67108864.0]
• for B: [–2048.0 ... 2048.0]
• for C: [–16.0 ... 16.0]
Out-of-range values will be edge-clipped.
Description
No error
A exceeded the maximum allowed value.
A undercut the minimum allowed value.
B exceeded the maximum allowed value.
B undercut the minimum allowed value.
C exceeded the maximum allowed value.
C undercut the minimum allowed value.
Execution denied (possibly a BUSY or INTERNAL BUSY error; for exact reason: see get_last_error).
Access denied.
3D Option not enabled.
No 3D table is currently assigned.
System driver not found.
(get_last_error
sets the three coefficients to the default values of the loaded
(and from the currently assigned 3D correction table via
page 174). Both positive and negative coeffi-
return code: RTC5_BUSY) if the board's
set_wait (PAUSED status set).
347